Agent-System-Documents/docs/proposals/2026-10-11-rdm-template-dialog-generation.md

title, type, date, execution, artifact_contract, product_contract_source

title	type	date	execution	artifact_contract	product_contract_source
RDM 基于模板与两树一网的对话文档生成方案	feat	2026-10-11	code	ce-unified-plan/v1	legacy-requirements

RDM 基于模板与两树一网的对话文档生成方案

修订：r1.1，首批顺序已确认，其余方案待用户评审。需求负责人：weichen；方案编制：Codex；实施负责人：待立项指定。 本轮授权终点是调查和方案；业务实施、模板迁移、模型试验、部署与运行验收均为 NOT_RUN。 本文件为模板生成子方案正文；总体范围、最新现状及优先级以最终目标完整交付方案为准。任务记录：Dev .task/feature-rdm-template-dialog-plan.md。 本案资产/代码表固定于 RDM 0081628a；本轮期间 d8d7e743 已新增项目绑定、部分命令授权和管理员引导修复，增量差距见总体方案，不再把旧表当作最新全系统状态。 路径前缀约定：RDM: 指 Agent-System-RDM；Legacy: 指旧 Agent-System；Dev: 指 Agent-System-Dev。

Goal Capsule

用户在项目对话中说出需要编制或更新的文档，系统选用明确版本的模板，从该项目有权使用的知识与文档中组织依据，生成可审阅、可追溯、可继续修改的草稿；编制人确认后形成内部版本，再经三权流程产生可导出的正式文档。

推荐在已有 RDM 插件内补齐生成闭环，复用基座的模型、任务、卡片和工件能力。模板决定文档结构与格式；笔记树提供知识；文档树承载文档及章节版本；追溯网记录依据、派生与影响关系。

本方案涵盖 69 类历史文档资产的接入路线，首批用项目建议书和竞品分析验证完整链路，再扩展全部文档。此顺序已由用户于 2026-10-11 明确确认：“先打通项目建议书、竞品分析，再扩展全部文档”；需求、设计、验证和其他文档族的后续批次仍待细化。 实施前先评审本方案及与既有两树一网方案的任务分工；任何设计批准不自动包含迁移、发布、合入或部署授权。

---

Product Contract

Problem Frame

系统确实有大量历史模板，但当前 RDM 的文档类型目录、模板注册表、章节树、对话命令和导出器尚未形成一致的产品路径。 需要解决的是“用户能在对话中可靠地编制整份体系文档”，不能以模板文件存在、命令注册或模型返回一段正文作为完成标准。

Current State

调查为 SELF·源码与资产检查，未查询业务数据库、未登录应用、未做真实模型或浏览器验收。 命令原始输出和对象 SHA 经 make evidence 记录于任务卡；静态控制流推导与运行结果分开。

对象	本次调查基线
Dev	95992d751f0a6ea8e345109dbb6b9367d9055e92
Dev Backend	3def5259023806a49ab84f885b7d220333cccde6
RDM	0081628a10ec48a36537c6eced11a57439c986fa
旧 Agent-System	ed4e17c81974c6d2b126fedb1ca4ed1e2c6c207f
RDM Backend pin	421fee81c314c05530bc809e224b5d0818ec3472

Dev 与 RDM 实际依赖组合不同；不能以 Dev 最新扩展已存在推断下游已接通。

资产/能力	盘点结果	含义
旧 Markdown 业务模板	69 份：bd 7、rd 60、pm 1、tm 1	是可复用的历史内容资产
旧报价 XLSX	1 份 templates/xlsx/cdo_quote.xlsx	单独登记，不并入 69 个 Markdown 文档类型
RDM 文档类型字典	69 个，与旧模板文件名集合一致	目录已迁入，不等于模板已迁入
RDM 注册模板	4 个，均为 v1	项目建议书、竞品分析、周报、评审纪要
已绑定文档类型	3 个：rd_proposal、bd_research、rd_design_plan	其余 66 种未绑定注册模板
RDM 自举文档树	10 份文档、22 个章节	是一个自举项目结构，不是 69 类的通用实例化
章节生成	Compose 调用 Host.Complete	已有真实模型调用路径，运行质量未验证
写入/审签/导出	有 apply、版本、三权域模型和 DOCX 代码	需补端到端契约与运行验收

资产依据：Legacy:templates/docs/、RDM:internal/domain/data/labels_seed.json:68、RDM:docs/templates/registry.yaml:4、RDM:docs/structure/rdm-self.yaml:1。

