docs: organize top-level documentation

2026-09-23 09:24:14 +08:00
parent 42d59c71a7
commit 7fd594a2a4
11 changed files with 50 additions and 50 deletions
@@ -81,8 +81,8 @@
 - 当前MQ-only/OSS调整目标已获用户明确批准由当前Agent独立执行，**不启动子Agent**，不得再以子Agent模型/fast环境阻塞本目标；此前按任务类型自动分工规则在本目标不适用。若未来另获启动授权，仍遵守下条模型要求。
 - 用户指定：若启动开发及配套审查子Agent，固定 **gpt-5.6-luna、max思考、fast模式**。启动前查询精确provider/model和runner支持并显式配置（当前工具用模型`:max`后缀及`fast: true`，不继承默认）；不可用/不支持/无法核验则报告阻塞，不静默换模型、降思考档、关fast或换CLI。此为后续执行约束，本轮仅修复计划，未启动开发子Agent。
 - 并行开发须先有获授权的可追溯Git/契约基线、一lane一工作区/测试资源、无交叠写集合及每批合并后回归；当前子项目尚未跟踪的文件不能假定存在于HEAD/worktree。不得自动提交、暂存或清理父项目无关改动；详情见计划§9。
- 当前已获授权进行本项目开发：W01 项目内契约基线和 W02 Proto/stubs 已建立；仍不能把设计、Mock、Proto或88项测试清单写成真实供应商/生产验收已通过。入口和权威依据仍为 `docs/Go重写方案_v0.3.md`、`docs/验证与切换验收_v0.3.md`、`docs/通信与事件数据交互_v0.1.md`、`docs/OpenAPI与MQ字段索引_v0.1.md`、`docs/开源组件选型与复用清单_v0.2.md`。
- 开发准备见 `docs/G0开发准备与契约冻结提案_v0.1.md`：D01–D10的方案方向、双模式/许可/恢复机制及内部PoC初始profile已获用户确认；本项目已自行交付 W01/W02 开发基线，但外部权威发布、真实预算、供应商签收和 G0/PoC 仍需分别验证，不能混写为生产合同。缺失字段细节、实际预算及方案变更另行确认。本轮验收基线收敛为单节点/单 Agent/单 Cell/单租户；双节点、第二 Cell、第二租户及其公平/故障矩阵不在本轮开发或验收范围，跨 Cell/多租户能力保留为后续阶段。
+- 当前已获授权进行本项目开发：W01 项目内契约基线和 W02 Proto/stubs 已建立；仍不能把设计、Mock、Proto或88项测试清单写成真实供应商/生产验收已通过。入口和权威依据仍为 `docs/architecture/Go重写方案_v0.3.md`、`docs/acceptance/验证与切换验收_v0.3.md`、`docs/contracts/通信与事件数据交互_v0.1.md`、`docs/references/OpenAPI与MQ字段索引_v0.1.md`、`docs/dependencies/开源组件选型与复用清单_v0.2.md`。
+- 开发准备见 `docs/architecture/G0开发准备与契约冻结提案_v0.1.md`：D01–D10的方案方向、双模式/许可/恢复机制及内部PoC初始profile已获用户确认；本项目已自行交付 W01/W02 开发基线，但外部权威发布、真实预算、供应商签收和 G0/PoC 仍需分别验证，不能混写为生产合同。缺失字段细节、实际预算及方案变更另行确认。本轮验收基线收敛为单节点/单 Agent/单 Cell/单租户；双节点、第二 Cell、第二租户及其公平/故障矩阵不在本轮开发或验收范围，跨 Cell/多租户能力保留为后续阶段。
 - 用户已确认完整 Go Agent、分阶段替换：调度、Cell 执行、ARI/RTP/录音、AI 流及 Cell 配置接收。最终没有 Python 运行依赖；不重写 Asterisk、不实现第二套管理后台。
 - 本项目已独立拆仓运营，源码、文档、依赖、配置、迁移、测试、部署、发布入口全部留在本目录。普通构建/测试/运行不读取父目录，不使用其它项目内部模块、环境文件或夹具，不共享其业务数据库。
 - 当前已初始化独立 Git 仓库并绑定公开远程 `git.ipao.vip/rogee/go-sip`；未经授权不要重新 `git init`、改为 submodule、移动历史或更改父仓库跟踪关系。
@@ -59,16 +59,16 @@ sip-go-agent agent upload-retry --spool /path/to/agent-spool \
 | 文档 | 内容 |
 | --- | --- |
 | [plan-0918：开发计划与需求阅读索引](docs/plan-0918.md) | 首读入口：W00–W16及并行子任务、I/M/G关口、R0–R10索引、认领/单写/隔离/合并规则；部署候选前置到W13-a |
-| [Go重写方案 v0.3](docs/Go重写方案_v0.3.md) | 本次单节点/单 Cell/单租户目标、至少3 SIP fixture、双AI模式、P0/P1/第二阶段分期 |
-| [通信与事件数据交互 v0.1](docs/通信与事件数据交互_v0.1.md) | 首发Unary、静态SIP与双模式、§6.1–6.3 SaaS配置来源/参数矩阵/安全边界 |
+| [Go重写方案 v0.3](docs/architecture/Go重写方案_v0.3.md) | 本次单节点/单 Cell/单租户目标、至少3 SIP fixture、双AI模式、P0/P1/第二阶段分期 |
+| [通信与事件数据交互 v0.1](docs/contracts/通信与事件数据交互_v0.1.md) | 首发Unary、静态SIP与双模式、§6.1–6.3 SaaS配置来源/参数矩阵/安全边界 |
 | [SaaS↔Dispatcher契约](docs/contracts/saas-dispatcher.md) | MQ-only目标、D唯一身份/独立Topic、待冻结消息及旧实现差异 |
 | [Dispatcher↔Agent契约](docs/contracts/dispatcher-agent.md) | 当前Unary/Proto事实及MQ上传结果的衔接待办 |
 | [SaaS/MQ/D/A/OSS泳道图](docs/contracts/saas-rabbitmq-oss-dispatcher-agent-timeline.md) | 全MQ目标时序，Agent直传OSS，无SaaS↔D HTTP |
-| [OpenAPI与MQ字段索引 v0.1](docs/OpenAPI与MQ字段索引_v0.1.md) | 旧源只读提取42个HTTP操作/115个组件及哈希；不代表新MQ-only入口，不手改生成物 |
+| [OpenAPI与MQ字段索引 v0.1](docs/references/OpenAPI与MQ字段索引_v0.1.md) | 旧源只读提取42个HTTP操作/115个组件及哈希；不代表新MQ-only入口，不手改生成物 |
 | [deploys：物理机 systemd 发布包](deploys/README.md) | 锁定 Debian 13/Go 1.27.1/发布版本，构建并上传不依赖 Docker 的 Agent/Dispatcher 安装包 |
