协作记录（Collaboration Log - COLLAB）¶

文档编号：DOC-A07 / COLLAB 版本：V1.0 创建日期：2026-08-17 最近更新：2026-08-17 维护人：听写（DT） 关联文档：PMG V9.1、DT 听写工作手册、WDE 听码工作手册、WCL 听云工作手册、WLG 工作日志

一、文档定位¶

本文档是三 AI 角色（听写 DT / 听码 WDE / 听云 WCL）跨角色协作的唯一通道，替代原来通过工作日志（DLG/OWLG/DWLG）进行协作的机制。

1.1 与工作日志的关系¶

文档类型	定位	维护方	内容
协作记录（本文档）	协作通道	听写（DT）	三 AI 之间的协作请求、进展、结论
DLG 工作日志	过程留痕	听写（DT）	主仓 AI 对话过程记录（含协作结论的留痕）
OWLG 运维日志	过程留痕	听云（WCL）	运维操作过程记录
DWLG 开发日志	过程留痕	听码（WDE）	代码开发过程记录

核心区别：协作记录是"正在进行时"的协作通道；工作日志是"已经完成时"的过程留痕。协作结论达成后，听写将结论同步至对应工作日志。

1.2 支持的协作场景¶

主项目协作：三 AI 在 hk2026 主项目中互相交流（听写↔听云↔听码）
子项目协作：子项目（ops/dip1）AI 与主项目 AI 跨项目协作
人类触发协作：人类在主项目或子项目中通过 @ 标记触发特定 AI 协作

1.3 适用范围¶

听写（DT）、听码（WDE）、听云（WCL）之间的所有协作
协作内容包括但不限于：bug 处置、需求澄清、配置变更、文档同步、测试报告、跨项目依赖

二、使用规范¶

2.1 条目格式¶

每条协作记录采用以下格式：

### COLLAB-YYYYMMDD-NN | {主题简述}

- **发起方**：{DT/WDE/WCL}
- **接收方**：{DT/WDE/WCL}（标注 @听写/@听码/@听云）
- **协作类型**：{Bug处置/需求澄清/配置变更/文档同步/测试报告/跨项目依赖/其他}
- **来源**：{主项目/ops/dip1}
- **状态**：{open/in_progress/blocked/closed}
- **发起时间**：YYYY-MM-DD HH:MM
- **关闭时间**：YYYY-MM-DD HH:MM（closed 时填写）

**协作内容**：
{详细描述协作请求、背景、预期目标}

**进展记录**：
- YYYY-MM-DD HH:MM {进展内容}
- YYYY-MM-DD HH:MM {进展内容}

**协作结论**：
{closed 时填写最终结论}

**留痕同步**：
- DLG-XX / OWLG-XX / DWLG-XX（同步至对应工作日志）

2.2 @ 标记规则¶

标记	接收方	触发场景
`@听写`	听写（DT）	需要文档撰写、业务规则澄清、真实用户测试
`@听码`	听码（WDE）	需要代码修复、技术实现、API 变更
`@听云`	听云（WCL）	需要运维操作、配置变更、生产环境排查

2.3 状态说明¶

状态	含义
`open`	协作请求已发起，待接收方响应
`in_progress`	协作进行中
`blocked`	协作受阻，需升级或外部输入
`closed`	协作已完成，结论已记录

2.4 追加规则¶

新条目追加在 §三顶部（最新在上，便于查看最新协作）
条目编号：COLLAB-YYYYMMDD-NN（NN 为当日序号，从 01 开始）
状态变更：直接在原条目更新状态字段和进展记录，不新建条目
关闭同步：closed 时须填写协作结论和留痕同步（对应工作日志编号）

2.5 维护责任¶

维护人：听写（DT）独立维护本文档
其他角色：通过 @ 标记发起协作请求，由听写回填进展和结论
定期清理：每月 1 日由听写归档上月已 closed 的条目至 §四历史归档

三、协作记录¶

最新条目追加在顶部。条目按 COLLAB-YYYYMMDD-NN 编号。

COLLAB-20260817-01 | 人机协作关系优化（本次）¶

发起方：人类
接收方：@听写
协作类型：其他（人机协作关系优化）
来源：主项目
状态：closed
发起时间：2026-08-17
关闭时间：2026-08-17

协作内容：听云生产环境完全上线后，优化调整人机协作关系：① 明确主/子项目沟通机制（@ 规则）；② 听写新增真实用户测试职责；③ 建立协作记录文档替代原日志协作机制；④ 配套新建 DT/WDE 工作手册，WCL 工作手册增加沟通机制章节。

进展记录： - 2026-08-17 完成 AGENTS.md V9.0→V9.1（沟通机制章节+听写新职责） - 2026-08-17 完成 docs/DT-听写工作手册.md V1.0 创建 - 2026-08-17 完成 dip1/docs/WDE-听码工作手册.md V1.0 创建 - 2026-08-17 完成 ops/WCL-听云工作手册.md V1.4→V1.5（§1.4 沟通机制） - 2026-08-17 完成 docs/协作记录.md V1.0 创建（本文档） - 2026-08-17 完成 RQD-B V1.3→V1.4 新增 §六真实用户测试需求 TST-01~23 - 2026-08-17 完成 DIP1-SPEC V2.0→V2.1 新增 §3.10 听写只读后门 F-DT-001~006 + NFR-21~23 + 错误码 1006/3060/3061 + dt_backdoor_audit 审计表（功能点 213→219） - 2026-08-17 完成 DIP1-IMP V2.1→V2.2 听码角色定义引用 WDE 工作手册 + 新增听写后门实施任务 - 2026-08-17 完成 DLG-72 工作日志创建 + WLG V7.0→V7.1 索引同步

