docs: design DSH native diagnostic workspace

This commit is contained in:
abaishu0730 committed 2026-10-27 15:48:41 +08:00
1 parent d744c36365
commit b2498baeb7
1 file changed
+250
@@ -0,0 +1,250 @@
# DSH 原生交互诊断工作区设计
日期:2026-10-27(Asia/Shanghai)
分支:`dsh`;调研基线:`d744c363654bfaacf217f5b0f85a10fea0e45abb`
状态:方向与主要交互已确认;本文汇总设计,待用户整体评审。本文不是编码或部署授权。
## 1. 已确认的方向
用户依次确认:
1. 内核深度参考 DeepSeek Harness(DSH);界面尽量复刻原生交互,以缩短迭代周期。
2. 选择“原生交互复刻到现有工作台”,保留工作台账号、权限和审计。
3. 第一版以运行诊断为主:连接、采集、归档和失败原因。
4. 使用三栏诊断工作区:左会话、中对话/事件、右上下文。
5. 持久化事件 + SSE 推送;断线回退轮询。
6. 自然语言 + 固定诊断命令面板。
目标:用户在一屏内完成“描述异常 → 了解当前阶段 → 阅读诊断及依据 → 确认受控操作 → 核实结果”,并在刷新或断线后继续查看真实进度。
## 2. 调研依据与复用策略
### 2.1 原生 DSH 是主要参照
实际核对本机已安装的 `@deepseek-ai/*` 0.2.1-rc.2 包、中文 README、类型声明及 headless 事件投影源码,包元数据指向 [官方源码仓库](https://github.com/deepseek-ai/deepseek-harness)。[官方产品入口](https://www.deepseek.com/en/harness/)用于背景说明;本次实现判断以本机固定版本为准。
| 原生模块 | 已核对的交互/实现依据 | 本项目适配 |
|---|---|---|
| `dsh-client-ui-layout` | 三栏 AppFrame、左右栏伸缩、中栏空间优先 | 复制三栏层级和伸缩规则;宽度按工作台可用空间调整 |
| `dsh-client-ui-sidebar` | 会话目录、搜索、分组、状态提示 | 个人会话、服务端标题搜索、活跃/归档 |
| `dsh-client-ui-chat` | 回答与过程分组、终止失败行、稳定节点和滚动归属 | 阶段默认折叠、回答独立、增量更新、不抢阅读位置 |
| `dsh-client-ui-commands` | `/` 触发、候选菜单、popupSelect/action、键盘确认;命令不静默降级为提示词 | 固定诊断命令目录、目标选择、未知命令本地报错 |
| `dsh-client-ui-sidebar-right` | 按会话关联的详情面板 | 概况、证据、操作、记录四个页签 |
| `dsh-client-ui-trajectory` | 按轮次组织记录、历史加载、依据真实事件计时 | 使用业务阶段时间线;不搬入系统提示词/推理/原始工具参数检查器 |
| `dsh-headless` | `--json` 的 `session/status/text/thinking/tool_call/tool_result/final` 事件 | 解析白名单阶段,丢弃敏感/内部载荷,最终结果继续严格校验 |
包 README 的原生布局为左栏默认 280px、范围 264–420px、收起轨道 56px;宽度不足时优先让右栏让步。原生会话和命令组件依赖 React、Cordis、Session controller、renderer 和 slot 服务,不能当作独立 HTML 直接插入当前 Tabler 页面。
本版选择:直接参照上述原生交互与组件结构,在现有原生 JS/Tabler 内实现业务适配;保留官方 DSH headless 内核及最小 profile,新增事件适配层。不是启动第二套 DSH Web 服务,也不声称已完成原生 Web 实时体验或逐像素比对。
如实施时摘取上游源码、样式或资源,固定来源版本和具体文件,保留其 MIT 版权声明(包内 LICENSE 为 Copyright (c) 2026 DeepSeek),增加 `licenses/DeepSeek-Harness-MIT.txt` 及复用清单。无需为了相似外观引入整套 React/Cordis 前端。此项只在实际复制资源时增加文件。
Open WebUI 已是本项目早期会话布局的参照,见[原助手设计](2026-10-17-zcode-chat-design.md)。按用户本轮选择,首版以 DSH 为唯一主要交互基准;不在未核验其他产品的情况下拼接所谓“主流 UI 优点”。
### 2.2 当前实现及具体问题
| 位置 | 当前行为 | 优化目标 |
|---|---|---|
| `web/modules/assistant/view.js` | 顶部说明卡、会话管理条、左会话列表、中央聊天卡 | 收紧首屏,聊天及输入区在常见屏幕上同时可见 |
| `web/modules/assistant/operations.js` | 全部 AI 操作记录与管理员修复表单插在聊天上方 | 移到右侧记录页签与管理员高级入口 |
| `web/app.css` | 消息区 `max-height:65vh`,多个外层卡片叠加 | 工作区占剩余视口;中央消息独立滚动、输入固定在中栏底部 |
| `view.js` 的 `drawMessages()` | 轮询时整段重建 `innerHTML` | 以 turn/action/event ID 更新节点,保留选区、折叠和滚动 |
| `src/modules/assistant/dsh-runtime.cjs` | stdout 全量缓存,进程结束后只解析最终 JSON | 有界逐行解析阶段;最终回答仍完整校验 |
| `service.cjs` / `store.cjs` | 运行/成功/错误等轮次状态;会话密文存储 | 增加与会话状态一致的持久化 UI 事件及快照证据 |
| `api.cjs` | 创建/读取/归档/延续/取消/执行;无推送 | 增加只读增量事件和 SSE,保留旧接口兼容 |
## 3. 三栏界面与具体交互
```text
工作台导航(可收起) DSH 诊断工作区:会话标题 · 模型/连接状态 · 上下文开关
┌──────────────┬─────────────────────────┬──────────────────┐
│ 新建 / 搜索 │ 用户:归档为什么失败? │ 概况 证据 操作 记录│
│ 活跃 / 归档 │ │ 本轮快照时间 │
│ │ ▾ 本轮过程 │ 目标连接/服务器 │
│ 最近会话 │ 快照 → DSH 分析 → 建议 │ 最近观测状态 │
│ 会话状态 │ │ │
│ │ 诊断结论、依据、建议 │ 待确认:归档重试 │
│ │ 操作摘要 [查看操作] │ 目标/影响/确认 │
│ ├─────────────────────────┤ │
│ │ / 诊断命令 多行输入 │ 操作编号/结果入口 │
│ │ [停止/发送] · 权限提示 │ │
└──────────────┴─────────────────────────┴──────────────────┘
```
### 3.1 外壳与布局
- 保留现有“工具 → DSH 助手”入口与助手设置入口,不新增平行导航。
- 助手页收紧重复标题、说明和工具页签占位;默认收起工作台大侧栏,保留可操作的导航开关,离开助手页恢复原状态。只影响本页呈现,不修改其他页面布局偏好。
- 布局以工作区可用宽度计算:≥1180px 显示三栏,左 264px、右 320px、中栏弹性且至少 480px;880–1179px 默认收左栏为 56px 轨道,右栏按需展开;不足 880px,左右栏均为互斥抽屉,中栏优先。
- 桌面左右栏可拖宽;右栏不足 300px 或挤压中栏到 400px 以下时收起。移动端抽屉打开、关闭有明确焦点归还,Esc 只关闭最上层弹窗/抽屉。
- 中央消息独立滚动;输入区随内容增高但不被页面底部推走。400% 缩放/软键盘下仍可到达发送和停止按钮。
- 保留工作台绿色主色与身份,不使用旧 ZCode 的 `Z` 空状态头像;三栏、菜单、消息间距和过程折叠沿 DSH 语义。
### 3.2 左栏:个人会话
- 新建、标题搜索、活跃/归档切换;列表按最近更新显示,保留 25 条分页,服务端跨页搜索个人标题,不将当前页筛选冒充全量搜索。
- 活跃会话现有限额为 50 个,全部纳入标题搜索;归档会话没有现有总量上限,首版搜索最近 2000 个并明确标注范围及是否截断,每批读取 100 个并让出事件循环。只解密本人的标题,不检索正文、不转存明文搜索索引;超出范围的归档仍能通过原列表分页浏览。
- 每条显示标题、最近更新时间及当前轮次状态。标题只读,重命名/置顶/永久删除不纳入本版。
- 保留归档、恢复、继续新对话;达到 100 轮时引导延续,明确只带入最近 3 轮,不将其描述为原生完整 Session 恢复。
- 切换会话保留本页内各自输入草稿、滚动和折叠;草稿只存当前页面内存,退出登录清空,不持久化业务文本到浏览器存储。
### 3.3 中栏:回答与过程
- 首次空态显示四项任务:连接健康、扫描异常、归档失败、通知阻断。选择后进入命令/目标选择流程,不直接触发恢复操作。
- 每轮分为用户问题、可展开过程、已校验回答、操作摘要。失败、中断、额度不足各有持久状态行。
- 回答支持段落、列表、表格、代码块及复制;禁止原始 HTML/自动加载远程图片。链接只允许已验证的同源业务路由与安全 HTTP(S),不把模型给出的路径或 URL 作为命令执行。
- 只在用户接近底部时跟随新增内容;用户向上阅读时显示“有新进展”,点击返回底部。更新不重建整个消息树。
- 重试诊断保留原失败轮次,经用户点击新建一轮、重新取快照并计入额度;绝不重放该轮的业务操作。取消成功后再次提问也创建新轮次。
- “继续新对话”与“停止后继续问”是不同动作;不承诺恢复被终止进程的原生执行点。
### 3.4 右栏:概况、证据、操作、记录
| 页签 | 内容和行为 |
|---|---|
| 概况 | 当前授权连接、扫描/导出/归档摘要、业务阻断摘要;显示观测时间、缺项、截取范围,不把历史状态称为实时健康 |
| 证据 | 当前选中轮次实际使用的脱敏快照摘要,条目数量、截取说明、来源 ID、原页面入口;与当前概况分开 |
| 操作 | 当前会话的建议/执行/待核验卡片;点击中央摘要定位到这里。只有一套执行按钮和 action ID,避免双重提交 |
| 记录 | 当前会话阶段记录;完整操作审计另通过受权限控制的入口查询,管理员全局审计不混入成员会话 |
刷新概况只读取本机允许的状态,不隐式连接 BPM/SMB,不重新调用模型;旧轮次证据不随刷新变化。未配置模型时仍可看有权限的概况,回答和动作清楚显示不可用原因。
管理员“提出代码修复”迁入高级面板,继续选文件、看修改前后和固定测试结果;字段采样/映射入口放在扩展能力面板。两者不占诊断首屏,也不扩大权限或自动启用。
### 3.5 输入与命令
| 命令 | 固定语义 | 是否调用模型/执行操作 |
|---|---|---|
| `/help` | 展示当前可用命令及权限说明 | 本地展示;不调用模型 |
| `/status` | 读取授权状态,展示概况,可点“请 DSH 分析” | 只读刷新;分析需再次发送 |
| `/bpm` | 选择本人可见连接,生成“分析该连接及最近扫描异常”的草稿 | 提交后调用模型;不启动扫描 |
| `/storage` | 选择有权查看的存储配置,生成连接状态诊断草稿 | 提交后调用模型;不执行连接检查 |
| `/archive` | 选择有权查看的归档记录,生成失败诊断草稿 | 提交后调用模型;不自动重试归档 |
- `/` 和输入框命令按钮打开同一个候选菜单;支持方向键、Enter/Tab 选择、Esc 返回输入;中文输入法合成时 Enter 不发送。
- 以上命令为工作台适配命令,不声称与 DSH 所有内置命令同名兼容。仅精确命令名与目标选择器;不解析任意 URL、路径、Shell 参数。
- 未知 `/命令` 显示“此命令未开放”,保留草稿,不静默当普通提示词发给模型;普通自然语言不受影响。
- 选定目标以结构化 ID 随请求提交,服务端再次授权,不从名称文本推断 ID。建议请求格式为 `{text, diagnostic:{command,targetId?}, requestId}`,旧 `{text}` 保持兼容。
- 原生快捷发送、多行输入、自适应高度与停止按钮保留。模型名只展示当前配置;切换模型仍在管理员设置,不放假模型选择器。
## 4. 深度复用内核与事件设计
### 4.1 边界
继续使用官方 DSH 0.2.1-rc.2 最小 profile 中的 session、projection、agent 和 headless。业务事实及权限继续由应用提供,恢复动作继续由确定性后端执行。首版深度适配点是运行生命周期、事件投影、上下文和确认/结果语义;不为模仿原生界面挂载文件/Shell/MCP/插件/自主任务工具。
本版连续对话继续由现有工作台加密历史驱动;每轮私有 DSH profile 和清理策略保留。不将 DSH 原生完整 Session 持久化、任意工具环或压缩/分叉能力混入此次改版。
### 4.2 真实阶段与终态
```text
请求接受 → 快照就绪 → 运行包就绪 → 模型分析 → 输出校验 → 回答完成
└→ 建议待确认
用户确认卡片 → 权限/目标/幂等复核 → 操作运行 → 成功 / 失败 / 待核验
取消请求 → 停止中 → 已确认退出:已停止;未确认退出:待核验
```
- `queued` 仅表示请求已被持久化接受,不表示新增排队调度器。保留全服务最多 2 个模型调用和每会话串行;超额返回 429,不制造后台排队。
- `snapshot`、`runtime`、`model`、`proposal`、`awaiting_confirmation`、`action_running` 都需要对应真实开始/结果,不按计时器演出阶段。
- 轮次完成与操作待确认/执行是两条生命周期:模型完成后可继续提问,旧卡片仍在;卡片不会因为回答完成而自动执行。
- 各动作终态独立;同一轮的 3 张卡片可以有不同结果。时间线只在已有时间戳时显示耗时,不生成虚假进度百分比。
- `cancel_requested` 后显示“停止中”;`cancelled` 只在子进程树退出已确认后显示。停止按钮仅取消模型回复,不暗示能撤销已开始的归档、扫描或代码修复。
- 服务重启将未结束轮次标记中断,未结束操作标记待核验;不自动续跑或重放。
### 4.3 Headless 协议适配
以官方 `dsh-headless/lib/json-stream-BA-F3lfb.js` 的事件映射为依据:
| 原生输出 | 本项目处理 |
|---|---|
| `session` | 仅私有适配器内用于相关性检查;不发原始 cwd/session 路径给客户端 |
| `status:turn_start/step_start/step_end/turn_end` | 映射到受控阶段;只保留已验证的状态、序号和必要计时 |
| `text` | 当前协议可能是已完成块;正文又是结构化 reply/actions JSON,不直接展示/持久化未校验片段 |
| `thinking` | 立即丢弃,不记录、不展示 |
| `tool_call/tool_result` | 在本版无原生工具 profile 下视为越界,停止并报错;不能转译为业务操作 |
| `error` | 转为脱敏错误码与可理解提示,不传原始 stderr |
| `final` | 保持唯一 final、完整终态及 reply/actions 严格校验;通过后才发布回答与卡片 |
首版“流式”指真实阶段/受控操作进展推送;不包含逐 token 回答。逐 token JSON 提取会改变未完成/失败回答语义,另立后续需求。
适配器采用 UTF-8 增量解码、有界逐行 NDJSON 解析,处理半字符、跨 chunk 的换行及最后未换行片段;维持原 stdout+stderr 总量限制、超时与进程树终止。未知事件版本不得默认为成功;新增事件只经固定版本适配器接纳。
## 5. 数据、权限与可靠传输
### 5.1 持久化和读取模型
- 在现有 `assistant.sqlite` 新增会话事件表,字段为 `conversation_id, seq, turn_id, action_id, kind, created_at, payload`;`(conversation_id,seq)` 唯一递增。payload 沿用 AES-GCM,元数据不存业务正文。
- 会话、轮次/卡片状态变更与对应 UI 事件在同一数据库事务内提交;事件提交后才能广播。事件推送失败不回滚真实业务结果。
- 诊断轮次保存实际使用的脱敏证据摘要(有数量与截取标识),不保存原始业务表单、邮件正文、密钥或内部推理。旧轮次只能显示已有证据,标注“历史阶段未记录”,不补造进程事件。
- 保留独立 `operations.sqlite` 的只追加审计。UI 事件不是其替代品;执行前审计不可写仍阻断动作。两库没有跨库原子事务,恢复时以操作真实状态和审计复核,冲突显示待核验。
- 事件采用离散状态,不持久化 token;每轮最多 128 条 UI 阶段/进展事件,进度按有意义变更合并并预留终态空间。旧会话/审计不因本版迁移删除,保持既有 100 轮限制。
- 新增请求幂等:客户端 `requestId` 由服务端按 owner + conversation 唯一保存。相同 ID/相同载荷返回已创建轮次,不再计费;相同 ID/不同载荷返回 409。网络错误仅先查询/重取状态,不自动生成新 ID 重发。
### 5.2 API 轮廓
| 接口 | 约定 |
|---|---|
| `GET /api/assistant/context` | 当前账号脱敏只读概况及可选目标,含 observedAt/范围;无外部检查副作用 |
| `GET /api/assistant/conversations?...&query=` | 个人会话标题搜索,延续 scope/page/pageSize 校验;query 最长 100 字 |
| `GET /api/assistant/conversations/:id` | 保留原返回,增加一致快照 `eventCursor`,供刷新后追增量 |
| `GET /api/assistant/conversations/:id/events?after=N` | 按 seq 升序返回最多 100 条、nextCursor、hasMore;可连续补齐 |
| `GET /api/assistant/conversations/:id/stream?after=N` | 同一事件序列的 SSE,心跳及恢复指令,不创建模型任务 |
| 现有 messages/repair-messages/cancel/execute | 保留路径、权限和业务约束;messages 增加可选诊断目标/requestId |
流帧包含 `id: seq`、`event: assistant_event` 和 `{schemaVersion:1,conversationId,seq,turnId,actionId?,kind,at,data}`。data 每个 kind 有独立白名单,不塞入原始上下文或完整模型返回。正文/卡片变化通知携带 ID,客户端重新读取权威会话。
### 5.3 SSE 与回退
- 同源 Cookie 会话认证,沿现有 CSP。订阅时复核本人会话所有权;管理员也不能通过 SSE 读取其他人的个人会话。完整管理员审计继续走独立权限接口。
- 初次用快照 cursor 追增量,重连用 Last-Event-ID;参数与 header 都存在时取经验证的 Last-Event-ID。非法、超前 cursor 返回明确错误,客户端重取快照,不盲跳。
- 订阅与历史回放要覆盖交界竞态:先捕获新事件,再回放至高水位,最后按 seq 去重发布后续事件,不能在回放后才开始订阅而丢事件。
- SSE 设置 `text/event-stream`、`Cache-Control:no-store`、`X-Accel-Buffering:no`,立即 flush;每 15 秒发送无业务内容的心跳并复核登录有效性。反向代理需验证不缓冲、空闲超时覆盖心跳。
- 网络故障指数退避 1/2/4/8/15 秒;连续 3 次无法建立 SSE 时回退为每 3 秒增量轮询,稳定后每 60 秒尝试恢复 SSE。补历史时顺序请求,防止并发覆盖 cursor。
- 401/403 不循环重连:关闭连接,清除该会话界面数据并提示重新登录/权限变化;429/5xx 可退避。切会话/离页/退出登录立即关闭旧流与定时器,晚到响应以会话代次隔离。
- 每浏览器仅当前会话一条流,服务端每账号最多 2 条、全局最多 30 条;达到上限返回 429 并回退轮询。单连接待写缓冲超过 256KiB 断开,客户端依 cursor 恢复,避免慢客户端阻塞服务。
- 服务停止先关闭 SSE 和长连接,再关闭 HTTP server 与数据库;为 `application.cjs` 增加对应清理步骤,避免现有 server.close 等待永久流。
- 断流、页面刷新、重连、收到旧事件都不触发模型重发或业务动作重试。
## 6. 权限及操作结果
- 新 context、目标目录、证据、事件 API 共用一套授权过滤;不能因为右栏可展示而扩大模型可见数据。存储/导出记录与原业务页 ACL 对齐,发现现有快照过宽时先收紧,不照搬缺陷。
- 操作员仅扫描本人负责连接;存储检查、样本/字段能力、代码修复仍按现有管理员规则;只读成员仅诊断。
- 卡片展示操作类型、目标名称/ID、影响、当前可执行原因、来源轮次与操作编号;确认后再次复核最新角色、设置、目标状态和幂等结果。
- 不把底层 `action.status=success` 一律渲染成业务成功。修复的 ready_for_review/rolled_back/needs_review、映射的 checked/blocked、归档的实际状态必须分别呈现;blocked 是受阻,needs_review 是待核验。
- 重试模型与重试操作分开。操作结果不明、中断或 SMTP unknown 不给一键重跑,导向原页面核验;已有非 proposed 卡片仍不能重复执行。
- 禁止 BPM 写操作、改变发送资格、自动重发 unknown、修改收件人/业务规则、自动合并/部署。PDF 与通知的当前业务前置关系以[设计要求](../../design-requirements.md)为准;本版不调整。
## 7. 模块拆分与实施批次
下表是交付顺序和评审边界;用户评审本文后再写逐任务、含测试步骤的实施计划。
| 批次 | 交付物 | 主要位置 | 独立验收 |
|---|---|---|---|
| A:原生外观和阅读交互 | 三栏、空态、会话轨道、固定输入、右栏、增量渲染;暂沿现有轮询 | `web/modules/assistant/view.js` 拆出 layout/conversation/context-panel/composer;`operations.js`;独立助手 CSS;`web/app.js`、`web/modules/navigation/{view,lifecycle}.js` 的本页外壳/释放;`web/index.html`、`src/app/assets.cjs` | 常见分辨率无需翻页寻找输入区;草稿/滚动不丢;旧动作/设置入口可达 |
| B:事实与阶段内核 | 加密事件、原生 NDJSON 阶段适配、一致状态、轮次证据、重启恢复、请求幂等 | `src/modules/assistant/{store,service,dsh-runtime}.cjs`;新增 conversation-events/event-policy;`conversation-history.cjs` | 原生假模型、半包/越界/取消/重启;事件与终态一致;无隐私泄露 |
| C:实时传输与命令 | SSE/增量轮询、context ACL、标题搜索、诊断目标、固定命令 | `api.cjs`;新增 event-stream/diagnostic-context;前端 events-client/commands;`src/app/application.cjs` | 断线回放不丢/不重;退出撤权;并发/慢客户端;命令不触发写操作 |
| D:闭环与文档 | 受控恢复结果、人可读错误、窄屏/键盘、业务回归、指南 | `tests/assistant/`;`docs/user-guide.md`;助手截图与验收记录 | 诊断→证据→确认→执行→核验贯通;实际模型与夹具结果分开报告 |
保持当前 CommonJS 后端、原生 JS 前端、Tabler 和 SQLite;不引入第二套账号/服务/前端构建链。只有确有需要的 Markdown 渲染依赖才单独固定版本、许可和消毒规则,不顺带升级其他依赖。
## 8. 验收标准与验证范围
1. 主流程:虚构失败归档例子,从提问到展示证据/建议,确认后有唯一 action ID、真实结果与可查询记录;未确认绝不执行。
2. 信息正确:快照时间/当前概况分离,截取范围可见;模型完成不等于操作完成;缺失/受阻/结果未知均有对应文案。
3. 交互:1600×900、1366×768、1024×768、390×844;中栏优先、输入可见,抽屉不叠压;键盘导航、中文 IME、长消息/代码/表格不横向破版。
4. 生命周期:切会话时旧流不写新界面;草稿、选区、滚动及折叠不被心跳/状态轮询清空;发送超时后重取状态不会多开轮次。
5. 协议:NDJSON 半字符/半行、超大行/总量、唯一 final、异常终态、未知事件、禁止工具、推理过滤、stdout/stderr 脱敏。
6. 流可靠性:断线 cursor 回放/重复去重/回放订阅竞态、登录失效、撤权、SSE 代理缓冲、轮询回退、限流、慢客户端、服务关闭均有自动验证。
7. 权限:跨用户会话/事件/context 拒绝;管理员全局审计与个人会话分开;非法 targetId、未知命令、越权/过期卡片及重复执行拒绝。
8. 保留既有会话归档/恢复/延续、100 轮限额、每日额度、全局 2 调用、受控修复的失败恢复与审查语义。
9. 实施时执行 `npm ci`、新增专项、现有助手专项与 `npm test`;`npm test` 当前仅指 package.json 的 test:business,不能宣称全测试通过。跨服务生命周期变更还需 `npm run test:full`,按基线区分旧失败与新失败。
10. 无真实模型凭据时使用官方本机假模型测试;正式说明必须区分“夹具/协议验证”与“真实模型及公司业务闭环验证”。不因改界面启用模型或重启/更新正在运行的服务。
## 9. 评审与后续边界
本轮只产出设计文档。主要待整体评审的是:三栏首屏的具体布局、原生组件的适配策略、第一版阶段推送而非逐字回答、固定命令行为、恢复/待核验及上述四批交付顺序。
本文批准后,使用 writing-plans 编写 `docs/superpowers/plans/2026-10-27-dsh-diagnostic-workspace.md`,再执行开发。当前不生成名为“已批准”的实施计划,不修改应用代码、配置、运行态或真实业务数据。
关联依据:[DSH 受控能力设计](2026-10-27-mail-dsh-controlled-optimization-design.md)、[原助手设计](2026-10-17-zcode-chat-design.md)、[当前设计要求](../../design-requirements.md)、[用户指南](../../user-guide.md)。