-| [验证与切换验收 v0.3](docs/验证与切换验收_v0.3.md) | 10个首发汇总门禁、88项基线按阶段适用、P2公平性及独立容量验收 |
-| [开源组件选型与复用清单 v0.2](docs/开源组件选型与复用清单_v0.2.md) | §1.3首发基础库/AI SDK选择，§4.3参数能力及锁版/许可/PoC门禁 |
-| [G0开发准备与契约冻结方案 v0.1](docs/G0开发准备与契约冻结提案_v0.1.md) | 原D01–D10方向已确认；MQ-only新增GAP-10及受影响G0须重新验证，真实外部发布/生产联调另行安排 |
+| [验证与切换验收 v0.3](docs/acceptance/验证与切换验收_v0.3.md) | 10个首发汇总门禁、88项基线按阶段适用、P2公平性及独立容量验收 |
+| [开源组件选型与复用清单 v0.2](docs/dependencies/开源组件选型与复用清单_v0.2.md) | §1.3首发基础库/AI SDK选择，§4.3参数能力及锁版/许可/PoC门禁 |
+| [G0开发准备与契约冻结方案 v0.1](docs/architecture/G0开发准备与契约冻结提案_v0.1.md) | 原D01–D10方向已确认；MQ-only新增GAP-10及受影响G0须重新验证，真实外部发布/生产联调另行安排 |
 | [AGENTS.md](AGENTS.md) | 本独立子项目的开发与安全约束 |

 ## 独立项目原则
@@ -5,20 +5,20 @@
 ## 首读顺序

 1. [`plan-0918.md`](plan-0918.md)：W00–W16 任务台账、阅读索引、I/M/G 门禁和当前范围。
-2. [`Go重写方案_v0.3.md`](Go重写方案_v0.3.md)：单节点、单 Cell、单租户的总体方案与分期。
+2. [`architecture/Go重写方案_v0.3.md`](architecture/Go重写方案_v0.3.md)：单节点、单 Cell、单租户的总体方案与分期。
 3. [`contracts/`](contracts/)：SaaS、Dispatcher、Agent、RabbitMQ 和 OSS 的项目内契约。
-4. [`验证与切换验收_v0.3.md`](验证与切换验收_v0.3.md)：验收门禁、证据要求和第二阶段边界。
+4. [`acceptance/验证与切换验收_v0.3.md`](acceptance/验证与切换验收_v0.3.md)：验收门禁、证据要求和第二阶段边界。
 5. [`evidence/20260922-mq-only-local-final.md`](evidence/20260922-mq-only-local-final.md)：当前 MQ-only 本地/隔离范围的最新汇总证据。

 ## 按职责查找

 ### 方案与范围

- [`Go重写方案_v0.3.md`](Go重写方案_v0.3.md)：产品范围、运行边界和阶段目标。
- [`通信与事件数据交互_v0.1.md`](通信与事件数据交互_v0.1.md)：通信、事件、AI 配置和上传边界。
- [`G0开发准备与契约冻结提案_v0.1.md`](G0开发准备与契约冻结提案_v0.1.md)：D01–D10 方向及 G0 前置。
- [`开源组件选型与复用清单_v0.2.md`](开源组件选型与复用清单_v0.2.md)：组件、SDK、版本和 PoC 门禁。
- [`OpenAPI与MQ字段索引_v0.1.md`](OpenAPI与MQ字段索引_v0.1.md)：旧源只读索引，不是当前 MQ-only Schema。
+- [`architecture/Go重写方案_v0.3.md`](architecture/Go重写方案_v0.3.md)：产品范围、运行边界和阶段目标。
+- [`contracts/通信与事件数据交互_v0.1.md`](contracts/通信与事件数据交互_v0.1.md)：通信、事件、AI 配置和上传边界。
+- [`architecture/G0开发准备与契约冻结提案_v0.1.md`](architecture/G0开发准备与契约冻结提案_v0.1.md)：D01–D10 方向及 G0 前置。
+- [`dependencies/开源组件选型与复用清单_v0.2.md`](dependencies/开源组件选型与复用清单_v0.2.md)：组件、SDK、版本和 PoC 门禁。
+- [`references/OpenAPI与MQ字段索引_v0.1.md`](references/OpenAPI与MQ字段索引_v0.1.md)：旧源只读索引，不是当前 MQ-only Schema。

 ### 契约与决策

@@ -4,9 +4,9 @@

 ## 1. 使用边界

-本文件是 [Go 重写方案](Go重写方案_v0.3.md) 的执行清单，**不是验收通过报告**。项目内已具备 Go 可执行程序、W01/W02 契约与本地测试入口；下文仍将本地通过、协议 Mock、真实集成和生产签收严格分开。
+本文件是 [Go 重写方案](../architecture/Go重写方案_v0.3.md) 的执行清单，**不是验收通过报告**。项目内已具备 Go 可执行程序、W01/W02 契约与本地测试入口；下文仍将本地通过、协议 Mock、真实集成和生产签收严格分开。

-**本轮MQ-only修订重新打开受影响验收**：SaaS↔D所有请求/响应/事件只能走RabbitMQ，每个D全局唯一ID、独立接收Topic/队列。旧HTTP/仅租户路由/本地OSS验证证据不能覆盖新基线，见[计划§8.2](plan-0918.md)和[SaaS↔D契约](contracts/saas-dispatcher.md)。新增子场景纳入既有88项，不新增虚假通过数；本轮仅改文档，未执行这些运行测试。
+**本轮MQ-only修订重新打开受影响验收**：SaaS↔D所有请求/响应/事件只能走RabbitMQ，每个D全局唯一ID、独立接收Topic/队列。旧HTTP/仅租户路由/本地OSS验证证据不能覆盖新基线，见[计划§8.2](../plan-0918.md)和[SaaS↔D契约](../contracts/saas-dispatcher.md)。新增子场景纳入既有88项，不新增虚假通过数；本轮仅改文档，未执行这些运行测试。

 每个阶段分别报告：通过、失败、未执行、被外部条件阻塞，以及“本阶段不适用/延后”。延后不得计入通过率或当成实现。旧Python证据不计Go通过数；管理平台、SIP Mock、供应商和Go Agent分别签收。

