公开仓库文档体系整理

1. 状态与背景

状态：已完成，中文为主文档、英文译文集中在 docs/en；续做方案与验证记录见第 8 至 13 节。建档时间：2026-10-29 16:05:54（北京时间）。

Fast-VC 已有服务代码、双语 README、WebSocket API、快速开始和历史性能报告，缺少统一设计入口及任务维护规则。此次按公开、独立 GitHub 仓库组织文档，README 保留项目介绍、效果入口和首次调用流程。

源码核对基线：27eced54047fba4cdb42c41589345b5cbb3d6801，包版本 0.1.7。本任务仅整理文档，不升级软件版本。

2. 目标与范围

• 建立仓库自足的 AGENTS、贡献指南、文档索引、当前设计、Spec、changelog 和已确认待办机制。
• README 面向开源用户，说明项目用途、服务层能力、运行条件、样例、快速开始及性能依据。
• 校正双语使用文档和 API，使协议、命令、资源路径与源码一致。
• 保留历史版本说明、原理笔记和性能报告，明确其来源及历史属性。
• 不引入个人机器路径、内部资料或仓库外依赖；不修改源码、客户端、配置、依赖、子模块、模型和音频。

3. 方案与取舍

当前设计回答系统如何工作，Spec 保留单次任务的方案与验收，每日 changelog 只记实际变化。已确认待办与历史愿望分开。

保留 README.md / README_ZH.md、API 和快速开始的既有路径。历史性能目录保留原拼写，新增入口说明。原理笔记归档并保留原路径导航。历史版本说明从既有 README 提取，保留日期与条目正文；不将历史条目倒填成新每日日志。

首次调用使用现有简单协议客户端，显式传入仓库样例，固定使用其可对应的 PCM / 16 kHz 输出路径。标准客户端文档通过 Inputs 显式传入资源，避开脚本默认入口中的环境相关配置。示例脚本问题单独记录，不夹带代码修复。

运行前提、认证占位、单实例参考音色、PCM 返回格式、异步保存和性能统计限制按代码说明；不把源码审阅表述为 GPU 实测。

4. 实施步骤

1. 保存变更前文件摘要，核对源码、配置、协议和现有文档。
2. 建立协作规则、贡献入口及文档骨架，整理当前设计与操作指南。
3. 更新双语 README、快速开始和 WebSocket API，补 HTTP 接口与评测入口。
4. 迁移版本历史和原理笔记，保留历史性能报告，梳理旧 TODO。
5. 检查本地链接与锚点、文档代码片段、协议/配置一致性、公开内容边界和 Git 差异，回填验收。

5. 验收标准

• 单独克隆仓库即可沿 README 和 docs 导航理解使用与开发流程。
• 文档不引用机器绝对路径或仓库外的研究、实验资料。
• 中英文 README、快速开始和 API 的主要事实一致。
• 不存在指向已删除脚本的现行运行指令；历史正文保持可追溯。
• 源码、配置、依赖、音频、子模块及历史性能报告不变。
• 本地链接、文档示例静态检查和 git diff --check 通过。

6. 验证与剩余事项

2026-10-29 完成文档整理。验证覆盖：

• 本地 Markdown / HTML 链接目标与仓库边界、章节编号和公开内容检查通过。
• 文档 Shell 示例通过 bash -n；嵌入 Python 片段通过 AST 解析；API JSON 示例通过解析。
• 中英文 README 与快速开始的 Shell 代码块一致，中英文 API 的 JSON 示例一致。
• 标准客户端 Inputs 字段、简单客户端参数及时间线工具 analyze 命令已与源码核对；修正文档中将函数名误作 CLI 子命令的问题。
• 维护正文的 Git 空白检查通过；暂存区全量检查提示历史版本条目与归档笔记已有的行尾空白及末尾空行，按原文保留约定不改写，已与 HEAD 中的迁移来源逐项核对。源码、配置、依赖、音频和历史性能报告的 SHA-256 与整理前一致。
• 三份原理笔记归档与原文摘要一致；双语版本条目和历史 TODO 正文保持不变。

未执行模型下载、服务启动、GPU 推理、音质试听、容器构建或性能重测；未验证外部站点链接实时可用性。快速开始为按现有实现整理的复现路径，未作为本轮成功运行证据。

源码审阅中确认的认证占位、简单客户端 Opus 参数遗漏、标准客户端默认输入配置、服务端非 16 kHz 时间线统计及 VC_SLOW 单位问题，已写入使用指南或设计限制。本任务未修复代码，也未将这些问题自动列为已承诺任务。