模板	绑定类型	当前用途与问题
review-minutes@v1	bd_research、rd_design_plan	评审纪要，不应默认替代调研/计划正文
weekly-report@v1	rd_proposal	周报，不应默认替代项目建议书
project-proposal@v1	rd_proposal	业务正文模板，含内容要求与排版说明
competitive-analysis@v1	bd_research	业务正文模板，含内容要求与排版说明

当前关键缺口：

ID	源码事实或静态推导	对本方案的影响
G1	两条编写 intent 只调用 templates.for，且传 project-proposal-v1/competitive-analysis-v1；该接口要求字典 docType（plugin.go:212–230，templates.go:127–138）	自然语言入口参数不一致，尚不是完整编制入口
G2	RDM 命令未声明 exposeAsTool；实际 pin 的 EXT-14 仅投影显式声明命令（pins/.../internal/cmdbus/cmdbus.go:47）	注册命令不等于模型可调用；须核对实际工具目录与 schema
G3	Compose 模板开关可缺省；按第一个适用 key 选模板，读取失败静默返回空串（compose.go:17、63–85、150）	可能选周报/纪要，或者无模板继续起草
G4	单章提示词注入整份模板；章节结构另存 YAML，文档/版本无 templateKey/version/hash（compose.go:35–47，doctree.go:29–65）	模板、章节和历史无法一致固定
G5	Compose 返回即时内容；apply 重新检索，固定 topK=8；skip 旧依据参与起草却不能进入 accepted，Basis 直接取 accepted（draft.go:93–108，writegate.go:158–186）	候选漂移、旧依据丢失、无法固定确认对象
G6	写版本后逐条建 supports 边（writegate.go:186 起）	中途失败可导致正文与追溯不一致；复用既有原子事件工作项
G7	draft/compose/apply 仍可空项目回退，处理器缺少对应编制人检查（runtime.go:106，plugins/rdm/plugin.go:1645 起）	上下文、生成和提交均须领域授权；只靠宿主 owner 不够
G8	approve/reject/final schema 必填 reviewer/actor/approver，处理器却拒绝这些参数（plugin.go:295–320、945–1001）	总线契约矛盾；必须从真实分发入口验证审签
G9	模板从工作目录或编译时源码路径读取；构建仅生成二进制（templates.go:45，prompts.go:42–52，Makefile:40）	需验证安装包脱离源码仍能加载模板
G10	DOCX renderer 接收标题与章节，未消费模板排版规格；导出取章节当前版本（docx.go:155、298–306）	排版要求未兑现，正式版需绑定整文批准快照

这些是实施前应验证和修复的具体断点，不声明现网已经复现。

Requirements

ID	用户可见要求	来源	验收判据
R1	对话中查询、选择并预览模板	SR-C2、SR-E6	显示用途、版本、适用类型和可用状态；不混淆类型数量与模板数量
R2	一句话编制整文或指定章节	UR-11、F4、SR-E4	确定当前项目、目标文档、操作范围及模板后进入生成任务；歧义时澄清
R3	文档结构来自固定模板	SR-C1/C2、M5	文档绑定已发布模板版本；每章有稳定标识、内容要求、检索条件及顺序
R4	只使用当前有权使用的依据	SR-G2、U0 R09/R21	跨项目、私人未发布、待裁定、撤销资料不能进入共享生成正文
R5	每段事实可回到实际来源	UR-11、SR-D1/D6、08 R1–R5	引用能定位切片/结论/已有文档的准确版本与锚点，历史可复核
R6	缺证据明确标出，冲突由有权者裁决	F4、SR-B8/B9、U0 D4	不编造内容；文档层选择不改变项目共享结论；未裁决冲突不混入有效事实
R7	草稿提案经确认才改正文	F-B、SR-C4/C6	展示新增/更新/冲突与差异；确认对象固定；未接受内容不写入
R8	保留已有正文与依据，支持增量更新	UR-05、SR-C6	只修改用户选择范围；保留、增加、删除的依据与最终正文一致
R9	编制、审核、批准职责与版本固定	SR-C7/C8、U0 D2/D5	非编制人不能生成/改正文；提交锁定；审签绑定完整文档版本
R10	长任务可查看、取消、恢复	SR-F4、SR-B10、U0 R21	刷新/重启后看到同一任务；重复点击不重复生效；失败章节不冒充整文完成
R11	输出可打开、下载、追溯的 DOCX	U0 R14、10 号定稿决议	内容、格式、引用及版本与选定草稿/正式快照一致；下载再次鉴权
R12	旧模板逐份纳入可管理的目录	03 §7、SR-C2	69 份都有资产处置记录；已发布/待整理/不适用分别显示，不能批量冒充可用
R13	对话、卡片、工作区使用同一状态	SR-E6、U0 D7、DESIGN.md	收起右栏仍可完成编制；陈旧卡片不能批准新内容；按 seq 丢弃旧事件