@@ -248,7 +248,7 @@ P1运行不依赖旧Python Cell；迁移验证如需临时桥接而旧端不满

 本轮仅能检查第 1 类中的文档结构与一致性，不能把尚未生成的 Go 测试/服务列为“通过”。

-开发前的交付/解锁证据见 [G0开发准备与契约冻结方案](G0开发准备与契约冻结提案_v0.1.md) §2/§5/§8。D01–D10方案已获用户确认；项目内 W01 版本和 W02 Proto 已交付，但外部权威签收、D10正式PoC和真实供应商仍未完成；十项交付门禁不增加本方案88项运行验收数量。§5.5内部profile已确认为隔离PoC初始值，未实测、不是生产SLA，也不覆盖下节上游/供应商基线。P1必须实施当前租户及单 Cell 原子配额，P2/第二阶段再扩展多租户公平、跨 Cell 和并行竞争验收。
+开发前的交付/解锁证据见 [G0开发准备与契约冻结方案](../architecture/G0开发准备与契约冻结提案_v0.1.md) §2/§5/§8。D01–D10方案已获用户确认；项目内 W01 版本和 W02 Proto 已交付，但外部权威签收、D10正式PoC和真实供应商仍未完成；十项交付门禁不增加本方案88项运行验收数量。§5.5内部profile已确认为隔离PoC初始值，未实测、不是生产SLA，也不覆盖下节上游/供应商基线。P1必须实施当前租户及单 Cell 原子配额，P2/第二阶段再扩展多租户公平、跨 Cell 和并行竞争验收。

 E12/E19新增明确子场景（不新增用例编号）：证明OSS配置来自D配置文件，A经Unary向D领取固定15分钟临时TOKEN后直传，SaaS不下发OSS配置/TOKEN，D/gRPC无文件内容。配置缺失/无效明确失败，不向SaaS取配置、不使用A本地长期凭据；过期由A显式向D重申请，原上传/对象绑定不变。D失联时已有有效TOKEN可继续直传，过期保留文件，不自动续期或重试。直传成功但Dispatcher/MQ不可达时保留原事实和通知恢复状态；恢复后以原recording.uploaded身份可靠入队，不等待SaaS verified/OSS ID，不重新PUT。

@@ -292,7 +292,7 @@ E12/E19新增明确子场景（不新增用例编号）：证明OSS配置来自D

 ## 10. 开源复用与 SDK 门禁

-组件候选和源证据见 [开源组件选型与复用清单](开源组件选型与复用清单_v0.2.md)。以下 PoC 在项目内隔离协议 Mock/真实本地 Asterisk、DB、MQ 下执行；不是自动获准调用供应商。
+组件候选和源证据见 [开源组件选型与复用清单](../dependencies/开源组件选型与复用清单_v0.2.md)。以下 PoC 在项目内隔离协议 Mock/真实本地 Asterisk、DB、MQ 下执行；不是自动获准调用供应商。

 | ID | 场景 | 必须满足 |
 | --- | --- | --- |
@@ -328,7 +328,7 @@ P0冻结前逐行登记阶段、状态、责任人及风险。本轮MQ-only新

 ## 12. 最新架构验收 A01–A20

-源数据/RPC草案见 [通信与事件数据交互](通信与事件数据交互_v0.1.md)，源快照见 [字段索引](OpenAPI与MQ字段索引_v0.1.md)。本组与前述68项合计88项，按§1.2分阶段；缺首发Proto/契约则P1 blocked，未来在线发布接口未实现记后续，不用临时字段凑过。
+源数据/RPC草案见 [通信与事件数据交互](../contracts/通信与事件数据交互_v0.1.md)，源快照见 [字段索引](../references/OpenAPI与MQ字段索引_v0.1.md)。本组与前述68项合计88项，按§1.2分阶段；缺首发Proto/契约则P1 blocked，未来在线发布接口未实现记后续，不用临时字段凑过。

 | ID | 场景 | 可判定通过条件 |
 | --- | --- | --- |
@@ -2,7 +2,7 @@

 ## 1. 状态、权限与使用方式

-**状态：D01–D10原方向已确认，旧W01契约和W02 Proto已有项目内证据；本轮用户确认SaaS↔Dispatcher全MQ，受影响G0的项目内部分已按[计划§1.2/§8.2](plan-0918.md)重新验证。** SaaS与D之间所有请求、响应和事件禁止HTTP，每个D具备全局唯一ID和独立接收Topic/队列；V1 Schema、拓扑和关联已有本地包及RabbitMQ证据，外部发布/签收另计。OSS补充确认：配置存于D配置文件，A向D领取固定15分钟临时上传TOKEN后直传；SaaS不再提供OSS配置/TOKEN，上传完成以recording.uploaded可靠入队为界，不等待SaaS verified或OSS ID，D不转发文件。原HTTP方向被本修订替代，不把旧证据覆盖到新设计。
+**状态：D01–D10原方向已确认，旧W01契约和W02 Proto已有项目内证据；本轮用户确认SaaS↔Dispatcher全MQ，受影响G0的项目内部分已按[计划§1.2/§8.2](../plan-0918.md)重新验证。** SaaS与D之间所有请求、响应和事件禁止HTTP，每个D具备全局唯一ID和独立接收Topic/队列；V1 Schema、拓扑和关联已有本地包及RabbitMQ证据，外部发布/签收另计。OSS补充确认：配置存于D配置文件，A向D领取固定15分钟临时上传TOKEN后直传；SaaS不再提供OSS配置/TOKEN，上传完成以recording.uploaded可靠入队为界，不等待SaaS verified或OSS ID，D不转发文件。原HTTP方向被本修订替代，不把旧证据覆盖到新设计。

 本项目已创建并验证自己的 Go module、W01 bundle、W02 Proto/stubs、RPC/mTLS 和本地 Mock 测试；未修改父项目权威来源、字段索引或生成产物，未访问真实供应商或创建云资源。文件名保留“提案”以保持链接稳定，不代表还需重复审批已确认方向。

@@ -12,7 +12,7 @@
 - 内部机制、字段方向及兼容策略已确认，正式 Proto 的类型/编号/错误映射等仍需定稿与校验。本轮不生成 `.proto`，也不以临时 JSON 绕过契约；未提供的字段细节、实际预算和技术验证不能视为一并通过。
 - 角色简称：S＝SaaS/上游契约维护方，M＝管理平台维护方，D/A＝Dispatcher/Agent 实现方，O＝部署/安全/测试负责人。角色不代表已指定人员或已签收；实际姓名、版本、日期和证据须在批准记录补全。
 - 保留既有业务语义和8类业务事件，但原7条SaaS HTTP路径与AI GET全部废弃为接入方式；控制/查询/补传/配置授权/上传协调都改为专用MQ请求响应。D↔A仍Unary，A→OSS仍直传，不新增任务mode字段或内部MQ。