README 提供仓库源音频和参考音频入口，未生成新的转换结果或实时演示；展示当前版本的完整试听合集仍需单独准备可发布素材及运行证据。

7. 变更范围与历史保留

新增仓库协作规则、贡献指南、文档总索引、四篇核心设计、配置与部署、故障排查、HTTP 接口、评测入口、Spec/changelog/todo 维护机制。重写双语 README、快速开始和 WebSocket API。

历史性能报告原路径原文保留；原理笔记迁入 design/archive，并在原路径提供导航；发布说明和历史 TODO 从原 README 保留正文。旧正文中的命令按历史上下文理解，当前操作从新索引进入。

仅变更仓库内 Markdown 文档；Git 提交与推送按维护者指令执行。

8. 2026-10-30 设计模块整理

8.1 背景与目标

维护者确认按七个职责模块整理当前设计：服务启动与运行配置、接入与协议适配、会话与状态管理、音频输入与缓冲、流式转换流水线、模型与参考音色、数据记录与可观测性。总体设计负责串联模块、音频主链路和资源归属。

本轮核对基线为 d0ccdfe，包版本仍为 0.1.7。这是文档职责划分，不改变源码中的类、调用关系或服务行为。

8.2 方案与实施步骤

1. 将原三篇模块文档的内容分配到七篇专题；总体设计保留定位、模块边界、主链路和进程 / Worker / 会话资源归属。
2. 每篇专题说明职责、输入输出、关键流程和约束，链接具体源码及相关文档；模型准备与逐块执行、会话状态与数据记录分别说明。
3. 用新专题替换原三篇模块文档，同步设计索引、文档总索引、归档导航以及操作指南、API、评测中的引用。历史笔记正文与原轮验收记录保持不变。
4. 对照源码与 configs/prod.yaml 检查默认值、生命周期、音频表示和推理顺序，保留认证、完成语义、运行文件隔离和测量口径等现有限制。
5. 检查本地链接、锚点、章节编号和 Git 空白差异，核对源码、配置、素材及历史正文未变，回填验证并追加当日 changelog。

模块划分不要求一篇文档对应一个源文件。API 文档继续维护完整字段与消息合同，操作指南继续维护运行命令和配置用法，评测指南继续维护测量步骤。

8.3 验证与剩余事项

2026-10-30 完成总体设计与七篇模块设计，入口见当前设计。原三篇模块文档已由新专题替换，文档总索引、设计索引、归档导航、历史入口导航、HTTP API、故障排查和评测引用同步更新。

实际验证：

• 对照 CLI、App、配置、路由、协议适配器、Buffer、Session、模型工厂和转换流水线核对职责、调用顺序与资源归属，注明 prod.yaml 与类默认值的区别。
• 现行文档本地链接和锚点检查通过，未发现指向被替换专题的遗留链接；设计目录核对为索引、总体设计及七篇模块专题。
• 变更文档的 H1 / H2 / H3 编号、行尾与结尾换行、机器路径检查通过，git diff --check 通过。
• 整理前后核对 56 个源码、配置、依赖、素材及历史正文文件的 SHA-256，内容一致；变更仅涉及仓库 Markdown 文档，归档原文和历史性能报告保持不变。

未执行模型下载、服务启动、GPU 推理、音质或性能重测，也未验证外部站点链接实时可用性。本文档整理已完成；现有实现限制继续按所属专题记录，不新增功能、代码修复或待办承诺。尚未提交或推送。

9. 2026-10-30 API 文档规范化

9.1 背景与范围

维护者确认将接口合同集中到 docs/api/，与内部模块设计平级。本轮从 7a4be15 开始，包版本仍为 0.1.7；该提交已包含第 8 节设计整理。本轮只整理接口文档，不修改服务路由、协议或客户端实现。

9.2 方案与兼容影响

• 建立 docs/api/README.md 统一导航，清点 WebSocket、HTTP 业务入口和框架文档入口，说明协议选择、访问控制和文档分工。
• 将原中文、英文 WebSocket 文档分别迁为 websocket.md、websocket.en.md，按连接生命周期、字段类型与省略默认值、控制消息、音频格式、错误和客户端限制组织；保留原协议文档版本历史。
• 将 HTTP 文档迁为 http.md，继续提供中英对照，逐接口说明方法、路径、参数、状态码、响应和示例，补充会话数据编码、日期查询、前缀匹配及保存时序。
• 标明接入约定与现有校验的差别，不把缺失校验、异常关闭或适配器格式能力写成已实现保证。接口文档引用源码，设计只解释内部机制，快速开始继续维护可执行上手步骤。
• 同步协作规则、README、快速开始、设计与其他现行引用，移除原 API 正文。文档路径变化可能影响仓库外的旧链接；服务 URL 和协议不变。历史 Spec 与版本说明保留当时叙述。