R1–R13 为方案候选范围，人工评审均未完成。R12 的登记全覆盖与各模板运行验收是两个阶段。

User Flow

示例：“用已有资料生成这个项目的设计开发任务书。”

1. 从可信会话解析项目，辨认是新建、更新、只改某章还是查询；“总结一下任务书”不能触发写入。
2. 查现有文档与职责。已有同类文档时确认更新对象，缺模板或有多个正文模板时给出可选项，不随意选第一项。新文档无职责时保留请求为“等待职责分配”；有权负责人可在对话中指定异人的编制/审核/批准角色，其他成员可提出分配请求，由负责人处理。若当前用户不是编制人，则显示当前职责并允许转交编制请求，不把原私聊全文传给他人。职责就绪后由指定编制人接续同一目标、重验权限并确认启动，负责人不自动获得编制权。
3. 展示一张编制卡：文档名称、模板版本、章节范围、使用的资料范围、将创建草稿的效果。确认后启动任务；已明确提供的信息不重复询问。
4. 按章准备依据，必要时集中呈现冲突双方、来源、建议及理由，由相应角色裁决。
5. 后台逐章起草与校验；对话即时显示计划和阶段，允许继续讨论或取消。无材料章节注明待确认。
6. 完成后提供正文预览、逐章差异、来源和未决项；编制人可要求“只重写第二章”“采用这个依据”“保留现有市场分析”。
7. 编制人采纳所选提案后产生内部版本；提交审核时执行完整性检查并锁定完整文档版本。
8. 审核人和批准人分别以真实身份确认。完成后可导出 DOCX，继续通过对话查看来源或发起受控修订。

编制卡、冲突卡、差异采纳卡和审签卡是不同决策，不合并成一次模糊的“确认全部”。同一决策可以在对话与工作区投影，使用同一服务端对象。 编制过程中说明空缺不等于强制补齐所有字段；沿 SR-C5，资料上传阶段不推送缺项清单，正式完整性门禁只在提交审核/申请推进阶段执行。

Scope Boundaries

本期设计复用现有模板，先完成内容与格式结构化、生成和受控落盘，再分批扩大覆盖。 标准模板替换沿 F-10，待系统测试后由用户提供；不擅自下载其他“官方模板”替代旧资产。 不把合规边有来源等同于满足具体法规；法规结论继续走既有双通道及人工复核，本方案不作标准符合性判定。 飞书对接、变更流程引擎、跨项目自动取材、无人审批、所有文档自动重写不纳入本次实施建议。 最新两树一网可视化方案已单列，生成能力不等待全局大图；文档引用浏览与项目审计中心沿各自权限开放。

---

Planning Contract

Alternatives

路线	收益	代价及结论
复用 RDM，补齐模板/候选/整文契约	保留已有知识、版本、审签与追溯，职责清楚	推荐；先修跨层契约，再扩模板
将旧生成系统整体搬回新系统	可快速得到旧模板和流程	会带回任务键绑定、多份目录及旧状态治理，不采用
把整份模板和检索结果直接交模型输出文件	演示快	难保证固定依据、增量更新、三权和恢复，只能用于隔离试验

KTD1. Template Contract

将“文档类型”“模板资产”“项目文档实例”分开管理。 文档类型保留兼容键；模板使用 templateId + version + hash；文档实例使用项目内稳定 docId。 注册表是模板权威入口，避免再增一套手写目录；缓存和索引只能由它生成。

模板层	核心内容	执行方式
资产元数据	名称、用途（正文/纪要/汇报）、别名、适用类型、版本、生命周期、来源 SHA	可查询、受控发布；禁止字典序判断版本新旧
内容结构	稳定 sectionKey、标题层级、内容要求、表格列、条件适用、允许缺省	编译为文档树实例与内容校验规则
依据规则	共享标签条件、资料类型、强制输入、可用结论/文档类型	编译检索计划；保留人工选择与审阅
格式规格	页型/页边距、字体、标题编号、页眉页脚、表格、引用呈现	由确定性 DOCX renderer 消费，不靠模型猜排版
发布清单	schema 版本、资产哈希、依赖字典、审批记录、兼容范围	安装包自包含；运行时清楚报告缺失或不兼容