- 依据：[重写方案](Go重写方案_v0.3.md)、[通信设计](通信与事件数据交互_v0.1.md)、[验收方案](验证与切换验收_v0.3.md)、[只读字段索引](OpenAPI与MQ字段索引_v0.1.md)、[组件清单](开源组件选型与复用清单_v0.2.md)。索引不是独立契约包。
+- 依据：[重写方案](Go重写方案_v0.3.md)、[通信设计](../contracts/通信与事件数据交互_v0.1.md)、[验收方案](../acceptance/验证与切换验收_v0.3.md)、[只读字段索引](../references/OpenAPI与MQ字段索引_v0.1.md)、[组件清单](../dependencies/开源组件选型与复用清单_v0.2.md)。索引不是独立契约包。

 ## 2. 方案确认记录与开发边界

@@ -47,7 +47,7 @@ P2 增加多个同时活跃租户的等权轮询、额度不足跳过、公平

 ### 2.3 本轮MQ-only补充（已确认方向，消息细节待冻结）

-本轮补充纳入D03/D04/D07/D09/D10及通信设计GAP-10，不新增运行验收编号。完整约束见[SaaS↔D契约](contracts/saas-dispatcher.md)：每个D全局唯一ID、独立Topic/接收队列、请求/响应固定原D与租户、持久inbox/outbox、错目标/重复身份/重投/乱序/超时/重启恢复；新路由长度须重算，不能照搬旧224字节租户预算。ID生命周期、Topic/绑定、消息枚举/字段/关联、错误/期限未冻结前不实现猜测协议。
+本轮补充纳入D03/D04/D07/D09/D10及通信设计GAP-10，不新增运行验收编号。完整约束见[SaaS↔D契约](../contracts/saas-dispatcher.md)：每个D全局唯一ID、独立Topic/接收队列、请求/响应固定原D与租户、持久inbox/outbox、错目标/重复身份/重投/乱序/超时/重启恢复；新路由长度须重算，不能照搬旧224字节租户预算。ID生命周期、Topic/绑定、消息枚举/字段/关联、错误/期限未冻结前不实现猜测协议。

 P1仍为单节点/单Agent/单Cell/单租户/单活D，下文沿用的早期两Cell/两Agent全量矩阵仅为后续目录，不是本轮门禁。新增D1/D2本地消息fixture只验证定向隔离，不授权多D业务调度、HA或共享配额。旧OpenAPI/只读索引和历史证据原样保存；新MQ生产链不得保留SaaS↔D HTTP；D提供上传TOKEN的职责保留，项目完成边界为recording.uploaded可靠入队，不等待SaaS对象处理。

@@ -232,7 +232,7 @@ D/O须核验配置文件读取、服务地址/bucket/对象规则、受控凭据

 ## 8. D10：最小 PoC 顺序与证据

-复用[组件清单](开源组件选型与复用清单_v0.2.md)现有候选，不新增协议栈。本轮不声称已下载或验证任一精确版本。每个采用项记录 module/tag/commit、源码/依赖哈希、Go 1.27.1 构建、许可证/NOTICE、传递依赖/漏洞处置和适用协议版本。
+复用[组件清单](../dependencies/开源组件选型与复用清单_v0.2.md)现有候选，不新增协议栈。本轮不声称已下载或验证任一精确版本。每个采用项记录 module/tag/commit、源码/依赖哈希、Go 1.27.1 构建、许可证/NOTICE、传递依赖/漏洞处置和适用协议版本。

 | 顺序/已有验收域 | 本地最小检查与通过条件 | 失败处理 |
 | --- | --- | --- |
@@ -40,7 +40,7 @@ OSS数据面已明确为**Agent→OSS直连上传**：D读取自身配置文件
 | 可靠性基础 | 同执行不重复拨号、未知不重拨、控制屏障/持久恢复/录音交接安全；租户独立队列、复合幂等键和单 Cell 调度边界留在本轮 |
 | 契约与独立交付 | SaaS/MQ 交互按版本化契约、Schema、fixture 和本地状态机验收；可独立检出、构建、测试、打包，无父仓库/Python运行依赖 |

-验收按[验收方案§1.1–§1.2](验证与切换验收_v0.3.md)执行。P1通过只表示当前单节点/单 Cell/单租户本地范围通过；不代表真实 SaaS/MQ receipt、真实供应商/ECS、双节点、第二 Cell、双租户、1000路/N+1或生产切换通过。
+验收按[验收方案§1.1–§1.2](../acceptance/验证与切换验收_v0.3.md)执行。P1通过只表示当前单节点/单 Cell/单租户本地范围通过；不代表真实 SaaS/MQ receipt、真实供应商/ECS、双节点、第二 Cell、双租户、1000路/N+1或生产切换通过。

 ### 1.2 明确不做

@@ -111,7 +111,7 @@ Dispatcher配置包含MQ/SaaS受控引用、SQLite路径、两个Agent Endpoint

 ### 3.2 权威来源与独立拆仓

-**本轮用户已确认SaaS↔Dispatcher全MQ：双方不再有任何HTTP请求/回调；每个D有全局唯一ID和独立接收Topic/队列。** 执行、控制、查询、补传、AI配置/授权及上传完成事实均经MQ；上传不申请SaaS会话、不等待verified/OSS ID，详见[SaaS↔D契约](contracts/saas-dispatcher.md)与[计划§1.2/§8.2](plan-0918.md)。旧HTTP和旧租户路由已删除；新Schema/拓扑/身份生命周期/关联已在项目内唯一 V1 包和本地证据中冻结，旧源包及哈希不改。
+**本轮用户已确认SaaS↔Dispatcher全MQ：双方不再有任何HTTP请求/回调；每个D有全局唯一ID和独立接收Topic/队列。** 执行、控制、查询、补传、AI配置/授权及上传完成事实均经MQ；上传不申请SaaS会话、不等待verified/OSS ID，详见[SaaS↔D契约](../contracts/saas-dispatcher.md)与[计划§1.2/§8.2](../plan-0918.md)。旧HTTP和旧租户路由已删除；新Schema/拓扑/身份生命周期/关联已在项目内唯一 V1 包和本地证据中冻结，旧源包及哈希不改。

 现有上游权威是《SaaS交互_OpenAPI与MQ契约规划_v0.1.md》（正文 v1.0）及经核验的发布产物。现有产物包括 `mq.schema.json`、`executor.openapi.yaml`、`cell-agent.openapi.yaml`、AI 配置及 SIP 管理相关契约。文件存在不代表完整覆盖：P0 必须逐条核对正文、Schema、状态语义和实现差异。