9.3 实际验证与状态

2026-10-30 完成 API 导航、中文 WebSocket、英文 WebSocket 和中英 HTTP 文档（现已按第 10 节拆为系统与会话数据）。旧目录正文已迁出，协作规则、双语 README、快速开始、设计及文档总索引引用同步更新。

按源码补充字段类型、提供要求、字段省略默认值、消息时序、超时与结束边界；简单协议错误格式与实际可触发的路由错误分开说明。HTTP 文档补充 JSON 字符串编码、日期回退、文件名前缀匹配、无文件返回 500，以及完成响应早于保存的语义。

实际验证：

• 静态提取 3 条 HTTP 与 2 条 WebSocket 路由声明，均在 API 导航中覆盖；WebSocket 两条路径使用同一处理函数。
• 21 个 JSON 示例、3 个 Shell 示例及 1 个 Python 示例分别通过 JSON 解析、bash -n 和 AST 解析。
• 中英文 WebSocket 的 9 组 JSON 示例、16 行字段名称与类型及章节结构一致；对照源码检查默认值、错误和超时描述。
• 在不导入服务或模型的条件下加载协议适配器，核对文档中的初始化映射、结束识别、完成消息和标准错误示例；HTTP 解码示例使用内存 ZIP / GZIP / Base64 数据及模拟响应离线执行通过，未访问服务。
• 现行文档本地链接与锚点、变更正文的章节编号与空白检查通过，未发现旧 API 路径引用；双语项目 README 保留原有题图入口，未调整其标题结构。
• 56 个源码、配置、依赖、客户端、素材及历史正文文件的 SHA-256 与整理前一致；变更仅涉及 Markdown，git diff --check 通过。

未执行模型下载、服务启动、真实 WebSocket / HTTP 联调、GPU 推理、音质或性能评测，也未验证外部站点实时可用性。文档整理已完成，现有限制未作为代码修复或新待办处理；本轮 API 文档变更尚未提交或推送。

10. 2026-11-02 API 按功能组织

10.1 目标与命名

接口文档按对外功能划分，传输协议在各接口正文中说明。语音转换使用 voice-conversion.md 与 voice-conversion.en.md；健康检查与版本查询使用 system.md；已保存会话数据使用 session-data.md。后两篇继续中英对照。

system.md 表达系统级接口职责，与现有基础路由的 System 标签一致。当前仅包含健康检查和版本查询，不将就绪检查、能力查询等潜在扩展写为已实现接口。

10.2 实施与验证计划

迁移双语语音转换文档，拆分原 HTTP 文档并保留字段、响应、示例及实现边界；在 API 导航中按功能列出文档和端点。同步 README、快速开始、设计与 Spec 链接；第 9 节保留当时的迁移记录。服务路由与消息协议保持不变。

完成后检查本地链接、锚点、章节编号、双语示例与 git diff --check；复核拆分后的路由覆盖、示例及源码一致性，记录实际验证。

10.3 实际验证与状态

已完成语音转换及其英文版、系统 API、会话数据 API的功能划分；API 索引、双语 README、快速开始、设计、协作规则与现行链接同步调整。

本地链接、锚点、章节编号、空白与机器路径检查通过，未发现指向已移除协议命名文件的链接。3 条 HTTP、2 条 WebSocket 路由均在索引中覆盖；21 个 JSON、3 个 Shell 与 1 个 Python 示例静态检查通过；双语语音转换的 9 组 JSON、16 行字段与类型及章节编号一致。协议适配器示例与会话数据解码示例离线执行通过。

56 个源码、配置、依赖、客户端、素材及历史正文文件的 SHA-256 与整理前一致，git diff --check 通过。未执行服务启动、真实接口联调、GPU 推理或性能评测。此次仅调整文档组织，API 文档改动尚未提交或推送。

11. 2026-11-02 API 文档表达优化

11.1 问题与参考

上一版将源码核对、迁移历史、验证限制与接口说明混排，且系统、会话数据和导航逐段中英重复。调用方在看到请求和响应前需要阅读过多维护信息。