模板生命周期建议为 draft→published→retired。模板先评审再发布，再实例化文档树；同一已发布版本不可原地改写。 首期内置共享模板及默认绑定只由获批的仓库发布流程变更，模板发布权不继承文档编制权。普通编制人只能选择已发布版本。后续用户上传模板只形成待评审候选；运行时发布/退役/改默认的责任主体与项目或共享作用域须另行评审后开放，不能借上传模板修改其他项目规则。 普通编制人只选已发布版本，不因生成一次文档重复审批模板。退役不删除历史快照。 默认绑定使用“docType＋purpose＋显式 default”；候选多于一个且无明确默认则询问；用户指定模板优先，但须校验适用性。 用户指定“按模板生成”时，模板缺失/失效须停止该路径并解释，不能静默按自由文本起草。 更新模板不自动改已有文档；迁移章节映射、内容影响和格式变化以单独提案确认。旧文档保持原 templateRef。

KTD2. Template Migration

建立 69 份历史模板的逐项台账：原路径与 SHA、对应类型、目标 key、用途、章节数、内容差异、格式要求、处置结果、发布与验收状态。 先保全原件与哈希，再拆出正文要求、管理信息、格式约束。追溯表、签署记录、缺项登记、已有材料摘要等管理信息进入相应台账或附属视图，不直接复制成正文章节。 模板提取可以由模型提出候选，但发布结构与章节映射须人工审核；不因 Markdown 有二级标题就认定它是合格模板。 10 份自举文档逐份做语义映射，避免仅凭原 docType 将“实施推进方案”套成“项目建议书”。已有内容只生成映射候选，不覆盖。 建议发布包内置受控资产 bundle；后续用户模板使用同一校验/发布协议，从受管目录或存储载入，禁止依赖编译机器的源码路径。

KTD3. Three Structures and Context

每项目独立解析两树一网；共享模板通过固定版本引用，不建立跨项目业务边。 笔记树切片及结论提供内容；文档树章节提供输出目标、既有内容及版本；追溯网提供已有依据、取代关系、冲突和受影响对象。

检索先判权限和资料发布状态，再检索和排序，不能先读全库再让模型筛项目。 章节强制依赖、现版有效依据、已选结论及其原始 basis 应完整保留；其余素材用标签、语义、图关系合并、去重和有界排序。 语义路须传确定项目；知识 chunk 到领域切片建立稳定映射，不能同一原件只取第一个 slice。 超出上下文预算时分章节、分资料批次处理并保留覆盖账本；不得以 topK 截断后声称“已查全部资料”。检索降级向编制人可见。 新内容优先是排序线索，不自动推翻已生效结论；已废止、待裁定资料只能用于有权限的冲突说明，不能作为已生效事实。 私人对话原文不因关联项目就共享。模型从对话提炼的资料须沿既有发布/相关性边界进入共享知识；私有资料确需用于共享文档时，先获得明确发布授权。 模板、上传原文和引用资料是任务数据，不得提升为系统指令或扩大工具权限。

KTD4. Durable Generation Objects

建议增加四类持久对象，字段名为设计候选，不是已发布 API：

对象	固定什么	主要作用
GenerationRun	项目、文档、编制人、会话、范围、templateRef、章节基线、知识水位、模型/提示词与检索版本	任务进度、恢复、成本与产出可追溯
ContextManifest	选中来源 ID/版本/hash/锚点、授权/发布依据、保留与排除集合、冲突裁决	解释实际给模型的材料，不保存隐藏推理
SectionProposal	sectionKey、baseVersion、结构化正文、段落引用、差异、空缺、校验结果、状态	供人修改/比较/采纳；不改变生效正文
DocumentRevision	全部章节版本集合、模板与布局版本、内容/hash、依据集合、审批快照	固定整文审签和导出，防止“各章最新”拼装

段落引用持久化为稳定对象引用，短编号仅用于显示，必须保留编号映射。来源包括 slice、结论及依据、受控文档版本、模板版本、明确授权的外部材料。 引用存在性、项目归属、版本和采纳范围由服务端校验；引用能打开不证明语义支持，另用模型检查加人工抽验判断事实是否被证据支撑。 保留旧依据、增加新依据、移除依据分别记录，最终 Basis 从实际成文引用聚合并校验。用户取消某素材后，相关事实必须删除、重写或改为未证实，不能只删脚注。 人工修改提案后重新计算 hash 并校验；内容、选材或目标版本变化使旧确认失效。

KTD5. Generation and Human Decisions