@@ -121,7 +121,7 @@ Dispatcher配置包含MQ/SaaS受控引用、SQLite路径、两个Agent Endpoint
 - 新增调度器—Cell 的消息、fencing、回执或对账字段，先形成契约变更提案并获批；本方案不擅自定字段或 MQ 路由。
 - 本项目自己的设计、运行、验收文档只在此处维护；上游共享契约仍只有一个编辑源。
 - 本项目已独立初始化 Git，并按 `git.ipao.vip/rogee/go-sip` 维护；不创建 submodule 或改变父仓库跟踪关系。项目许可证和第三方 NOTICE 在对外发布前确认。
- [通信与事件数据交互](通信与事件数据交互_v0.1.md)覆盖执行命令、8类业务事件、全MQ请求响应目录及13个内部Unary职责草案；[字段索引](OpenAPI与MQ字段索引_v0.1.md)完整提取42个HTTP操作/115个命名组件。
+- [通信与事件数据交互](../contracts/通信与事件数据交互_v0.1.md)覆盖执行命令、8类业务事件、全MQ请求响应目录及13个内部Unary职责草案；[字段索引](../references/OpenAPI与MQ字段索引_v0.1.md)完整提取42个HTTP操作/115个命名组件。
 - 已逐字段/哈希确认MQ信封command_type/command_id、event_type/aggregate_*及task_revision与正文一致；但事件payload目前仅通用object，专属约束仍需上游补齐（GAP-01）。不能以旧测试或通用object校验冒充完整验收。文字事件准确名称为transcript.updated。
 - 42操作/115组件是上游目录，不是本项目首发工作量。P1保留既有业务语义/8种业务事件，但7条HTTP交互及AI GET改为获批MQ请求响应；消费实际所需AI配置和静态制品；不实现管理平台30个API或复制其业务后端。生成/校验仅覆盖使用入口及其引用闭包，来源包与只读字段索引保持完整。
 - 当前AI Schema强制要求llm/prompt/tts/asr/conversation，缺少明确的ASR-only表达。GAP-08须先在上游批准模式/缺省/文字与错误语义；不在MQ添加临时mode字段或绕过required校验。
@@ -148,7 +148,7 @@ P1 建模块时拟使用 `go 1.27.1` 并锁定 CI/构建镜像及 digest；`go`

 标准库/现有服务原生能力能覆盖的先用它们；其余使用经评估的现成开源库。自有代码只承担契约绑定、状态机、权限、配额、事务和必要的薄适配，不能以“薄适配”为名重写 SIP/ARI、RTP 编解包、G.711、WebSocket、AMQP、数据库驱动、OSS 签名、供应商 SDK 或 Schema 解析器。

-候选、许可证、上游证据与风险集中维护在 [开源组件清单](开源组件选型与复用清单_v0.2.md)。使用Cobra、官方grpc-go/protobuf、gopsutil、Asterisk/ARI、Pion、amqp091-go；modernc SQLite用于Dispatcher，pgx退出本项目选型，Agent不引数据库驱动业务能力。ASR/LLM/TTS按批准供应商选SDK。不将所有候选一并引入，不用sipgo/diago另起SIP栈。
+候选、许可证、上游证据与风险集中维护在 [开源组件清单](../dependencies/开源组件选型与复用清单_v0.2.md)。使用Cobra、官方grpc-go/protobuf、gopsutil、Asterisk/ARI、Pion、amqp091-go；modernc SQLite用于Dispatcher，pgx退出本项目选型，Agent不引数据库驱动业务能力。ASR/LLM/TTS按批准供应商选SDK。不将所有候选一并引入，不用sipgo/diago另起SIP栈。

 P0 必须以锁定 tag/commit 的 PoC 验证 Go 1.27.1、Asterisk 镜像、API/音频格式和现有契约，检查许可证全文、传递依赖、安全通告及 SDK 自动重试；失败则阻塞该组件，不默许改为手写协议。只有业务接口确有必要才抽象，不额外引入 Web 框架、ORM、Redis 锁或认证服务。

@@ -329,8 +329,8 @@ Dispatcher对Agent稳定事实去重后，按 command/call/transcript_segment/re
 ### 7.2.1 AI配置来源与调参边界（本次必需）

 - 配置流固定为：MQ任务引用agent_version_id → **D经MQ请求SaaS不可变配置/授权，原D专用Topic收响应** → 校验租户/关联/源Schema/摘要/能力并持久绑定 → R07执行快照/获批缓存引用 → Agent会话局部SDK请求与控制器。旧AI GET已废弃；Agent不查询SaaS，不从CLI/env另填参数。
- 初选组件为百炼devinyf/dashscopego、火山ASR/TTS共用GizClaw/doubao-speech-go、LLM官方openai-go；均需实际协议与参数PoC，尤其火山TTS不能忽略语速/音量等字段。基础库及未完成的锁版门禁见 [组件清单§1.3/§4.3](开源组件选型与复用清单_v0.2.md)。
- 模型、提示词/变量、语言/中间稿、音色/语速、音频格式、temperature/Token上限、超时、开场白、打断、静音/轮数/时长、分句/缓存等已有参数必须从SaaS贯穿到执行；热词/VAD/top_p/音量/阶段超时等实际所需扩展先由上游补GAP-09。精确字段及缺省/单位/能力规则仅在源契约维护，需求索引见 [交互§6.1–§6.3](通信与事件数据交互_v0.1.md)。
+- 初选组件为百炼devinyf/dashscopego、火山ASR/TTS共用GizClaw/doubao-speech-go、LLM官方openai-go；均需实际协议与参数PoC，尤其火山TTS不能忽略语速/音量等字段。基础库及未完成的锁版门禁见 [组件清单§1.3/§4.3](../dependencies/开源组件选型与复用清单_v0.2.md)。
+- 模型、提示词/变量、语言/中间稿、音色/语速、音频格式、temperature/Token上限、超时、开场白、打断、静音/轮数/时长、分句/缓存等已有参数必须从SaaS贯穿到执行；热词/VAD/top_p/音量/阶段超时等实际所需扩展先由上游补GAP-09。精确字段及缺省/单位/能力规则仅在源契约维护，需求索引见 [交互§6.1–§6.3](../contracts/通信与事件数据交互_v0.1.md)。
 - 在已支持并获授权的能力范围内，SaaS发布新不可变版本，新任务显式引用即可调参，无需改代码/重建/重启；在途与原排队任务固定原快照，未知执行不因版本变化重拨。SIP静态发布不限制这条AI配置读取链路，也不需要建设R04通用热更新平台。
 - 无有效授权缓存、版本冲突、未支持参数、模式/SDK能力不匹配均在准入前明确失败；不改用SDK默认值或伪造配置。显式0/false/未提供必须区分，并发两Agent不能共享可变参数。凭据/端点来自受控引用，业务参数不能突破安全硬限额或启用不安全SDK重试。
 - 本轮确认配置来源/需求，不代表SaaS已有全部参数或SDK已暴露全部控制。GAP-08/09批准前不手改只读字段索引、不添加MQ临时字段/metadata后门；首发参数必须以SDK请求/本地控制器实测证明有效。