本轮查阅以下官方文档，参考信息组织方式，不移植其接口行为：

• Ollama Generate：接口用途、方法与路径、请求 / 响应示例、字段类型及默认值；流式响应和错误单独解释。
• Prometheus Management API：简单系统接口直接列路径和返回含义；HTTP API将通用格式与具体端点分开。
• vLLM OpenAI-Compatible Server：明确支持范围，调用示例与扩展参数分层说明。

11.2 实施方案

保留语音转换、系统接口、会话数据三个功能分类。每页直接说明用途和调用方式，再给参数、响应、错误与必要限制；语音转换先展示完整消息流程，标准和简单协议分别说明。索引只保留接口入口、地址、访问约定与相关文档。

中文文件使用连续中文正文，英文统一使用 .en.md 配对文件；新增英文索引、系统及会话数据文档，同步英文 README 和快速开始。文档核对基线、历史版本表和验证记录集中保留在本 Spec，不再重复放入每篇 API 正文。现有字段、默认值、错误、无鉴权、异步保存和客户端兼容限制仍按源码描述。

本轮基线仍为 7a4be15、包版本 0.1.7；只修改 Markdown。保留已有暂存区，不提交或推送。完成后检查链接、章节编号、双语字段与示例、路由覆盖及 git diff --check，不将静态或离线验证表述为服务联调。

11.3 原协议文档版本记录

以下表格从原语音转换 API 页迁入保留，版本号不是请求中的协商字段。

协议文档历史版本	日期	变更
1.0	2025-05-27	初始版本
1.1	2025-06-15	简单协议与 opus_frame_duration
1.2	2025-11-04	sample_rate_out

2026-10-29 校正源码一致性，2026-10-30 迁入 API 目录并规范化说明，2026-11-02 按语音转换功能命名，均未修改协议实现。

11.4 实际验证与状态

已重写 API 索引、语音转换、系统接口和会话数据文档，并为四者提供独立中英文文件。标准协议的初始化、ready、音频收发、end 和 complete 按调用顺序展示，随后提供字段表、音频格式、简单协议及错误处理；系统接口直接给出请求和响应，会话数据保留解码示例与保存时序。英文 README 和快速开始指向英文页面，文档总索引明确语言入口。

对照路由、协议适配器及 SessionDataManager 复核现有行为。24 个 JSON 示例、6 个 Shell 示例和 2 个 Python 示例分别通过解析、bash -n 与 AST 检查；4 对中英文的章节编号、字段类型及对应代码示例一致。3 条 HTTP、2 条 WebSocket 路由均在索引覆盖，9 组语音转换 JSON 示例通过适配器离线检查，会话数据解码示例通过模拟 HTTP 响应执行。

现行文档的本地链接、锚点和变更文档章节格式检查通过；56 个源码、配置、依赖、客户端、素材及历史正文文件摘要与整理前一致。git diff --check 通过。保留了先前暂存内容，本轮未提交或推送；未执行真实服务联调、GPU 推理或性能评测。

12. 2026-11-02 多语言文档组织

12.1 目标与依据

维护者确认采用独立语言正文、限定翻译范围和语言目录。用户文档覆盖安装、配置、接口调用及故障排查；研发设计、Spec、每日日志、待办与评测文档继续中文维护，历史正文保留原语言。

调研参考 FastAPI 语言目录及翻译排除规则、Kubernetes 本地化指南、Vue 翻译维护规则。采用按语言组织及明确维护范围的做法，不引入独立翻译仓库或站点构建系统。

12.2 方案与兼容影响

1. 根目录保留英文 README.md 与中文 README_ZH.md；新增 docs/zh/README.md、docs/en/README.md 作为各语言用户入口，docs/README.md 保留中文总索引和多语言维护规则。
2. 将 API 分别迁入 docs/zh/api/、docs/en/api/，对应文件统一使用 README、voice-conversion、system、session-data 名称；快速开始、配置与故障排查使用各语言的 getting-started/quick-start.md、configuration.md、troubleshooting.md，补齐英文配置和故障排查。
3. 中文用户文档作为维护原文，英文为译文；保持参数、示例及行为一致。语言版本内优先链接同语言页面，无译文时标明原文语言。翻译范围只覆盖索引列出的用户文档，不自动扩大到新增文档。
4. 更新全部现行相对链接和锚点，历史 Spec 与日志只更新失效链接，保留当时的路径叙述。原 getting_started 中三篇历史笔记的兼容入口和归档正文保留；历史性能报告索引去除重复的英文摘要，报告正文不改写。
5. 保留本轮开始前的暂存区及已有修改，不提交或推送。仅调整 Markdown，不修改服务、客户端、依赖、配置或素材。路径迁移可能影响仓库外旧链接。