起草遵循“检索并固定输入→模型组织正文→结构/引用/冲突检查→持久提案→人工采纳”，允许模型自主拆任务和选择可用工具，受控写入口保持确定性。 现有 Compose 和 Gate 应重构复用，修正“仅有 skip 旧依据时被视作无素材”、旧依据不能保留等路径，不另起第二条正文写入链。 模板内容要求决定章节任务；不能把整份模板重复塞入每一章。独立章节可并行，共享术语/数据依赖按章节依赖顺序生成，最终做全篇一致性检查。 无法证实的数据不得补成事实。临时草稿允许“待确认”标记；正式版不能含未处理的必需项，处理方式是补证、明确不适用及有权确认，不能改规则绕过。 冲突分两层：编制人决定本文档引用哪条依据；改变项目共享结论由项目负责人或指定知识责任人裁决。后台模型不自动做这两个决策。

KTD6. Authorized Atomic Apply

从可信请求身份解析 actor，不接受前端 actor/reviewer/approver 自报。所有生成、读取、确认、导出及旧命令统一经过领域授权。 生成开始、关键读取、恢复、结果投递和最终采纳时重验项目与职责；管理员/负责人不因角色高就自动拥有文档编制权。 apply 接收固定 proposalId、预期章节/文档版本、采纳范围和幂等键，不再重跑检索重建“当时的候选”。 事务内验证权限、版本和引用，原子提交版本、依据/追溯边、提案状态和领域事件；提交后更新投影。跨库宿主审计通过可靠 outbox 投递。 多章节整文采纳默认同一业务事务；用户主动选择部分采纳时，生成包含未改章节原版本的新 DocumentRevision，清楚标记剩余未采纳章节。 部分采纳先构造实际将保存的新旧章节组合，重新校验章节依赖、共享术语及关键指标一致性；后继章节依赖未采纳的前置改动时暂停采纳，列出必须一同处理的章节供编制人选择。校验绑定该组合的 hash 与版本；事务提交前再核对版本，不能沿用整份候选曾经通过的检查。 模型调用不占持久写锁；候选失效返回具体变化，保留提案供比较，禁止覆盖新版本或静默再生成。 断连/超时先按幂等键查询提交结果，再决定是否重试。跨库工件生成与领域提交不冒充一个事务，以导出任务和可恢复映射协调。

KTD7. Conversation Tools and UI

RDM 提供模板查询/预览、文档实例化、生成准备/启动/状态/取消、提案查看/修改/采纳、提交审核、审签与导出能力；名称和 schema 在实施契约中固定。 先统一 docType/templateId/version 含义及 schema 与处理器身份约定，再将需要模型访问的命令显式投影到工具目录；保留确定性命令入口用于卡片与测试。 RDM 编制 skill 提供渐进说明与编制规则，业务权限与确认不靠提示词约束。skill 的新增/变更纳入真实模型任务级对照。 审签决策由指定人通过认证确认产生，Agent 只准备与呈递，不因用户一句模糊“继续”批准未展示的新版本。 基座负责通用模型路由、运行/卡片、工件字节、资源授权执行；RDM 负责模板、领域项目、资料发布、两树一网、提案、三权与版本。 公开面不足时按 RDM AGENTS 四要素提扩展申请；禁止下游导入 Backend internal 或修改 pins。

界面沿 Dev:DESIGN.md：对话为完整主入口，右栏“工作”看任务/待办，“文件”看文档；同一工件只有一个预览落位。 对话展示模板名/版本、章节进度、需处理事项、最终文件和来源入口，不直接倾倒 slice ID、事件 JSON 或内部工程术语。 一个服务端对象拥有异步状态，对话与工作区只作投影；按 seq 处理事件，刷新从服务端恢复，陈旧卡片显示已过期及原因。 UI 使用令牌、MotionKit、Collapsible 和安全 HTML 原语；无额外第四栏或新的平行预览器。

KTD8. Review and Export

现有审签主要按章节实现；推荐面向用户升级为文档级职责与审签，章节审签仅作为可选内部协作步骤，不要求用户为每章重复三权操作。 文档提交时冻结 DocumentRevision：章节版本、模板、内容要求、依据及当时职责。后续撤权或职责变化使待处理授权失效或要求重新提交，不能接续旧签名批准新版本。 审核期间所有正文入口拒写；驳回回编制态产生新内部修订，不提前增加正式版号；原正式版在新正式版批准前仍可查看。 旧章节职责、审签和正式版作为原始历史保留，不自动合并为文档级授权或“已批准整文”。同一旧文档的章节可能由不同人编制/批准：转入新流程前由有权负责人明确文档职责；迁移清单列出旧活动审签，经有权人确认撤回后重提，未完成该处置的文档保持旧态只读查询并暂不启用新整文流程。首个文档正式版须重新完成整文审签；历史导出明确标识为旧章节版本集合，不冒充整文批准。 草稿导出清楚标记草稿。正式版导出只读取批准快照，不读取当前各章最新；正文、引用附录、签署元数据与格式使用同一快照。 DOCX 由结构化内容和布局规格确定性渲染，保存 artifact 与文档版本的关联。导出生成、预览、下载分别鉴权；权限撤销后已有任务不得继续泄露结果。 允许异步重试导出，不因文件生成失败回滚已获批准的文档状态，也不把导出文件反向作为领域内容权威。

