54 KiB
54 KiB
SIP Go Agent 项目开发计划与需求阅读索引（plan-0918）
1. 用途、状态与优先级
本文件是后续 Agent 的开发任务入口：先确认需求及来源，再按依赖开发，最后用证据更新状态。 0918 是文件标识，不代表工期或上线日期承诺。本文件不替代权威契约、详细设计或验收用例，不重复维护 Schema。
当前基线：总体架构、P1/P2 边界、D01–D10 方案方向及内部隔离 PoC 初始参数已获用户确认；项目已按用户本次授权自行建立并嵌入 W01 项目内契约基线和 W02 Unary Proto/stubs。旧基线的项目内 G0/W04、单节点/单 Cell/单租户本地验收曾按范围签收；本轮 MQ-only 修订重新打开受影响的契约、实现和验收项，见 §1.2、§8.2。真实供应商/云/拨号/生产 receipt/容量及切换仍属于第二阶段；旧本地通过不等于新设计通过、外部权威发布或生产放行。
已确认的 OSS 分工：OSS 配置存于 Dispatcher 配置文件；Agent 向 Dispatcher 领取临时上传 TOKEN 后直传 OSS，不保存长期凭据；Dispatcher 不接收/缓存/转发文件。TOKEN 过期由 Agent 显式向 D 重新申请，不向 SaaS 取配置/TOKEN。SaaS 业务上传会话及 complete/verified 仍经 MQ，上传完成后的校验归属不变，取得 SaaS verified 后才回传 recording.ready/OSS ID。
1.1 2026-09-20 本轮范围修订
用户已明确将本轮收敛为项目自行制定第一版契约并完成单节点/单 Cell/单租户本地闭环；双节点、第二 Cell、双租户及真实 SaaS/MQ 联调延期第二阶段：
- D01/D02/D03/D06 第一版项目契约由本项目制定、版本化、生成并自校验；不再等待外部第一版发布才能开始实现，但必须明确标记为 project-owned v1，不能冒充 SaaS 已发布合同。
- Static Cell 制品由本项目按 v1 Schema 自动生成、批准并在单 Cell 隔离环境验证；本轮采用单节点、单活 Dispatcher、单 Agent/Cell/Asterisk 路径，双节点和第二 Cell 延后，不作为本轮开发或验收门禁。
~/.zshenv中已提供并由用户直接授权使用的VOLC_*、BAILIAN_*运行凭据可直接注入，不再因凭据本身重复确认；密钥仍不得写入代码、文档、日志、证据或聊天。- 本轮必须完成单节点/单 Cell 的 PCMA/RTP、录音、ASR、LLM、TTS、播放回流和业务事实本地/隔离验收；真实外呼/ECS 联调属于第二阶段，不作为本轮前置。
- 本轮不执行生产切换、真实外呼或 ECS 创建；本地恢复/回滚和安全检查按隔离环境验证。未来真实外呼仍须在当前会话展示通道、原始号码和抓包方案并取得该次确认；每条 SIP trunk 对每个原始手机号每天最多 3 次，线路失败可在额度内经当前会话确认后改测另一条线路；不自动重试、超额或静默换线。
- Mock/mixed/real 不再拥有三套业务流程：
internal/callflow统一执行开场、媒体收集、ASR、LLM、TTS、播放和事实统计，ai.Pipeline/媒体适配器仅按 mode 注入；CLI 使用通用--call-once与AGENT_CALL_*配置，不再使用REAL专用入口。真实 real 环境属于第二阶段，不能作为本地通过的隐式前置。
需求依据顺序：
- 当前适用的用户确认和 项目约束。已确认方向不重复索要审批；缺失字段、预算及偏离方案的变更不能自行补成“已批准”。
- 外部字段/路径/状态在外部权威闭包可用时来自上游版本化契约包；当前运行使用项目内只读
contracts/upstream/2026-09-18-p1-baseline开发基线，并明确标注其非外部权威来源。内部接口来自项目内agent.v1Proto；不能将未进入上述包的说明文字当作 Schema。 - G0确认方案记录最新确认和待交付门禁；总体、通信、组件和验收文档补充实施细则。
- 本计划只编排任务和阅读入口。若发现来源冲突，列明两个出处并暂停受影响部分；不得用计划、旧实现或 SDK 默认值覆盖权威合同。
1.2 本轮 MQ-only 架构纠正（用户已确认）
- SaaS↔Dispatcher 的所有交互只走 RabbitMQ：执行、控制、查询、整体补传、AI 配置/授权、上传会话、complete/verified 及其响应都通过专用 Topic 订阅；禁止双方任何 HTTP 请求、回调、兼容入口或故障回退。
- 每个 Dispatcher 有全局唯一、不重复的 ID 和独立接收 Topic/队列。消息必须定向到指定 D，响应回原 D，来源可追溯；不能多个 D 共用一条队列竞争消费或广播后过滤。Dispatcher 身份不等于 tenant/Agent/Cell ID 或
dispatcher_epoch，租户独立队列与原值tenant_key仍保留。 - 精确 ID 生成/持久化/重复身份处理、Topic/队列/绑定命名、信封关联/错误/超时以及新 routing key 的完整字节预算须由 W01 冻结；方向已经确认，但不能自行往严格旧 Schema 加字段。P1仍是单活 D，D1/D2 路由隔离只作本地契约/消息 fixture，不新增多 D 调度、HA、共享额度或生产资源。
- D↔A 仍为 Unary，A→OSS 仍直传。MQ-only 不禁止 OSS/ARI/供应商 HTTP(S) 或 gRPC HTTP/2。OSS 配置由 D 配置文件提供，临时 TOKEN 由 D 向 A 提供，不再由 SaaS 下发；保留 D 签发能力，SaaS 最终 verified 校验职责不变。R12/R13 如何衔接业务会话/complete 的异步 MQ 结果，由 W02/W11 核验 pending、原操作恢复与有界等待，不伪造当前 Proto 已支持。
- 旧 AI GET、控制/查询/补传 HTTP 和上传 HTTP 方案被本修订替代；
contracts/upstream/2026-09-19-p1-v1/、旧版本、生成索引及历史证据保留原样，不能当作 MQ-only 新合同或重写哈希。相关新版本和正反例发布前，受影响 I 不就绪；禁止先实现猜测消息再补合同。 - 当前只授权纠正计划/契约及相关设计文档，不修改 Schema/Proto/代码，不访问真实 SaaS、broker、云或拨号。文档完成不关闭 §8.2 的开发/验收待办。
目标语义见 R8，当前内部实现事实与差异见 R9，完整 MQ 目标时序见 R10。R1–R6 或历史证据中与本修订冲突的旧传输、路由及通过结论，不得继续作为新接入依据；只读来源包的变更必须走新版本发布。
2. 后续 Agent 的开工与收尾流程
2.1 每次任务的必做顺序
- 读取
AGENTS.md、本计划 §1–§4 和 §8 当前状态；检查实际文件、Git 工作区及既有改动，不覆盖别人的工作。项目已有独立 Git；先同步远程，不重新 init/submodule/移动历史。 - 将本次请求映射到 §5 的 W 编号和 §4 的需求行；按 §3 找到对应详细章节，读取正文后再决定修改点。索引、记忆或先前摘要不能替代本次涉及的合同/代码正文。
- 核验前置证据及当前合同/工具版本：区分“方向已确认”“源已发布”“实现完成”“测试通过”。前置缺失就标 blocked，不猜 Schema、不用临时协议偷跑。
- 给出本次范围、完成条件和明确不做项，再在当前授权范围内执行。用户明确要求开始本地开发后不重复询问已确认设计；修改上游唯一来源、真实业务网络/付费/拨号/切换等依旧按权限边界处理。
- 优先复用标准库、成熟开源库/官方 SDK；先查已有实现再改，禁止自写替代协议栈。仅围绕本次任务增加必要代码和检查，不预建后续功能空壳。
- 执行相应检查并保存脱敏证据，更新§8及阻塞/下一步。回报代码、模拟、真实验证分别完成了什么；失败和未执行不得记为通过。
2.2 开工确认格式
任务：Wxx（本次子范围）
需求依据：文档相对路径＋章节；契约/制品版本及哈希（适用时）
已确认要求：本次实际遵循的条目，不重新审批既定架构
前置证据：满足哪些；缺什么、由谁补齐
修改范围：本项目具体路径；是否涉及上游/真实资源
完成条件：接口I/模块M/合并集成G分别需要的可执行检查及期望事实
不做：明确排除的后续功能或未授权操作
只做文档任务时不伪造代码测试命令；进入代码任务后，先读相关代码/调用链再改。发现代码已存在时先核验再更新本计划基线，不能永久照搬“当前无实现”。
3. 参考文档索引与按需阅读
| 索引 | 文档 | 先读内容及使用方式 |
|---|---|---|
| R0 | AGENTS.md | 全文：独立项目、P1/P2、复用、安全和执行权限；每次开工先读 |
| R1 | Go重写方案 v0.3 | 总体职责、数据/执行流程、工程结构、分期与切换；W00 通读，具体任务重读涉及章节 |
| R2 | 通信与事件数据交互 v0.1 | 7条业务交互、8种事件、R01–R13 Unary、幂等/事实/控制、文件/OSS、GAP清单；做协议边界必读 |
| R3 | G0开发准备与契约冻结方案 v0.1 | §1–2状态/解锁；§3事件；§4 AI；§5许可/会话/恢复；§6静态/OSS/profile；§7契约包；§8 PoC；§9确认结果。文件名保留“提案”，方向已经确认 |
| R4 | 验证与切换验收 v0.3 | §1.2首发适用范围、§5.1 AI参数子场景、§9/§9.1基线及对应详细用例；当前88项是跨阶段清单，不是88项已通过 |
| R5 | 开源组件选型与复用清单 v0.2 | §1.3首发基础栈/SDK、§4.3参数能力；全文复用禁区、许可证/锁版/PoC门禁；采用依赖前必读 |
| R6 | OpenAPI与MQ字段索引 v0.1 | 来源指纹、实际操作/组件、严格Schema约束；只读生成索引，不能手改；42操作/115组件不等于本项目全量实现任务 |
| R7 | README.md | 项目入口、当前范围及未来实际运行/验证入口；命令只能以届时真实存在的脚本/配置为准 |
| R8 | SaaS↔Dispatcher 契约 | MQ-only、D唯一身份/专用Topic、请求响应及旧实现差异；不是已发布新Schema |
| R9 | Dispatcher↔Agent 契约 | 当前Proto/handler事实；R12/R13与MQ异步协调的待改项；不能把本地OSS验证等同SaaS verified |
| R10 | SaaS/MQ/D/A/OSS时间泳道图 | 目标全MQ时序、独立D订阅和新旧差异；所有中文新消息名仅为语义标签 |
3.1 按任务定位必读章节
| 当前要做什么 | 最小详细阅读范围 | 要取得的关键依据 |
|---|---|---|
| 改外部MQ消息/拓扑或升级源包 | 本计划§1.2；R8全文/R10；R3 §3/§4/§6.2/§7；R2及R6实际源 | D身份/专用Topic、租户/请求关联、错误/期限、版本/哈希及正反例；旧HTTP只作语义对照，不继续实现 |
| 配置两种AI模式、缓存或传参 | R3 §4；R1 AI章节；R5 §1.3/§4.3；R4 §5.1 | mode兼容、原摘要、有效授权、参数到SDK映射、0/false、取消/自动重试 |
| 写SQLite、inbox/outbox或MQ接入 | R1持久化/调度章节；R2可靠性/事件；R3 §3/§5/§6.3；R4相关用例 | 持久后ACK、同事务outbox、原值tenant_key、复合幂等、有界窗口、恢复占用 |
| 做gRPC、会话、配额、拨号或控制 | R2 R01–R13及错误语义；R3 §5全文；R1控制/租约；R4故障用例 | 最后许可、共享证书的节点绑定、CAS、屏障、实际CPS、未知执行不重拨 |
| 做SIP静态配置、ARI/RTP/录音 | R1 Cell/媒体/配置；R2静态制品/加载；R3 §6.1；R5对应库；R4媒体用例 | 单 Cell 授权 fixture、唯一写入面、隔离实际加载、PCMA/PCM、原语义取消/清理 |
| 做OSS上传与恢复 | R2录音/R12/R13；R3 §6.2/§6.3；R4 E12/E19 | D配置文件→临时TOKEN→A直传；不向SaaS取OSS配置/TOKEN；显式重申请/complete幂等、SaaS verified与文件清理 |
| 调参数、上线或迁移/回退 | R3 §5.5/§6.3；R4 §1.2/§9/§9.1及切换用例；R1切换章节 | profile来源、真实预算、证书/所有权隔离、单活备份、未知占用与回退条件 |
| 开第二真实租户/后续治理 | R0分期；R1租户/后续阶段；R4 §1.2及公平性用例 | P2门禁，不能仅把tenant数量从1改成2 |
普通构建/测试/运行只使用本项目内导入的只读契约包和自身文件，不读父项目目录。维护者查阅/导入上游发布物是明确的维护动作，不能变成运行依赖。
4. 已确认需求基线与任务映射
此表只索引约束，不复制字段Schema或供应商参数范围。
| 需求 | 已确认边界 | 主要任务/依据 |
|---|---|---|
| Q01 独立工程 | Go 1.27.1、单module/二进制、Cobra显式agent/dispatcher；无Python运行依赖、不合并management | W00/W03；R0/R1/R5 |
| Q02 P1拓扑 | 1个单活D/SQLite、1个Agent/1套Asterisk、至少3家独立SIP trunk 的配置/协议 fixture、1个启用租户；双节点/第二 Cell/第二租户不在本轮 | W05/W06/W09/W14；R1/R4 |
| Q03 持久化 | D持有任务/配额/inbox/outbox；A无业务DB，执行/文字/录音/上传恢复落文件；不接PG/NFS双活 | W05/W06/W08/W13；R1/R2/R3 §5 |
| Q04 MQ/身份/租户 | SaaS↔D全部交互只走RabbitMQ，禁双方HTTP；每个D全局唯一ID及独立接收Topic/队列，响应回原D；保留租户独立队列/原值key/复合幂等/有界窗口，完整新路由预算须重算，超限停发保留 | W01/W05/W08/W12；§1.2、R8/R10 |
| Q05 内部可靠性 | Unary gRPC、D预配Endpoint、共用A证书但独立会话；单 Cell 最后许可、控制屏障和未知占用按本地故障注入验收；跨 Cell 协调延期 | W02/W06/W08/W13；R3 §5 |
| Q06 双AI模式 | ASR-only和完整AI均为P1；D经MQ取得SaaS不可变AI配置/授权后给A，不再调用AI GET；不加任务mode字段、不靠CLI/env覆盖、不复用旧LLM/TTS | W01/W07/W10；R8 §6.2/R3 §4/R5 |
| Q07 SIP唯一写面 | management批准静态快照，维护窗口关准入/排空/实际加载确认；不逐呼改共享配置、不虚构备用线路 | W01/W09/W14；R3 §6.1 |
| Q08 OSS直传 | D配置文件保存OSS配置，A经Unary向D领临时TOKEN后直传；SaaS不下发OSS配置/TOKEN，业务会话/complete/verified仍MQ，SaaS最终校验不变；D本地验证不替代verified | W01/W02/W11/W12；R8 §6.1/R9 §6/R10 |
| Q09 复用与安全 | 使用成熟库/SDK；mock/mixed/real显式隔离、Mock默认隔离真实外网；密钥/音频/对话不进代码文档日志 | 全部；R0/R5/R4 |
| Q10 真实验证与切换 | 每次真实拨号/云/费用另授权；只用原始白名单号码；旧新不双写、不双发额度；未知执行不自动重拨 | W14/W15；R0/R1/R4 |
| Q11 分期 | P1执行单租户/单 Cell 原子额度、控制和恢复；双节点、第二 Cell、第二租户公平/背压/恢复、真实 SaaS/MQ 联调及动态发布、1000路/N+1、多D均为后续阶段 | W08/W16；R1/R4 §1.2 |
5. 开发步骤、依赖与完成条件
W编号是本计划的工作分解，不是新增协议、需求或验收编号。沿用总体方案的P0、P1a–P1d、P2分期；下表为父任务，§5.4细化工作包和产物依赖。先按门禁解锁，再按证据签收，不按预计日期虚报完成。
就绪标记：I（接口就绪）＝源/Proto或模块接口已冻结并合入共同基线，附版本/哈希及合法/非法样例；M（模块就绪）＝该子任务实现并通过本地检查；G（合并集成通过）＝合入指定共同提交后通过相关联合回归。文档方向确认不是I，分支测试绿不是G；运行安全要求不因M就绪而放行。非代码任务可标不适用，但须说明理由。
5.1 P0：合同、工程准备与关键PoC
| 步骤 | 开发内容与预期产物 | 前置/可并行关系 | 完成条件与阅读依据 |
|---|---|---|---|
| W00 开工核对 | 按§2映射请求，核对实际工具链/文件/工作区；登记范围、源版本、责任角色、外部阻塞 | 后续明确安排开发时开始；本轮只建计划 | 有开工记录和可验证前置清单；无误认已实现内容。读R0/R1/R3 §1–2/R4 §1.2 |
| W01 项目合同与P1交接冻结 | 在旧闭包之上发布MQ-only新版本：D唯一身份/生命周期、专用Topic/队列/绑定、所有请求/响应/来源/关联/错误/期限、完整路由长度；复用既有事件/AI/上传语义，不改旧不可变包 | W00；与W02及不依赖业务字段的W03 PoC并行；不得借此修改/冒充上游权威发布 | MQ-only新包自包含、来源/版本/哈希及严格Schema/拓扑正反例通过；旧2026-09-18/19包不能代签，真实预算/授权/外部签收分开。读§1.2/R8/R10及R2/R3/R6 |
| W02 内部协议定稿 | 保留已建立的 agent.v1.AgentControlService；核验MQ异步配置/上传结果与Unary的衔接、D逻辑身份与epoch边界；冻结R12/R13 pending/恢复/最终响应，确需变更才更新Proto/stubs，不编造当前能力 |
W00；与W01并行；后续业务字段必须引用 W01 版本 | buf lint/build/generate、生成包测试、错误/幂等/状态合同可检验；不建R04/R06在线发布空壳。读R2 Unary章节/R3 §5 |
| W03 最小工程、契约包与复用PoC | 按§5.4拆W03-a～e：先建最小单module/Cobra/构建基线，再独立验证生成工具、存储/消息、gRPC/媒体和AI/上传SDK | W03-a基线合入后，其余按各自接口依赖并行；源生成须等W01/W02对应产物，原理PoC不猜业务字段；共享依赖由集成负责人统一修改 | 精确版本/许可/漏洞及各子任务PoC证据，生成确定性与隔离构建通过；各子任务分别验收，边界和依赖清晰。W13-a另负责后续可部署完整候选制品。读R3 §7–8/R5 |
| W04 G0证据汇总 | 将D01–D10逐项关联项目内契约、Proto、关键本地PoC及未决项，给出本阶段单节点 P1 放行范围 | W01/W02/W03的P1适用产物 | 项目内契约和必需本地PoC有证据即可标本阶段 G0；真实供应商/容量/生产验收列第二阶段，不用Mock代签生产。读R3 §2/§9、R4门禁 |
PoC可以提前排除库/工具风险，不意味着允许未冻结的业务实现。若某模块具备完整前置可独立推进，须在W04记录其解锁范围；不得因此宣称整体G0通过。
5.2 P1：持久控制面、执行面与完整业务闭环
W04整体或已记录的对应模块放行是本节共同前置；I/M并行只解除等待其它模块整包完工的约束，不跳过G0合同/PoC门禁，也不授权真实拨号。
| 步骤 | 开发内容与预期产物 | 前置/可并行关系 | 完成条件与阅读依据 |
|---|---|---|---|
| W05 Dispatcher持久控制面 | D唯一身份、专用Topic与租户隔离；所有SaaS请求/响应经MQ inbox/outbox持久接收/关联，控制/查询也经MQ；移除旧SaaS HTTP入口，不留兼容或回退 | W04放行 | 重复命令/commit前后故障不丢任务、不造第二执行；队列与持久待发起窗口有界；控制接收不伪装applied。读R1持久化/R2消息/R3 §3/§5 |
| W06 Agent运行与文件恢复 | 无业务DB；gRPC/mTLS、受控激活/boot/session、健康/版本报告、原子文件与崩溃恢复；只接获授权任务 | W04放行；与W05并行 | 错SAN、错节点、重放、旧会话拒绝；新boot保留旧未知占用/资产；文件损坏隔离、敏感信息不泄露。读R2内部协议/文件/R3 §5.1–5.2 |
| W07 AI配置快照与授权 | W07-d经MQ获取SaaS不可变版本/授权，响应回原D并持久绑定；W07-a校验/执行快照；禁止开发旧AI GET client，覆盖重复/迟到/撤销/重启恢复 | 两端接口I及AI源已发布后可各自实现；联合G需W05/W06的相关模块M，不等对端全部功能完工才写适配 | 旧完整模式兼容、新模式明确；跨租户/同版本异内容/无授权拒绝；在途不漂移；0/false保真。W10继续验证SDK实际行为。读R3 §4/R5 §4.3/R4 §5.1 |
| W08 调度、单 Cell 额度和控制屏障 | W08-d负责D单 Cell 原子额度/许可/CAS，W08-a负责A发起串行区/控制/未知恢复；共享合同单写 | I就绪后两端及W09适配可并行；联合G需要W05–W07相关模块M和W09媒体模块M，一起验证后合入；不是先要求W08.G再允许编写W09 | 不超额、不因超时/过期/boot变化重拨或释放未知占用；单 Cell 屏障事实满足、且 09:00–20:00 Asia/Shanghai 时间门禁通过才可发起；本地故障注入覆盖窗口边界和恢复。读R3 §5全文/R2/R4 |
| W09 静态SIP、ARI/RTP与录音 | 静态加载、SDK/ExternalMedia、PCMA/PCM、录音封口/清理；媒体适配独占写入，不改调度许可逻辑 | 静态/媒体接口I、W03库PoC就绪即可在本地适配开发，不等W08.G；接入业务发起必须等W08控制模块M，W08/W09联合G前禁止业务准入 | 隔离 Asterisk 22.10.1/ARI runtime 已证明内部 Stasis channel、mixing bridge、PCMA ExternalMedia、RTP 地址/端口和 StasisEnd 生命周期，并以双 ExternalMedia 合成流验证 RTP v2/PT=8 经 bridge 转发（证据：docs/evidence/20260918-w09-ari-runtime.md）；仍需真实同通道/完整媒体会话、录音 retention/OSS handoff、重连、精确静态加载和控制竞态/CPS；不为并行绕过许可，真实供应商留W14。读R1/R3 §6.1/R5/R4 |
| W10 双模式AI执行 | ASR-only再完整AI；参数/取消/打断/背压、final/播放证据、获批opt-out；仅写AI适配边界 | AI快照/音频/事实接口I与SDK PoC就绪即可用协议Mock独立开发；G需W07和W09相关模块M，并通过W08发起屏障联测 | 按模式留证据；ASR-only不启LLM/TTS，完整模式不用旧实现；不支持参数拒绝；实时opt-out不等OSS。真实供应商属于第二阶段。读R3 §4/R5 §4.3/R4 §5.1 |
| W11 Agent→OSS直传与恢复 | W11-d核验D配置文件→临时TOKEN及显式重申请，保留SDK签发能力；实现SaaS MQ业务会话/complete/verified与R12/R13持久关联，W11-a保留直传/恢复；仅禁止D本地校验替代SaaS verified，不删除签发职责 | 上传合同、封口文件元信息/生命周期接口I即可用合法测试文件开发，不等整套W09；G需W05/W06相关模块M并接W09实际封口产物联测 | D/gRPC不传文件；有效授权在15分钟内完成一次PUT；过期/失败保留文件并等待显式重新申请；PUT不早发ready；沿原资产恢复，verified后MQ回OSS ID。读R3 §6.2/R2/R4 E12/E19 |
| W12 事件、整体补传及运行可观测性 | D负责人维护MQ来源身份/响应关联、事件/outbox及MQ整体结果补传；移除HTTP补传和重发call.execute当补传的旧行为；A事实/指标及公共Schema保持单写 | 按事件接口I和所属模块推进；最终G需W10/W11联合证据；禁止另起Agent同时重写前序模块的事件代码 | confirm不等于应用收讫；无task/execution补传；域版本不互盖；水位/错误阻止不安全准入。日志/指标随模块实现。读R2/R3 §3/§6.3/R4 |
5.3 P1验收、切换与P2入口
| 步骤 | 开发/验收内容 | 前置 | 完成条件与阅读依据 |
|---|---|---|---|
| W13 单节点部署候选与故障集成 | 先W13-a：可复现构建制品、digest/清单、非root分角色权限/目录、配置样例及运行手册；再用同一制品在隔离 DB/broker/单 Asterisk 环境注入重启、丢包、证书、磁盘、额度和 OSS 故障 | W13-a可随前序完善，完整候选冻结需W08–W12联合G；禁止以真实 ECS 或手工外部环境作为本轮前置 | 验证单 Cell 重启/断连/证书轮换/磁盘使用 unknown/容量失败语义/额度屏障/OSS恢复/备份；记录候选代码commit和制品digest。P1适用用例逐项签收，Mock/mixed明确标注。读R1部署/R4/R3 §5–6 |
| W14 单节点本地集成验收 | 用W13候选在本地/隔离环境验证单 Agent/单 Asterisk、至少3家SIP fixture、1租户、双AI、MQ/OSS契约、PCMA/RTP、控制/恢复、本地CPS及 09:00–20:00 时间门禁 |
W13通过；契约/fixture、隔离 DB/broker、AI/OSS协议 Mock、本地故障注入和窗口边界测试齐备；真实 ECS/供应商/生产 receipt 延期第二阶段 | P1-01–P1-10适用子场景通过；不能把 fixture 写成真实联调。真实 SaaS/MQ、真实外呼、双节点/第二 Cell/第二租户不阻塞本轮。读R0/R4/R3 §6 |
| W15 第二阶段生产切换（本轮不适用） | 真实联调完成后，另行执行排空、唯一写入/调度所有权交接、备份及未知执行核对；本轮只保留本地恢复证据 | 第二阶段另行授权、真实维护窗口和生产回迁方案 | 不把未执行的生产切换写成通过；本轮由 scope amendment 记录不适用。读R1切换/R4/R3 §6.3 |
| W16 第二阶段多租户公平（本轮不适用） | 双租户、等权轮询、配额不足跳过、完整背压、轮转恢复、死信/重试归原租户和公平验收 | 第二阶段另行安排；本轮只验证单租户窗口/配额 | 不开放第二真实租户；本轮不把双租户测试缺失列为阻塞。读R0分期/R1租户/R4公平性 |
交付主线：W00 → W01/W02/W03按产物推进 → W04（项目内契约范围）→ W05/W06基础 → W07–W12按I/M并行及联合G → W13单节点候选/故障 → W14本地集成。W15生产切换、W16双租户公平为第二阶段，不阻塞本轮；此箭头表示交付关口，不要求模块编写整包串行，精确依赖以下表为准。
5.4 工作包与产物依赖
以下是逻辑工作包和产物依赖，按实际范围安排；不存在接口/测试资源时不以想象中的模块目录启动工作。
| 工作包 | 负责角色/边界 | 开始条件及交付 |
|---|---|---|
| W01 / W02 | 契约负责人；外部来源与内部Proto分清权威，业务实现不得手改源 | W00；产出已发布外部包/正式Proto及I金样；上游修改仍须授权 |
| W03-a | 集成负责人 | 先合最小工程、构建/测试入口、锁工具链和依赖，发布共同基线B0；不建无用途空壳 |
| W03-b | 生成工具负责人；生成结果仍由公共产物负责人合入 | B0；验证真实源方言/引用闭包/生成确定性，需W01/W02相应源 |
| W03-c | 存储/消息PoC负责人 | B0；独立SQLite/文件/broker环境验证持久/恢复，不定义业务协议 |
| W03-d | gRPC/媒体PoC负责人 | B0；原理PoC可先做，业务协议测试需W02.I；固定本地Asterisk/SDK |
| W03-e | SDK PoC负责人；确有独立边界可再拆ASR/LLM/TTS/OSS子任务 | B0；参数映射和取消/重试；本地协议Mock不等于供应商实测 |
| W05、W07-d、W08-d、W11-d、W12-d | Dispatcher负责人 | 依父任务前置按顺序交付；SQLite迁移/服务端业务/事件outbox统一维护 |
| W06、W07-a、W08-a、W12-a | Agent核心负责人 | 依父任务前置交付；会话/文件生命周期/本地发起门闩同一写入者 |
| W09-media | 媒体负责人 | 静态/媒体接口I及库PoC；独立适配M，与W08-a/d联合G；不能绕过许可接业务拨号 |
| W10-ai | AI负责人 | 模式/快照/音频/事实接口I及SDK PoC；用批准样例实现M，再与控制/媒体联合G |
| W11-a | 上传负责人 | 上传/文件生命周期接口I及SDK PoC；合成合法测试文件实现M，再与D/封口产物联合G；不自行修改D或A核心 |
| W13-a | 部署负责人（可由集成负责人兼任） | 早期维护真实可运行入口；相关G完成后冻结完整制品/配置/手册；W13-b必须使用它 |
| W13-b / W14 / W15 | 集成/验收负责人；本地/隔离环境单一调度 | 顺序执行候选集成和本地验收；W15生产交接延期第二阶段；只读审查可并行，不能并行改同一环境 |
联合G不互相等待另一任务的G：例如W08/W09各自M及依赖到齐后，一次合并候选联合测试，再分别记G。W10/W11的接口样例必须来自I；生产依赖未就绪时用协议Mock完成M，不能把Mock变成生产回退。契约负责人更新I版本后，受影响任务必须重新对齐和验证，不能混用新旧基线。
6. 门禁、阻塞和明确不做项
6.1 各阶段状态不能混用
| 关口 | 放行什么 | 不能据此宣称什么 |
|---|---|---|
| 方案确认（已完成） | 按既定方向准备合同与PoC，不重复架构审批 | 不等于Schema已发布、Proto已生成、库兼容或实现完成 |
| G0/对应模块前置（受影响部分重开） | 旧基线曾完成；MQ-only新版本须按§8.2重新取得I与本地证据再放行 | 旧通过不等于新MQ契约通过，也不等于第二 Cell、真实供应商或生产验收 |
| 本地P1验证（本轮） | 完成单节点/单 Cell/单租户契约、协议 fixture、故障注入和本地回归 | 不等于真实供应商、生产 SaaS/MQ receipt 或生产切换 |
| 真实P1与切换（第二阶段） | 获授权后另行受控联调/首发运行 | 不属于本轮验收；双节点、第二 Cell、第二租户及1000路/N+1仍另立项 |
外部缺项按角色记录：S（SaaS契约/授权/上传会话）、M（管理平台制品/审批）、O（部署/安全/供应商/预算），D/A负责实现证据。实际责任人未安排写“未指派”，不能代签。阻塞记录至少包含：受影响W/Q/D项、缺失事实、责任角色、可并行工作、解除证据。
6.2 不纳入本轮及P1的扩展
P1不预建在线发布/回滚编排、自动SIP FALLBACK、多Dispatcher协调/HA、权重借用、1000路/N+1实现或文本OSS专属归档；这些后续能力另行安排，不阻塞P1的合法开发，也不能将当前安全屏障延期。D全局唯一ID、专用Topic及D1/D2隔离消息fixture属于本次MQ契约修正，不得借“多D延期”省略；不要求部署第二业务Dispatcher。
单EIP+NAT与第二套管理后台不是延期功能，而是明确排除的架构；后续也不得自行设计、实现或验收。持续采用多机器/多EIP直连，management保持SIP配置唯一编辑/审批面。
真实电话仅允许原始号码 15003164745、15830461047，白名单不是呼叫授权；SIP外呼仅允许 Asia/Shanghai 每日 09:00（含）至 20:00（不含），窗口外 Dispatcher/Agent 必须 fail-closed，不能等待、自动延迟、重试或换线；每次实际外呼前仍必须在当前会话再次获得用户明确确认，并展示将使用的SIP通道名称、外呼号码和抓包方案；每条 SIP trunk 对每个原始手机号每天最多 3 次，线路失败可在额度内经当前会话确认后改测另一条线路；此前确认不自动延用，也不得自动重试或超额。 云创建/EIP变更/网络放行/供应商消费/清理都另行授权，不能因计划写了W14就自动执行。
7. 验证及证据规则
7.1 文档阶段
检查相对链接、章节引用、表格结构、D01–D10确认状态、源指纹及改动范围。仅改索引/计划不得手改生成Schema/字段索引，也不能以文档检查替代运行验收。W01/W02及本地代码已建立后，文档检查仍不能代替下列代码/集成/真实验收。
7.2 后续代码阶段
在本项目自己的实际 Go module 根目录，至少执行：
# 项目内模块基线的最低验证要求；每次协议/运行时变更后重跑。
go version
go vet ./...
go test -race ./...
go build ./...
另做自有源码格式检查，输出差异而非静默改动第三方/生成物；核验实际Go 1.27.1及构建镜像/依赖锁。当前入口还须运行 buf lint/build/generate、scripts/check-contracts.sh、scripts/check-proto.sh、make acceptance-local；对应任务还须运行源生成一致性、真实隔离DB/MQ、协议、故障注入及实际构建入口的检查。以上命令不代表所有验收完成。
证据使用稳定的项目相对路径（后续可在 docs/evidence/ 下按W/工作包保存，不提前建空目录），记录环境/mock-mixed-real、代码base/head/integration commit、制品/合同/依赖版本、命令、预期与实际、退出码、时间和风险。工作包证据按实际范围归档；集成负责人将证据绑定到实际合并提交后记G。禁止存密钥、完整音频/对话，不复制旧报告冒充验收。
8. 当前执行台账（后续 Agent 必须维护）
状态词固定使用：未开始、进行中、blocked、待验证、完成；“完成”须有对应证据，不代表后续真实验收完成。本节由集成负责人维护，任务负责人提交证据和状态建议。每个父任务按工作包记录I/M/G；代码父任务需所属工作包的合并回归通过才完成，只有局部M时保持待验证。本轮文档完成不等于W00开发开工已执行。
项目已交付旧W01基线、W02 Proto/stubs和旧本地P1证据。本轮MQ-only修订后，受影响父任务改为待验证，当前下一动作及解除条件见§8.2；表内已有证据保留作为修订前历史，不能据旧HTTP、单租户路由或本地OSS结果关闭新门禁。 未受影响模块的旧通过事实不撤销；本轮没有重新运行代码或真实验收。
| 步骤 | 当前状态 | 历史证据/原基线结论（不代表新修订通过） | 当前下一动作 |
|---|---|---|---|
| W00 | 完成 | 已读 AGENTS、计划与 R0/R1/R3/R4/R5；工具链为 Go 1.27.1；已记录父工作区既有改动和契约源 commit。证据：docs/evidence/20260918-local-development.json |
维护本地基线并按 W04 证据门禁推进 |
| W01 | 待验证 | 项目内 contracts/upstream/2026-09-18-p1-baseline 已形成自包含版本、严格事件/AI/授权/OSS/静态制品/profile Schema、8种事件正例和负例、README/SNAPSHOT/release-manifest/父清单哈希；明确继承 source dirty 且非外部权威。证据：W01 bundle、internal/contract 与 internal/ai 测试 |
发布MQ-only新契约及正反例，见§8.2；外部签收与本地冻结分开 |
| W02 | 待验证 | proto/agent/v1/agent.proto、gen/agent/v1/*、proto/ERRORS.md、manifest 已交付；buf lint/build/generate 和生成包测试通过，覆盖 R01–R03/R05/R07–R13，不建 R04/R06 空壳 |
核验D身份/epoch和R12/R13的MQ异步衔接，按需冻结Proto变更，见§8.2 |
| W03 | 完成 | W03-a 单 module/Cobra/构建基线、W03-c 存储/MQ 本地实现、W03-e AI Schema/contract SaaS Mock PoC、W03-d Pion RTP thin adapter、gopsutil 资源采样已有测试；已完成 Go module 许可证清单、go mod verify 和 govulncheck@v1.7.0（Go 1.27.1 构建）无漏洞扫描；临时 module 的 ari/v5.3.1、openai-go/v3.62.0、dashscopego/v0.1.2、doubao-speech-go API/协议 Mock PoC 通过但均未锁入项目；固定 Asterisk 22.10.1 + 临时 ARI client runtime PoC 已通过内部 Stasis/bridge/ExternalMedia lifecycle；PJSIP/PJSUA2 full mock leg 已通过双向 PCMA、U1/U2/U3 播放、端点 WAV 封口和 ARI cleanup（证据：docs/evidence/20260918-w09-sip-rtp-ari.md）；一次 disposable RabbitMQ 4.1.8 broker confirm/ACK/DLQ 集成通过，并新增 Dispatcher tenant consume→SQLite inbox/task/outbox→event publish integration test；另以 TestOutboxProcessCrashRecovery 覆盖一次真实测试子进程在 outbox claim 后退出、父进程恢复并发布的本地故障窗口（证据：docs/evidence/20260918-w05-restart.md）；2026-09-19 另锁定物理 Asterisk 22.10.1 source/native-stage、Jansson 2.15.0、PJPROJECT 2.17 和 Debian 13 systemd 构建/安装输入，依赖补充证据见 docs/evidence/20260918-dependencies.md，make check、脚本语法和 deployment lock JSON 检查通过 |
本阶段项目内 Go/SDK/契约/隔离验证已签收；生产 ARI module/tag/许可证、供应商真实 SIP/媒体、录音 retention/OSS、批准 broker 版本/ACL、真实 broker/commit 故障注入属于第二阶段；隔离 SIPp-to-PJSIP/ARI signaling 证据见 docs/evidence/20260918-w09-sip-ari.md，不把本地或隔离 PoC 当生产通过 |
| W04 | 待验证 | W01/W02 项目内产物和 D10 隔离 PoC 已具备；本阶段项目内 G0 契约、Schema、fixture、隔离 PoC 和范围修订已签收；外部权威、真实预算/角色签收、生产依赖及生产运行证据属于第二阶段，不计入本轮门禁；汇总：docs/evidence/20260918-g0-status.md |
汇总新MQ合同及本地PoC，重新签收受影响G0，见§8.2 |
| W05 | 待验证 | 已有 SQLite inbox/tasks/quotas/controls/replays/outbox、control HTTP、本地 reservation-to-Agent seam 和 RabbitMQ adapter 的 publisher confirm、prefetch=1、per-tenant DLQ 拓扑测试；新增 contract-backed local flow 将租户命令、配额、Agent 执行和 event 校验串联；make mq-integration-local 已用 disposable RabbitMQ 4.1.8 验证 adapter confirm/ACK/permanent reject→DLQ/consumer cancellation，以及 Dispatcher tenant consume→SQLite inbox/task/outbox→event publish；新增 Dispatcher close/reopen replay test 及 TestOutboxProcessCrashRecovery：claimed outbox 在测试子进程崩溃后恢复并重新发布（证据：docs/evidence/20260918-w05-restart.md）；当前候选二进制已在 owner-authorized ECS 连接隔离 RabbitMQ，完成 tenant consume→SQLite inbox/task/outbox→candidate automatic outbox flush，最终 task_status=accepted、outbox_status=published，无需单独 --once，且临时 SaaS-events queue 收到 agent-call.command.result（证据：docs/evidence/20260918-rabbitmq-integration.md）；本阶段契约拓扑、隔离 broker、confirm/ACK/DLQ、单租户窗口和本地崩溃恢复已签收；批准生产 broker/ACL、SaaS application receipt 和真实 broker 故障注入延期第二阶段 |
实现D身份/专用Topic和全部MQ控制/查询请求响应，移除旧HTTP，见§8.2 |
| W06 | 完成 | 已有文件状态、transcript/assets、unknown 恢复和损坏隔离测试；agent.v1 runtime handlers、TLS1.3 mTLS config、持久 session-generation journal、session/fencing/CAS/permit/fact/upload boundary、静态 Cell 制品启动路径/激活校验、gopsutil 主机/进程采样（媒体/AI维度显式 unknown）、R01 pre-activation status、Dispatcher AgentCoordinator/no-retry reconciliation 与可选 CLI listener 已通过本地测试；mTLS smoke、session generation、fingerprint allowlist 和错误 endpoint 拒绝已有证据；跨主机/第二 Cell/fleet-wide rotation 属后续阶段，不阻塞本轮单 Cell 验收 |
本阶段单 Cell 健康/版本报告与隔离故障矩阵已纳入本地 P1 证据；后续阶段再做跨主机 fleet 管理 |
| W07 | 待验证 | W01 项目内 AI 双模式/授权/digest Schema 和样例已闭合；RPC Agent 可按部署注入的不可变快照/授权/egress 对 permit 与 Execute 做租户、版本/digest/mode、有效期、egress、撤销校验，DispatcherCoordinator 继续绑定 permit；本地 SaaS contract/fixture Mock 已由 scripts/check-contracts.sh、internal/contract、internal/ai 和 make mq-integration-local 覆盖（证据：docs/evidence/20260919-local-saas-contract-mock.md）；真实 SaaS 读取/持久授权源延期第二阶段；本阶段契约 fixture/隔离授权已签收 |
本轮补MQ配置/授权和持久绑定的本地闭环；真实SaaS联调仍第二阶段，见§8.2 |
| W08 | 待验证 | 已有租户/单 Cell scope 原子配额和 control CAS 本地测试；Dispatcher.ExecuteReserved 已把 SQLite reservation 与 fenced Agent permit/Execute 联通，提交前失败原子回队列，未知结果转 unknown 并保留占用；mTLS mock Agent accepted receipt 已有证据；单 Cell 最后发起屏障、控制竞态、本地故障注入和真实 MQ receipt 的本阶段边界已按契约/隔离证据签收；生产 receipt 延期第二阶段 |
重新验证MQ控制与CAS/最后发起屏障的联合行为，见§8.2 |
| W09 | 完成 | 已采用 Pion RTP v1.10.5 的 bounded PacketGuard，使用库解析并覆盖 payload/SSRC/包长边界；项目内 contract.ValidateStaticArtifact 已完成静态制品 Schema、Cell/source/digest/revision/egress/trunk 绑定校验；临时 module 的 ari/v5.3.1 已在固定 Asterisk 22.10.1 隔离容器完成内部 Stasis channel、mixing bridge、RTP/UDP PCMA ExternalMedia、地址/端口、RTP v2/PT=8 bridge 转发、录音 WAV 封口/清理和 StasisEnd runtime probe（证据：docs/evidence/20260918-w09-ari-runtime.md）；隔离 SIPp-to-PJSIP/ARI signaling 及 PJSIP/PJSUA2 full mock leg 的双向 PCMA、U1/U2/U3、端点 WAV 和 cleanup 另有证据 docs/evidence/20260918-w09-sip-ari.md、docs/evidence/20260918-w09-sip-rtp-ari.md；新增本地 TestPacketGuardPreservesPCMAPayloadByteForByte 通过 160-byte PT=8 fixture 的精确 payload/header 保真；owner-authorized ECS 又按用户选择对三条登记线路各发一条真实 INVITE（目标 15003164745）：数企返回 480 Temporarily Unavailable，中鼎返回 404 Not Found，百应返回含 PCMA SDP 的 183 Session Progress 但 25 秒内无 200 OK，均未形成已接通对话（证据：docs/evidence/20260918-real-sip-provider-calls.md、docs/evidence/20260919-real-sip-provider-calls-retry.md）；后续允许窗口重试仍为数企 100/183 无 200、中鼎 100 无最终响应、百应 100/183/180 无 200；2026-09-19 新 ECS 对两个白名单目标再次直连真实供应商：数企/百应均无最终 200，中鼎第二目标一次信令达到 200，但后续媒体 probe 未干净完成，仅捕获 5 个 SIP 包和 1 个非 SIP UDP 包，未验收 RTP/录音，证据：docs/evidence/20260919-real-provider-ecs-direct.md；同一 ECS 已直接编译并以 systemd 启动物理 Asterisk 22.10.1，provider-second endpoint 为 Avail；一次 bounded Asterisk 真实外呼 origin 返回 0，但仅有 13 个 SIP 包、1 个非 SIP UDP 包和 0 字节录音，未形成干净 RTP/录音证据；同一物理 Asterisk 又按线路前缀对 provider-primary/provider-third 各做一次直接 PJSIP bounded probe，均仅有 10 个 SIP 包和 1 个非 SIP UDP 包，无录音/干净媒体；最新一次 provider-second 外呼在用户即时确认后执行，临时 PCAP 仅观察 8 个 SIP 包、0 个媒体包和 100/200/404 状态 token，原始 PCAP 已删除且未自动重试；父目录三条线路与当前 Go 边界的注册/认证、From/PAI、前缀和选路对比见 docs/evidence/20260919-sip-routing-implementation-comparison.md；新增 docs/evidence/20260919-mixed-ari-callflow.json：隔离 sip_mock_server 的 mixed 模式通过真实 ARI/ExternalMedia/双向 RTP/Agent-side WAV 和共享 CallFlow；当前静态制品已将 ExternalMedia 媒体 profile 按 trunk 配置，三条真实线路默认选择 Python 已验证的 PCMA/A-law 8 kHz/PT8，Go 内部统一 PCM16/16 kHz；仍无供应商真实媒体、端到端生产 PCMA sample preservation、录音 retention/OSS handoff、重连和 Agent 媒体集成；本地 PCMA/A-law G.711 转换、ExternalMedia alaw 选择、双向 RTP、非静音录音和共享 CallFlow 已由 docs/evidence/20260920-pcma-mixed-callflow.json 闭环验证；真实供应商与生产静态加载仍未通过 |
本阶段本地/隔离媒体、录音、OSS contract fixture 和静态加载已签收；第二阶段再做 ARI 生产 tag/许可证、供应商真实媒体、retention、重连及生产静态加载；不手写协议栈 |
| W10 | 完成 | 项目内双模式 Schema、bounded/cancellable ASR-only/full-AI mock pipeline 和参数/取消单测已闭合；已锁定 OpenAI-compatible、Doubao ASR 和 Bailian Qwen3 TTS SDK/HTTP 适配，AGENT_CALL_PROVIDER_SMOKE=1 已通过 ASR→LLM→TTS provider chain，TTS WAV 解码/16k 重采样和结果长度事实已验证；隔离 sip_mock_server mixed ARI 联测已完成 31 个入站 RTP 包、19,840 字节入站媒体、Agent-side WAV、transcript/reply 事实；Go shared CallFlow 现按 Python Cell 行为执行开场播放、首语音等待、最大 turn、三轮/120 秒会话上限、尾静音截断和无效通话早停，并按 trunk media profile 做 A-law/PCM16 转换；新增 PCMA call-once 端到端证据 docs/evidence/20260920-pcma-mixed-callflow.json，完成 ARI answered、PCMA/8000/PT8、ExternalMedia alaw、110/20 双向 RTP、U1 播放、双端非静音 WAV、transcript/reply；一次 freshly-confirmed provider-second 真实外呼曾进入 Stasis/ExternalMedia 并观察到 220 RX/136 TX RTP，但真实 ASR 为空；当前 capture-first provider-second 重测仍以 cause=1 在 StasisStart 前结束，PJSIP/完整 PCAP 记录 100 Trying 后 404 Not Found，无媒体；provider-primary capture-first 记录 100/183/486 Busy Here，同样无媒体；provider-third 则已完成一次约49秒三轮真实 AI、RTP、3段入站/4段出站录音和双方文本事实。证据：docs/evidence/20260920-real-provider-second-capture-first-v9.json、docs/evidence/20260920-real-provider-primary-capture-first.json、docs/evidence/20260920-real-provider-third-capture-first.json；禁止以 provider smoke 或 Mock 代签 |
第二阶段在获得真实供应商授权后再重跑 RTP/ASR/LLM/TTS/播放联调；不自动更换通道或号码 |
| W11 | 待验证 | W01 OSS upload control-plane Schema、Agent 受限 grant 的 HTTPS/host/size/checksum/expiry/object-key/redirect 防护、直接 PUT client 和 upload metadata RPC handlers 已通过本地测试；Alibaba OSS SDK v2 presigned PUT、PUT/HEAD、SHA-256、SQLite durable grant/completion、recording.ready outbox、显式重新申请及幂等已有证据；本阶段按契约结构/fixture/隔离状态机签收 upload-session/complete/verified，真实 SaaS handoff 延期第二阶段 |
本轮补D配置文件/TOKEN接线、SaaS MQ业务会话/complete/verified及恢复；保留D签发能力，旧验证结果不代签，见§8.2 |
| W12 | 待验证 | 8种事件 strict Schema/fixtures、command.result outbox、transcript.updated builder、资源 freshness/unknown、invalid alias rejection 和 contract-backed local flow 已通过本地测试；internal/calllog 脱敏业务日志、统一 AgentControl listener、R11 fact durable 去重/冲突和 Dispatcher-owned aggregate version 已有专项证据；本阶段按契约结构、fixture、confirm/outbox 状态机和隔离 RabbitMQ 验收，生产 broker ACL/TLS/application receipt 延期第二阶段 |
实现MQ来源/关联和整体结果补传，移除HTTP与重投执行的旧补传路径，见§8.2 |
| W13 | 待验证 | W13-a 可复现构建制品、manifest、非 root 权限/目录、配置样例、capture-first 入口和本地 package smoke 已有证据；最新本地 gofmt、go build、go test -race ./...、go vet ./...、go mod verify、契约和 Proto 检查通过；本轮只需在本地/隔离单 Cell 注入重启、断连、证书、磁盘、额度和 OSS 故障，不要求 ECS 或第二 Cell |
依据新MQ合同更新候选配置/手册，重新验证消息及上传故障，见§8.2 |
| W14 | 待验证 | 已有单 Cell 隔离 session/permit 本地测试；历史双 Cell mock 仅作事实记录，不作为本轮门禁；一台 owner-authorized Debian ECS 已创建、加固并完成二进制 mock smoke，并在该主机隔离运行 Asterisk/PJSIP/PJSUA2/ARI compatibility probes；本轮另从固定 EIP 对三条登记 SIP endpoint 完成 OPTIONS 200 OK reachability probe；provider-primary 本次 capture-first 对 sip:708915003164745@61.132.228.221:5060 返回 100/183/486 Busy Here，provider-second 此前对 sip:15003164745@60.171.24.90:5060 返回 100/404；两次均有完整失败 PCAP，但未进入媒体；经本次当前会话确认，provider-third 160.202.254.79:5060 对原始号码 15003164745 返回 100/183/180/200，完成约49秒三轮真实 AI 通话、3段入站+4段出站 PCM16/16k录音和双方文本事实；新 ECS 两白名单目标的直接真实供应商探针和物理 Asterisk bounded call 见 docs/evidence/20260919-real-provider-ecs-direct.md。新增 physical-host systemd package 安装 smoke，但其 manifest 仍为 dirty/non-production，未启动生产服务。仍没有批准生产 broker/SaaS application receipt、真实 provider-third 录音上传闭环、第二 Cell/第二 Asterisk 及完整 3 供应商真实证据（已移出本轮范围）；Alibaba OSS grant/PUT/HEAD、15分钟单次 token/显式重新申请、durable completion 和 recording.ready outbox 已完成授权本地及新 ECS mTLS gRPC→OSS 实际上传验证；provider-third 的单 Cell SIP/RTP/AI/录音/文本成功仅为部分证据，隔离 ECS RabbitMQ candidate receipt 仅为部署证据。证据：docs/evidence/20260918-cloud-host-bootstrap.md、docs/evidence/20260918-rabbitmq-integration.md、docs/evidence/20260918-real-sip-provider-calls.md、docs/evidence/20260919-real-sip-provider-calls-retry.md、docs/evidence/20260919-real-provider-callflow-attempts.json、docs/evidence/20260919-physical-systemd-deployment.md、W09 evidence；2026-09-20 已按用户授权创建并加固 Debian 13 ECS i-2zeew9pswry8sr33095l，绑定固定 EIP 123.56.71.98，安装 Asterisk/Go Agent；一次真实 provider-second 外呼曾观察到双向 RTP但 ASR 为空，新版三轮重试以 cause=1 在 StasisStart 前结束；capture-first v4 的 PJSIP logger 明确记录 provider-second 对 sip:15003164745@60.171.24.90:5060 返回 100 Trying 后 404 Not Found，但短事务 PCAP 为 header-only，entrypoint 已加入 drain，真实三轮/录音/双方文本/OSS/MQ 仍未闭合；部署与失败证据：docs/evidence/20260918-cloud-host-bootstrap.md、docs/evidence/20260920-real-provider-second-15003164745.json、docs/evidence/20260920-real-provider-second-3turn-attempt.json、docs/evidence/20260920-real-provider-second-capture-first-v4.json、docs/evidence/20260920-real-provider-second-capture-first-v7-package.json、docs/evidence/20260920-real-provider-second-capture-first-v9.json、docs/evidence/20260920-real-provider-third-capture-first.json、docs/evidence/20260920-real-provider-primary-capture-first.json、docs/evidence/20260920-real-sip-attempt-ledger.json、docs/evidence/20260920-sip-attempt-guard.md、docs/evidence/20260920-acceptance-status.md、docs/evidence/20260920-real-cloud-inventory.md |
重新执行MQ-only本地全流程及D1/D2路由fixture，旧验收不覆盖修订，见§8.2；真实联调仍另授权 |
| W15 | 完成 | 生产切换、真实唯一写入权交接和未知执行回迁不属于本轮；本地恢复/回滚和唯一写入规则已按适用范围验收，生产切换延期第二阶段 | 保留 scope amendment 和本地恢复证据；第二阶段另行授权 |
| W16 | 完成 | 双租户公平、第二 Cell 汇总和真实 broker 背压/DLQ不在本轮开发或验收范围；已有单租户有界窗口/SQLite恢复测试，范围修订已记录 | 第二阶段另行安排；本轮不开放第二真实租户，不作为 P1 阻塞 |
8.1 本轮文档变更
- 状态：完成（仅文档）。
- 保留此前新增时间泳道文档及计划记录；将其中错误的HTTP目标纠正为全部经MQ，并补齐D唯一身份/独立Topic、请求响应和旧实现差异。
- 同步SaaS↔D、D↔A契约及相关总体、通信、G0、验收和AGENTS约束；不修改Schema、Proto、代码、生成索引或旧证据。
- 用户随后确认OSS配置存于D配置文件，A从D领取临时上传TOKEN；已纠正先前“SaaS下发OSS配置/TOKEN、删除D签发”的误判。TOKEN显式重申请也找D；SaaS业务会话及最终verified校验职责不变。
- 完成条件：目标时序无SaaS↔D直连、所有交互明确MQ路径、独立D接收与租户隔离不冲突、新旧状态分开。
- 本轮OSS来源纠正文档验证已通过：11份文档、75个本地链接/锚点、76张表格、代码围栏/空白及
git diff --check；55条时序连线保留D配置→D临时TOKEN→A直传及SaaS最终verified，无SaaS↔D直连。旧“SaaS提供OSS配置/TOKEN、删除D签发”目标表述已清理，验收编号未变；代码、Proto、旧契约包/生成索引及历史证据未改。未进行Mermaid渲染或运行测试，不以静态检查替代实现验收。
8.2 MQ-only修订后的当前待办与解除条件
| 工作包 / 当前状态 | I/M/G 与下一动作 | 解除条件 |
|---|---|---|
| W01 / 待验证 | 新I未就绪；契约负责人冻结身份生命周期、Topic/队列/绑定、完整路由预算和所有消息/关联/错误/期限 | 新版本、来源/哈希、严格Schema与正反例；旧包原样保留，不能只改图就记I |
| W02 / 待验证 | 原Proto证据保留；重新核验D身份与epoch、MQ异步配置/上传到Unary的衔接 | pending/有界等待/原操作恢复/最终结果可验证；必要Proto变更先冻结再生成 |
| W04 / 待验证 | 汇总新I及相应PoC，受影响G0重新签收 | 新合同与本地消息/恢复PoC证据；真实资源仍另授权 |
| W05/W08/W12 / 待验证 | 新M/G未通过；MQ控制/查询/补传、D身份/定向响应、持久恢复和控制屏障；删除旧SaaS HTTP通道 | 控制accepted/applied、查询、原结果补传及崩溃/重复/乱序通过，不重发执行当补传，不保留HTTP兼容 |
| W07 / 待验证 | 实现MQ配置/授权与持久绑定；不开发旧AI GET | 原租户/版本/摘要及有效授权保持，缓存/撤销/迟到/重启检查通过 |
| W11 / 待验证 | 核验D配置文件/TOKEN/显式重申请；实现SaaS MQ业务会话/complete/verified，与R12/R13联合 | 配置缺失明确失败，不向SaaS取配置/TOKEN；保留D签发、A直传；SaaS verified后才ready，不以D本地验证替代，不新建资产 |
| W13/W14 / 待验证 | 新候选与本地联合G未通过；部署配置/手册取消旧HTTP接入 | 全流程无SaaS↔D HTTP；D1/D2消息fixture无串收/竞争，重复ID、错目标、路由长度、不可路由/断连及关联恢复均验证；不扩为双D业务运行 |
实际负责人尚未指定；本轮只完成文档纠正，以上不是实现完成记录。后续顺序：W01新合同及W02衔接核验 → W04对应门禁 → D侧各工作包按新I实现 → W13/W14联合回归。旧通过数和20260920-local-p1-acceptance.md不覆盖新修订。
**历史本地结果：**修订前W01–W14 的项目内单节点/单 Cell/单租户适用范围曾由本地回归、契约/fixture、隔离故障矩阵和 20260920-local-p1-acceptance.md 签收；本轮受影响项以§8.2待验证为准。W15生产切换、真实 SaaS/MQ receipt、真实供应商/ECS、双节点/第二 Cell/双租户、容量/N+1属于第二阶段，不阻塞本轮，也不能被本地证据反写成生产已完成。生产服务未来仍须使用 deploys/ 的 Debian 13/systemd 包，真实外呼继续遵守逐次确认、capture-first、白名单、09:00–20:00 Asia/Shanghai 和每日额度规则。
后续每次完成任务时按负责人和证据规则更新本节、实际运行说明及证据；只有需求变化才修改§4/阶段范围并注明用户确认，不能用更新进度掩盖变更。