从首页进入不同内容
首页用星球和底部 Dock 作为入口，可以进入技术、博客、旅途、训练和终端页面。
09 // MANUAL
网站说明书
先从访客视角说明这个网站能看什么、能点什么，再补充维护方式和后续改进方向。
访客说明
先看访客能直接使用的能力，不把首页特效当成网站的全部。
内容页面
关于、技能、项目、博客、旅途、训练、联系和终端页面已形成完整访问路径。
阅读文章并互动
博客支持搜索、分类标签、文章详情、浏览量和点赞，适合长期沉淀经验。
生活模块
旅途页用中国地图点亮城市，训练页展示身高体重、BMI、三大项和周计划。
内容可维护
博客、旅途和训练内容都已经接入后台维护流程，正式配置后可直接发布。
上线基础已准备
中英文页面、站点地图、搜索引擎基础信息和公开路由已经准备好。
页面说明
每个页面都有明确作用：展示、记录、交互或维护，不再只是占位入口。
路径: /zh
首页
第一屏是主视觉入口。用户可以移动鼠标唤起星球标签，点击星球或 Dock 进入不同页面。
数据来源: 页面结构与首页配置
路径: /zh/about
关于
说明个人定位、表达方式和实现原则，帮助访客快速理解这个网站不是单一作品集。
数据来源: 站点内容配置
路径: /zh/skills
技能
按安全分析、工程实现、交付协作组织能力，适合快速扫描。
数据来源: 站点内容配置
路径: /zh/projects
项目
展示当前项目卡片，强调结果、约束、技术路线和可复用经验。
数据来源: 站点内容配置
路径: /zh/blog
博客
从 content/blog 读取 Markdown，支持搜索、分类标签、文章详情、浏览量和点赞。
数据来源: Markdown frontmatter 与正文
路径: /zh/travel
旅途
中国地图展示去过的城市，点击城市可查看日期、封面、相册、标签和正文记录。
数据来源: content/travel/{locale}/*.json
路径: /zh/fitness
训练
展示当前身高体重、自动 BMI、深蹲/卧推/硬拉、阶段目标和周训练计划。
数据来源: content/fitness/{locale}/profile.json
路径: /zh/contact
联系
保留基础联系路径，并把彩蛋作为附加体验，不阻断正常联系。
数据来源: 站点内容配置
路径: /zh/terminal
终端
可用命令浏览站点信息、模拟文件系统和隐藏入口，是安全主题互动层。
数据来源: 终端命令配置
维护说明
维护说明放在页面后半部分，只解释工作流，不展示任何真实密钥、密码或私有环境变量。
登录
使用 ADMIN_PASSWORD 校验，成功后写入 8 小时 HttpOnly Cookie。
内容维护
Blog 编辑 Markdown/frontmatter；Travel 可维护城市、经纬度、封面、图库和正文；Fitness 可用表单维护身高体重、三大项和周计划。
旅途和训练怎么改
进入 /zh/admin 登录后切换 Travel 或 Fitness。Travel 上传图片可选择设为封面或加入图库，常用城市可一键填经纬度；Fitness 周计划直接增删训练日，不需要手写 JSON。
发布与上传
GitHub 环境变量完整时可发布到仓库，并上传图片到 public/uploads。
降级模式
缺少 GitHub 配置时，前台读取本地内容，后台可预览但禁用发布和上传。
改进建议
后续优先补真实内容和环境验收，再继续增加彩蛋和更复杂的动效。
P0
真实环境联调
用 cms-validation 分支验收 GitHub 发布闭环，并配置 KV REST 验证浏览量/点赞跨重启持久化。
P1
真实内容与视觉精修
补充真实项目案例、旅行照片、训练数据；继续优化首页星球层次、移动端阅读和页面留白。
P1
后台表单校验
加强 Travel 坐标、图片路径、Fitness 数值和 Markdown 字段校验，减少发布错误。
P2
内容分发与彩蛋系统
增加 RSS、站内搜索增强、终端挑战和彩蛋进度系统，但不影响主路径可用性。
P2
更丰富的 3D 与动效
在性能稳定后再扩展 R3F 场景、星球材质、机器人状态和二级页面轻量动效。