12.3 验证计划

检查语言目录对称性、同语言导航、全部现行本地链接和锚点、章节编号、请求与配置示例、中英文参数与默认值；核对源码及历史正文摘要、已有暂存内容和 git diff --check。示例仅做静态与必要离线验证，不执行服务部署或 GPU 联调。

12.4 实际验证与状态

已迁移 12 篇用户文档，补齐英文配置部署与故障排查，并建立中文入口和英文入口，每种语言均包含 8 篇对应文档。总索引集中维护翻译范围、原文与译文关系、同步及单页语言规则，AGENTS 与 CONTRIBUTING 链接该规则；根 README、设计、评测、历史入口及任务记录中的现行链接已同步。

8 对文档的文件路径、章节编号、字段类型与代码示例对应一致；19 行配置名称和示例值一致，迁移前后原有代码块保持不变。24 个 JSON、24 个 Shell 和 2 个 Python 示例通过静态检查；API 适配器及会话解码示例离线验证通过。同语言导航、英文正文语言与现行文档链接、锚点、章节格式检查通过。

55 个源码、配置、依赖、客户端、素材及历史正文文件摘要保持不变。历史性能报告索引按方案更新链接并去除重复英文摘要，报告正文、发布说明、归档原文及三篇旧路径跳转页保持不变。开始前暂存差异的 SHA-256 与完成时一致，git diff --check 通过。

仅完成文档与离线验证，未运行模型下载、真实服务、GPU 推理或性能评测。此次改动未提交或推送。

13. 2026-11-02 中文主文档与英文译文目录

13.1 目标与方案

维护者确认中文为主文档，英文译文集中在 docs/en/，继续沿用限定翻译范围。默认语言位于主目录、其他语言使用子目录的方式也见 VitePress 多语言说明；本仓库仅使用 Markdown 链接，不引入文档站点工具。

1. 根 README.md 使用中文项目介绍，原英文项目介绍迁入 docs/en/README.md，原英文用户索引迁为 docs/en/index.md。删除重复的 README_ZH.md，将中文用户导航并入 docs/README.md。
2. 中文 API 与操作指南分别迁回 docs/api/ 和 docs/getting-started/，英文保持相同功能子目录和文件名。移除 docs/zh/，同步 Markdown、HTML 资源引用和语言切换链接。
3. 根 CONTRIBUTING.md 改为中文，AGENTS.md 仅保留根目录一份中文规则。翻译范围仍为项目首页、用户导航、快速开始、配置、故障排查和 API；英文用户索引只覆盖中文总索引中的用户导航，其他中文文档通过注明语言的链接引用。
4. 文档总索引集中维护语言约定，AGENTS 摘要并链接。开发设计和任务记录继续中文维护，历史发布说明、性能报告、归档原文及旧笔记跳转页保留；历史 Spec 与日志只修正失效链接，不重写当时采用的目录方案。
5. 本轮仅修改文档，保留开始前工作区与暂存内容，不提交或推送。旧 README_ZH.md 与 docs/zh/ 的外部链接需要改用新路径；包元数据继续引用根 README.md，项目主页和包介绍将以中文为默认语言。

13.2 验证计划

检查根目录和英文入口、全部现行本地链接与锚点、Markdown 标题格式、英文页面的同语言导航与中文目标标注。对照迁移前后文档正文及代码块，确认 API 字段、配置示例和调用命令不变，中英文事实一致。核对非文档文件、历史原文和暂存差异摘要，并执行 git diff --check。

13.3 实际验证与状态

已将中文项目首页置于根 README，英文项目首页和用户索引分别置于 docs/en/README.md、docs/en/index.md；中文操作指南和 API 回到 docs/getting-started/、docs/api/，中文用户导航并入总索引。CONTRIBUTING 改为中文，AGENTS 和总索引同步语言约定；英文页面引用中文贡献指南、设计及任务记录时明确标注语言。原 README_ZH.md 与 docs/zh/ 已移除。