High-Level Technical Design

flowchart TB
  U[项目对话或工作区] --> A[可信项目与角色解析]
  A --> T[固定模板与文档目标]
  T --> C[按章准备依据快照]
  N[笔记树与有效结论] --> C
  D[文档树及原版本] --> C
  G[追溯网与冲突] --> C
  C --> M[模型起草与确定性校验]
  M --> P[持久提案和差异]
  P --> H[编制人确认]
  H --> W[原子写版本与追溯]
  W --> R[冻结整文审核与批准]
  R --> E[按快照生成 DOCX]

stateDiagram-v2
  [*] --> Preparing
  Preparing --> AwaitingDecision: 目标或冲突待确认
  AwaitingDecision --> Preparing: 有权人决定
  Preparing --> Generating: 输入固定
  Generating --> Validating
  Validating --> Proposed: 校验通过
  Validating --> NeedsRevision: 检查发现问题
  NeedsRevision --> Generating: 修订受影响章节
  Proposed --> Applied: 编制人采纳及事务成功
  Proposed --> Stale: 依据权限或目标版本失效
  Generating --> Failed
  Generating --> Cancelled
  Failed --> Preparing: 重验后恢复

生成运行状态与文档审批状态分开。Applied 仅表示形成内部内容版本；随后仍需“编制中→审核中→待批准→已批准”，驳回回编制中，批准绑定固定整文快照。 取消只停止未完成任务，不撤销已经确认提交的版本；状态未知时先查事务结果。恢复重新取得受限 Host 与权限，不能序列化旧凭据或长期复用旧 Host。

Dependencies and Assumptions

与 两树一网集成方案 r1 复用项目绑定/授权、原子事件、历史重放和可读引用能力，不建立第二套项目或审计服务。 该方案文档记录已批准，不能据此声称实现已经完成；本生成方案把相关能力作为实施前置条件，是否复用已合入实现以启动时源码和证据为准。 与 多人协作存储方案 复用持久任务、事务与团队存储方向。RDM 仍需自己的事件/领域存储适配，不因基座使用 PG 就宣称 RDM 已支持多实例。 近期建议单实例完成两项目隔离和三人职责验收；团队多实例单独通过并发、恢复与迁移验证后开放。 基线更正：RDM requirements/README 已确认相关 V2.2 正文于 2026-10-09 合入定稿；正文残留“待评审”不推翻该裁定。本案新增实现契约仍待用户评审。

---

Implementation Units

以下为待批准的分期，U-ID 只在本方案内有效；责任模块已明确，人员在立项时确定。每阶段均按 policy/delivery.md 人工评审，允许阶段内根据证据迭代。

U1. Contracts and Asset Ledger

目标：形成完整资产清单与可运行入口的修复设计。覆盖 R1/R2/R9/R12。 范围：RDM templates.go、plugins/rdm/plugin.go、labels_seed.json；新增资产迁移台账、总线契约测试，复用 templates_test.go/templates_v01_test.go。 措施：记录 69+1 旧资产；统一类型/模板键、默认用途和真实身份字段；声明工具投影；确认现有项目/权限前置工作由哪项任务交付。 验证：两条中文编写请求匹配合法文档类型；同类型周报不抢正文模板；审签经总线可达且伪造身份拒绝；查询/总结不得生成；69 类处置无遗漏。 出口：资产及契约评审完成；未把全部模板标为可用。无需先搬迁所有正文。

U2. Published Template and Document Instantiation

目标：模板成为结构与排版的唯一版本依据。依赖 U1；覆盖 R1/R3/R12。 范围：RDM docs/templates、rdmapp/templates.go、structure.go、domain/doctree.go、payloads.go/replay.go；新增 template_contract_test.go、template_instance_test.go、发布包资产检查。 措施：发布生命周期、稳定章节键、固定 templateRef、显式默认、版本比较、资产 bundle；两个已有业务模板先结构化，旧自举树做映射而非覆盖。 验证：v2/v10 顺序正确；缺模板明确失败；不同用途不误选；模板新版本不改历史文档；同名章节、可选章节、模板退役、无源码安装包启动均覆盖；普通编制人不能发布共享模板或修改其他项目默认。 出口：从两个已发布模板产生正确文档树，内容要求与导出规格可供后续步骤读取。

