Skip to content

fix: 修复场景入口索引冲突并记录 API 上线验收 #73

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
yi-ge merged 1 commit into from
Oct 15, 2026
Merged

fix: 修复场景入口索引冲突并记录 API 上线验收 #73

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 11 additions & 3 deletions PLAN.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

本计划把已核对的 DesireCore 接口整理成公开站点中的“集成与 API”区域。用户应能根据文档取得正确的服务地址和授权凭据，完成一次调用，理解响应与运行结果，并处理实际错误。实施采用主 Agent 协调、多个 subAgent 按接口能力并行核查、编写和验证的方式；先交付一个完整可用的接入流程，再按各项能力的实际进度发布扩展参考和 OpenAPI 下载。

状态：P0—P5 完整选定范围已实施并通过本地验收；8 组双语页面、示例客户端、24 个端点及三个服务的规范就绪。上游 #4793 与源码 #4798 已全绿合并；公开文档 PR #72 正在刷新最终来源与发布。P6 自动部署与生产验收进行中。更新日期：2026-10-15。
状态：P0—P5 完整选定范围已实施并通过本地验收；8 组双语页面、示例客户端、24 个端点及三个服务的规范就绪。上游 #4793、源码 #4798 与公开文档 #72 已合并，自动部署成功；16个API页面和8个下载正式线上验收通过。全站验收发现应用场景入口的旧canonical冲突，正在补修。更新日期：2026-10-15。

## 1. 实施目标与完成标准

Expand Down Expand Up @@ -302,8 +302,8 @@ pnpm exec docusaurus serve --host 127.0.0.1 --port 3000

- [x] **T6.1** 审阅最终 diff、支持矩阵、脱敏验证记录和中英文页面。
- [x] **T6.2** 按批次创建 `codex/` 分支与 PR；涉及其它仓库的前置修正分别发布并记录依赖。
- [ ] **T6.3** 进入发布流程后，将已验证改动合并/推送到公开仓库 `main`，等待自动部署结果。按仓库规范无需手动执行 Vercel 部署命令。
- [ ] **T6.4** 核对线上 `/api`、`/en/api`、已公开叶子页面、语言切换及 OpenAPI 下载（若本批包含）。
- [x] **T6.3** 进入发布流程后，将已验证改动合并/推送到公开仓库 `main`，等待自动部署结果。按仓库规范无需手动执行 Vercel 部署命令。
- [x] **T6.4** 核对线上 `/api`、`/en/api`、已公开叶子页面、语言切换及 OpenAPI 下载（若本批包含）。
- [ ] **T6.5** 部署成功后执行 `pnpm sitemap:check`，验证生产 URL、canonical、robots、跳转和软 404。
- [ ] **T6.6** 检查新增内容的搜索可发现性；区分搜索爬取延迟与页面部署失败。
- [ ] **T6.7** 回写本计划状态、公开端点清单与内部台账，记录最终代码/文档/发行基线。
Expand Down Expand Up @@ -469,3 +469,11 @@ P0—P5 表示工作范围，不能作为全局串行阶段。主 Agent 先完
来源清单与三个规范固定到最终源码，内部 docs 指针为远程可达的 `9cc47fc9216db4a3803a982f00649f7af667c933`。33个端点来源/Schema文件仅认证 gate 导入方式调整，调用顺序和24端点合同不变。外围用量消息增加可选模型字段、回执按实际响应归集模型身份；现有指南与客户端兼容，不追加新字段保证或客户端版本约束。原定向运行结果仍按各自固定基线记录。

公开分支已衔接最新 main，保留三个发行版的并行更新日志。部署前生产/API路径及规范下载返回404、sitemap尚无API条目，作为上线前快照；上线验收须等公开PR合并与自动部署成功后执行。

## 14. 生产部署与验收（2026-10-15）

公开PR #72 在最终HEAD `8f808384d3cc8668998c2f097145cbeb0dc12f15` 全部7项检查通过后合并。主分支提交 `93fcbd26c64465e147b8c6532f48c1558a3c989a` 的Production deployment `7088235715` 于北京时间16:54:38成功；未手动执行Vercel部署。

严格生产验收16页、8下载全部200，canonical、语言/同页alternate、可索引性、两语言sitemap条目、robots及下载字节/规范来源全部通过，逐项报告见 `api/production-verification.json`。浏览器从中文对话指南切换英文，保持同页，英文正文和API导航渲染正常、无整页水平溢出。

全站718URL均200，但 `/use-cases` 与 `/en/use-cases` 的canonical被目录README隐式索引覆盖为尾斜杠地址。作者资产说明已重命名为默认排除的 `_README.md`，不改正常入口slug、不放宽验收器。待该修正自动部署后重跑全站检查，再完成T6.5。
Loading
Loading