42 篇现行文档的本地链接与锚点、变更文档标题和空白检查通过。英文目录共 9 篇文档，其中 8 篇与中文完整配对，用户索引单独核对导航覆盖；语言切换、同语言导航及英文正文检查通过。8 对文档的章节编号、API 字段类型与代码示例一致，19 行配置名称和示例值一致；24 个 JSON、28 个 Shell 和 2 个 Python 示例分别通过解析、bash -n 和 AST 检查，迁移前后所有原有代码块未变。

55 个非文档文件、历史正文及旧笔记跳转页摘要与迁移前一致；历史 Spec 和日志正文保留，只修正失效链接并追加此次记录。开始前暂存差异的 SHA-256 与完成时一致，工作区和暂存区的 git diff --check 均通过。

本轮仅做文档迁移和静态验证，未重复执行此前的 API 离线验证，也未执行真实服务、模型下载、GPU 推理或性能评测。未提交或推送。

14. 2026-11-03 统一评测与报告目录

14.1 目标与命名

维护者要求将历史性能报告并入 evaluation，报告正文保持原样，更新相关链接与文档导航；reports 子目录按时间精确到分钟命名，不再按版本分组。确认采用 2025-06-14_1952、2025-06-15_1803、2025-06-15_2103 三个目录，不额外添加时间依据说明。

14.2 实施方案与兼容影响

1. 评测方法继续维护在 docs/evaluation/README.md，新增 reports/README.md 作为报告索引与归档规则的唯一维护位置。
2. 三份原文分别迁至 reports/2025-06-14_1952/1080ti.md、reports/2025-06-15_1803/4090d.md、reports/2025-06-15_2103/v100.md，逐个比较 SHA-256，保留历史数据、措辞、语言、空白与标题。
3. 新报告使用实际测试开始时间的北京时间 YYYY-MM-DD_HHmm 目录，报告内记录时间及其时区、版本与完整复现条件。
4. 原 perfermance_tests 的索引与三份报告路径仅保留简短迁移指引，维护中的中英文首页、文档入口、归档入口与网站侧栏统一指向新位置。
5. 更新协作规则、文档维护与网站设计说明。网站仍为报告正文附加历史提示，正文及旧路径入口不进入搜索，报告索引可检索；HTML 检查器允许迁移后的历史正文保留旧标题格式。
6. 仅调整文档组织及对应构建规则，不改服务、依赖、配置、音频或模型，不提交、推送或发布。

14.3 实际验证与状态

状态：已完成。三份历史报告与迁移前 HEAD 中的原文逐字节一致，SHA-256 一致；中英文首页、用户索引、维护与归档入口、网站侧栏均指向新位置。四个旧路径页面保留可用迁移链接，报告正文有历史提示，评测指南与报告索引可搜索，报告正文和旧路径入口不进入搜索。

文档内容检查通过（9 对文档、54 个机器示例、60 个配置值）；既有 18 个 Python 和 9 个 Node 用例通过。生产构建完成，60 个 HTML 页面、站内链接、锚点、资源与 237 条真实搜索记录检查通过。git diff --check 通过；新位置的历史正文保留原有行尾空白与末尾空行，未为格式检查改写原文。

仅完成本地文档与构建验证，未运行服务联调、GPU 推理或性能评测；未提交、推送或发布。

14.4 后续调整：移除旧目录

维护者要求直接删除 docs/perfermance_tests，不保留兼容入口。此决定替代 14.2 中保留旧路径的方案；14.3 及此前日志保留当时的验证事实。

删除旧目录的四个迁移页，移除报告索引与当前设计中的兼容说明，以及网站历史标记、搜索排除和相应用例中的旧目录分支。现行链接与导航继续使用 evaluation/reports，三份历史原文保持不变。旧网址不再提供迁移页或重定向。

完成后检查文档、生产构建、站内链接和搜索，确认源目录、生成页面与构建清单中的旧入口已移除；核对报告摘要与本轮开始前的暂存差异，保留已有暂存内容。

14.5 旧目录清理验证

已删除四个兼容入口及源目录，清理现行文档的兼容说明、网站历史标记与搜索排除中的旧路径规则；旧目录名仅作为历史事实保留在 Spec 和变更记录中。构建清单、搜索记录及生成网页均不再包含旧入口。

文档内容检查、18 个 Python 与 9 个 Node 用例通过；生产构建、56 个 HTML 页面、站内链接与资源、237 条搜索记录检查通过，git diff --check 通过。三份报告的 SHA-256 与本轮开始时一致，已有暂存差异的 SHA-256 保持不变。

本轮未暂存、提交、推送或发布；未运行服务、GPU 推理或性能评测。