需求、设计与验收

1. 建档规则

重要功能、重构、协议、配置语义、推理链路和部署变更先建 Spec；小修复与一般文档调整可仅记 changelog。纯讨论与只读分析不建档。完整协作规则见 AGENTS.md。

目录采用建档北京时间 YYYY-MM-DD_HHmm__中文任务名/，默认文件为 01__设计与验证.md，续做任务更新原目录，不建立空模板。

记录背景、目标、范围、需求行为、设计取舍、实施步骤、兼容影响、验收标准、实际验证、未验证范围和剩余问题。方案变化先更新记录，再实现；已授权工作不因建档另设审批。

语音相关任务按需记录模型/子模块版本、配置、硬件、源音频与参考音频、输入输出采样率、分块参数和评测方法。素材未公开时记录可公开的复现条件，不附内部资源地址。

状态区分实施中、已实现待验收、已完成。Spec 保存任务历史，design 维护当前设计；完成后同步二者及 changelog。

建档日期	任务	状态
2026-11-04	文档按中英文目录迁移	已完成；迁移到 docs/zh 与 docs/en，55 个既有网页地址及 900 个锚点保留，29 项回归及内容/构建/网页检查通过；Pages 部署成功，57 个线上网页及双语导航、搜索资源验收通过
2026-11-02	VitePress 展示与酸橙主题	已完成；27 个回归用例、57 页构建、双主题、双语搜索、移动端与旧路径兼容通过，Pages 发布及线上内容检查通过
2026-11-02	文档维护与同步检查	已完成；9 对文档内容检查、17 个回归用例、56 页严格构建通过，Pages 发布成功，六个线上地址与本地产物一致
2026-11-02	文档网站与自动发布	已完成；本地严格构建、链接与浏览器验证通过，Pages 首次部署成功，线上页面与搜索索引 HTTP 200 且与本地产物一致
2026-10-29	公开仓库文档体系整理	已完成；含七模块设计、API 重写、中文主文档与英文译文结构，以及 2026-11-03 评测报告归档；文档与网站检查通过，既有 API 示例离线验证见 Spec，未执行 GPU 联调