协作结论：本次人机协作关系优化全部 8 项任务完成：① PMG V9.1 沟通机制章节；② DT 工作手册 V1.0；③ WDE 工作手册 V1.0；④ WCL V1.5 §1.4 沟通机制；⑤ 协作记录 V1.0（含 8 条历史协作提取）；⑥ RQD-B V1.4 §六真实用户测试需求；⑦ DIP1-SPEC V2.1 §3.10 听写只读后门；⑧ DIP1-IMP V2.2 听码角色定义独立化。三 AI 工作手册体系成型（DT/WDE/WCL），协作记录替代原日志协作机制，听写新增真实用户测试+只读后门功能定义就绪。

留痕同步： - DLG-72（人机协作关系优化）

四、历史归档¶

每月 1 日由听写将上月已 closed 的条目归档至此章节。

4.1 历史协作记录提取（V1.0 初始化）¶

以下条目从历史工作日志（DLG-65_71/OWLG-0911/DWLG）中提取的三 AI 协作内容摘要，用于初始化协作记录文档。完整过程记录见对应工作日志。

来自 DLG-65（2026-08-09）DIP1 原生 App 方案升级¶

协作方：人类 ↔ @听写
协作内容：用户发现 PWA 体验不足，要求升级为 React Native 原生 App + 跳过阶段 1 直接实施阶段 2
结论：DIP1 全套文档（15 份）升级至 V2.0，技术栈对齐 React Native + Expo + NativeWind
状态：closed
留痕：DLG-65

来自 DLG-66（2026-08-10）DWLG-02 修正 + 公开同步部署¶

协作方：@听写 ↔ @听码（DWLG-02 修正）
协作内容：听码工作日志补充人工业务测试过程记录；公开同步部署首次全流程走通
结论：DWLG-02 修正完成；MkDocs 构建部署验证通过
状态：closed
留痕：DLG-66 / DWLG-02

来自 DLG-67（2026-08-11）听云工作手册 V1.2 + 文档自主权¶

协作方：@听写 ↔ @听云
协作内容：听云工作手册升级 V1.2，新增文档自主权说明；AGENTS 导航表新增 ops/ 运维板块
结论：WCL V1.2 发布；公开同步导航结构调整
状态：closed
留痕：DLG-67 / OWLG-09

来自 DLG-68（2026-08-11）公开同步纳入听码文档¶

协作方：@听写 ↔ @听码 ↔ @听云
协作内容：同步脚本 V2.6 扩展，新增 ops/ 和 dip1/docs/ 扫描范围；双重排除前缀 ops/private/ + ops/worklog/ 防止敏感内容泄露；听码 dip1/docs 首次纳入公开范围
结论：听码文档首次纳入公开同步；安全排除规则修复
状态：closed
留痕：DLG-68

来自 DLG-69（2026-08-11）公开同步一级分类调整¶

协作方：@听写 ↔ @听云
协作内容：主文档一级分类重排（PMG/RQD/QSV/CPT/MDS/OPS/TND/dip1 八大类）；经用户确认 DIP1 工作日志恢复公开
结论：V2.8 移除 dip1/docs/worklog 排除前缀；url_map MANUAL_MAP 批量扩展
状态：closed
留痕：DLG-69

来自 DLG-70（2026-08-12）公开同步 V2.9 新增 DIP1 用户手册¶

协作方：@听写 ↔ @听云 ↔ @听码
协作内容：新增 DIP1 用户使用手册 + DIP1 管理员 7 操作手册 + 客服 6 工作手册；V2.9 安全补丁：同步脚本新增 ops/deploy/ 排除前缀（防止 hosts 修改脚本/Caddyfile/启动脚本含内网 IP 泄露）
结论：公开镜像仓 3 次 commit 221 文件；MkDocs 构建 242 资产部署 Cloudflare Pages
状态：closed
留痕：DLG-70

来自 DLG-71（2026-08-14）公开同步 V3.0 业务知识库 + 客服 V2.0¶

协作方：@听写 ↔ @听云
协作内容：业务知识库 6 文档（公司背景/业务知识/实时状态/AI人设/扩展业务）+ 客服手册 V2.0（2 新增 AI 服务架构/训练语料 + 6 重构 AI 拟人化客服）+ 管理员 5 大手册完善 + Cloudflare→阿里云 ECS 架构迁移
结论：主仓 8f2bb4e（48 文件 6596 新增行）；公开镜像仓 409eae4（25 文件 5125 新增行）；MkDocs site/ 251 文件就绪
状态：closed
留痕：DLG-71 / OWLG-11

来自 OWLG-11（2026-08-14）Cloudflare 凭据配置¶

协作方：人类 ↔ @听云
协作内容：用户需要配置 Cloudflare 凭据（CLOUDFLARE_ACCOUNT_ID + CLOUDFLARE_API_TOKEN）以执行最终部署步骤
结论：凭据配置完成，部署执行成功，生产环境上线可用
状态：closed
留痕：OWLG-11

五、修订记录¶

版本	日期	修订人	修订内容
V1.0	2026-08-17	DT	首版创建（承接 PMG V9.1 人机协作关系优化）：① 文档定位（替代原通过 DLG/OWLG/DWLG 日志协作的机制）；② 使用规范（条目格式、@ 标记规则、状态说明、追加规则、维护责任）；③ §三协作记录区（当前 COLLAB-20260817-01 人机协作关系优化 in_progress）；④ §四历史归档区（从 DLG-65_71/OWLG-0911/DWLG 提取 8 条历史协作记录摘要，用于初始化）

本文档为三 AI 协作通道，由听写（DT）维护。对齐 PMG V9.1 沟通机制。工作日志见 WLG / OWLG / DWLG。