@@ -407,7 +407,7 @@ P1a–P1d为同一首发的有序工作包，不是各自可替代完整首发
 5. 排空旧端、处理 broker 未 ACK、保存控制版本/幂等 ID/待执行/未知执行/outbox/录音进度，再切换所有权。数据库迁移显式、可审计，不长期双写同一业务库。
 6. Go 接手新执行后，不能让 Python 忘记这些执行直接恢复消费。回滚先停止新准入、排空并对账；状态无法兼容回迁就暂停并前向修复，不能靠退镜像冒险重拨。

-详细演练、量化profile及新增架构门禁见 [验证与切换验收](验证与切换验收_v0.3.md)。
+详细演练、量化profile及新增架构门禁见 [验证与切换验收](../acceptance/验证与切换验收_v0.3.md)。

 ## 12. G0 待冻结清单

@@ -4,9 +4,9 @@

 本文件保留现有外部命令/事件与内部职责目录，并明确本轮适用范围：**P1为1 Agent/1 Asterisk/单 Cell、至少3家SIP trunk 的契约与协议 fixture、单租户、静态配置、ASR-only与完整AI双模式；真实 SaaS/MQ 联调、双节点、第二 Cell、第二租户和生产切换延期第二阶段。** 全量目录不等于本轮全部实现；当前只交付设计，运行通过记录另见验收证据。

- **本轮用户已确认SaaS↔Dispatcher全部交互只经RabbitMQ专用Topic，禁止双方HTTP。每个D有全局唯一ID及独立接收Topic/队列，不能共享队列抢收指定D的消息。** 精确身份/拓扑/消息/关联待新版合同冻结，见[MQ-only契约](contracts/saas-dispatcher.md)与[计划§1.2/§8.2](plan-0918.md)。P1仍单活D；D1/D2仅用于本地路由隔离fixture，不开发多D协调。
+- **本轮用户已确认SaaS↔Dispatcher全部交互只经RabbitMQ专用Topic，禁止双方HTTP。每个D有全局唯一ID及独立接收Topic/队列，不能共享队列抢收指定D的消息。** 精确身份/拓扑/消息/关联待新版合同冻结，见[MQ-only契约](saas-dispatcher.md)与[计划§1.2/§8.2](../plan-0918.md)。P1仍单活D；D1/D2仅用于本地路由隔离fixture，不开发多D协调。
 - 旧外部业务字段以《SaaS交互_OpenAPI与MQ契约规划_v0.1.md》正文v1.0及固定包记录为语义来源；其中HTTP传输和旧租户路由已被MQ-only修订替代。旧OpenAPI/哈希只作对照，不手改源包或只读索引，不把中文MQ语义当已发布字段。
- [OpenAPI与MQ字段索引](OpenAPI与MQ字段索引_v0.1.md) 是5份OpenAPI、42个HTTP操作、115个命名组件及2份JSON Schema的只读机器提取快照，记录源哈希，不是第二套手写Schema。
+- [OpenAPI与MQ字段索引](../references/OpenAPI与MQ字段索引_v0.1.md) 是5份OpenAPI、42个HTTP操作、115个命名组件及2份JSON Schema的只读机器提取快照，记录源哈希，不是第二套手写Schema。
 - 下文 **“现有契约”** 不允许自行改字段/语义；**“内部草案”** 是待批准的gRPC方法/数据模型，不冒充已有OpenAPI；**“缺口”** 明确阻塞相应实现/验收。
 - 用户已确认保留Unary RPC、Dispatcher维护Agent Endpoint列表、Agent共用一套mTLS证书。OSS配置存于Dispatcher配置文件，Agent向D领取临时上传TOKEN后直传OSS；SaaS不下发OSS配置/TOKEN；本项目只保证recording.uploaded可靠入队，不等待SaaS会话、verified或OSS ID。文本继续实时MQ回传，OSS只作归档。
 - 准确的文字事件名是 **`transcript.updated`**；`call.transcript` 是之前讨论中的泛称，不是合法event_type，不新增该别名。
@@ -129,7 +129,7 @@ P1从管理批准的静态route_policy/caller_profile选择供应商trunk与获

 ## 6. SaaS↔Dispatcher 全MQ交互目录

-旧7条业务HTTP路径及AI GET均不再作为目标接入。其业务语义由新版MQ合同承接；旧[字段索引](OpenAPI与MQ字段索引_v0.1.md)只作只读对照，不手改生成物。下表中文名称不是已获批消息枚举，详见[SaaS↔D契约§5–§6](contracts/saas-dispatcher.md)。
+旧7条业务HTTP路径及AI GET均不再作为目标接入。其业务语义由新版MQ合同承接；旧[字段索引](../references/OpenAPI与MQ字段索引_v0.1.md)只作只读对照，不手改生成物。下表中文名称不是已获批消息枚举，详见[SaaS↔D契约§5–§6](saas-dispatcher.md)。

 | 业务语义 | MQ请求/响应方向 | 保留的约束 |
 | --- | --- | --- |
@@ -188,7 +188,7 @@ OSS配置/TOKEN来源不属于上述SaaS MQ目录：OSS配置存于D配置文件

 ## 7. 内部gRPC公共规则（草案）

-以下为早期内部方法职责草案，不是当前Proto字段权威；W02已交付的Proto/handler事实见[Dispatcher↔Agent契约](contracts/dispatcher-agent.md)。本轮MQ异步协调仍需核验，不因已有Unary就宣称端到端完成，也不据本文新增SaaS接口。
+以下为早期内部方法职责草案，不是当前Proto字段权威；W02已交付的Proto/handler事实见[Dispatcher↔Agent契约](dispatcher-agent.md)。本轮MQ异步协调仍需核验，不因已有Unary就宣称端到端完成，也不据本文新增SaaS接口。

 - 采用官方grpc-go与protobuf，全部Unary；两个角色都可作为受控gRPC客户端/服务端，共用HTTP/2连接池。
 - 方向认证：Agent只接受受信Dispatcher角色的管理调用；Dispatcher只接受Agent群组证书和有效节点会话。共享证书只证明群组，不证明agent_id。
