从一个基础 Astro 主页，逐步演进为完整的个人数字中枢。
这是 Azek431 Home 的首个公开发行版本。
本次发行并不是一次单点功能更新，而是对项目自 2026 年 5 月 29 日建立以来全部开发成果的阶段性整理。经过百余次提交，项目已经从最初的个人主页雏形，发展为一套包含个人介绍、项目展示、公开链接、状态记录、站内搜索、更新日志、统计信息、RSS、Sitemap、主题系统、快捷键和自动化工作流的静态个人主站。
Azek431 Home 的核心定位是 Digital Nexus（数字连接中枢）：它不试图把所有文章、文档和工具都塞进同一个仓库，而是作为整个 Azek431 公开内容体系的统一入口，连接个人介绍、项目作品、资料库、后续博客、AI 实验和更多独立站点。
版本亮点
完整的个人数字中枢
主站已经不再只是一个简单的个人介绍页面，而是形成了清晰的内容层级：
- 首页负责展示当前重点、精选项目、主要入口和最近更新；
- About 页面用于介绍个人方向、兴趣与长期关注领域；
- Projects 页面集中展示当前项目、状态、分类与仓库入口；
- 项目详情页提供项目介绍、功能、技术标签、仓库和相关项目导航；
- Links 页面整理公开网络入口，并提供分类筛选与复制链接功能；
- Now 页面记录最近正在进行的事情和关注方向；
- Uses 页面整理开发设备、软件、工具和工作流；
- Blog 页面作为后续独立博客体系的入口；
- Colophon 页面说明网站技术栈、设计理念、字体和实现原则；
- Changelog 页面集中记录站点迭代历史；
- Stats 页面展示站点、页面、项目和访问相关信息；
- Search 页面提供站内统一检索；
- 自定义 404 页面为错误访问提供项目和页面推荐；
- RSS 与 Sitemap 为订阅和搜索引擎抓取提供标准入口。
主站由此形成了“首页总览—内容分区—项目详情—公开入口—长期记录”的完整访问路径。
全新首页信息架构
首页经历了多轮结构重排与视觉重构，最终收敛为更明确的内容顺序：
- 品牌与主站定位；
- 当前项目和核心行动入口；
- 全站搜索入口；
- 精选项目；
- 主要导航矩阵；
- 最近更新；
- 公开网络入口；
- 长期关注方向；
- 统一页脚和快捷键帮助。
新的首页减少了无意义的状态堆叠，把最重要的信息放在首屏，并将项目、搜索、站内页面和公开网络入口分开表达。
首页同时完成了组件拆分，将大型页面结构整理为多个独立的 Home 组件，降低后续维护和继续扩展时的耦合。
项目展示系统
项目数据已经从页面中的零散硬编码，整理为统一的项目详情数据结构。
当前项目体系支持：
- 项目名称、描述和详细介绍；
- 已上线、计划中、构想中等状态；
- Website、Docs、Blog、Lab 等分类；
- 技术标签和主题强调色；
- 项目官网；
- GitHub 仓库；
- Gitee 镜像；
- 核心功能列表；
- 项目亮点信息；
- 最近更新时间；
- 动态生成项目详情页；
- 项目详情上下页导航；
- 相关项目推荐。
当前收录内容包括：
- Azek431 Home：个人主站与数字导航入口；
- Azek创游世界资料库：资料整理、项目说明与文档入口；
- Azek431 Blog：计划中的独立技术博客；
- AI Experiments：面向 AI 工具、提示词和自动化流程的实验项目。
GitHub 与 Gitee 入口已在主站、项目卡片和项目详情中统一呈现，为不同网络环境下的访问提供更多选择。
导航系统 V4
顶部导航经过多轮重构，已经从普通链接栏升级为完整的导航系统。
当前导航包含：
- 品牌入口；
- 首页、项目、关于、链接等主要页面；
- 独立搜索入口；
- GitHub 入口；
- Gitee 入口；
- 明暗主题切换；
- “更多”完整导航面板；
- 当前页面状态；
- 桌面端和移动端差异化布局；
- 导航面板遮罩与滚动锁定；
- Esc 关闭；
- 焦点管理和焦点陷阱；
- 导航面板与快捷键面板互斥；
- 触屏安全点击区域；
- 手机横屏和超窄屏适配。
导航数据、页面描述和快捷键映射已集中到统一的数据模块中，减少 Header、快捷键面板和运行脚本之间的重复配置。
全局键盘快捷键
本版本加入了统一的全局快捷键系统，让站点可以像一个轻量控制台一样使用。
页面导航
g→h：首页；g→p：项目；g→a：关于；g→l：链接；g→n：Now；g→u：Uses；g→b：Blog；g→c：Colophon；g→k：Changelog；g→s：Stats；/：站内搜索。
全局操作
t：切换明暗主题；r：随机打开一个项目；?：显示或隐藏快捷键面板；Esc：关闭当前浮层。
快捷键运行时会避让输入框、文本域、下拉框和可编辑区域，避免影响正常输入；组合键设有超时机制，错误按键不会持续占用导航状态。
站内搜索
新增统一 Search 页面，并建立集中式搜索数据。
搜索范围覆盖：
- 主要页面；
- 项目；
- 公开链接；
- 更新日志；
- 后续内容入口。
搜索页提供：
- 实时筛选；
- 类型和内容匹配；
- 无结果提示；
- 键盘
/快速进入； - 与首页搜索入口、Header 搜索按钮和快捷键系统联动。
搜索数据由站点页面、项目和更新数据共同生成，避免重复维护独立的搜索清单。
更新日志与站点统计
Changelog
新增独立更新日志页面，用于记录网站重要迭代。
支持：
- 版本或阶段信息；
- 更新日期；
- 更新类型；
- 更新标题；
- 详细变更内容；
- 按类型筛选；
- 首页展示最新条目；
- 完整历史集中查看。
Stats
新增站点统计页面，用于展示项目当前规模与维护状态。
统计内容围绕：
- 页面与内容结构；
- 项目数量和状态；
- 更新记录；
- 构建时间；
- 站点运行时间；
- 本地访问相关数据。
站点时间逻辑已经从不稳定的运行时 Git 调用中拆离，改为使用固定建站时间与构建环境信息，使 Cloudflare Pages 等静态构建环境下的结果更加稳定。
RSS、Sitemap 与 SEO
项目补齐了静态站点所需的基础公开能力：
- RSS 订阅源；
- XML Sitemap；
robots.txt；- favicon；
- 自定义 404；
- 页面标题与描述；
- canonical 基础地址；
- Open Graph 基础信息；
- 语义化页面结构；
- 正式域名统一为
azek431.top。
Astro 的站点地址已统一为正式域名，RSS、Sitemap 和页面链接可以基于同一站点根地址生成。
UI System V2
视觉系统经历了多轮探索，从基础深色页面、玻璃卡片、液态玻璃和科技 HUD，逐步收敛为当前更统一的 Digital Nexus 视觉语言。
当前设计特征包括：
- 深色科技感背景；
- 玻璃质感容器；
- 柔和极光与渐变光晕；
- 分层边框与阴影；
- 统一的颜色、圆角、间距和缓动 token；
- 页面 Hero 统一结构；
- 项目卡、链接卡、按钮和筛选控件统一语言；
- 卡片光泽、悬停和按下反馈；
- 滚动入场动画；
- Header 滚动收缩；
- 路由切换视觉过渡；
- 鼠标跟随光晕；
- 适度的 3D 倾斜和粒子反馈；
- 明亮主题；
- 减少动态效果适配；
- 减少透明效果适配；
- Windows 高对比模式支持。
样式已经从单一大型全局 CSS，逐步拆分为全局底座、UI System V2 入口和多个职责明确的 UI 样式层。导航拥有独立样式模块，避免继续通过后置覆盖无限叠加。
明暗主题
新增完整的明暗主题切换能力。
主题系统具备：
- 用户主动切换；
- 主题按钮状态同步；
- 页面刷新后保持选择；
- 主要页面、卡片、导航和浮层的明亮主题适配；
- 焦点环在不同主题下保持清晰；
- CSS 变量缺漏修复；
- 移动端显示稳定性优化。
主题切换与全局快捷键 t 联动。
交互体验
本版本加入了多种增强交互，但同时保留静态站点的轻量特征。
主要交互包括：
- Toast 提示组件；
- 一键复制主页和链接地址；
- Links 卡片悬停复制按钮；
- 卡片标签跨页面筛选；
- 项目随机跳转；
- 搜索无结果反馈；
- 页面滚动提示；
- 路由切换幕布；
- 时间线交互与进度表现；
- 卡片悬停光泽；
- 项目相关内容推荐；
- 导航与快捷键帮助面板；
- 点击浮层外部关闭；
- 浮层打开后的焦点恢复；
- 多浮层互斥控制。
全局交互脚本经过多次收口，减少了重复事件监听和不同组件之间的状态冲突。
响应式与移动端
移动端体验不是简单缩小桌面布局，而是经过多轮针对性修正。
本版本完成：
- 移动端导航抽屉；
- 超窄屏 Header 收缩；
- 触摸设备点击区域扩大；
- 手机横屏与矮屏适配；
- 导航菜单滚动；
- 底部安全区域；
- 卡片单列布局；
- 标题字号与留白调整；
- 背景稳定性优化；
- 页面切换时背景闪烁修复；
- 菜单横向溢出修复；
- 手机端降低部分背景光效；
- 移除不必要的点击高亮；
- 触摸和桌面悬停逻辑区分。
组件化架构
当前主站已经形成较完整的 Astro 组件体系。
核心组件包括：
Header；Footer；GlobalShortcuts；ShortcutPanel；ThemeToggle；Toast；NavCard；PageHero；Breadcrumb；Roadmap；RuntimeCounter；InterfaceFX；VisualAura；- 首页专用组件集合。
页面公共结构由 BaseLayout 统一负责，包括：
- HTML 基础结构；
- 页面元数据；
- SEO 信息；
- Header 与 Footer；
- 全局视觉效果；
- 主题初始化；
- 全局快捷键；
- Toast；
- 样式入口。
数据层整理
站点数据已经按职责拆分：
site.ts：站点配置、基础导航和公开链接；navigation.ts：导航描述、顺序与快捷键映射；projects.ts：项目详情和动态项目页面；changelog.ts：更新日志；search.ts：搜索索引；time.ts：建站时间、构建时间和时间格式化。
项目列表由项目详情数据派生，导航与快捷键由统一配置派生，降低了多个页面重复维护同一份信息造成不一致的风险。
工程化与代码质量
项目建立了完整的基础工程规范：
- Astro；
- TypeScript；
- pnpm；
- Prettier；
- Astro Check；
- 静态生产构建；
- EditorConfig；
- Git 属性与换行规范；
- 完整
.gitignore； - Prettier 忽略规则；
- Node.js 版本约束。
提供的主要命令包括：
pnpm dev：启动开发服务器；pnpm build：生成生产静态文件；pnpm preview：预览生产构建；pnpm check：执行 Astro 类型和模板检查；pnpm format：格式化项目；pnpm format:check：检查格式；pnpm verify：依次执行格式检查、Astro Check 和生产构建。
GitHub Actions
本版本包含两套自动化工作流。
持续验证
代码推送或相关事件触发后，可自动执行完整验证流程：
- 安装依赖；
- 检查格式；
- 执行 Astro Check；
- 执行生产构建。
GitHub Release 同步到 Gitee
发布或编辑 GitHub Release 后，工作流会：
- 获取完整 GitHub Release 信息；
- 等待 Gitee 镜像同步对应标签；
- 检查 Gitee 是否已有同标签发行版；
- 不存在时创建；
- 已存在时更新；
- 同步标题、正文和预发行状态；
- 在 Gitee 发行说明中保留 GitHub 原发行版入口；
- 支持从 Actions 页面输入标签手动补同步。
这使 GitHub 可以继续作为唯一主发布源，同时为 Gitee 用户自动提供对应的镜像发行版。
稳定性修复
开发过程中完成了大量细节修复与收口，包括但不限于：
- 修复首页组件调用参数与接口不一致；
- 修复 Roadmap 数据结构和格式问题；
- 修复 Stats 页面类型检查；
- 修复输出插值问题；
- 修复 CSS 变量缺漏；
- 修复移动端菜单横向溢出；
- 修复手机端页面切换背景异常；
- 修复站点时间和构建时间来源；
- 修复外部链接安全属性；
- 修复占位链接被误认为正常入口；
- 修复搜索无结果时缺少反馈；
- 修复多套快捷键监听重复执行；
- 修复浮层焦点和关闭状态冲突；
- 清理旧组件、缓存目录和无效生成文件；
- 重整仓库说明、忽略规则和格式规范。
这些修复使当前版本从“功能可用”进一步进入“可以长期维护”的状态。
技术栈
- Astro 6
- TypeScript
- CSS
- pnpm
- Prettier
- GitHub Actions
- Cloudflare Pages
- GitHub + Gitee 双平台入口
项目保持静态输出，不依赖常驻后端服务，适合部署到 Cloudflare Pages 或其他静态托管平台。
开发历程
2026-05-29：项目建立
- 创建 Astro 项目；
- 完成首页、关于、项目和链接四个基础页面；
- 建立最初的导航与样式结构。
2026-05-30 至 2026-06-01：基础工程与组件化
- 拆分公共布局、组件和数据配置；
- 增加 SEO、favicon、robots 和 404；
- 完善 NavCard；
- 引入 Prettier、EditorConfig 和忽略规则；
- 增加项目详情页和仓库信息；
- 持续优化移动端显示。
2026-06-03 至 2026-06-04：内容体系扩展
- 加入创游世界资料库项目及 Gitee 镜像；
- 深度重构页面 UI；
- 增加 Now、Uses、Colophon；
- 增加移动端导航抽屉和面包屑；
- 增加 RSS；
- 增加 Changelog、Stats、Search 和 Blog；
- 增加项目详情导航和相关项目。
2026-06-05：交互和稳定性
- 加入主题切换、Toast、复制链接、Quick Stats；
- 加入键盘导航和随机项目；
- 整理全局交互脚本；
- 统一项目数据、统计来源和站点时间；
- 修复移动端菜单溢出；
- 完善 Links 分类和搜索反馈。
2026-06-09 至 2026-06-10：视觉系统重构
- 重构首页与核心页面 UI；
- 引入液态玻璃、科技 HUD 和微交互；
- 统一页面 Hero、按钮、项目卡、Links、Search、About、Stats 和 Footer；
- 重排首页信息架构并拆分组件；
- 建立 UI System V2 分层 CSS；
- 增加性能守卫和可访问性适配。
2026-06-11 至 2026-06-12：导航系统收口
- 重构首页首屏和当前项目卡；
- 修复组件接口与 Roadmap；
- 增加 Header Gitee 入口；
- 建立完整导航面板；
- 统一导航数据与快捷键数据；
- 统一全局快捷键运行时；
- 精修导航状态；
- 完成 Navigation System V4 和旧 CSS 去重。
2026-06-14：发行自动化
- 增加 GitHub Release 自动同步到 Gitee 的工作流；
- 支持发行版创建、编辑和手动补同步；
- 为首个公开版本完成双平台发行准备。
当前版本定位
v0.1.0 标志着 Azek431 Home 已经完成从“个人主页原型”到“可长期维护的个人数字中枢”的第一次完整演进。
当前版本已经具备稳定的内容结构、项目展示、导航、搜索、主题、响应式、无障碍基础能力和自动化验证流程，可以作为后续博客、资料库、项目官网和 AI 工具入口的长期基础。
后续方向
接下来的开发将更多转向内容质量和长期维护，而不是继续无限增加视觉效果。
计划方向包括：
- 完善项目案例内容与项目截图；
- 正式推进独立 Blog；
- 更新 README 与当前代码架构的一致性；
- 完善 Open Graph 图片和站点图标；
- 加强 SEO 与结构化数据；
- 增加链接检查、端到端测试和自动化可访问性检查；
- 持续整理 Changelog 和站点统计；
- 进一步减少旧样式与历史兼容代码；
- 扩展 AI Experiments 与自动化工作流内容。
致谢
感谢所有访问、测试和关注 Azek431 Home 的人。
这个版本记录了主站从第一行代码到完整 Digital Nexus 的全部演进过程。后续仍会继续维护、整理和扩展，让这里成为连接项目、学习、创作和公开内容的长期入口。