Compare commits

..
Author SHA1 Message Date
weichen 73bbb4cea6 Merge remote-tracking branch 'origin/main' into feature/layered-python-env 2026-10-15 14:01:27 +00:00
weichenandCursor 945db355fc Record the layered Python environment proposal
Why: 8788 could not render docx because the sandbox hides host site-packages and there is no request path for extra packages. The proposal fixes the design before the implementation lands.
Evidence: SELF — proposal written from the cnv_7936c0a799ff transcript and the existing exec-deps-dir code path.
Impact: Documents only. Index lists the proposal as pending review, not approved.
Refs: docs/proposals/2026-10-15-layered-python-env.md
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-15 13:29:49 +00:00
weichen f01aefa4eb Merge pull request 'Record the document duty matrix rework' (#108) from feature/rdm-duty-matrix into main 2026-10-15 09:15:11 +00:00
weichen 5f411499c5 Merge remote-tracking branch 'origin/main' into feature/rdm-duty-matrix 2026-10-15 09:14:32 +00:00
weichenandCursor 034faa4021 Record the document duty matrix rework
Why: the duty page needs one record for the four domain rulings, and the earlier settings plan must show which duty-page sections it no longer owns.
Evidence: SELF review of the proposal text against the approved implementation plan.
Impact: r1 section 4 and the duty-page parts of P5 and P7 point at r2. Settings, members, and the permission matrix stay in r1.
Refs: docs/proposals/2026-10-15-rdm-duty-matrix-rework.md
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-15 07:20:46 +00:00
6 changed files with 169 additions and 655 deletions
@@ -81,6 +81,10 @@ product_contract_source: legacy-requirements
## 四、文档查找与职责分配
> 2026-10-15:本节的职责页交互(文档清单加选中详情、章节级入口、整文审签)已被
> [文档职责矩阵整改 r2](2026-10-15-rdm-duty-matrix-rework.md) 取代。成员校验、版本冲突、
> 在途审签确认和历史保全仍然有效。下文保留作被取代前的记录。
文档职责页面采用“**文档清单+选中文档的职责详情**”:
- 上方提供统一搜索框,支持文档 ID 精确检索、标题精确/模糊匹配。
@@ -162,9 +166,9 @@ product_contract_source: legacy-requirements
| P2 系统设置闭环 | Core 设置描述、Backend 设置 API/存储/生效链/模型及密钥解析;系统管理入口 | P1;**基座发版与 RDM/Dev 升 pins**(见评审补充 1) | 系统受管项只能由有权管理员配置,旧个人/项目值不能覆盖 |
| P3 人员与成员接口 | 扩展公开账号搜索;RDM 专业角色摘要、成员查询、项目身份调整与提交校验 | P1;姓名来源核实(见评审补充 3) | 账号/姓名/角色过滤同源,添加与身份调整明确分离 |
| P4 文档与职责接口 | 专用文档目录、当前职责读取、统一职责服务、版本校验、变更失效及成员移除联动 | P1、P3 | 跨项目/非成员指派被拒,职责与审签变更全成或全败 |
| P5 通用选择器 | UI 仓搜索选择、单/多选、键盘操作、分页与状态;Frontend 人员/文档适配 | P1,接线依赖 P3、P4 | 三类使用场景共享交互,无自由文本误提交 |
| P5 通用选择器 | UI 仓搜索选择、单/多选、键盘操作、分页与状态;Frontend 人员适配。文档职责页的文档选择器改由 r2 三视图承接 | P1,接线依赖 P3、P4 | 人员选择共享交互,无自由文本误提交。职责页交互见 r2 |
| P6 权限解释与矩阵 | RDM 项目动作目录、单人/批量解释、覆盖三态、来源与拒绝原因 | P1、P3 | 矩阵与执行规则一致,系统动作无法写入项目覆盖 |
| P7 项目设置集成 | 重构现有项目页,连接四个页面、能力状态、读取回填与保存结果 | P2—P6 | 创建者、普通成员、职责人员均有对应可用流程 |
| P7 项目设置集成 | 重构现有项目页,连接设置、成员与权限页。文档职责页改为 r2 的三视图,不再包含整文审签 | P2—P6 | 创建者、普通成员、职责人员均有对应可用流程。职责页验收以 r2 为准 |
| P8 迁移与组合验收 | 旧配置处置、真实数据库与浏览器验收、精确组件组合验证、证据回填 | P2—P7 | 需求到证据闭合,无越权、隐私泄露或数据丢失 |
前端主要改动落在现有 `ProjectSettingsModal`、`adminRdmSections`、`rdmManagement`、`api` 和 `store`;按业务拆分成员、职责及权限组件,避免继续扩大一个管理组件文件。
@@ -1,188 +0,0 @@
---
title: 快慢通道 r2 非阻塞对话与任务卡实施计划
date: 2026-10-15
revision: r2-draft.3
status: pending-review
owner: weichen
execution: plan-only
parent: 2026-10-15-fast-slow-r2-nonblocking.md@r2-draft.3
---
# 快慢通道 r2 实施计划
状态:**阶段 5 文稿已按阶段 1–4 的修订联动更新,仍未评审。** 须等阶段 1–4 通过后再单独评审。
批准前不写业务代码,不推送,不合入。
规格依据 [r2 增补方案](2026-10-15-fast-slow-r2-nonblocking.md) @ r2-draft.3。r1.1 在 r2 阶段 4 批准前仍然有效。
**Goal:** 先闭合非阻塞闭环:完整结果、原卡到达、卡内选择、已读、请求复用,以及右栏不可见时的完整操作。再做进展归并、滚动、时间和面板整理。
**Architecture:** 服务端任务卡仍是唯一快照。增量 1 交付全部 P0,并保持 NB14、NB23。增量 2 交付 P1。不把前台 outbox 做成跨刷新存储。
**Tech Stack:** Go(Core/Backend)、React+TypeScript(UI/Frontend)、既有 ActivityCard、HITL、事件 seq 与 `make evidence`。
## 全局约束
- 视觉继续消费 `@ui/tokens.css`、`mk-*` 和 Collapsible。不新增裸色值、私有 `@keyframes`、行内字号或 `<details>`。
- 异步状态只有一个所有者。事件按 seq 处理,过期事件丢弃。
- 折叠和归并是展示规则。已保存且有权查看的公开过程、工具名、授权参数和输出继续可回放。隐藏思维链、系统或开发者提示、凭据、原始请求载荷和未授权工具数据不进入投影。
- 右栏关闭、切到文件或窄屏时,中栏展示同一 taskId 的完整卡片与操作。
- 跨仓顺序:Core 契约 → Backend → UI → Frontend → Documents 指针与 Dev gitlink。组合验证用 `make test`。
- 与 `feature/fast-slow-u2-u3-plan` 并行。本分支从 Dev `origin/main` 的 R0 `63e70d8b91ccb1691ce9b78a373e4e8bc9da24a2` 切出;修订前已同步到 `692735e91d6a9ab07ddd3686feb60a56b270728a`。不从该 U3 分支堆叠。
- 证据写入任务卡只用 `CMD=… make evidence`。本地记录标 SELF。合入所需的 GATE 不在本计划的交付终点里。
## 明确不做
- 不跑新的模型质量试验,不改模型路由。
- 不把「先不选择」或自由输入解释为授权同意。
- 不离线重写旧会话的模型正文。存量只改读取和展示。
- 不实现前台消息的跨刷新、跨会话恢复,不新增 outbox 的服务端草稿、恢复鉴权或删除语义。
- 不把工具开始或结束记成新的阶段记录。
## 增量 1:P0 非阻塞闭环
对应 NB01、NB02、NB05、NB07、NB08、NB09、NB10、NB11、NB12、NB13、NB18、NB19、NB21、NB22、NB24。
NB14 与 NB23 在本增量保持,不单独排工作项。
完成条件:方案 §1.2 的六步走查里,完成不新增中栏消息,选择不锁住无关对话,重复明确指令不新开任务,右栏关闭时中栏能读摘要、处理选择并打开文件。同一摘要请求只执行一次。增量 1 结束时,重复进展行和滚动联动仍可能存在,留在增量 2。
### W1 — Backend:完成卡读取最终结果
**Files:**
- Modify: `modules/backend/internal/runmgr/runmgr.go`(约 2241 行的 160 字摘要)
- Test: `modules/backend/internal/runmgr` 下现有完成卡测试
**内容:** 用户可见概览使用已形成的要点。没有可靠要点时写入「整理结果已生成,查看完整结果」,并保留全文入口。停止把 `truncate(fullText, 160)` 当作摘要。旧卡已写入的短摘要按方案 §4.9 只读展示,展示文案的存量折叠留到增量 2 的 NB20。
### W2 — Backend:完成和失败只更新原卡
**Files:**
- Modify: `modules/backend/internal/runmgr/runmgr.go` `deliverNotices` / `startNoticeRun`(约 2536、2602、2634 行)
- Modify: `modules/backend/internal/runtime/verify.go`(约 43 行 `materialNoticeBackstopReason`)
- Test: 通知与终轮兜底的现有测试
**内容:** 材料整理完成或失败时更新原卡、写未读、发一次轻提示事件。移除强制汇报和强制 `confirm_choice`。不调用 `claimConversation` 来占住会话。失败保留已保存的部分结果和原因,不显示成功完成。
真实模型前后对照:此工作项改变提示词和终轮门禁。状态 `NOT_RUN`。原因:2026-10-15 用户确认模型质量试验不是这些交互修复的前置条件。补救:增量 1 获实施授权后,按 `modules/backend/eval/live/` 或等价最小重放集补一次任务级对照,写入任务卡并标来源。未补之前,任务卡不得把该行为写成「已用真实模型验证」。
### W3 — Core/Backend:选择、已读与任务请求
**Files:**
- Modify: Core HITL / ActivityCard 契约(选择状态、请求键、未读、结果版本)
- Modify: `modules/backend/internal/runmgr/material.go` `materialKey`(约 44 行)及派发去重
- Modify: `modules/backend/internal/runmgr/runmgr.go`(约 805 行,自由输入投影)
- Test: 幂等、过期选择、已读转换、授权隔离、安全投影夹具
**内容:** 选择状态为待选、已选、暂不处理。暂不处理可回到待选且不新建请求。已读与未读按方案 §4.5 的互斥状态表实现:已读只在用户针对具体结果版本主动展开、打开全文、激活「有 1 项更新」或显式标记时发生,布局自动展开、刷新、重挂载、进入视口都不算;新的成功或失败终态版本使任务未读,仅启动重试不触发;未读数只在此前没有未读版本的任务上加一;当前工作与工作历史互斥,正在阅读的历史卡暂留原位。请求键由授权作用域(认证账号、项目、来源会话)加材料内容 hash、解析版本、用途、请求版本组成,复用须归属一致且请求者仍有权限,否则按无既有请求处理且不泄露其存在。按钮和绑定后的聊天消息共用该键。重复提交和重复的明确指令返回已有任务。引用在发送和组装模型上下文时各重新鉴权,撤销后不注入内容、不泄露存在性。重新生成或改变范围才递增版本。过期或已处理的选项刷新为服务端状态,不能再提交。自由输入和「先不选择」不算授权同意。投影排除 NB23 列出的隐藏内容。
确定性绑定先覆盖:卡片输入、显式任务引用、同时点明该材料与用途动作的句子。其余消息保持为新话题,并保留原选择。含糊消息只澄清。命中并绑定后,无论复用已有请求还是新启一次,都把所属任务卡的选择写为「已选」(记录选项、来源为聊天指令、时间)并关闭待选区;多选卡只关闭被满足的选项;重复指令不新增选择记录(NB12)。
### W4 — Frontend/UI:同一张卡的两种落位
**Files:**
- Modify: `modules/frontend/src/components/Conversation.tsx`
- Modify: `modules/frontend/src/components/ConversationWork.tsx`
- Modify: UI 任务卡与确认卡
- Test: 组件测试与 `design-guard`
**内容:** 右栏「工作」可见时,中栏只留关联入口。右栏关闭、切到文件或窄屏时,中栏内联展开同一 taskId 的完整卡片(窄屏同样内联,不做抽屉或遮罩;展开不移动输入焦点、不改写滚动位置、不因展开本身标已读):摘要、依据、单选或多选、补充输入、「按此处理」、「先不选择」、打开文件。处理后展示实际选择。输入区放可移除的引用标签。未引用时不把结果版本写成已经读过。收起提示「后台工作 N 项 · 新结果 M 项」打开同一面板。
### W5 — 聊天队列不被后台占用
**Files:**
- Modify: Backend 会话占用,使后台 run 和普通待选不再返回让聊天一直排队的占用
- Test: 后台整理进行中的新消息能进入对话
**内容:** 不修改 `modules/frontend/src/outbox.ts` 的存储,也不把排队消息写成可跨刷新恢复的记录。前台生成中的短暂内存排队可以保留。危险授权继续只阻塞依赖它的工作。
### 增量 1 测试与停止
测试:完成卡、通知、请求幂等(含跨账号、跨项目、跨会话与权限撤销后不命中)、选择与已读状态机(含布局自动展开、刷新、重挂载不算已读,同任务重复完成不重复加一,失败终态未读,启动重试不未读,阅读中历史卡暂留原位)、直接交代后选择关闭、引用两次鉴权、右栏关闭时的同一任务、授权隔离、NB23 夹具。浏览器走查留到阶段 7,其中轻提示可达性走查按方案 §4.11.1,由非作者逐项记录。
停止条件:无关消息被静默当成选择答复;「先不选择」或自由输入触发了需授权的动作;同一请求键产生两份结果;完成或失败通知再次插入中栏长回复;右栏关闭时不能读摘要或提交选择;展开内容出现 NB23 排除项。出现任一条即停增量 1,不进入增量 2。
## 增量 2:P1 归并、滚动、时间与面板
对应 NB03、NB04、NB06、NB15、NB16、NB17、NB20。前置:增量 1 已提交,且 r2 阶段 4、5 已批准。
完成条件:重复累计进展只占一行;工具起止不新增阶段记录;中栏滚动不带动右栏;完整时间戳有悬停、键盘、触屏和读屏路径;旧的 160 字摘要被标明为当时保存的开头。
### W6 — Backend/Frontend:进展按任务归并
**Files:**
- Modify: `modules/backend/internal/runtime/sub_loop.go`(约 210 行,累计文本进度)
- Modify: `modules/frontend/src/live.ts`(约 244 行,`runEventsToTimeline`)
- Modify: `modules/frontend/src/store.ts`(`agent.progress` 写入)
- Test: `modules/frontend/test/live.test.ts`
**内容:** 同一子任务的文本流更新同一条展示。阶段变化才新增阶段记录。工具开始和结束只更新活动行并进入执行记录。原始事件保留。运行中的要点不收「我来检索」和工具调用。旧会话按同一规则折叠,详细记录仍按 seq 可查。
### W7 — Frontend:两栏独立滚动与历史分区
**Files:**
- Modify: `modules/frontend/src/components/Conversation.tsx`(约 659 行)
- Modify: `modules/frontend/src/scrollsync.ts`
- Modify: 右栏当前工作 / 工作历史
- Test: `modules/frontend/test/scrollsync.test.ts`
**内容:** 去掉滚动百分比联动。保留点击「查看关联任务」和「定位发起消息」后的定位与 `flashElement`。当前工作与工作历史按方案 §4.8 排序。阅读中的卡不因更新而自动排序、展开或跳转,只显示「有 1 项更新」。
### W8 — 时间标签
**Files:** Frontend 消息与任务卡组件;必要时 Core 卡片时间字段。只用 `@ui` 已有原语。
**内容:** 消息时刻来自创建时间,后台更新不回写。卡片显示创建、更新、完成。跨天显示日期。完整时间戳同时支持悬停、键盘聚焦、触屏点按和屏幕阅读器(`time` 的 `datetime` 与完整本地时间的可访问名称)。选择记录带提交时间。
### 增量 2 测试与停止
测试:进展回放、滚动、时间的非悬停路径、旧会话折叠。阶段 7 用方案 §1.2 和边界做浏览器走查,含窄屏。
停止条件:归并导致原始事件不可回放;工具起止被写成新的阶段记录;完成卡在全文存在时仍只显示开头;滚动改动把定位高亮一起删掉;完整时间只剩悬停。出现任一条即停止增量 2 的后续工作项。
## 验收映射
| 场景 | 需求 | 增量 | 证据形态 |
|---|---|---|---|
| 上传后一张材料卡持续更新 | NB02 | 1 | Backend 任务身份测试 |
| 整理完成不新增中栏回合,失败同样留在原卡 | NB07 NB21 | 1 | 通知测试;浏览器走查留阶段 7 |
| 全文可读,没有要点时用诚实入口 | NB05 | 1 | 完成卡测试 |
| 「总结一下这份材料」第二次不新开摘要 | NB12 NB13 | 1 | 请求键测试 |
| 先不选择可重新展开;过期选择不能再提交;已读、再次未读与当前/历史分组 | NB09–NB11 NB16 NB22 NB24 | 1 | 状态机测试(NB16 分组迁移的展示部分在增量 2) |
| 右栏关闭仍能读、选、打开文件;窄屏内联不开抽屉 | NB01 NB18 | 1 | 同一 taskId 测试;浏览器走查留阶段 7 |
| 右栏关闭时一步定位并完成一次选择,焦点与两栏滚动不变 | NB07 NB18 NB24 | 1 | 方案 §4.11.1 非作者走查记录;阶段 7 前 `NOT_RUN` |
| 直接交代后关闭已满足的选择 | NB12 | 1 | 选择状态测试 |
| 请求复用与引用的授权边界 | NB08 NB13 | 1 | 跨账号、跨项目、权限撤销夹具 |
| 后台进行中新消息进入对话 | NB19 | 1 | 会话占用测试 |
| 授权放弃不算同意;展开不见隐藏内容 | NB14 NB23 | 1 | 回归夹具 |
| 重复进展不刷行,工具起止不进阶段记录 | NB03 NB04 NB06 NB20 | 2 | `live.test.ts` |
| 滚动独立,点击才定位;历史分区不抢阅读 | NB15 NB16 | 2 | `scrollsync.test.ts` |
| 完整时间不只有悬停 | NB17 | 2 | 组件测试;读屏路径留阶段 7 |
阶段 7 之前,上表浏览器项保持 `NOT_RUN`。单测通过只证明机制。
## 文件范围汇总
| 仓库 | 增量 1 | 增量 2 |
|---|---|---|
| Core | 选择状态、请求键、未读、结果版本 | 卡片时间字段,若现有字段不够 |
| Backend | `runmgr.go` 完成摘要、`deliverNotices`、`verify.go`、`material.go`、会话占用 | `sub_loop.go` 进度 |
| UI | 卡内选择、未读、右栏关闭时的完整卡 | 历史分区、时间 |
| Frontend | `Conversation.tsx`、`ConversationWork.tsx`、引用标签 | `live.ts`、`store.ts`、`scrollsync.ts` |
| Documents | 本计划与方案状态 | 获批后回写进展 |
| Dev | gitlink 与任务卡 | gitlink 与任务卡 |
`modules/frontend/src/outbox.ts` 不在本计划的修改范围内。
## 评审
| 阶段 | 对象 | 结论 |
|---|---|---|
| 5 实施计划 | 本稿增量 1、增量 2 @ r2-draft.3 | 未评审 |
阶段 1–4 通过并且本稿获批之后,才允许按增量 1 写业务代码。增量 2 在增量 1 完成并确认偏差后继续;若增量 1 改变了本计划的接口或顺序,先修订本稿再继续。
@@ -1,460 +0,0 @@
---
title: 快慢通道 r2 非阻塞对话与任务卡
date: 2026-10-15
revision: r2-draft.3
status: pending-review
owner: weichen
execution: design-only
parent: 2026-10-12-fast-slow-channel-display.md@r1.1
---
# 快慢通道 r2:非阻塞对话与任务卡
状态:**阶段 1–4 已按第二轮评审意见修订(r2-draft.3),结论仍为未评审。** 本稿是已批准方案
[r1.1](2026-10-12-fast-slow-channel-display.md) 的增补候选。评审通过前,r1.1 仍是有效方案;
下文「拟取代」条款在阶段 4 批准后才生效。业务代码、模型试验、推送、PR、合入与部署均未授权。
授权依据:2026-10-15 用户确认独立兄弟分支,并确认本轮只产出阶段 1–5 文档、逐阶段评审。
Dev 任务分支 `feature/fast-slow-r2-nonblocking`。任务启动 R0
`63e70d8b91ccb1691ce9b78a373e4e8bc9da24a2`。修订前已 `task-sync`,同步基线
`692735e91d6a9ab07ddd3686feb60a56b270728a`(包含 `7a0f934`)。
实施计划见 [r2 实施计划](2026-10-15-fast-slow-r2-nonblocking-plan.md)。
## 1. 需求拆解
### 1.1 目标
保留现有视觉风格。中栏是一条连续对话,右栏是持续更新的任务卡。后台结果写回自己的卡片,
默认只给轻提示。用途选择留在任务卡里,用户可以继续聊天、稍后决定,或用一句话直接交代下一步。
右栏关闭、切到文件或窄屏时,同一张卡的阅读和操作改由中栏内联展开承担,不另开抽屉。
### 1.2 用户场景
以下时间是验收走查的预期,不是已发生的运行结果。
1. 11:04 上传说明书。中栏给出简短收件反馈。右栏立即出现一张材料整理卡。
2. 后台开始整理。同一张卡更新阶段和已经形成的要点。用户可以继续发消息。
3. 11:05 整理完成。右栏出现内容概览、完整整理结果、来源和可选下一步。中栏保持原有对话顺序。
4. 用户说「总结一下这份材料」。系统把要求关联到该材料。已有同范围请求时复用并显示进展;没有时才启动一次摘要任务。右栏显示它的进展。
5. 用户转而讨论别的问题。中栏继续当前话题。摘要完成后更新自己的卡片,并显示未读提示。
6. 用户查看摘要。在右栏读要点、展开全文或打开文件。需要追问时,可以把结果引用到对话后再提问;不引用也可以问,但回答不得声称看过未带入的版本。
若第 3 步出现的用途区选择「先不选择」,用途区收起,材料整理结果仍可查,会话里没有挂起的前台回合。
之后可以点「暂不处理 · 可随时继续」重新展开原选择区。
### 1.3 子需求
| 主题 | 用户可观察到的结果 |
|---|---|
| 栏职责 | 发言在中栏。右栏「工作」可见时,后台进度、阶段成果和完整结果在同一张右栏任务卡,中栏只留关联入口。右栏关闭、切到文件或窄屏时,中栏内联展开同一张卡和操作(窄屏同样内联,不使用抽屉) |
| 一张卡 | 一项后台工作从开始到结束保持同一身份、同一来源消息和同一材料 |
| 阅读层级 | 概览、工作详情、执行记录对应 r1.1 的 L0–L3。可展开的是已保存且有权查看的公开摘要、工具名、授权参数和输出 |
| 进展 | 同一段流式文字更新原位置;阶段变化才新增阶段记录。工具开始和结束只进入活动行和执行记录 |
| 完成正文 | 展示可读要点和完整结果;没有可靠短摘要时说明结果已生成并给出入口 |
| 到达 | 原卡更新、轻提示一次;此前没有未读版本的任务才使未读数加一;对话历史、焦点和滚动位置保持不动。只有用户针对该结果版本的主动动作才算已读,布局自动展开、刷新、重挂载和出现在视口都不算(状态表见 §4.5) |
| 引用 | 引用保证该结果版本进入下一回合。未引用时助手只可按权限查询,且不得声称看过未带入的内容 |
| 选择 | 用途选项、补充要求和「先不选择」都在任务卡内,不占住会话。暂不处理可以重新展开 |
| 直接交代 | 语义清楚的材料用途指令绑定该材料,复用已有同范围请求;没有时才启动工作。无论复用还是新启,被该指令满足的选择都转为「已选」,原待选区关闭(验收见 NB12) |
| 汇合 | 选择按钮和聊天消息进入同一个任务请求;重复提交看到已有进展。请求键限定在认证账号、项目和来源会话内,复用前必须归属一致且请求者仍有权限(验收见 NB13) |
| 滚动 | 两栏各自滚动;只有点击关联入口才定位和高亮 |
| 时间 | 消息时间固定;卡片分别标创建、更新、完成;选择和阶段带事件时间。完整时间戳不只有悬停 |
### 1.4 边界与非目标
纳入:信息归属、任务卡投影、进展去重、完成正文、到达通知、已读与再次更新、用途选择、
暂不处理的重新展开、任务请求幂等、滚动、时间戳、存量事件的读取规则、安全展示边界,
以及这些行为的测试计划。
不纳入:
- 新的模型质量试验、提示词效果对照和供应商切换。触及提示词与终轮门禁的真实模型对照
在实施时按交付规范标注;本轮把它标为 `NOT_RUN`,不把它当作交互修复的前置条件。
- 视觉风格重做、新的颜色字号和第四栏。
- 在跑任务的动态改写。改变范围或要求重新生成时,建立新的结果版本。
- 部署、线上修复,以及 U3 质量线 `feature/fast-slow-u2-u3-plan` 的传输与工具流工作。
- 前台消息跨刷新、跨会话的 outbox 可靠性。作者私有草稿、服务端持久化、恢复鉴权和删除语义另立需求。
### 1.5 待澄清(不阻塞本稿结构)
| 项 | 本稿采取的写法 | 需要评审时裁定 |
|---|---|---|
| 「语义十分清楚」由谁判定 | 先用确定性规则:卡片输入、显式任务引用、或与待选材料及用途词同时出现的指令 | 是否以后增加模型判断 |
| 存量 160 字摘要 | 历史卡保留已保存正文,并提供完整结果入口;新完成卡按本节规则生成 | 是否离线回填旧卡 |
| 引用是否为读取结果的前提 | 引用保证该结果版本进入本轮。未引用时只允许受权限约束的查询,并禁止声称看过未带入的内容 | 是否改为「不引用就不能读」 |
## 2. 需求评估
### 2.1 价值与现状
2026-10-15 对一次真实会话的只读核对,已经把现象对应到固定组合里的实现。
修订文稿前又在 `task-sync` 之后重验行号。来源为 SELF:只读源码,没有改业务代码,没有调用模型。
核对对象:Dev 同步基线 `692735e91d6a9ab07ddd3686feb60a56b270728a` 物化后的组件
Backend `80bb123c874cd9eb0e25f12ccd41e888f727a7e1`、
Frontend `5ab81432d10291e1885256293192bc96038fa061`、
Core `5773e74086791731059730bd3726dc8c9cd1381f`、
UI `e295caeef377a0e9588a3057d280864b2a011b71`、
Documents `0f06abd57c7bfa9e88dfea22e2a46719a7bfc5bf`(已含 Documents `origin/main`
`d668a3e0ac345dc80a72d15469f25918c4535ee6`)。
原稿记录的 Backend `0a57853154e331cdb02a6a74ec2e13033b843e63` 已被本次同步取代。
行号属于这次检出,后续提交移动后以当时文件为准。
| 现象 | 当前实现 | 符合度 |
|---|---|---|
| 协作进展重复 | `runtime/sub_loop.go` 每个 `text_delta` 发布累计文本前 80 字(约 210 行);`live.ts` `runEventsToTimeline`(约 244 行)把每条追加成「协作进展」 | 需调整后符合。事件可以留,展示要按任务归并 |
| 右栏看不到完整结果 | `runmgr.go` 约 2241 行在摘要为空或为「完成」时 `truncate(fullText, 160)`。全文已在 `payload.Text` 和落库消息里 | 需调整后符合。读取已有全文即可,不必先提高模型质量 |
| 整理结束后出现新回复和选择卡 | `deliverNotices`(约 2536 行)经 `startNoticeRun`(约 2602 行)占住会话;约 2634 行要求汇报并立即 `confirm_choice`;`verify.go` 约 43 行对弱模型再强制一次 | 需调整后符合。这是行为变更,批准前不能动 |
| 已处理仍写「可自由输入」 | `AskHITL` 约 805 行只把一句 Markdown 放进投影,没有输入控件,处理后也不替换 | 需调整后符合 |
| 两栏滚动位置奇怪 | `Conversation.tsx` 约 659 行用 `scrollsync.ts` 的滚动百分比带动右栏 | 需调整后符合 |
| 同一摘要像处理了两遍 | `material.go` `materialKey`(约 44 行)只用文件名和解析字数,没有「材料内容 + 用途 + 请求版本」这一任务请求身份 | 需调整后符合 |
项目定位仍然是对话推进工作、服务端权威、通用基座。r2 不把文档审签或业务风险等级写进基座。
### 2.2 可行性、成本与风险
| 项 | 判断 |
|---|---|
| 可行性 | 完整结果、事件和任务卡已经存在。P0 改完成通知、选择状态、已读和请求幂等。P1 改进展归并、滚动、时间和面板整理 |
| 成本 | 跨 Core、Backend、Frontend、UI 与 Dev gitlink。Documents 只承载方案。无新模型调用预算。不新增 outbox 服务端存储 |
| 依赖 | 既有 ActivityCard、HITL、事件 seq、工件预览。内容身份沿用 r1.1 §8.3:内容 hash 与解析版本 |
| 在途重叠 | Dev `feature/fast-slow-u2-u3-plan` 及 Documents 同名远端分支在做 U3 r0.1–r0.6,会碰到 `runmgr.go`、`store.ts`、`live.ts`。本任务是兄弟分支,不堆叠、不暂停对方。合入前各自 `task-sync`,冲突按语义核验 |
| 信息架构 | 原稿把中栏写成始终只留入口,与 DESIGN.md「右栏关闭或切到文件时中栏承担完整卡片与操作」以及 r1.1 R11 冲突。修订后两种可见性共用同一 taskId |
| 范围 | 原稿把前台排队的跨刷新恢复放进核心闭环。那会带出作者私有草稿、服务端持久化、恢复鉴权和删除语义。本轮拿掉,只保留后台任务和普通待选不占聊天队列 |
| 风险 | 取消自动汇报会改变用户已经习惯的「做完会在对话里说一声」。轻提示和未读必须真实可达,否则结果会被漏看。右栏关闭时若中栏没有完整操作,R11 会退步 |
| 行为面 | P0 会改 `startNoticeRun` 提示和终轮兜底。交付规范要求真实模型前后对照。用户已说明该对照不是这些交互修复的前置条件,故计划中标 `NOT_RUN` 并写补救,不用「预期改善」代替证据 |
### 2.3 与 r1.1 的拟取代条款
下列条款在本稿阶段 4 获得人工批准后,由 r2 取代。批准前 r1.1 原文保持有效。
| r1.1 | r2 拟采用 |
|---|---|
| §9.1 多任务相继完成时,原卡先显示结果,父会话空闲后再合并汇报 | 只更新原卡,加未读和一次轻提示。不启动前台汇报回合 |
| §9.4 前台忙时沿用输入排队 | 前台正在生成时可以短暂排队。后台运行和普通待选卡不占聊天队列。跨刷新、跨会话恢复排队消息不在本轮 |
| §5 右栏顺序「需要你处理 → 当前查看 → 其他进行中 → 新结果 → 已收纳」 | 收敛为「当前工作」和「工作历史」。新任务在上,历史按完成或处理时间倒序并默认折叠 |
| R10 完成后把结论回投到对话 | 右栏更新。引用把结果版本带入下一回合;不引用时不得声称已读该版本。右栏不可见时,中栏展示同一张卡 |
| §6.1「后台结束」默认在快通道给结论 | 快通道保持用户正在进行的对话。结果留在原任务卡;右栏不可见时由中栏展示这张卡 |
r1.1 的其余已批准内容继续有效:四层阅读里 L3 执行记录仍保留、失败与成功分开、来源不编造、
更新不抢占正在阅读的文件、材料内容身份不用文件名加字数冒充、成果不是思维链、
右栏关闭与窄屏时主要能力完整(R11)。
## 3. 需求表
项目符合度依据第 2 节源码核对。处理结论在阶段 3 评审前均为待定;下表给出建议结论,供评审确认。
「纳入本增量」指 r2 实施计划中的增量,不表示现在可以写业务代码。
层级:P0 是核心非阻塞闭环;P1 是时间、归并和面板整理;「约束」必须保持,不单独排期。
| ID | 描述 | 符合度 | 层级 | 可判定验收 | 依赖 | 建议结论 |
|---|---|---|---|---|---|---|
| NB01 | 中栏按发送顺序展示用户发言和助手对当前问题的回复。右栏「工作」可见时,后台进度、阶段成果和完整结果不复制进中栏,只留关联入口。右栏关闭、切到文件或窄屏时,中栏展开同一任务的完整卡片与操作 | 需调整后符合 | P0 | 右栏展开时,材料整理的子任务日志不进入第一轮快速回复。右栏关闭时,不打开右栏即可读摘要和依据、处理用途选择、打开文件,且与右栏是同一任务 ID | 既有消息与 run 事件 | 纳入增量 1 |
| NB02 | 一项后台工作从开始到结束只维护一张任务卡,身份和触发消息、材料保持不变 | 需调整后符合;r1.1 R02 已有方向,完成通知目前会另起回合 | P0 | 走查场景 1–3 步始终是同一张材料卡;刷新后仍是同一 ID | 任务登记 | 纳入增量 1 |
| NB03 | 概览、工作详情、执行记录三层可读,并映射 r1.1 L0–L3。可展开的是已保存、且当前用户有权查看的公开工作摘要、工具名、已授权参数和输出 | 需调整后符合 | P1 | 默认见名称、材料、状态、时间和当前事项;展开可见完整结果与执行记录。折叠不删除已保存的公开事件 | 既有事件回放 | 纳入增量 2 |
| NB04 | 同一段流式文字更新原位置。只有阶段变化才新增阶段记录。工具开始和工具结束只更新活动行并进入执行记录 | 需调整后符合 | P1 | 用一段重复开头的进度事件回放,时间线里该段只占一行。工具起止不增加阶段行。原始事件仍在详细记录中可查 | `agent.progress` | 纳入增量 2 |
| NB05 | 完成卡读取后台最终结果。没有可靠短摘要时显示「整理结果已生成,查看完整结果」 | 需调整后符合 | P0 | 完成卡正文能打开全文。开头是标题或表格时,概览不把截断标题当成摘要 | 已落库的子代理消息 | 纳入增量 1 |
| NB06 | 运行中的「当前发现」只收已经形成的实质结果。检索开场和工具调用只进入活动行或执行记录 | 需调整后符合 | P1 | 「我来检索」「正在调用工具」不出现在「已整理的要点」 | 阶段与工具事件 | 纳入增量 2 |
| NB07 | 后台完成时更新原卡、标记新结果版本,并给出一次轻提示。此前没有未读版本的任务才使工作入口未读数加一,同一任务再来新版本不重复加一 | 需调整后符合;当前会 `claimConversation` 后启动通知回合 | P0 | 完成时中栏消息条数不变,滚动位置不变,输入焦点不变。提示含材料名,例如「《说明书》的材料整理已完成」。同一任务连续完成两个版本,未读数只增加 1,两次轻提示不叠加成两条未读 | 卡片与未读 | 纳入增量 1 |
| NB08 | 用户可以把结果引用到当前输入。引用可移除。发送后才成为新回合,并带上被引用的结果版本。引用保证该版本进入本轮;未引用时不得声称看过未带入的内容 | 符合度待核实:输入区尚无此引用标签 | P0 | 引用后提问出现在对话末尾,时间是发送时间,回答可以使用该结果版本而不再跑一遍同一摘要。未引用的提问不把该版本写成已经读过,除非权限内查询实际读到并加以说明。引用在发送时和组装模型上下文时各重新鉴权一次:权限被撤销后,该版本内容不注入上下文,提示与回答也不透露该资源是否存在,表现与引用不存在的资源一致 | 任务结果版本 | 纳入增量 1 |
| NB09 | 用途选择放在所属任务卡底部,含单选或多选、补充输入、「按此处理」和「先不选择」。右栏不可见时,同一选择出现在中栏的同一张卡上 | 需调整后符合 | P0 | 选择出现时用户仍能发送无关消息并得到回复。推荐项有标识,且不会自动执行 | HITL 投影 | 纳入增量 1 |
| NB10 | 自由输入是卡片里的真实控件。处理后展示实际选择和补充要求,并与后续生成的完成状态分开 | 需调整后符合 | P0 | 处理后可见「已选择:简明摘要;重点:使用流程和技术参数」,同时后续任务仍显示自己的进行中或完成。失效的「可自由输入」不再出现 | `AskHITL` 投影 | 纳入增量 1 |
| NB11 | 「先不选择」收起选择区,留下「暂不处理 · 可随时继续」,不催问、不自动重开。点该提示重新展开原选择区并回到待选,不新建请求 | 需调整后符合 | P0 | 收起后没有挂起的前台回合;刷新后仍是收起状态。点提示后选项恢复,任务请求数不变 | 选择状态持久化 | 纳入增量 1 |
| NB12 | 明确回答当前材料用途的发言,绑定该材料并复用已有同范围请求;没有时才启动一次工作。其他问题按新话题处理,原选择保留。直接交代后,被该指令满足的选择转为「已选」并关闭待选区 | 需调整后符合 | P0 | 第二次说「总结一下这份材料的摘要」不新开摘要任务,只显示已有进展。同时讨论无关问题时,原选择仍在。直接说「帮我做简明摘要」后,无论复用已有请求还是新启一次,所属任务卡的选择状态都变为已选(记录选项、来源为聊天指令和时间),不再留下待选区,也不留下「先不选择」的收起提示;重复说同一指令不产生第二条选择记录。多选卡只关闭被指令满足的选项,其余选项仍可选 | 确定性绑定规则 | 纳入增量 1 |
| NB13 | 选择按钮和聊天消息汇合到同一任务请求。已有工作只显示进展。明确要求重新生成或改变范围时才建立新结果版本 | 需调整后符合 | P0 | 两个入口几乎同时提交,只产生一个摘要任务和一组结果文件。再次要求「重新生成」才出现新版本。请求键限定在认证账号、项目、来源会话,再加材料内容 hash、解析版本、用途和请求版本;只有归属一致且请求者仍有权限时才复用。换账号、换项目或换会话提交相同内容不命中既有请求,也看不到其进展;权限撤销后重复提交不返回既有任务,表现与没有既有请求一致 | 内容 hash、用途、请求版本 | 纳入增量 1 |
| NB14 | 需要授权的操作继续等待授权,并且只阻止依赖该授权的工作。自由输入和「先不选择」不算同意 | 符合;危险确认已经独立。需保持 | 约束 | 授权卡未处理时,无关对话仍可发送。两种放弃动作不会让被授权动作执行 | 既有 HITL | 随增量 1 保持,不单独排期 |
| NB15 | 取消按滚动百分比联动。关联只在用户点击「查看关联任务」或「定位发起消息」时定位并高亮 | 需调整后符合 | P1 | 滚动中栏时右栏位置不变。点击入口后目标高亮。用户正在看旧卡时,新结果只显示「有 1 项更新」 | `scrollsync.ts` | 纳入增量 2 |
| NB16 | 右栏分当前工作与工作历史。当前工作含进行中、确实等待输入的任务、新到未查看的结果,新任务在上。历史默认折叠。当前工作与工作历史互斥,一张卡同一时刻只在其一 | 需调整后符合 | P1 | 用途选择和选择历史留在所属任务卡内,不另堆「已处理」卡。阅读旧卡时卡片不因更新而自动排序、展开或跳转;正在阅读的历史卡收到更新时暂留原位并显示「有 1 项更新」,用户离开该卡后再按未读状态迁入当前工作 | 卡片排序 | 纳入增量 2 |
| NB17 | 消息常驻显示时刻,跨天显示日期。完整时间戳除悬停外,键盘聚焦、触屏点按和屏幕阅读器也能得到(`time` 的 `datetime` 与含完整本地时间的可访问名称)。卡片分别标创建、更新、完成。选择记录带提交时间 | 需调整后符合 | P1 | 键盘、触屏和读屏得到的完整时间与悬停一致。后台更新不改变已有消息的时间。选择时间与后续任务的开始、完成时间彼此可区分 | 消息 `createdAt`、卡片时间 | 纳入增量 2 |
| NB18 | 右栏「工作」可见时中栏只留入口。右栏关闭、切到文件或窄屏时,中栏内联展开同一 taskId 的完整卡片与操作。窄屏只保留这一种落位,不使用抽屉 | 需调整后符合;`ConversationWork` 已有收起摘要,需改成同一面板,并在中栏补齐操作 | P0 | 收起、窄屏、文件入口和右栏展开打开的是同一任务 ID。窄屏下点击入口在中栏内联展开该卡,不出现抽屉或遮罩,输入焦点不移动,已读只按 NB24 判定。右栏关闭时可以读摘要和依据、处理确认或用途选择、打开文件 | 现有右栏 | 纳入增量 1 |
| NB19 | 后台运行和普通待选卡不使聊天一直排队。前台生成中可以短暂排队。跨刷新、跨会话恢复不在本需求 | 需调整后符合;当前完成后通知回合会占住会话 | P0 | 材料整理进行中直接发送的新消息进入对话,而不是一直停在本地队列。刷新之后排队消息是否还在,不作为本需求的验收 | 会话占用 | 纳入增量 1 |
| NB20 | 升级后仍能阅读旧会话。重复进展按新规则折叠展示,原始事件还在。旧完成卡若只有 160 字摘要,概览标明这是当时保存的开头,并尽量链到已存全文 | 需调整后符合 | P1 | 打开含 80 次重复进展的历史会话,默认时间线没有 80 行相同开头;详细记录仍能按事件查看 | 旧事件只读 | 纳入增量 2 |
| NB21 | 后台失败时原卡进入失败状态,保留已保存的部分结果和原因,不启动汇报回合。未读与轻提示仍发生一次。对应 r1.1 R08、R17 | 需调整后符合;失败目前可能随通知回合出现 | P0 | 失败卡不显示成功完成。中栏消息条数不因失败汇报增加。已保存的部分结果仍可打开 | 原任务卡与 run 终态 | 纳入增量 1 |
| NB22 | 选择已过期或已处理时,界面刷新成服务端状态,旧选项不能再次提交。对应 r1.1 R07 | 需调整后符合;r1.1 已有方向,r2 选择改到卡内后须保持 | P0 | 服务端返回已处理或版本过期后,原选项不可提交,中栏与右栏状态一致 | 选择版本 | 纳入增量 1 |
| NB23 | 展开不得展示隐藏思维链、系统或开发者提示、凭据、原始请求载荷、未授权工具数据。展开不提升权限。成果不是思维链(r1.1 §7.3) | 需保持;r1.1 §7.3 已批准 | 约束 | 夹具含上述类别时,任务卡、中栏入口和引用标签都不可见这些内容 | 现有权限 | 随增量 1 保持,不单独排期 |
| NB24 | 已读、再次未读、当前/历史分组和暂不处理按 §4.5 的互斥状态表转换。只有用户针对具体结果版本主动展开、打开全文、激活「有 1 项更新」或显式标记,才算已读;布局切换、刷新、组件重挂载和仅出现在视口不算。新的成功或失败终态版本使任务未读,仅启动重试不触发。未读数增加的是此前没有未读版本的任务,不是每个结果事件 | 符合度待核实:未读与暂不处理尚无这一状态机 | P0 | 右栏关闭后因布局切换自动展开该卡,未读仍在;刷新和重挂载后未读不变;用户手动展开该版本后未读消失。同一任务已有未读时再完成新版本,未读数不变;已读后再完成才加一。失败终态使任务未读,启动重试不使其未读。正在阅读的历史卡收到更新时暂留原位显示「有 1 项更新」,用户离开后迁入当前工作;激活该提示才把新版本标为已读。点「暂不处理 · 可随时继续」回到待选且不新建请求 | 结果版本与选择状态 | 纳入增量 1 |
## 4. 方案设计
### 4.1 方案选择
| 方案 | 结果 | 结论 |
|---|---|---|
| A. 只改样式和截断长度 | 重复行、自动回合和滚动联动还在 | 不采用 |
| B. 完成后仍自动追加一轮短回复 | 对话顺序仍会被后台打断 | 不采用 |
| C. 完成后完全无提示 | 容易漏看结果 | 不采用 |
| D. 右栏持续更新同一张卡,加未读和一次轻提示;选择留在卡内;对话只在用户引用或主动提问时继续;右栏不可见时中栏承担同一张卡 | 对齐第 1 节场景,并保持 R11 | **推荐** |
### 4.2 职责
```text
右栏「工作」可见时
中栏:用户与助手发言;前台回合的折叠过程;「已启动材料整理」→ 打开该任务;文件打开入口
右栏:当前工作(新在上);同一任务卡;选择与选择历史;工作历史
右栏关闭、切到「文件」或窄屏时
中栏:除上述发言外,展开同一 taskId 的完整卡片与操作(摘要、依据、选择、打开文件)
文件入口:仍只做列表和预览
```
异步状态只有一个所有者:服务端任务快照。前端按事件 seq 更新,过期事件丢弃。
中栏入口、中栏展开卡和右栏卡片读取同一任务 ID,不各算一份摘要。
### 4.3 任务卡与 r1.1 四层阅读
| r2 卡片层 | r1.1 | 默认展示 |
|---|---|---|
| 概览 | L0 一行汇总加 L1 工作摘要 | 任务名称、关联材料、状态、创建/更新/完成时间,以及当前在做什么或已经得到什么 |
| 工作详情 | L2 阶段与依据 | 内容要点、完整结果、依据、范围、文件、选择与补充要求 |
| 执行记录 | L3 执行记录 | 已保存且当前用户有权查看的公开过程、工具名、已授权参数和输出,默认折叠 |
不在任何一层展示:隐藏思维链、系统或开发者提示、凭据、原始请求载荷、未授权工具数据。
展开不提升权限。这是 r1.1 §7.3「成果不是思维链」在 r2 的保持项(NB23)。
运行时活动行使用真实阶段,例如「已提取文档文字」「正在整理内容结构」。
「已整理的要点」只接收已经形成的实质结果。工具名和「我来检索」留在活动行或执行记录,不进入要点。
完成时概览切到「整理结果」。正文来自后台最终消息的结构化要点;要点缺失时显示
「整理结果已生成,查看完整结果」,并链到已保存全文。实现上停止把全文开头 160 字写入用户可见摘要。
### 4.4 进展归并
`agent.progress` 继续可以高频产生,原始事件不删。展示层为每个子任务维护一条「当前文字」:
同一文本流的后续累计内容替换这一条。阶段变化才新增阶段记录。
工具开始和工具结束只更新活动行,并记入执行记录,不新增阶段记录。
回放与实时使用同一归并规则,避免刷新后再次刷出重复行。
### 4.5 到达、已读与引用
未读、已读和分组共用一套互斥状态。状态属于「任务 × 结果版本」,由服务端持有,前端只投影。
**1. 已读判定(唯一入口)**
只有用户针对具体结果版本做出下列主动动作之一,该版本才算已读:
- 主动展开该版本的工作详情;
- 主动打开该版本的完整结果或全文;
- 激活该卡上的「有 1 项更新」;
- 显式点「标记已读」。
下列情形一律不算已读:布局切换(右栏关闭、切到文件、窄屏)带来的自动展开、页面刷新、
组件重挂载、卡片仅出现在视口、轻提示出现或消失。已读按版本记录;已读旧版本不使新版本已读。
**2. 未读转换与计数**
| 事件 | 该任务未读 | 未读数 |
|---|---|---|
| 新的成功终态版本 | 置为未读 | 此前该任务没有未读版本才加 1 |
| 新的失败终态版本(含失败后的新尝试以失败结束) | 置为未读 | 同上 |
| 仅启动重试或重新生成(尚无终态) | 不变 | 不变 |
| 已有未读版本时又来新终态版本 | 仍为未读,未读版本集合增加 | 不变 |
| 用户对最新未读版本做出 §1 动作 | 清除该任务未读(仍有更旧未读版本时一并清除,已读按「用户看到最新版」计) | 减 1 |
未读数 = 仍有未读版本的任务数,不按结果事件条数计。轻提示每次终态版本到达发一次,
多任务同时完成可合并成一条计数提示;轻提示不影响未读数。
**3. 当前工作与工作历史互斥**
| 卡片状态 | 所在分组 |
|---|---|
| 进行中、等待输入、有未读版本 | 当前工作 |
| 已读、无待选、无进行中的终态卡 | 工作历史(默认折叠) |
| 正在被用户阅读的历史卡收到新终态版本 | 暂留工作历史原位,卡上显示「有 1 项更新」,不改变排序、展开状态和滚动位置;用户离开该卡后,按其未读状态迁入当前工作 |
| 阅读中的历史卡,用户激活「有 1 项更新」 | 新版本标为已读,卡片留在原位 |
一张卡同一时刻只属于一个分组。「正在阅读」指用户已主动展开该卡且仍停留在其中;
离开指展开态被用户收起或焦点和展开目标切到其他卡。
**4. 与选择状态的关系**
选择状态(待选 / 已选 / 暂不处理)与未读相互独立,各自转换。「暂不处理」写入 `deferred`
并收起选择区。点「暂不处理 · 可随时继续」回到待选并展开原选项,不新建请求,也不改变未读。
选择已过期时改为刷新服务端状态,不恢复旧选项。
**5. 引用**
引用保证被引用的结果版本进入下一条用户消息的上下文。它不是助手读取结果的唯一前提。
引用动作本身不算已读。
后台完成时:
- 原任务卡写入结果版本,标记「新结果」。
- 按 §2 更新未读,按 §3 决定分组。
- 轻提示一次,带材料名。
- 不插入历史消息,不追加助手长回复,不移动焦点,不改变滚动位置。
「引用结果到对话」在输入区放一个可移除标签。用户发出下一条消息时,该消息成为普通回合,
并记录被引用的任务和结果版本。助手回答相关问题时可以读取这个已经完成的版本。
没有引用时,助手只可通过当前用户已有权限的任务结果查询读取。回答不得写成「我已看过该版本」,
除非这次查询实际读到了它,并说明读到的是哪一版。
多个任务同时完成时,每张卡各自更新,未读按任务计数,轻提示可以合并成一条计数,
仍然不启动汇报回合。
### 4.6 选择
卡片底部:
```text
接下来想怎样处理?
这一步可以稍后决定,你可以继续对话。
○ 看一份简明摘要
○ 提取参数与重点
○ 检查缺项和不一致
补充要求
[例如:先关注使用流程和技术参数……]
[按此处理] [先不选择]
```
- 互斥方案用单选。可以组合的事项用多选,并写明「可多选」。
- 推荐标记只是标识。
- 「先不选择」写入选择状态 `deferred`,选择区收起为「暂不处理 · 可随时继续」。
- 点该提示重新展开原选择区,状态回到待选,不新建任务请求。
- 选择历史保留选项、补充要求、提交时间和后续工作结果。
- 「已选择」与「生成完成」是两条状态。
需要授权的操作仍使用现有确认卡,只阻塞依赖该授权的工作。自由输入和「先不选择」的存储值
不得被执行器解释为同意。
### 4.7 直接消息与任务请求
绑定到待选任务的入口只有三个:卡片内输入、消息里明确引用该任务、确定性规则判定为在回答
该材料的用途。规则至少同时识别材料指向和用途动作。无法同时满足时,只澄清关联,不静默绑定。
任务请求键由两部分组成:授权作用域(认证账号、项目、来源会话)和现有内容字段
(材料内容 hash、解析版本、用途、请求版本)。选择按钮与聊天消息使用同一键。
复用既有请求须同时满足:作用域三项与既有请求一致,且请求者此刻仍有权限访问该项目、会话和材料。
任一不满足时不命中既有请求:不返回其进展,也不提示存在相同请求,按没有既有请求处理。
已有未完成或已完成且范围相同的请求时,展示其进展,不另起一份。重复的明确指令也走这条规则,
不再次启动工作。用户明确要求重新生成或改变范围时,请求版本递增,保留旧结果。
直接交代的收尾:确定性规则命中并绑定后,无论复用已有请求还是新启一次,都把所属任务卡的
选择状态写为「已选」,记录选项、来源(聊天指令)和提交时间,并关闭待选区;不留下待选区,
也不留下「暂不处理」收起提示。指令只满足多选卡中的部分选项时,只关闭这些选项。
重复的同一指令不新增选择记录。规则未命中或有歧义时,选择状态保持不变。
`materialKey` 继续可以存在于受控元数据,供旧客户端识别;用户默认卡身不展示内部键。
内容身份以 hash 和解析版本为准,与 r1.1 §8.3 一致。
### 4.8 右栏、滚动与时间
当前工作:进行中、确实等待输入、新到未查看。新任务在上。
工作历史:按完成或处理时间倒序,默认折叠成紧凑行。
删除中栏滚动百分比到右栏的写入。`flashElement` 只在用户点击定位后使用。
用户停留在某张历史卡时,新结果不改变排序、展开状态和滚动位置,只显示「有 1 项更新」。
消息时间来自消息创建时间,后台卡更新不回写它。跨天显示日期。
完整时间戳有四条路径:指针悬停、键盘聚焦、触屏点按、屏幕阅读器。
实现使用 `time` 元素的 `datetime`,可访问名称包含完整本地时间。
具体控件在阶段 5 确认,只用 `@ui` 已有原语,不新增私有样式。
卡片显示「创建」「更新」「完成」。选择记录显示「11:09 已选择:简明摘要」。
阶段和执行记录显示事件时间。正文流式输出不逐段显示时间。
右栏「工作」可见时,中栏只留短入口。右栏关闭、切到文件或窄屏时,中栏展开同一任务的完整卡片与操作。
窄屏只有一种落位:中栏内联展开同一 taskId 的卡,不打开抽屉或遮罩。内联展开不移动输入焦点,
不改写两栏滚动位置,也不因展开本身标记已读(见 §4.5)。收起提示打开的同样是这一任务面板。
### 4.9 失败与存量
| 情况 | 表现 | 需求 |
|---|---|---|
| 后台失败 | 原卡进入失败状态,保留已保存的部分结果和原因。不启动汇报回合。未读与轻提示仍发生一次 | NB21 |
| 选择已过期或已处理 | 刷新成服务端状态。过期选项不能再次提交 | NB22 |
| 重复点击 | 同一请求键只执行一次,按钮进入已提交 | NB13 |
| 刷新与断线 | 卡片、选择状态和未读从服务端恢复。连接提示不改写业务终态。前台排队消息的跨刷新恢复不在本轮 | NB19 的排除项 |
| 旧的重复进展 | 默认按 4.4 折叠;详细记录按原始 seq 查阅 | NB20 |
| 旧的 160 字摘要 | 概览标明这是当时保存的开头,并链到已存全文。不把旧摘要改写成新的模型结果 | NB20 |
| 无全文可链 | 显示「当时只保存了开头,完整结果不可用」 | NB20 |
### 4.10 数据与权限
新增或收紧的状态:任务请求键、选择状态(待选 / 已选 / 暂不处理)、结果未读、输入区引用。
它们归属会话和项目的现有权限。未读是展示状态,不改变 run 终态。
引用只携带当前用户已经能阅读的任务结果版本,并在两个时点重新鉴权:发送消息时,和组装模型上下文时。
任一时点权限已撤销:不注入该版本内容;用户可见提示和助手回答不得区分「无权」与「不存在」,
不泄露资源是否存在、标题或大小。任务请求键的授权作用域见 §4.7;复用前同样按请求者当前权限判定。
不新增跨项目读取。执行记录的可见性保持现有权限,展开不提升权限。
公开投影排除隐藏思维链、系统或开发者提示、凭据、原始请求载荷和未授权工具数据。
不新增前台 outbox 的服务端记录,也不定义作者私有草稿的保存、恢复和删除。
### 4.11 待验证假设
| 假设 | 验证 | 若失败 |
|---|---|---|
| 最终消息里能够稳定抽出要点 | 增量 1 用已保存子代理消息做投影测试 | 没有要点就用诚实占位,不回退到截断开头 |
| 确定性绑定能覆盖「总结一下这份材料」这类句子,同时不误绑无关消息 | 增量 1 的语句样本,含无关话题、含糊句和重复的明确指令 | 含糊句只澄清。重复明确指令复用已有请求。不在未批准时改成模型判断 |
| 去掉自动汇报后,轻提示足够让用户找到结果;右栏关闭时中栏卡片同样可达 | 阶段 7 的浏览器走查,按下方 §4.11.1 逐项记录 | 调整提示位置或中栏展开,仍不恢复自动长回复 |
#### 4.11.1 轻提示可达性走查
前置:右栏关闭;中栏输入框有焦点且含未发送文字;两栏均已滚动到非初始位置并记录像素位置;
材料整理在后台完成并留下一个待选的用途选择。
| 步骤 | 通过判据 |
|---|---|
| 1 完成到达 | 轻提示出现并含材料名;中栏消息条数不变;输入焦点、输入文字和两栏滚动位置与前置记录一致 |
| 2 一步定位 | 只点一次轻提示或未读入口,同一 taskId 的卡在中栏内联展开并可见,无需先打开右栏 |
| 3 完成一次选择 | 在该卡内选一个用途并提交,卡内显示实际选择;其间不要求打开右栏 |
| 4 状态不被污染 | 全过程输入焦点和输入文字不变,两栏滚动位置在展开前后一致(卡片自身展开导致的高度变化不得牵动另一栏);未读只在步骤 2 的主动展开后减少,步骤 1 结束时仍为未读 |
执行与记录:由非作者执行并按步骤逐项记录通过或失败、浏览器与视口、对象 SHA、时间、执行人;
作者本人的走查只能标 SELF,不替代这份记录。窄屏视口重复一遍,并确认全程没有抽屉或遮罩出现。
任一步失败,本假设按「若失败」处理。该走查在阶段 7 前保持 `NOT_RUN`。
## 5. 验收场景
主场景即 1.2。边界同时覆盖:多个任务同时完成、右栏关闭、切到文件、刷新、重复点击、
重复的明确指令、直接交代后选择关闭、旧选择过期、后台失败、暂不处理后再展开、未读与再次更新、
布局自动展开不算已读、跨账号或权限撤销后的请求复用和引用、窄屏内联展开。
判据:进展不刷重复行;完整结果能读到;选择不锁住无关对话;同一摘要只执行一次;
结果到达不改变消息顺序;历史记录的是用户实际决定;右栏不可见时中栏能完成阅读、选择和打开文件;
排除项不会出现在展开内容里。
这些场景在本稿阶段是计划,状态 `NOT_RUN`。设计文档的保存不表示场景已通过。
## 6. 评审记录
| 阶段 | 对象 | 结论 | 评审人 | 时间 | 依据 |
|---|---|---|---|---|---|
| 1 需求拆解 | 本稿 §1 @ r2-draft.3 | 未评审 | — | — | 待人工确认与原始意图一致 |
| 2 需求评估 | 本稿 §2 @ r2-draft.3 | 未评审 | — | — | 待人工确认取舍与 U3 并行方式 |
| 3 需求表确认 | 本稿 §3 NB01–NB24 | 未评审 | — | — | 待人工确认范围与验收条件 |
| 4 方案设计 | 本稿 §4 @ r2-draft.3 | 未评审 | — | — | 待人工批准后,拟取代条款才生效 |
| 5 实施计划 | [实施计划](2026-10-15-fast-slow-r2-nonblocking-plan.md) | 未评审 | — | — | 待阶段 1–4 通过后单独评审;未授权写业务代码 |
### 6.1 修订记录
| 项 | 内容 |
|---|---|
| 对象 | Dev `7b87e03`、Documents `3a43ce6` 上的 r2-draft |
| 意见 | 阶段 1–4 建议「需修改」,不是拒绝。阶段 5 未评审 |
| 来源 | SELF。智能体评审不能替代人工阶段批准 |
| 本稿 | r2-draft.2。阶段结论保持未评审 |
| 裁定 | 引用是保证上下文,不是读取结果的唯一前提。已读以展开详情、完整结果或显式标记为准,视口曝光不算。这两项仍可在人工评审时改 |
| 同步 | 修订前 `task-sync` 到 Dev `692735e`。该提交包含评审提到的 `7a0f934`。Documents `origin/main` 为 `d668a3e`。§2.1 行号已按 Backend `80bb123` 重验 |
#### 第二轮(r2-draft.2 → r2-draft.3)
| 项 | 内容 |
|---|---|
| 对象 | Dev `13d2315`、Documents `a672adb` 上的 r2-draft.2 |
| 意见 | 阶段 1、3、4 建议「需修改」,阶段 2 内容可接受但随阶段 1 保持未评审,阶段 5 未评审。不是拒绝,未发现不可行项 |
| 来源 | SELF。智能体复审不能代签人工批准;阶段 1–4 仍为未评审 |
| 本稿 | r2-draft.3。仅改文稿,未改业务代码 |
| 1 窄屏落位 | 只保留中栏内联展开同一 `taskId`,删除窄屏抽屉表述(§1.1、§1.3、NB18、§4.8) |
| 2 状态机 | 新增 §4.5 互斥状态:已读判定唯一入口、未读转换与计数、当前/历史分组互斥、与选择状态的关系;NB07、NB16、NB24、§1.3 同步 |
| 3 授权边界 | §4.7 请求键限定认证账号、项目、来源会话,复用须归属一致且仍有权限;§4.10 引用在发送与组装上下文时重新鉴权,撤销后不注入也不泄露存在性;NB08、NB13 验收补充 |
| 4 直接交代 | NB12 验收与 §4.7 写入「直接交代后关闭已满足的选择」,含多选部分满足与重复指令 |
| 5 可达走查 | 新增 §4.11.1:右栏关闭时一步定位并完成一次选择,焦点与两栏滚动不变,由非作者逐项记录;§5 边界同步 |
| 待澄清项 | 按评审建议保留 §1.5 当前写法:确定性绑定、不离线回填旧摘要、引用不是读取的唯一前提 |
| 同步 | 修订前 `task-sync` 到 Dev `ff3a562`(相对 `692735e` 只新增任务卡闭合提交,未推进业务组件) |
| 现场 | 任务卡相对 `13d2315` 曾有 114 行未提交删除(主要是两段 SELF 收据);经用户确认后先另存补丁到源码外 `/tmp`,再还原,随后启动检查 READY |
| 未执行 | 真实模型、浏览器走查和 `make test`:`NOT_RUN` |
源码核对:SELF,2026-10-15,对象见 §2.1。真实模型、浏览器和部署:`NOT_RUN`。
@@ -0,0 +1,108 @@
# 分层 Python 环境方案 r1
状态:待评审(收录不是批准)。编制:2026-10-15。
触发:dev 8788 会话 `cnv_7936c0a799ff` 中,智能体无法把已有 Markdown 摘要渲染成 docx,并向用户报告「没有 Python 对应的包」。
## 1. 已核实的故障(不是「缺包」本身)
8788 的 `run_python` / `run_shell` 跑在 bwrap 沙箱里(只读根、`--tmpfs /home`、`--unshare-net`)。同一台宿主机的 `~/.local` 里其实已经有 python-docx、lxml、openpyxl、python-pptx。失败来自四件事叠在一起:
1. **依赖层没有接线。** 代码已有 `--exec-deps-dir`(F3),但 `scripts/svc.sh` 与 8788 的启动参数都没有传入它。沙箱把 `/home` 遮掉之后,`~/.local` 不可见。
2. **解释器解析到会被遮掉的路径。** 服务进程的 `PATH` 里 linuxbrew 在 `/usr/bin` 之前,`python3` 被解析成 `/home/linuxbrew/.linuxbrew/bin/python3`。沙箱里这条路径不存在,`run_python` 得到 `exit=127`。
3. **工具说明指向一条走不通的安装路径。** `run_python` 描述和 `base.deliverables` 都写「缺库先 `pip install --user`」。沙箱断网、根只读、家目录是空 tmpfs,这条命令必然失败。
4. **没有向系统申请包的通道。** 智能体只能探测、报错、让用户选择,再派一个后台任务去轮询一个永远不会出现的依赖。
同一次会话里还有多次模型网关 `401 invalid_api_key`。那是密钥问题,不在本方案范围内。
## 2. 目标
每个工作区和沙箱都能直接使用系统提供的 Python 能力(解释器 + 办公与数据处理基础包),不必各自新建虚拟环境。某个工作区需要额外的包时,向系统申请;系统决定装不装,并只把结果挂给这个工作区。
成功标准:
- 沙箱内 `import docx, openpyxl, pptx` 成功,`python3 -m housestyle.build` 能产出通过结构自检的 docx。
- 两个工作区要同一包的不同版本时,互不影响,基础层版本不变。
- 沙箱仍然断网。安装只发生在宿主侧的构建器里,并且只接受带哈希的预编译 wheel。
- 白名单内的包自动批准;白名单外、要改基础层版本、体积超限、用户上传的 wheel,弹审批卡。sdist 与黑名单直接拒绝。
## 3. 不采用的两条路
- **每个工作区一个 venv。** 贵的是重复下载、解析和安装,不是 venv 目录本身。同样的包会被装很多遍。
- **所有包装进一个可变的系统环境。** 一个工作区的需求会改变所有工作区的行为,版本冲突无法隔离,也无法复现「当时用的是哪一套包」。
## 4. 采用的结构
所有环境层不可变,按内容哈希命名,按会话挂载。系统只新增层,不改已经发出去的层。
```text
<envroot>/ 默认 runtime/envs/,各服务实例共享
python/cpython-<ver>/ 系统托管的 CPython(只读)
python/current -> 上述目录
layers/base-<hash>/site-packages
layers/x-<hash>/site-packages 扩展层:相对基础层的增量闭包
layers/iso-<hash>/site-packages 完整隔离层:仅在审批通过「覆盖基础层版本」时使用
wheelhouse/ 按 sha256 去重的 wheel
locks/<hash>.json
catalog.json 白名单、黑名单、单包体积上限
current -> layers/base-<hash>
bin/pip 垫片:提示改用 python_env,不以安装成功退出
```
层键 = 锁文件内容 + Python 标签 + 平台的哈希。同一份需求在任何工作区都命中同一层。
基础层由系统策划,首批为:python-docx、openpyxl、python-pptx、lxml、Pillow、numpy、matplotlib、pypdf、reportlab、markdown、pdfplumber,以及它们的传递依赖。名单可以在评审时增减;锁文件在第一次 `env ensure` 时生成并应入库,之后构建按锁复现。
解释器优先使用托管前缀(python-build-standalone 的 install_only 包)。下载失败时,退化为用系统 `python3 -m venv` 做一份唯一的托管前缀,并在 `python/SOURCE` 里写明这是退化,不是每个工作区各做一份。沙箱里的 `python3` 永远是这个前缀的绝对路径;找不到托管前缀时才用 `/usr/bin/python3`,不再走会落到 `/home` 下的 `PATH` 查找。
## 5. 一次执行如何看到这些包
沙箱参数在 `--tmpfs /home` 之后,只读挂载:托管解释器前缀(如果它位于会被 tmpfs 遮住的路径上)、基础层、该会话绑定的扩展层。`PATH` 固定为 `<托管 bin>:<envroot>/bin:/usr/local/bin:/usr/bin:/bin`,不再继承宿主 `PATH`。`PYTHONPATH` 是这些层再加上 house-style。`PIP_NO_INDEX=1`。
扩展层与基础层来自同一次以基础层为约束的解析,每个发行名只有一个版本,所以叠放顺序不影响导入。隔离层例外:它替换基础层,而不是叠在上面,用来满足「这个工作区必须要 numpy<2」这类与基础层冲突的需求。
## 6. 申请(工具 `python_env`)
动作:`status`、`request`、`wait`。
- `status` 返回基础层包清单、本会话已绑定的层、未完成的申请。
- `request` 带包规格或工作区内的 `.whl`。解析以基础层锁为约束(等价于带 constraints 的 `pip install --dry-run --report`)。分级:
- 全部在白名单内、纯 wheel、未超体积:自动批准并构建。命中已有层时只是多挂一个目录。
- 白名单外、要覆盖基础层已固定的版本、超体积、用户上传的 wheel:写入 `exec_env_requests`,发一张选择卡(批准 / 拒绝;覆盖基础层版本时多一个「建隔离层」)。系统管理员或该会话的属主可以批。决定写入 `audit_events`。
- 只有 sdist、命中黑名单、解析失败、哈希不符:拒绝,并说明原因。
- 构建在宿主侧进行:`--only-binary=:all:`,校验 sha256,只用解包 wheel,不执行 setup.py。这是唯一有网络的步骤,并且不在沙箱里。
- 构建完成后把层 ID 写进 `exec_env_bindings`。下一次 `run_python` / `run_shell` 挂上这些层。`wait` 在短超时内轮询申请状态。
## 7. 三个顾虑如何被挡住
- **成本。** 基础层覆盖常见办公和数据场景。wheel 与层按哈希缓存,第二个工作区要同一套包时不再下载、不再解析。
- **冲突。** 不存在共享的可变环境。冲突需求要么被拒绝并说明卡在基础层的哪一个版本,要么经审批得到一份只属于该会话的隔离层。基础层哈希不变。
- **包都堆进系统环境。** 基础层只放策划过的包。扩展层按会话绑定,其他会话看不见。升级基础层生成新的 `base-<hash>` 并移动 `current`;已经绑定旧基础层的会话保持不动,直到显式 rebase。
## 8. 安全
- 沙箱断网、根只读、家目录遮蔽,这些都不放宽。
- 不在宿主上执行第三方构建脚本。
- 只挂当前会话绑定的层。
- 申请记录含会话、包、wheel 哈希、批准人。
- 任务封存时应能读到基础层哈希与层 ID(绑定表就是这份清单)。
## 9. 实施切片
- **P0** 解释器与 `PATH` 不再指向会被沙箱遮住的 linuxbrew;`svc.sh` 在环境根存在时传入 `AGENT_SYSTEM_EXEC_ENV_ROOT` 与基础层 `AGENT_SYSTEM_EXEC_DEPS_DIR`;工具说明与提示词改为 `python_env`,去掉 `pip install --user`;配置了依赖层时启动做真实导入探针。
- **P1** 环境根、锁、层、wheelhouse、托管解释器,以及 `agent-system env ensure|lock|gc|doctor|rebase|python`。
- **P2** 表 `exec_env_requests`、`exec_env_bindings`,工具 `python_env`,分级审批,pip 垫片,按会话挂载。
- **P3** 管理区「Python 环境」页(层、申请、批准/拒绝、rebase、gc、上传 wheel)。
## 10. 验收
- `sandboxArgv` 覆盖多层只读挂载、固定 `PATH`、`PIP_NO_INDEX`。
- 离线解析夹具:冲突、白名单、sdist 拒绝、哈希不符。
- 有 bwrap 时:沙箱内能导入层里的模块,`pip` 垫片给出申请指引,外网不可达。
- 两个会话分别要 `foo==1` 与 `foo==2`,各得一层,基础层哈希不变。
- 在基础层可用时,`housestyle.build` 产出的 docx 通过既有 OOXML 结构自检。
## 11. 已定与未定
已定(2026-10-15 对话):白名单内自动批准,其余弹审批卡;解释器由系统托管,而不是长期绑死宿主 `/usr/bin/python3`。
未定,留在评审:基础层最终包名单是否增减;审批人除系统管理员和会话属主外,是否还要接项目角色。本实施先只认系统管理员与会话属主,避免在基座里发明第二套项目角色判断。
@@ -0,0 +1,48 @@
---
title: 文档职责矩阵整改
date: 2026-10-15
type: feature
execution: code
artifact_contract: rdm-duty-matrix/v1
product_contract_source: legacy-requirements
---
# 文档职责矩阵整改 r2
负责人:weichen;编制日期:2026-10-15。
本记录是文档职责整改的唯一主记录。它取代
[r1 增量方案](2026-10-13-rdm-settings-members-duties-perms-increment.md)
第四节,以及该方案 P5、P7 中“文档职责页”的交互;r1 的设置归属、成员、权限矩阵与其余工作包继续有效。
候选分支 `feature/rdm-settings-completion` 里的文档职责界面暂停合入。系统设置、成员选择、权限矩阵和已落地的后端安全能力不在本暂停范围内。本任务从当时的 `origin/main` 另起兄弟分支 `feature/rdm-duty-matrix`,不把该候选当作父分支。
## 四项领域裁定
1. 职责只到文档级。项目设置不再新增章节级职责;历史章节审签只读保留。
2. 项目设置只分配已有受控文档的编制、审核、批准职责。不创建文档、不从模板生成、不提交审核、不审核通过、不驳回、不终批。
3. 每份文档恰好一名编制、至少一名审核、恰好一名批准。同一人在同一文档上只担一个职责。审核可以有多人。
4. 与文档职责完全一致的旧章节覆盖可以归并为文档级。同一文档下章节人员不一致的,列出清单,由项目负责人逐文档确认,不自动覆盖。
项目负责人可以分配职责,但不因负责人身份自动成为编制、审核或批准人。当前职责与已冻结的审签名单分开保存;修改当前职责不改写已批准版本和历史名单。
姓名来源仍按 r1 评审补充第 3 条待证。本页用账号标识展示,不把未证实的姓名字段写进契约。
## 契约
读:`rdm.duty.matrix`。`view` 为 `member`、`document` 或 `matrix`。筛选在分页之前。文档页上限 20。响应给出文档完整性、`dutyVersion`、章节覆盖数、在途轮次、成员资格、单元格 `none|author|reviewer|approver`,以及当前操作人是否可分配。单元格只投影当前文档级职责。没有 `duty.assign` 的调用直接拒绝,避免矩阵列头泄露不可见文档。
写:唯一入口仍是每份文档的完整目标,`rdm.review.assign.doc` 与 `rdm.review.assign.doc.batch`(1–20 项,整批原子)。带 `expectedDutyVersion` 与 `confirmInvalidation`。`rdm.review.assign` 只返回“章节级职责已停用,请在文档级设置”。
预览:`rdm.duty.preview` 与写载荷相同,只读返回替换对象、在途失效和缺人原因,不写数据。保存时服务端重新校验。
迁移:`rdm.duty.legacy.scan` 只读;`rdm.duty.legacy.apply` 只清除与文档职责完全一致的章节覆盖。
## 三视图
按人员、按文档、成员×文档矩阵共享同一份服务端数据和同一份未保存草稿。单元格由文档三权反推。把唯一编制或批准改成其他值可以继续编辑,但在指定接替人前不能保存。替换已有编制或批准时提示“将替换某某”,保存时一次替换。窄屏不压缩整张矩阵,改走前两个视图。一次保存最多 20 份文档。请求带递增序号,过期响应丢弃。写入结果未知时重读,不自动重放。
页面顶部写明:本页只分配已有文档的职责,不创建或生成文档。
## 验收
单文档三权恰好、多审核人、一人一责、三视图草稿一致、替换提示与原子替换、缺人禁止保存、成员失效保存被拒、版本冲突、批量整批失败不写、影响预览与历史不变、无私密文档列头泄露、无创建/生成/审签按钮、迟到响应不覆盖、design-guard、`make test` 与 `make build`。部署和真实账号浏览器验收另行授权。
+7 -5
View File
@@ -4,7 +4,8 @@
本索引负责导航与差异提示,规划正文、批准范围和验收条件仍以链接的主记录及其批准版本为准。
合入授权不批准新方向、不调整里程碑范围、不启动新的业务任务。
待评审(收录不是批准):[svc 插件组合部署(--with)方案 r1](2026-10-14-svc-plugin-compose-deploy.md)。
待评审(收录不是批准):[svc 插件组合部署(--with)方案 r1](2026-10-14-svc-plugin-compose-deploy.md);
[分层 Python 环境方案 r1](2026-10-15-layered-python-env.md)(8788 无法生成 docx 的环境层;白名单自动批准,其余审批)。
## 先看哪一份
@@ -17,9 +18,6 @@
- [快慢通道展示与动态工作摘要方案 r1.1](2026-10-12-fast-slow-channel-display.md):
运行卡呈现状态、已完成工作、当前发现与剩余项;四层阅读、阶段成果、来源、异常恢复及 U1–U4。
2026-10-12 方案设计已批准(阶段 1–4);首批仅 U1;[U1 实施计划 r1](2026-10-12-fast-slow-channel-display-u1-plan.md) 待阶段 5 批准;业务实施和运行验收 NOT_RUN。
候选增补 [r2 非阻塞对话与任务卡](2026-10-15-fast-slow-r2-nonblocking.md) 与
[r2 实施计划](2026-10-15-fast-slow-r2-nonblocking-plan.md) 已修订为 r2-draft.3,阶段结论仍为未评审。
评审通过前 r1.1 仍然有效,r2 不取代已批准条款,也不授权业务代码。
Generative UI 方向已收口(U1–U7 全部落地,2026-10-12):[使用说明与评测记录](2026-10-12-generative-ui-usage-and-evaluation.md)(final);
主记录 [r2](2026-10-10-generative-ui-plugin.md) 与 [U5 动作范围 r2](2026-10-11-generative-ui-u5-action-scope.md) 保留为过程权威。
@@ -185,7 +183,11 @@ RDM 总案把库分期作为支撑与依赖,不覆盖库分期的原始范围
- [最终验证与合入调度实施计划 r1](2026-10-13-merge-queue-implementation-plan.md):阶段 5 已于 2026-10-13 经用户「批准」确认,原生逐项实施;U1–U3 源码与自检在 Dev 任务分支推进,U4 待启用记录及规则已准备,U5 平台所有者操作与 U6 真实三任务 CI 试行仍 NOT_RUN。实际对象、证据和进度回链 Dev 任务卡,不把本索引当第二进度权威。
- [RDM 设置归属、成员、文档职责与权限矩阵完善增量方案 r1](2026-10-13-rdm-settings-members-duties-perms-increment.md):承接总案 U3/U4/U6(衔接 U5)的完整增量——设置作用域与受管项、可搜索人员选择器、文档清单+职责分配、单成员/多人权限矩阵与三态项目覆盖;含服务端一致性修复(职责目标成员校验推翻 G1-5 旧裁定、职责变更与审签失效原子化)与 P1–P8 工作包。**2026-10-13 用户评审通过并授权实施**(两批推进;正式验收与清理回收保留人工节点);P1 契约随本稿固定,P2 基座契约扩展按总案发版顺序排队。
- [RDM 设置归属、成员、文档职责与权限矩阵完善增量方案 r1](2026-10-13-rdm-settings-members-duties-perms-increment.md):承接总案 U3/U4/U6(衔接 U5)的完整增量——设置作用域与受管项、可搜索人员选择器、单成员/多人权限矩阵与三态项目覆盖;含服务端一致性修复。**2026-10-13 用户评审通过并授权实施**。第四节及 P5/P7 的文档职责页交互已被下方 r2 取代,其余部分继续有效。
## 2026-10-15 规划补充
- [文档职责矩阵整改 r2](2026-10-15-rdm-duty-matrix-rework.md):项目设置只分配已有文档的编制、审核、批准;按人员、按文档、成员×文档三视图共享一份草稿。章节级新指派停用,有歧义的旧章节职责逐文档确认。2026-10-15 按实施方案执行;部署与真实账号验收未授权。收录不把其余未完成增量自动标成已验收。
## 2026-10-12 规划补充