U3. Context Snapshot and Durable Proposal

目标：固定依据并可恢复地起草整文。依赖 U2 及项目授权/读取边界；覆盖 R2/R4/R5/R6/R10。 范围：RDM draft.go、compose.go、fbhost/adapter.go、domain/fb/writegate.go；新增 generation.go、proposal_store.go 及相应测试，具体命名实施时固定。 措施：持久 Run/ContextManifest/Proposal；精确来源映射；章级计划与预算；固定模型/提示词版本；空缺与冲突单列；持续进度与取消/恢复。 验证：无素材、只有旧依据、只有冲突、多切片同原件、跨项目/私有资料、超长上下文、模型失败、检索降级、取消、重启、撤权，均有真实可观察结果。 出口：两份文档可形成整文候选，逐段回到稳定来源，刷新和重启不丢；尚未自动写生效正文。

U4. Confirmed Atomic Document Revision

目标：采纳提案后内容、版本和追溯保持一致。依赖 U3 及两树一网原子事件能力；覆盖 R5/R7/R8/R9。 范围：RDM draft.go、domain/fb/writegate.go、doctree.go、eventlog.go、replay.go、review.go；新增 proposal_apply_test.go、document_revision_test.go、故障重放测试。 措施：固定 proposalId、CAS、幂等、保留/新增/删除依据；整文版本清单；统一编制权限；修正文档级审签；旧入口适配同一服务。 验证：两个标签页竞写、确认前版本变化、撤回依据、取消引用却残留事实、重复点击、写版本后建边失败、提交审核后旧卡片执行、部分采纳与整文导出一致性；只采纳后继章节而保留旧前置章节须被依赖校验拦下；迁移中同文档不同章节职责/正式版、审核中记录不得自动转成整文授权与批准。 出口：事务全成或全败；重放还原同一版本和引用；旧候选不会覆盖新内容。

U5. Chat Workflow and DOCX Delivery

目标：用户仅凭对话完成首批真实编制闭环。依赖 U4；覆盖 R2/R9/R10/R11/R13。 范围：RDM plugins/rdm/plugin.go、编制 skill、web/app.js、docx.go；必要基座公开契约申请；新增总线全链路、浏览器与 DOCX 文件验证用例。 措施：准备/冲突/采纳/审签卡同源状态；固定模板与章节的编制配方；文档级审批快照；草稿与正式 DOCX；文件卡复用基座预览下载。 验证：三名真实用户分别编制/审核/批准，两项目隔离；无职责的新文档经负责人在对话分配后由指定编制人接续，非编制人只可转交；收起右栏完成全程；刷新/重启、陈旧卡片、下载撤权；实际 DOCX 标题、表格、分页、页眉页脚、引用可见且版本一致。 真实模型对照：固定同一批素材与任务，记录改造前后正确模板选择、必需内容覆盖、引用支持、编造事实、人工修订量、耗时与失败恢复；单测/mock 不替代此项。 出口：项目建议书和竞品分析经真实 UI 与模型完成，产物持久可见可下载；评审人独立重放。

U6. Document Families and Legacy Migration

目标：按业务文档族逐批覆盖其余历史资产。依赖 U5，且每批模板先评审发布；覆盖 R3/R11/R12。 范围：RDM 模板资产/注册表/迁移台账及模板契约回归集；参考 Legacy:templates/docs，不再依赖旧工作流实现。 推荐顺序：用户需求与系统/软件需求→设计任务与计划→设计方案与记录→验证/确认与测试→评审/风险/其他体系文档；精确文档名和批次以 U1 台账与用户优先级确认。 验证：每个上线模板至少一个有材料的完整生成例和一个空缺/冲突例；每类特有表格、引用及 DOCX 规则有针对性验收，不能只跑注册表计数。 出口：69 类均有明确结果，所有声明已支持的类型通过对应验收；不适用由人裁定，未交付保留可见状态。报价 XLSX 单列，不偷换为 DOCX。

---

Verification Contract

测试在后续获批实施阶段执行，本轮结果全部 NOT_RUN。源码检查只能证明路径存在与静态矛盾，不能证明真实编制体验。

