M3 任务拆解：站点体验与发布能力增强
这份文档用于承接 M3：站点体验与发布能力增强 的执行范围，确保这一轮工作仍然按照“先拆解、再设计、再开发”的顺序推进。
本轮目标
在 M0 到 M2 已经完成“可构建、可导航、可按专题浏览”的基础上，继续把站点往“可发布、可检索、可被搜索引擎理解”的方向推进。
本轮交付范围
本轮优先交付下面四类能力：
- 搜索体验优化
- SEO 与社交分享元信息补齐
- 构建产物增强
- GitHub Pages 发布流程修正
任务拆解
任务一：搜索体验治理
目标：减少无效页面污染搜索结果，并补齐中文化搜索交互文案。
子任务：
- 为自动生成的占位页增加
search: false - 保留全站本地搜索能力
- 补齐搜索按钮和搜索弹窗的中文提示
- 校验重点页面能被正常检索
预期结果：
- 搜索结果更聚焦真实内容
- 占位页不再干扰阅读和检索
- 中文站点交互更统一
任务二：站点元信息增强
目标：让首页、模块页、专题页具备更完整的元信息表达能力。
子任务：
- 为首页、内容导航页、专题导航页与生成页补齐
title/description - 补齐站点级
head元信息 - 增加 Open Graph / Twitter Card 相关字段
- 为页面生成 canonical URL
预期结果：
- 页面标题和摘要更稳定
- 对外分享时可获得更完整的卡片信息
- 搜索引擎对页面关系的理解更清晰
任务三：构建产物补齐
目标：让构建结果具备正式发布所需的基础文件。
子任务：
- 增加
sitemap配置 - 生成
robots.txt - 统一站点生产地址和基础路径配置
- 校验构建产物中关键静态文件存在
预期结果：
- 站点具备基础爬取与索引入口
- GitHub Pages 场景下的路径行为更稳定
任务四：发布工作流修正
目标：让仓库内现有 Pages workflow 真正服务于 VitePress 产物，而不是直接上传整个仓库。
子任务：
- 检查现有
.github/workflows/static.yml - 改为安装依赖并执行 VitePress 构建
- 上传
docs-site/.vitepress/dist - 保持默认分支推送即可发布的行为
预期结果：
- 部署流程与 VitePress 产物一致
- 后续继续迭代文档站时无需重复手工发布
本轮执行顺序
按照当前项目约定，M3 继续严格遵循下面顺序：
- 先完成任务拆解
- 再补详细设计
- 再进入开发实现
- 开发完成后执行自测
- 自测通过后补开发记录与技术博客
- 最后执行 Git 提交与推送
风险与注意事项
- GitHub Pages 的基础路径必须与仓库发布地址对齐，否则静态资源会错位
- 站内搜索依赖构建索引，需重点确认生成页与占位页的索引策略
- 生成脚本是当前站点的核心入口，M3 变更应优先集中在生成脚本中收敛