文档迁移与路径映射
本次以稳定版 VitePress 1.6.4 替换 Jekyll/Minima。域名保持 https://hogancv.github.io，base 保持 /coordinate-agents/。英文为根语言，简体中文为 /zh-CN/。审计基线为 1341ae73daf182cca9b63df728e0e2e1a0b821a9，日期 2026-10-21。
改动清单
- 独立文档依赖和锁文件；GitHub Actions 构建、检查与部署。
- 原生语言菜单、独立中英文导航、移动导航、明暗主题、本地搜索、目录及代码复制。
- Web 产品主路径与结构化 Plugin 分区；完整双语上手、安装、排障、安全、协议、Session 与版本记录。
- 清理过期版本表述与整页双语混排；保留安全、权限、回执与 Runtime 限制。
- 保存精确原文、旧版快照、原地址和片段兼容；附自动链接检查。
- 应用实现、CLI、协议、根依赖与 npm 发布文件选择未改动。
内容清单与版本依据
审计覆盖全部 63 份已跟踪 Markdown（docs 内 47 份），记录路径、行数、SHA-256、标题和链接。
Markdown inventory · Machine-readable route map
| Component | Verified version | Evidence |
|---|---|---|
| Web source | 3.0.2 | package.json, root lockfile |
| npm latest | 3.0.2 | npm view @hogancv/coordinate-agents dist-tags --json |
| GitHub release | v3.0.2 | gh release view v3.0.2 |
| Structured Plugin | 2.4.0 | .codex-plugin/plugin.json (independent version) |
| VitePress stable | 1.6.4 | npm view vitepress dist-tags --json; 2.0.0-alpha.20 is next |
以上是审计日期的事实，不是未来版本承诺。源码、Web npm 包与 Plugin 的发布独立；历史开发记录中的 v3.1 是计划名称。
旧新路径映射
所有既有 Markdown 页面地址均原地保留，继续使用 .html。中文产品链接进入对应中文页；原文技术页不冒充完整译文。以下均相对于 /coordinate-agents/。
已有 /zh-CN/ 和 /zh-CN/codex-conversation-resume.html 同样保持。index.html 与目录首页均可直接访问。原站首页列出的重要入口不需要额外跳转；不存在服务器重写依赖。llms.txt、sitemap.xml 继续提供，旧的空 Atom feed.xml 保留兼容访问；新版版本信息以版本记录为准。
精确历史快照
- v2.4.0 original README
- v2.4.0 original Chinese README
- v2.4.0 original docs index
- v2.4.0 original installation
- Pre-migration docs index
快照位于 public/archive/v2.4.0/，来自固定提交 3e36942ce52004ad3136c6f24be57a8255361c75，保留完整原目录与文件内容。重构前 47 份文档的完整副本位于 public/reference-original/docs/，SHA-256 可与内容清单核对。它们是原始 Markdown，不进入当前文档搜索，不重写其内部历史链接。
剩余未翻译页面
以下为完整、明确的待翻译清单；本地化导航入口不计为全文翻译。主产品阅读路径及结构化 Plugin 上手已全文翻译。
构建与上线
npm ci --prefix docs
npm test --prefix docs
npm run build --prefix docs
npm run check --prefix docs
npm run dev --prefix docs -- --host 127.0.0.1工作流在 PR 中只构建检查；合并到 main 或在 main 手动运行时上传并部署。线上当前配置曾为 legacy / main:/docs，切换前必须先将本次变更合并至 main，再用下列 CLI 将 Source 改为 GitHub Actions 并触发工作流。域名和 HTTPS 配置不变；若部署失败可切回旧提交与旧 Pages Source。实际线上部署状态见维护验收记录，本页不声称本地构建已经上线。
gh api --method PUT repos/hogancv/coordinate-agents/pages -f build_type=workflow
gh workflow run pages-build.yml --ref main
gh run list --workflow pages-build.yml --limit 5