层级	对象与方法	必须证明
资产	69 类迁移台账、模板契约校验、安装包 smoke	类型/模板/默认/结构/格式一致；没有源目录依赖
单元与领域	RDM make test 的 Go 测试；模板、检索、版本、权限、状态机测试	正常、拒绝、边界、依据保留与失败事务行为
总线与工具	真实注册表→schema→认证主体→处理器→领域服务；实际模型工具清单	文本入口与 UI 共用真实可达能力；审签身份无自相矛盾
持久集成	实际领域存储、原子事件、重启重放、幂等与并发故障注入	内容/引用/审批不出现半完成；未知结果可查
浏览器	真实三用户、两项目、对话＋卡片＋预览＋下载；现 make test-web 只作局部辅助	刷新、断连、重启、权限变化后结果仍正确，右栏关闭不丢操作路径
模型行为	固定素材和模板的任务级前后对照、人工盲审结果	模板选对、事实有支持、缺项诚实、未授权内容不出现
交付物	解包检查 DOCX OOXML＋实际 Office/LibreOffice 打开检查	正确内容、格式、表格、引用和批准快照；不能只检查扩展名
跨仓	固定 RDM pins 与 Dev 公开契约 SHA，相关 CI 及独立重放	下游实际组合可运行，禁止用另一组组件证据替代

首批硬判据：所选模板/version 必须正确；持久引用全部存在且在授权范围内；负向越权与静默基线覆盖为零；已声明完成的章节无未标注的证据缺口；相同幂等请求只生效一次。 “引用存在”与“语义支撑”分别评分。测试/验证报告不得虚构执行记录、测量值或通过结论；无实际执行证据只能生成计划、空表或标注未执行的报告草稿。 耗时、费用、引用支持率和人工修订量先建立基线，再由用户确认可接受阈值；上传首轮 60 秒指标不套用为整文生成时限。 项目审计中心权限沿既有两树一网方案；编制人可查看完成本职责所需且有权访问的引用，不能借生成工具读取整个项目审计或他人私聊。 证据分 SELF/GATE/REPLAY；正式验收固定对象与环境，按仓库要求经 evidence 记录，不把模型自评作为独立通过。

Definition of Done

本轮方案交付：资产盘点、关键源码断点、需求与方案、分期和验收可追溯，待决事项与未执行内容明确；本地方案尚未获得人工批准。 业务完成：U1–U5 首批真实闭环有完整证据；后续 U6 每批独立验收和发布，不把首批成功写成 69 模板全部可用。 上线声明另需固定安装包、目标实例、迁移/恢复记录及运行验收；当前没有上线声明。

建议下一任务是 U1 的契约核对与模板台账，而不是直接批量生成 69 份文档。先复核远端在途任务，和两树一网授权/事务工作项分工；本建议不启动实施。

Review Decisions

请评审以下具体选择：

1. 采用“RDM 内补齐闭环＋69 类资产分批接入”的路线，复用现有模板内容。
2. 首批项目建议书、竞品分析，随后扩展全部文档——已确认（session-settled: user-approved，2026-10-11，用户对首批优先级问题的回复）。后续各文档族之间的顺序尚未确认。
3. 以文档级版本快照进行三权审签，章节作为生成、差异与增量采纳单位。
4. 固定模板和依据后生成持久提案，编制人确认才写入；标准模板替换仍待用户后续提供。

第 2 项首批及扩展方向已确认；第 1、3、4 项及完整实施/测试计划仍待评审。本次优先级确认不构成业务实施、迁移或部署授权。计划中确定性契约与测试细节可在评审意见内迭代，改变权限/模块职责/范围时重新评审。

Appendix

主要依据：

• RDM:docs/requirements/01-用户需求与系统需求.md：UR-11、SR-C1–C8、SR-D1/D6、SR-E4/E6、SR-F1/F4/F5、F-10。
• RDM:docs/requirements/03-产品设计方案.md：M5/M6/M9/M10、F4/F6、§7 旧版 69 模板处置。
• RDM:docs/requirements/08-核心数据模型-两树一网.md：两树职责、共用标签、F-B、R1–R5、模板来源维度。
• RDM:docs/proposals/2026-10-08-U0-baseline-and-shared-contracts.md：项目共享、三权、两层冲突裁决、固定版本和对话同源约束；其中旧源码缺口已重新核对，不原样当作当前事实。
• Dev:DESIGN.md：对话优先、工作/文件双入口、一个状态所有者、一个预览落位。
• 本目录 2026-10-11-rdm-two-trees-trace-audit-integration.md 与 2026-10-11-collaboration-storage-and-distribution.md：本方案的授权/事件/存储依赖；不复制作另一条实施主线。

完整资产目录见 模板资产盘点。目录仅报告源码资产状态，不包含线上项目的实际文档数量。