@@ -322,7 +322,7 @@ P1数据流：管理平台审批不可变制品 → 核验来源/版本/哈希

 ## 13. 缺口与冻结责任

-[G0开发准备与契约冻结方案](G0开发准备与契约冻结提案_v0.1.md) D01–D10方向及模式/许可/恢复机制已获用户确认；下表仍跟踪尚未交付的源字段/合同和验证，不再表示已确认方向待用户审批。该文档不是第二套Schema，权威源发布并验证后才关闭相应GAP。
+[G0开发准备与契约冻结方案](../architecture/G0开发准备与契约冻结提案_v0.1.md) D01–D10方向及模式/许可/恢复机制已获用户确认；下表仍跟踪尚未交付的源字段/合同和验证，不再表示已确认方向待用户审批。该文档不是第二套Schema，权威源发布并验证后才关闭相应GAP。

 D07补充确认：**OSS配置存于D配置文件，Agent经R12向D领取固定15分钟临时上传TOKEN后直传OSS**；SaaS不下发OSS配置/TOKEN，D保留SDK签发能力，不转发文件。Agent成功PUT后经R13报告原上传事实，D持久保存recording.uploaded outbox并以可靠入队完成本项目交付；不申请SaaS会话、不等待complete/verified/OSS ID，不自动续期，Agent不持长期凭据。

@@ -340,4 +340,4 @@ D07补充确认：**OSS配置存于D配置文件，Agent经R12向D领取固定15

 **GAP-10（本轮新增，已确认方向、未冻结机读合同）**：全MQ请求响应、D全局唯一身份及生命周期、独立Topic/队列/绑定、租户/目标/来源/原请求关联、完整路由预算/通配符边界、错误/期限/重复/迟到/重启恢复，以及R12/R13有界异步衔接。由W01/W02发布新版Schema/拓扑/正反例并核验后解除；不得修改旧不可变包或把图中的中文名称当新枚举。GAP-10是当前P1门禁，不新增88项编号，细则纳入既有C/S/E/L子场景。

-具体验收见 [验证与切换验收](验证与切换验收_v0.3.md) §1.1–§1.2。GAP-01/05/07/08/09及GAP-02/03/04/06的P1部分均为首发门禁；延后部分只在相应功能启用前冻结，不能记为通过。“文档齐全”不等于契约已获批。
+具体验收见 [验证与切换验收](../acceptance/验证与切换验收_v0.3.md) §1.1–§1.2。GAP-01/05/07/08/09及GAP-02/03/04/06的P1部分均为首发门禁；延后部分只在相应功能启用前冻结，不能记为通过。“文档齐全”不等于契约已获批。
@@ -49,7 +49,7 @@

 ## 2. 推荐与候选矩阵

-“优先”是PoC顺序，不是生产准入；实际采用组件须通过 [验收方案L01–L08及相应A项](验证与切换验收_v0.3.md)，适用阶段以该文§1.2为准。
+“优先”是PoC顺序，不是生产准入；实际采用组件须通过 [验收方案L01–L08及相应A项](../acceptance/验证与切换验收_v0.3.md)，适用阶段以该文§1.2为准。

 | 能力 | 优先复用的项目/原生能力 | 本轮许可/维护观察 | 决策与边界 |
 | --- | --- | --- | --- |
@@ -95,7 +95,7 @@ P0 的最小证明：锁定可用模块/commit → 本地固定 Asterisk + Mock

 ## 4. AI 接入：供应商范围已定，协议与参数须PoC

-用户确认百炼/火山ASR、OpenAI兼容LLM、火山TTS。模型ID、voice/resource、API版本与参数**不是源码常量**，由SaaS不可变任务配置经D下发；端点/凭据仅来自可信引用。ASR两个适配首发均需验证，但单执行只选其中一个，不因超时自动切换。完整参数链路和上游缺口以 [交互§6.1–§6.3](通信与事件数据交互_v0.1.md) 为唯一设计说明，本表不复制Schema。
+用户确认百炼/火山ASR、OpenAI兼容LLM、火山TTS。模型ID、voice/resource、API版本与参数**不是源码常量**，由SaaS不可变任务配置经D下发；端点/凭据仅来自可信引用。ASR两个适配首发均需验证，但单执行只选其中一个，不因超时自动切换。完整参数链路和上游缺口以 [交互§6.1–§6.3](../contracts/通信与事件数据交互_v0.1.md) 为唯一设计说明，本表不复制Schema。

 ### 4.1 已有 ASR 行为基线

@@ -23,7 +23,7 @@

 1. 当前适用的用户确认和 [项目约束](../AGENTS.md)。已确认方向不重复索要审批；缺失字段、预算及偏离方案的变更不能自行补成“已批准”。
 2. 外部字段/路径/状态在外部权威闭包可用时来自上游版本化契约包；早期项目内 W01 基线不再属于当前工作树，当前代码只使用项目内唯一的 `contracts/upstream/v1` 契约包；未发生契约迁移前不新增或合并契约。内部接口来自项目内 `agent.v1` Proto；不能将未进入当前契约包的说明文字当作 Schema。
-3. [G0确认方案](G0开发准备与契约冻结提案_v0.1.md)记录最新确认和待交付门禁；总体、通信、组件和验收文档补充实施细则。
+3. [G0确认方案](architecture/G0开发准备与契约冻结提案_v0.1.md)记录最新确认和待交付门禁；总体、通信、组件和验收文档补充实施细则。
 4. 本计划只编排任务和阅读入口。若发现来源冲突，列明两个出处并暂停受影响部分；不得用计划、旧实现或 SDK 默认值覆盖权威合同。

 ### 1.2 本轮 MQ-only 架构纠正（用户已确认）
@@ -67,12 +67,12 @@
 | 索引 | 文档 | 先读内容及使用方式 |
 | --- | --- | --- |
 | R0 | [AGENTS.md](../AGENTS.md) | 全文：独立项目、P1/P2、复用、安全和执行权限；每次开工先读 |
