Compare commits

...
Author SHA1 Message Date
weichen eb223350b4 Merge remote-tracking branch 'origin/main' into feature/rdm-u1-dev-closeout 2026-10-11 14:13:04 +00:00
weichen ab6b36c2fd Record U1 progress in the final-target master plan and index
Why: U1 (baseline reconciliation) landed via RDM PR #199/#200; the master plan status line and INDEX must reflect actual progress after Dev #340 merged the plan itself.
Evidence: SELF—RDM PR #199 merge 9b1b78a, card-close PR #200 merged; Dev PR #340 merge fe151b7.
Impact: plan status line, U1 progress paragraph, INDEX nav row only.
Refs: RDM PR #199/#200; Dev PR #340; Dev feature/rdm-u1-dev-closeout
2026-10-11 13:59:17 +00:00
weichen 72a098a783 Merge pull request 'Propose the U5 action scope for user review' (#70) from feature/generative-ui-u5-scope into main 2026-10-11 13:50:14 +00:00
weichen c7c5f94b64 Propose the U5 action scope for user review
Why: The r2 U5 clause requires a human review of the action scope
before implementation; this draft grounds the decision in the current
command inventory and existing safety machinery.

Evidence: Source facts cited inline (builtin command list with risk
levels, DangerHigh inline-confirm flow with pendingStore, audit
envelope) verified against backend main on 2026-10-11.

Impact: Documents-only (new proposal + index entry); no code changes.

Refs: 2026-10-10-generative-ui-plugin.md (r2 U5); Dev task
feature/generative-ui-u5-scope
2026-10-11 13:50:10 +00:00
weichen 74e41637e7 Merge pull request 'Record U3 progress in the two-trees master plan and index' (#69) from feature/rdm-u3-closeout into main 2026-10-11 13:40:15 +00:00
weichen a8f1096e78 Record U3 progress in the two-trees master plan and index
Why: U3 landed via RDM PR #201 (merge dbc41b6); the master record must reflect actual progress.

Evidence: SELF U3 closeout doc check exit 0 (receipt in Dev closeout task card).

Impact: proposal status line, U3 progress paragraph, INDEX row only.

Refs: RDM PR #201; Dev feature/rdm-u3-closeout
2026-10-11 13:40:12 +00:00
weichen eb36571653 Merge pull request 'Merge the template/final-target planning branch into the Documents main lineage' (#68) from feature/documents-reconcile-u2 into main 2026-10-11 13:10:50 +00:00
weichen 9cb09b967c Merge the template/final-target planning branch into main lineage
Why: Dev PR #340 pinned this Documents branch tip while it was never merged into Documents main (cross-repo pin discipline); this reconciliation unifies both planning lineages.

Evidence: merge-base 2a5f658; INDEX conflict resolved as union (U1+U2 progress row + two new plan entries).

Impact: docs only.

Refs: Dev #340
2026-10-11 13:10:38 +00:00
weichen 559af219d9 Merge pull request 'Record U2 progress in the two-trees master plan and index' (#67) from feature/rdm-u2-closeout into main 2026-10-11 11:23:07 +00:00
weichen 1673f3cea6 Record U2 progress in the two-trees master plan and index
Why: U2 landed via RDM PR #197 (merge fe8a75b); delivery policy requires the master record to reflect actual progress at task completion.

Evidence: SELF U2 closeout doc check exit 0 (receipt in the Dev closeout task card); RDM PR #197 merged=True via API.

Impact: proposal status line, U2 progress paragraph, and INDEX row only.

Refs: RDM PR #197; Dev feature/rdm-u2-closeout
2026-10-11 11:22:59 +00:00
4 changed files with 98 additions and 3 deletions
@@ -0,0 +1,84 @@
---
title: Generative UI U5 action-scope proposal
date: 2026-10-11
type: feat
revision: r1
status: awaiting-user-review
product_contract_source: generative-ui-r2-U5-clause
---
# Generative UI U5 动作范围提案(待用户评审)
依据:主记录 r2《Generative UI 调研与插件方案》U5 条款「**必须先评审本阶段动作范围**」。
本文是该评审的提案稿:给出动作分类与开放范围、审批挂接要求、明确排除项与验收条件。
用户裁定前不实施;实施另行开任务(U5 实现)。
负责人:裁定 weichen(用户);起草 Agent;更新时间 2026-10-11。
## 一、动作分类与本增量开放范围
| 类 | 定义 | U5 开放范围 | 通道 |
|---|---|---|---|
| **A 客户端本地** | 零副作用:页签切换、折叠展开、排序筛选、复制、doc-ref 打开工件预览 | **全部开放**(U4 已具雏形) | 纯前端,不经命令总线、不审计(无副作用可审);模型不能把 A 类标成"已执行" |
| **B 白名单命令绑定** | 把**既有命令目录**中的命令绑定为页面动作按钮 | **机制全量建设,第一版白名单为空**(见下) | cmdbus 四入口同源分发:审计信封、参数 Schema 校验、DangerHigh 确认卡 |
| **C 插件自身低危写** | generative-ui 表单提交落**插件自有**存储(Host.KVPut / 后台任务台账),不触发任何业务系统变更 | **开放**(场景 3「方案选择和需求表单」的实现面) | 新插件命令 `generative-ui.submit`,经同一分发/审计/幂等 |
| **D 业务写与高危** | 业务系统写(任务/项目/工件/知识库变更、对外发布、外发消息)、DangerHigh 命令直执、跨 owner/跨项目资源、代码执行 | **全部不开放** | U6+ 逐类单独评审后按 B 类机制逐条加白 |
**B 类第一版白名单为空的依据**(2026-10-11 源码事实):当前内置命令为
builtin.help / system.intent / conversation.create / runtime.mock / models.set /
conversation.profile——除 help/intent 外均为中危**写**命令,不存在可安全首开的内置只读命令。
结论:U5 交付「绑定-审计-幂等-确认」管道与测试,白名单从空起步,此后每加一条都走
独立评审(增量为零的机制 + 可验证的拒绝路径,先把地基打牢)。
## 二、审批挂接要求(映射 r2 KTD6 与现有机制,全部为既有能力复用)
1. **生成的按钮不是批准**:页面动作提交 → 宿主校验(启停/epoch/revision/权限/参数)→
`cmdbus.Dispatch`(Entrance=button,归一入审计信封)。模型只能引用允许的 action 名称,
不能伪造执行结果。
2. **DangerHigh 自动挂既有确认卡**:命中 `spec.Danger == high` 且未 Confirmed 时走现有
内联确认卡 + pendingStore 持久化 + Confirm 回道二次分发——**用户点卡确认是唯一批准来源**;
Confirmed 标志只能由卡回道置位,模型路径无法携带(红测断言)。
3. **幂等**:requestId 由客户端生成;服务端绑定 `(owner, surfaceId, revision, actionId,
requestId, 参数哈希)`。重复 requestId 同参数 → 返回已有回执;同 requestId 异参数 → 拒绝
(对齐 KTD6)。
4. **旧修订受控**:动作提交带 revision;revision ≠ 当前 latest → 拒绝并提示刷新
(旧按钮不重放)。
5. **禁用语义**:activation 关闭后新动作 403;在途按 U2 KTD7 表(已提交业务操作按命令台账
收尾,不承诺撤销)。
6. **表单草稿不进模型**:草稿由前端按 surfaceId/nodeId 管理,未提交不上传、不进
ctxasm(KTD4/KTD8;测试断言上下文不含未提交字段值)。
7. **参数校验**:动作参数按命令 ParamsSchema 服务端校验(validateParams 既有),拒绝
越权资源引用(owner 作用域)。
## 三、交付范围(实施任务的文件面,供参考)
- Backend:`POST /api/surfaces/{id}/actions`(提交动作,走 surfacesvc 守卫 + cmdbus);
幂等台账迁移(新表,纯增量);genui 目录文档补 action 绑定语法与「仅允许引用宿主下发的
action 清单」纪律。
- UI:UIRenderer `actions` 分支已有渲染,补 onAction 桥到宿主提交(SurfaceView 转发)。
- Frontend:SurfaceView onAction → 动作端点;确认卡复用现有 HITL 卡 UI;
表单草稿本地态(提交前不外发)。
- Core:优先零变更(action 绑定用服务端表,不扩 UINode 契约)。
## 四、明确排除(本增量不做)
业务实体写路径、跨会话/跨项目动作、自动触发的动作(只响应用户点击)、
动作结果自动改写页面(回执展示后由用户或 Agent 显式重组织)、
MCP/外部 HTTP 直连、任意命令即时全开。
## 五、验收条件(R7 映射,实施任务的判定线)
1. 场景 3 表单可提交、校验失败可修改重试;提交落插件台账可回读。
2. 旧 revision / 越权 action / 重复 requestId 异参数 → 拒绝(红测矩阵)。
3. DangerHigh 路径必须经确认卡;模型伪造 Confirmed 被拒(红测)。
4. 用户未提交的表单字段不出现在下一轮模型上下文(测试断言)。
5. 禁用后动作 403;A 类本地行为不受影响。
6. 幂等重放返回相同回执(并发双击一次生效)。
## 六、请用户裁定的三点
1. **分类与范围**:A 全开、B 机制先行白名单空起步、C 限插件自有写、D 全关——是否同意?
2. **C 类边界**:插件自身写是否限定为 KV + 后台任务台账(不建新的业务事实表)?
3. **确认卡 UX**:复用现有内联确认卡(不新建审批 UI)——是否同意?
裁定后:U5 实施按 `policy/delivery.md` 另行开任务;本文升级为已批准范围并回填裁定记录。
@@ -11,7 +11,7 @@ product_contract_source: legacy-requirements
修订 r1;负责人 weichen;编制 Codex;更新时间 2026-10-11(Asia/Shanghai)。
用户已明确最终实现范围:全部文档模板、文档三权、系统级项目及独立两树一网协作;本轮进一步要求先核对目标和差距、形成详细完整方案。
本总体方案待人工评审;业务实现、迁移、真实模型评测、浏览器验收、上线均 NOT_RUN。
本总体方案已经用户评审放行并随 Dev PR #340 合入(2026-10-11,用户指令「解决冲突合入」);U1 的 RDM 侧已实施合入(RDM PR #199 merge 9b1b78a)。其余工作包的业务实现、迁移、真实模型评测、浏览器验收、上线均 NOT_RUN。
本文件承担本次最终目标补齐的统筹记录;不替代 RDM 已批准需求正文。实施负责人按各工作包立项指定,不预设已有人承接。
下文 `RDM:` 为 Agent-System-RDM,`Dev:` 为 Agent-System-Dev,`Legacy:` 为旧 Agent-System 的仓内路径。
@@ -334,6 +334,8 @@ stateDiagram-v2
方法:先评审来源和范围,再按最小契约申请/采纳 X1–X5;已有能力只补接线,不重新立项重写。U1 保留在途 PR 及 owner、版本和接受条件。
验收:全部原编号各有最终行为/工作包/测试入口;没有历史 PASS 自动变成当前 PASS;被覆盖的旧表述有指向当前解释的入口。
进展(2026-10-11,RDM PR #199 merge 9b1b78a,卡闭合 PR #200):**RDM 侧已实施合入**——需求证据矩阵入仓为需求侧维护入口(`RDM:docs/records/2026-10-11-requirements-evidence-matrix.md`,34 UR/68 SR/10 F 逐条);requirements README 增基线核对条目(固定解释顺序:用户指示 → U0 D1–D9 与 V2.2 Q1–Q8 裁定 → 矩阵当前解释 → 既有定稿条款 → 原始会议材料;**历史 PASS 不自动成为当前 PASS**);U0 主记录页首 proposed 残留修正为 accepted;01–10 十号头部加统一「当前状态入口」引用块(含 05 头部草案状态漂移的口径声明)。Dev/Documents 侧(本 INDEX 行与组合钉入)随本 closeout 落地。剩余:Dev 扩展申请整理(X1–X5 的申请状态盘点)并入后续工作包立项时处理。
### U2. System Project and Management
覆盖 R1/R3/R5。交付创建/改名/归档、授权目录、成员加入/移除、创建者管理、宿主绑定及用户可用项目管理页面/对话路径。
@@ -9,7 +9,7 @@ product_contract_source: ce-plan-bootstrap
# RDM 两树一网集成、完善与追溯审计展示方案
修订:r1(2026-10-11 并入用户裁定);确认状态:用户评审通过(2026-10-11,需求拆解至实施计划五阶段一并,含 KTD4 双层管理员裁定);推进状态:U1 已实施并合入(RDM PR #195,merge 05b7d1a,2026-10-11);U2–U5、迁移与运行验收未启动。
修订:r1(2026-10-11 并入用户裁定);确认状态:用户评审通过(2026-10-11,需求拆解至实施计划五阶段一并,含 KTD4 双层管理员裁定);推进状态:U1、U2、U3 已实施并合入(RDM PR #195 merge 05b7d1a;PR #197 merge fe8a75b;PR #201 merge dbc41b6,2026-10-11);U4–U5、迁移与运行验收未启动。
需求负责人:weichen;方案编制:Codex;实施负责人:待实施立项时指定。
来源:2026-10-11 用户要求检查两树一网现状,并设计简单直观的项目追溯、审计展示;同轮明确选择“完善 RDM,并补齐必要的基座能力”。
目标仓:Agent-System-RDM;下文 `RDM:` 路径相对于该仓,`Dev:` 路径相对于 Agent-System-Dev;所有建议接口名均为候选契约。
@@ -287,6 +287,8 @@ U1 同批接通旧客户端的项目选择和命令封装,并解析可信会
建立结构事件到基座审计的 outbox,显示投递状态;旧缺失事实明确为不可恢复,不能补造批准人或时间。
验证:第二条/最后一条事件失败、提交后进程退出、投影刷新失败、相同请求重试、并发同版本更新;重启前后对节点/版本/边/审签/缺口深比较;旧快照与未知 schemaVersion 明确拒绝冒充完整;历史/导出截止落在批次中间时拒绝,上传发布/确认中断后状态与切片不重复、不矛盾。
进展(2026-10-11,RDM PR #197 merge fe8a75b):U2 已实施合入——`Runtime.TxProject` 事务批次(项目写锁+tx 绑定写穿+失败回滚并从库重建,零部分提交);入库拆事务内核/提交后宿主侧;结论确认/拒绝与上传五步同事务(`rdm_uploads` 表为事实源,meta.json 降为镜像);Retag 事件先行;重放保真(正式版 At/Actor 入载荷、CNode 升版重放重算 stale、cSnap 全量载荷+旧计数快照标 CountOnly、events schema_version 未知版本停止还原);`rdm_op_log` 幂等(结论/上传确认 opId);`rdm_audit_outbox` 同事务入箱+尽力投递+`rdm.audit.status`。写串行覆盖=事务面+已转换命令(用户裁定口径);进程级 kill 注入与运行验收随 U4/U5 复核。
完成条件:命令结果、持久记录、重建投影一致,故障不造成不可解释的部分成功。
### U3. 统一项目审计读服务
@@ -301,6 +303,8 @@ U1 同批接通旧客户端的项目选择和命令封装,并解析可信会
验证:旧网和合规网的同名 ID 不冲突,历史 v3 与当前 v4 不串用;未知/受限来源在旧 payload、差异、快照及导出副本中也不泄漏;游标换项目拒绝,分页期间新增事件不重不漏;动作审计同步延迟可见。
完成条件:无需读数据库即可通过受控接口回答来源、影响、变更与历史问题。
进展(2026-10-11,RDM PR #201 merge dbc41b6):U3 已实施合入——`inspection.go` 七面读服务(Capabilities/Summary/Tree/Object/Relations/Events/History)+统一响应壳(键集分页+截断+coverage 诚实标注);游标 base64 绑定项目(跨项目/过滤不一致拒绝);水位=已提交 max(seq);双网合流(layer 标注/kind 路由不串/ver 标注);schema v6 events.operation_id 列+TxProject BeginOperation 归组注入;披露标记(legacy-unattributed/model-candidate);`rdm.inspect.*` 七命令+审计面授权。基座侧动作审计待基座扩展(申请一/二)。
### U4. 项目追溯审计工作区
目标/需求:R2、R3、R4、R7;依赖:U3;页面载体在本增量设计评审时固定为宿主支持的 RDM 插件工作区。
+6 -1
View File
@@ -6,6 +6,10 @@
## 先看哪一份
待用户裁定:[Generative UI U5 动作范围提案](2026-10-11-generative-ui-u5-action-scope.md)(2026-10-11)。
r2 U5 条款要求先评审动作范围;本文给出 A/B/C/D 分类、审批挂接(复用既有 DangerHigh 确认卡与
幂等)、排除项与验收线,待三点裁定后 U5 实施另行开任务。
新增方向(已裁定取舍;U1 试验完成,r2 含结果与修订):[Generative UI 调研与插件方案 r2](2026-10-10-generative-ui-plugin.md)。
首试点为对话内完整分析页,交付采用可信编译插件;U1 试验限 MiniMax M3 + M2.7-highspeed、合成或脱敏材料、费用上限 ¥200,作为独立任务另行评审启动。
此记录独立于下方历史核验快照,不改写历史方案/PR 数量或验收结论。
@@ -17,6 +21,7 @@
| 三个智能体库如何继续演进 | [Agent 栈总案](2026-10-02-agent-stack-completion.md),阶段细化见 N1/Q1/I1、N2、N3、Q2/Q3 | R0/R1/D1、N1–N3、Q1–Q3、I1–I2、阶段评测 | weichen |
| RDM 下游的大目标和消费者里程碑是什么 | [RDM 阶段总案](2026-10-07-rdm-phase-plan.md) | P0–P4,对应 MS0'、MS1–MS4及发布前置 | weichen |
| 10–100 人协作与未来分布式如何演进 | [协作存储与分布式方案](2026-10-11-collaboration-storage-and-distribution.md) | 团队 PG 档 → 迁移恢复 → 多实例执行与故障验收;r1 已批准(2026-10-11),实施自 U1+U2 启动 | 需求:weichen;实施/运维待指定 |
| 最终目标的完整差距与交付顺序是什么 | [最终目标核对与完整交付方案 r1](2026-10-11-rdm-final-target-completion.md),配套[逐条矩阵](../records/2026-10-11-rdm-final-target-requirements-matrix.md) | 34 UR/68 SR/10 F 差距矩阵;U1–U16 十六工作包;已随 Dev #340 合入(2026-10-11),U1(需求基线核对)RDM 侧经 RDM #199/#200 落地 | weichen |
以上是依据文内显式范围和引用形成的阅读入口,不是新增优先级或批准结论。N2 阶段案未单列 owner,
应由负责人补齐;不能仅凭任务创建人推断全部规划的负责人。
@@ -161,7 +166,7 @@ RDM 总案把库分期作为支撑与依赖,不覆盖库分期的原始范围
## 2026-10-11 规划补充
- [RDM 两树一网集成、完善与追溯审计展示方案 r1](2026-10-11-rdm-two-trees-trace-audit-integration.md):对应 P3/MS3,源码已有部分实现;优先补项目绑定、创建者/管理员读取隔离与历史完整性,再接统一展示。用户确认范围为 RDM 与必要基座能力;r1 已获用户评审通过(2026-10-11,五阶段一并,含 KTD4 双层管理员裁定)。U1 项目身份与读取授权闭环已实施合入(RDM PR #195,2026-10-11;超管槽待基座能力接线,见 RDM 仓 U1 基座扩展申请);U2–U5 与运行验收未启动。
- [RDM 两树一网集成、完善与追溯审计展示方案 r1](2026-10-11-rdm-two-trees-trace-audit-integration.md):对应 P3/MS3,源码已有部分实现;优先补项目绑定、创建者/管理员读取隔离与历史完整性,再接统一展示。用户确认范围为 RDM 与必要基座能力;r1 已获用户评审通过(2026-10-11,五阶段一并,含 KTD4 双层管理员裁定)。U1、U2、U3 已实施合入(RDM PR #195、#197、#201,2026-10-11;超管槽待基座能力接线,见 RDM 仓 U1 基座扩展申请);U4–U5 与运行验收未启动。
- [RDM 模板与两树一网对话文档生成方案 r1.1](2026-10-11-rdm-template-dialog-generation.md):69 类旧资产、4 个当前注册模板的盘点及生成闭环设计;待评审,实施/迁移/模型试验/运行验收 NOT_RUN。与两树一网集成方案共用项目授权、原子事件与历史能力。 首批项目建议书/竞品分析、随后扩展全部文档已确认(2026-10-11),其余方案与实施仍待评审。