DLG-72 人机协作关系优化 — 听云生产环境完全上线后的协作机制重塑¶
日志编号：DLG-72 日期：2026-08-17 触发人：用户指令「人机协作关系优化」 执行人：听写助手（DT） 前置条件：听云项目（ops/）生产环境完全上线可用，相当于真实用户侧的可用性验证通过（但还未进行细节联调） 关联协作记录：COLLAB-20260817-01
一、优化背景¶
1.1 触发场景¶
听云（WCL）项目完成了生产环境的完全上线可用，相当于真实用户侧的可用性验证已通过。在此里程碑之后，用户提出对人机协作关系进行优化调整，核心诉求：
- 沟通机制明确化：听云、听码、听写和人类的沟通需在主项目和子项目（ops/dip1，未来还会增加）中灵活切换。主项目默认人类↔听写对话；听云/听码仅接受专门 @ 的消息（忽略未 @ 的消息）；三 AI 之间可在主项目直接互相交流。
- 协作记录替代日志协作：由听写建立专门的协作记录文档，替代原通过工作日志（DLG/OWLG/DWLG）进行协作的机制；历史协作记录须提取填充至新文档。
- 听写新增真实用户测试职责：听写代表真实用户对真实环境进行全面深入完整的测试，操作行为完全与真实用户相同，包括对用户操作手册类文档进行检查确认；并在测试过程中对 bug 类型进行区分（代码问题→听码处理 / 运行环境配置问题→听云处置）。为此，听写可拥有一组专用的只读性后门功能，普通真实用户不允许使用。
1.2 优化目标¶
- 明确三 AI 角色的消息接收边界，避免上下文干扰
- 建立专职协作通道，将工作日志回归单一「过程留痕」定位
- 听写承担真实用户测试职责，形成「测试→分类→@处置→验证」闭环
- 配套新建 DT/WDE 独立工作手册，与 WCL 工作手册形成三 AI 工作手册体系
二、执行步骤 10 阶段¶
阶段 1：需求澄清与方案对齐 ✅¶
用户在主项目发起优化指令后，听写就 4 个关键决策点向用户澄清：
| 决策点 | 用户选择 |
|---|---|
| 听写工作手册的位置 | 新建独立手册（docs/DT-听写工作手册.md） |
| 协作记录文档形式 | 单一协作日志文件（docs/协作记录.md） |
| 听码工作手册是否独立化 | 独立化（dip1/docs/WDE-听码工作手册.md），便于未来扩展至 DIP2/DIP3 |
| 只读后门功能规格定义位置 | DIP1-SPEC 中新增 |
阶段 2：AGENTS.md V9.0→V9.1 ✅¶
修改 AGENTS.md：
- 顶部版本号 V9.0 → V9.1，最后更新 2026-08-11 → 2026-08-17
- 人机协作模型表中听写职责新增「真实用户测试」「协作记录维护」两项
- 协作原则第 2 条「可追溯」增加协作记录引用
- 新增《沟通机制》章节：主/子项目沟通场景与消息接收规则表 + 三种沟通渠道 + 协作记录机制（替代原日志协作机制说明）
- 修订记录新增 V9.1 条目
阶段 3：DT 听写工作手册 V1.0 创建 ✅¶
新建 docs/DT-听写工作手册.md（DOC-A08 / DT）：
| 章节 | 内容 |
|---|---|
| §一 角色定义 | 基本信息、核心职责（含真实用户测试、协作记录维护）、决策权限 |
| §二 工作目录结构 | docs/ 目录布局 + 文档自主权原则 |
| §三 沟通机制 | 听写为主项目人类默认对话对象，4 类消息接收规则 |
| §四 真实用户测试职责 | 测试定位（真实用户身份）、测试范围 7 维度、Bug 类型区分 4 类（代码/配置/混合/业务规则）、只读后门功能 6 项（BD-01~06）、测试报告规范 |
| §五 协作记录维护职责 | 替代原日志协作机制，维护流程图 |
| §六 工作日志规范 | DLG/SWLG |
| §七 与其他 AI 的协作边界 | 听写↔听码、听写↔听云边界对照表 |
阶段 4：WDE 听码工作手册 V1.0 创建 ✅¶
新建 dip1/docs/WDE-听码工作手册.md（DOC-D01-W / WDE）：
- 从 DIP1-IMP §一 抽出听码通用角色定义
- 章节结构：角色定义 / 工作目录结构 / 沟通机制（仅响应 @听码）/ 与听写协作边界 / 与听云协作边界 / 工作日志规范
- 未来扩展说明：DIP2/DIP3 启动时工作目录相应扩展至
dip2//dipn/
阶段 5：WCL 听云工作手册 V1.4→V1.5 ✅¶
- 版本号 V1.4 → V1.5
- 新增 §1.4 沟通机制章节：听云消息接收规则（主项目仅响应 @听云，子项目 ops/ 默认响应所有消息）
- 定义听云发起/接收协作方式，通过协作记录文档留痕
- 4 类协作场景示例（DT→WCL 配置问题 / WCL→WDE 代码问题 / WDE→WCL 环境配置 / WCL→DT 业务澄清）
- 明确 §1.4 与 §五 SFM 反馈状态机的区别与互补关系
- 关联文档引用更新：WDE 引用改为独立工作手册，新增 DT 工作手册和协作记录引用
阶段 6：协作记录文档 V1.0 创建 ✅¶
新建 docs/协作记录.md（DOC-A07 / COLLAB）：
| 章节 | 内容 |
|---|---|
| §一 文档定位 | 与工作日志的关系、支持的协作场景、适用范围 |
| §二 使用规范 | 条目格式（COLLAB-YYYYMMDD-NN）、@ 标记规则、4 种状态（open/in_progress/blocked/closed）、追加规则（最新在上）、维护责任（听写独立维护） |
| §三 协作记录区 | COLLAB-20260817-01 人机协作关系优化（in_progress） |
| §四 历史归档 | 从 DLG-6571/OWLG-0911/DWLG 提取 8 条历史协作记录摘要 |
| §五 修订记录 | V1.0 首版创建 |
阶段 7：历史协作记录提取 ✅¶
从历史工作日志中提取三 AI 协作内容摘要填充至协作记录 §四：
| 来源 | 协作方 | 主题 |
|---|---|---|
| DLG-65 | 人类↔@听写 | DIP1 原生 App 方案升级 |
| DLG-66 | @听写↔@听码 | DWLG-02 修正 + 公开同步部署 |
| DLG-67 | @听写↔@听云 | 听云工作手册 V1.2 + 文档自主权 |
| DLG-68 | @听写↔@听码↔@听云 | 公开同步纳入听码文档 |
| DLG-69 | @听写↔@听云 | 公开同步一级分类调整 |
| DLG-70 | @听写↔@听云↔@听码 | 公开同步 V2.9 新增 DIP1 用户手册 |
| DLG-71 | @听写↔@听云 | 公开同步 V3.0 业务知识库 + 客服 V2.0 |
| OWLG-11 | 人类↔@听云 | Cloudflare 凭据配置 |
阶段 8：RQD-B V1.3→V1.4 ✅¶
- 版本号 V1.3 → V1.4，关联文档新增 DT 听写工作手册引用
- 新增 §六 真实用户测试需求：
- §6.1 测试范围需求 TST-01~07（三端端到端+8 阶段全链路+操作手册核对+异常场景+NFR）
- §6.2 Bug 类型区分需求 TST-08~11（代码→@听码 / 配置→@听云 / 混合→协同 / 业务规则→SPO/BO）
- §6.3 只读后门功能需求 TST-1220（BD-0106 六项后门+访问控制+数据脱敏+网络限制）
- §6.4 测试报告需求 TST-21~23
- §6.5 业务约束（真实用户视角/后门最小使用/安全红线/协作闭环）
- 修订记录新增 V1.4 条目
阶段 9：DIP1-SPEC V2.0→V2.1 ✅¶
修改 dip1/docs/DIP1-SPEC-需求规格说明书.md：
- 版本号 V2.0 → V2.1，关联实现文档新增 DT 听写工作手册 + RQD-B §六引用
- 新增 §3.10 听写只读后门功能（F-DT-001~006）：
- §3.10.1 功能清单 6 项（BD-01~06：服务健康检查/配置项查看/接口元数据查询/数据库表结构查询/错误日志摘要/用户会话状态查询）
- §3.10.2 访问控制 7 维度（认证/授权/审计/网络限制/数据脱敏/速率限制/只读保证）
- §3.10.3 错误码新增 1006（后门权限不足）/3060（后门速率超限）/3061（后门 IP 不在白名单）
- §3.10.4 数据库表新增
dt_backdoor_audit审计表 + 2 RLS 策略（待 DIP1-Schema V2.1 同步） - §3.10.5 OpenAPI 端点新增 6 个（待 DIP1-API V2.1 同步）
- 新增 NFR-21（后门只读保证）/NFR-22（后门访问审计）/NFR-23（后门数据脱敏）
- 功能点 213 → 219
- 修订记录新增 V2.1 条目
阶段 10：DIP1-IMP V2.1→V2.2 ✅¶
修改 dip1/docs/DIP1-IMP-Code-Agent实施指南.md：
- 版本号 V2.1 → V2.2
- §一 听码角色定义改为引用 WDE 工作手册，保留 DIP1 专属实施细节（技术范围/工时预算/跳过范围/交付物）
- §一 技术范围新增「听写只读后门 6 端点」（对齐 DIP1-SPEC V2.1 §3.10）
- §B 后端业务阶段工时预算含听写后门 1 人天
- 沟通机制对齐 PMG V9.1——听码在主项目仅响应 @听码，跨 AI 协作通过协作记录留痕
- 关联文档新增 WDE 工作手册引用
- 修订记录新增 V2.2 条目
三、产出物清单¶
3.1 新建文档（3 份）¶
| # | 文档路径 | 编号 | 版本 | 说明 |
|---|---|---|---|---|
| 1 | docs/DT-听写工作手册.md |
DOC-A08 / DT | V1.0 | 听写角色定义和工作机制（含真实用户测试+协作记录维护） |
| 2 | dip1/docs/WDE-听码工作手册.md |
DOC-D01-W / WDE | V1.0 | 听码角色定义和工作机制（从 DIP1-IMP 抽出） |
| 3 | docs/协作记录.md |
DOC-A07 / COLLAB | V1.0 | 三 AI 跨角色协作唯一通道（替代原日志协作机制） |
3.2 修改文档（5 份）¶
| # | 文档路径 | 版本变更 | 关键变更 |
|---|---|---|---|
| 1 | AGENTS.md |
V9.0→V9.1 | 新增《沟通机制》章节；听写职责新增真实用户测试+协作记录维护 |
| 2 | ops/WCL-听云工作手册.md |
V1.4→V1.5 | 新增 §1.4 沟通机制章节 |
| 3 | docs/需求分析/业务级需求.md |
V1.3→V1.4 | 新增 §六 真实用户测试需求 TST-01~23 |
| 4 | dip1/docs/DIP1-SPEC-需求规格说明书.md |
V2.0→V2.1 | 新增 §3.10 听写只读后门功能 F-DT-001~006 + NFR-21~23 + 错误码 1006/3060/3061 |
| 5 | dip1/docs/DIP1-IMP-Code-Agent实施指南.md |
V2.1→V2.2 | 听码角色定义引用 WDE 工作手册；新增听写后门实施任务 |
3.3 工作日志更新¶
- 本条 DLG-72（本文档）
- WLG §5.1 对话记录索引 同步更新
- 协作记录 COLLAB-20260817-01 进展记录追加 DLG-72 创建条目
四、关键决策¶
4.1 消息接收规则的核心约束¶
主项目中，听云/听码仅响应 @听云/@听码 专用消息，忽略未 @ 的消息。这一约束的目的是：
- 避免上下文干扰：主项目中人类主要与听写对话，听云/听码不需要处理无关消息
- 职责聚焦：听云专注运维，听码专注代码，避免被主项目通用对话分散注意力
- 例外场景：三 AI 之间在主项目可直接互相交流，无需 @
4.2 协作记录与工作日志的边界划分¶
| 文档类型 | 定位 | 时态 | 维护方 |
|---|---|---|---|
| 协作记录 | 协作通道 | 进行时 | 听写（DT） |
| DLG/OWLG/DWLG 工作日志 | 过程留痕 | 完成时 | 各 AI 维护各自日志 |
协作记录是"正在进行时"的协作通道；工作日志是"已经完成时"的过程留痕。协作结论达成后，听写将结论同步至对应工作日志。
4.3 只读后门功能的安全约束¶
听写专用后门功能 BD-01~BD-06 的核心安全约束：
- 仅供听写使用：普通真实用户无权访问，需
dt-backdoor角色 - 只读保证：仅支持 GET 方法，不修改任何数据
- 数据脱敏：手机号/邮箱/Token 明文等敏感字段自动脱敏
- 审计留痕：所有访问写入
dt_backdoor_audit表，同步至 OWLG - 网络限制：仅允许指定 IP 段访问
- 速率限制：单 Token 每分钟 ≤ 60 次请求
- Token 独立：独立于普通用户 Token，由 TL 签发并轮换
4.4 Bug 类型区分的判定逻辑¶
| Bug 类型 | 判定特征 | 处置方 |
|---|---|---|
| 代码问题 | 后门确认配置正常但 UI/逻辑错误 | @听码（WDE） |
| 运行环境/配置问题 | 后门确认服务健康异常或配置项缺失 | @听云（WCL） |
| 混合问题 | 同时存在代码与环境问题 | @听码+@听云协同 |
| 业务规则问题 | 代码与环境均正常但行为与规则不符 | SPO/BO 决策 |
五、文档关系影响¶
5.1 新增的文档关联关系¶
| 源文档 | → 目标文档 | 关系类型 | 说明 |
|---|---|---|---|
| PMG | COLLAB | 入口指引 | PMG 沟通机制章节指向协作记录文档 |
| PMG | DT | 入口指引 | PMG 协作原则指向 DT 听写工作手册 |
| DT | COLLAB | 维护责任 | DT 工作手册 §五 定义协作记录维护职责 |
| DT | RQD-B §六 | 需求定义 | DT 工作手册 §四 真实用户测试需求落地至 RQD-B |
| DT | DIP1-SPEC §3.10 | 技术规格 | DT 工作手册 §4.4 只读后门功能规格落地至 DIP1-SPEC |
| WDE | COLLAB | 协作通道 | WDE 工作手册 §三 定义协作记录使用方式 |
| WCL | COLLAB | 协作通道 | WCL 工作手册 §1.4 定义协作记录使用方式 |
| WDE | DIP1-IMP | 角色引用 | DIP1-IMP §一 引用 WDE 工作手册通用角色定义 |
5.2 文档体系升级后的三 AI 工作手册体系¶
PMG V9.1（人机协作指南）
├── DT 听写工作手册 V1.0（docs/DT-听写工作手册.md）✨ 新建
├── WDE 听码工作手册 V1.0（dip1/docs/WDE-听码工作手册.md）✨ 新建
├── WCL 听云工作手册 V1.5（ops/WCL-听云工作手册.md）⬆️ 升级
└── COLLAB 协作记录 V1.0（docs/协作记录.md）✨ 新建
六、后续待办¶
| # | 待办项 | 责任方 | 优先级 | 状态 |
|---|---|---|---|---|
| 1 | DIP1-Schema V2.0→V2.1 同步：新增 dt_backdoor_audit 表 + RLS 策略 |
听码（WDE） | P1 | 待启动 |
| 2 | DIP1-API V2.0→V2.1 同步：新增 /api/dt/* 6 端点 OpenAPI 规格 |
听码（WDE） | P1 | 待启动 |
| 3 | 听写后门功能代码实施（§B 后端业务阶段 1 人天） | 听码（WDE） | P1 | 待启动（待 DIP1 代码启动） |
| 4 | 听云工作手册 V1.5 同步至公开文档仓（待用户指令执行 AI 特定行为 #4） | 听写（DT） | P2 | 待用户指令 |
| 5 | 听写执行首次真实用户测试（待 DIP1 后端 + 三端前端部署 UAT 环境后启动） | 听写（DT） | P2 | 待启动 |
| 6 | PJM §3.1 RACI 表同步：听写职责新增真实用户测试+协作记录维护 | 听写（DT） | P2 | 待启动 |
七、自验结果¶
本次优化共涉及 8 份文档（3 新建 + 5 修改），自验清单：
| 验证项 | 验证方法 | 结果 |
|---|---|---|
| AGENTS.md V9.1 版本号 | Select-String "V9.1" | ✅ 4 处匹配（版本号/章节标题/修订记录/底部脚注） |
| AGENTS.md 沟通机制章节 | Select-String "沟通机制" | ✅ 匹配 |
| DT 工作手册 V1.0 创建 | Read 文件 | ✅ 316 行 8 章节 |
| WDE 工作手册 V1.0 创建 | Read 文件 | ✅ 229 行 7 章节 |
| WCL V1.5 版本号 | Select-String "V1.5" | ✅ 版本号 + §1.4 + 修订记录 3 处匹配 |
| 协作记录 V1.0 创建 | Read 文件 | ✅ 220 行 5 章节 + 8 条历史协作记录提取 |
| RQD-B V1.4 版本号 | Get-Content -TotalCount 10 | ✅ 版本号 V1.4 |
| RQD-B §六 真实用户测试需求 | Select-String "TST-" | ✅ 23 条 TST 需求条目 |
| DIP1-SPEC V2.1 版本号 | Select-String "V2.1" | ✅ 版本号 + 变更说明 + §3.10 + 修订记录多处匹配 |
| DIP1-SPEC F-DT-001~006 | Select-String "F-DT-001" | ✅ 6 项功能点完整 |
| DIP1-SPEC dt_backdoor_audit 表 | Select-String "dt_backdoor_audit" | ✅ 审计表 + RLS 策略 + 索引完整 |
| DIP1-SPEC NFR-21~23 | Select-String "NFR-21" | ✅ 3 项 NFR 完整 |
| DIP1-SPEC 错误码 1006/3060/3061 | Select-String "3060" | ✅ 3 个错误码完整 |
| DIP1-IMP V2.2 版本号 | Select-String "V2.2" | ✅ 版本号 + 变更说明 + 修订记录 3 处匹配 |
| DIP1-IMP 引用 WDE 工作手册 | Select-String "WDE-听码工作手册" | ✅ 多处引用 |
| DIP1-IMP 听写后门实施任务 | Select-String "听写只读后门" | ✅ §一 技术范围 + §B 工时预算匹配 |
八、关键里程碑¶
- 本次优化完成日期：2026-08-17
- 里程碑意义：听云生产环境完全上线后，人机协作关系从「探索期」进入「规范化期」——三 AI 角色边界、沟通机制、协作通道、测试职责全面明确，为后续 DIP1 代码实施和真实用户测试奠定协作基础
- 下一关键节点：DIP1 代码启动后，听写首次执行真实用户测试（届时将使用本次新增的只读后门功能进行 bug 类型识别）
本日志记录 PMG V9.1 人机协作关系优化的完整过程。协作通道见 协作记录，相关文档变更见 PMG V9.1 / DT V1.0 / WDE V1.0 / WCL V1.5 / RQD-B V1.4 / DIP1-SPEC V2.1 / DIP1-IMP V2.2。