-| R1 | [Go重写方案 v0.3](Go重写方案_v0.3.md) | 总体职责、数据/执行流程、工程结构、分期与切换；W00 通读，具体任务重读涉及章节 |
-| R2 | [通信与事件数据交互 v0.1](通信与事件数据交互_v0.1.md) | 7条业务交互、8种事件、R01–R13 Unary、幂等/事实/控制、文件/OSS、GAP清单；做协议边界必读 |
-| R3 | [G0开发准备与契约冻结方案 v0.1](G0开发准备与契约冻结提案_v0.1.md) | §1–2状态/解锁；§3事件；§4 AI；§5许可/会话/恢复；§6静态/OSS/profile；§7契约包；§8 PoC；§9确认结果。文件名保留“提案”，方向已经确认 |
-| R4 | [验证与切换验收 v0.3](验证与切换验收_v0.3.md) | §1.2首发适用范围、§5.1 AI参数子场景、§9/§9.1基线及对应详细用例；当前88项是跨阶段清单，不是88项已通过 |
-| R5 | [开源组件选型与复用清单 v0.2](开源组件选型与复用清单_v0.2.md) | §1.3首发基础栈/SDK、§4.3参数能力；全文复用禁区、许可证/锁版/PoC门禁；采用依赖前必读 |
-| R6 | [OpenAPI与MQ字段索引 v0.1](OpenAPI与MQ字段索引_v0.1.md) | 来源指纹、实际操作/组件、严格Schema约束；只读生成索引，不能手改；42操作/115组件不等于本项目全量实现任务 |
+| R1 | [Go重写方案 v0.3](architecture/Go重写方案_v0.3.md) | 总体职责、数据/执行流程、工程结构、分期与切换；W00 通读，具体任务重读涉及章节 |
+| R2 | [通信与事件数据交互 v0.1](contracts/通信与事件数据交互_v0.1.md) | 7条业务交互、8种事件、R01–R13 Unary、幂等/事实/控制、文件/OSS、GAP清单；做协议边界必读 |
+| R3 | [G0开发准备与契约冻结方案 v0.1](architecture/G0开发准备与契约冻结提案_v0.1.md) | §1–2状态/解锁；§3事件；§4 AI；§5许可/会话/恢复；§6静态/OSS/profile；§7契约包；§8 PoC；§9确认结果。文件名保留“提案”，方向已经确认 |
+| R4 | [验证与切换验收 v0.3](acceptance/验证与切换验收_v0.3.md) | §1.2首发适用范围、§5.1 AI参数子场景、§9/§9.1基线及对应详细用例；当前88项是跨阶段清单，不是88项已通过 |
+| R5 | [开源组件选型与复用清单 v0.2](dependencies/开源组件选型与复用清单_v0.2.md) | §1.3首发基础栈/SDK、§4.3参数能力；全文复用禁区、许可证/锁版/PoC门禁；采用依赖前必读 |
+| R6 | [OpenAPI与MQ字段索引 v0.1](references/OpenAPI与MQ字段索引_v0.1.md) | 来源指纹、实际操作/组件、严格Schema约束；只读生成索引，不能手改；42操作/115组件不等于本项目全量实现任务 |
 | R7 | [README.md](../README.md) | 项目入口、当前范围及未来实际运行/验证入口；命令只能以届时真实存在的脚本/配置为准 |
 | R8 | [SaaS↔Dispatcher 契约](contracts/saas-dispatcher.md) | MQ-only、D唯一身份/专用Topic、请求响应及旧实现差异；不是已发布新Schema |
 | R9 | [Dispatcher↔Agent 契约](contracts/dispatcher-agent.md) | 当前Proto/handler事实；R12/R13与MQ异步协调的待改项；不能把本地上传或 MQ 入队等同 SaaS 已消费、处理 |
@@ -1,7 +1,7 @@
 # OpenAPI 与 MQ 字段索引 v0.1

 > 本文件为本轮从现有上游文件一次性生成的只读索引，不是第二份可手工维护的 Schema。原始引用和约束原样保留；它描述“文件现在是什么”，不代表已经与正文权威契约一致。
-> 已逐字段和哈希确认：当前MQ的command_type/command_id与event_type/aggregate_*信封已对齐正文。仍待补齐8种事件的payload专属Schema/条件规则；详见《通信与事件数据交互_v0.1.md》。源文件更新须重新导入生成，不得只改索引。该索引保留上游OpenAPI历史字段（包括旧上传会话/verified/oss_id），不代表当前MQ-only运行时；当前上传以recording.uploaded冻结方案为准。
+> 已逐字段和哈希确认：当前MQ的command_type/command_id与event_type/aggregate_*信封已对齐正文。仍待补齐8种事件的payload专属Schema/条件规则；详见 [《通信与事件数据交互 v0.1》](../contracts/通信与事件数据交互_v0.1.md)。源文件更新须重新导入生成，不得只改索引。该索引保留上游OpenAPI历史字段（包括旧上传会话/verified/oss_id），不代表当前MQ-only运行时；当前上传以recording.uploaded冻结方案为准。

 普通构建/运行不读取父目录；P0须建立版本化契约包和可重复生成入口。本轮没有添加Python运行依赖或Go源码。

@@ -1652,4 +1652,4 @@
 - 本次索引覆盖42个HTTP操作及上述组件原始约束；没有新增、修复或覆盖父项目契约文件。
 - 文本归档授权、SaaS全局OSS配置同步、管理平台到Dispatcher发布适配及内部gRPC均不能假称已由这些OpenAPI定义；详见交互文档的GAP清单。
 - 对齐后更新源版本/哈希及索引，校验所有引用和黄金请求/事件；任何残留漂移阻塞类型生成和P0冻结。
- 以下文档才给出跨角色交互与事件语义：[通信与事件数据交互](通信与事件数据交互_v0.1.md)。
+- 以下文档才给出跨角色交互与事件语义：[通信与事件数据交互](../contracts/通信与事件数据交互_v0.1.md)。
@@ -1,8 +1,8 @@
 # W02 Unary gRPC contract

 This directory is the project-owned W02 protocol baseline, created from the
-confirmed R01–R03/R05/R07–R13 responsibilities in `docs/通信与事件数据交互_v0.1.md`
-and the crash/authorization rules in `docs/G0开发准备与契约冻结提案_v0.1.md`.
+confirmed R01–R03/R05/R07–R13 responsibilities in `docs/contracts/通信与事件数据交互_v0.1.md`
+and the crash/authorization rules in `docs/architecture/G0开发准备与契约冻结提案_v0.1.md`.

 - Transport is Unary gRPC over mTLS; no internal MQ, bidirectional audio stream,
 or HTTP call-execution callback is introduced.