任务总览视图 regrevia/dsh-vantage

dsh-vantage

一个只读的任务总览视图，给 DeepSeek Harness 用。它待在对话旁边，只回答一个问题：这个任务到底进展到哪了？

这个视图不调度、不停止、也不完成任何工作。它观察已经发生的会话事件，再把它们渲染出来：当前轮次的工作主题、每个主题背后的证据，以及早前轮次的一段有界历史。

预览

| 实时会话 | 已保存会话 | 已保存历史 |
| Fresh live overview | Saved Envoy overview | Saved session history |

截图来自真实安装的配置档：实时会话是一个全新轮次，已保存会话是打开时没开开关的既有存档。

最后一张图是同一个已保存会话，在用户自己正在运行的 Harness 窗口（localhost:62741）里打开的样子，不是测试夹具：

Saved session in the running Harness window

已保存的轮次保留自己的阅读位置：翻页器停在顶部，详情区滚动，返回时回到历史列表里的同一处。

Round pager in a saved round

它展示什么

- 一到三个工作主题 —— 改了什么、还在查什么、什么卡住了任务。主题是工作单元，绝不是工具名，也绝不是测试/检查/构建清单。
- 证据 —— 每个主题展开后有自己的说明和背后的事实：计划、报告或观察。原始命令输出收在该行内部，只有打开时才拉取。
- 验证 —— 收尾检查是通过、失败，还是仍未完成。通过的检查是证据，不是主题。
- 历史 —— 以真实回复结束的早前轮次，最新的在前。列表和轮次详情从不同时出现。在轮次内部，翻页器和 ←/→ 键一次移动一个轮次；最新的已保存轮次会把向前一步变成「回到本轮」。
- 已保存会话 —— 不再实时的会话以只读方式打开：它的最后一轮、已交付条目和历史都来自保存的日志，开关被隐藏，这样查看它不会启动记录或模型调用。
- 按会话开关 —— 默认关闭。关闭期间，插件既不折叠事件，也不构建快照，也不向模型发送任何东西。打开后从那一刻开始记录；已保存的轮次在历史里仍可读。

总览是阅读界面，所以消息输入框要让开：这个视图挂载期间，插件隐藏输入框座位，你切回对话的那一刻它就回来。做法是给宿主自己的座位加一个作用域属性和一条 CSS 规则，不是重写 DOM —— 宿主的界面外壳仍归宿主所有。

首次读取失败时

视图挂载时读一次 GET /snapshot，然后轮询。冷启动的插件读取、仍在挂载的 Host 路由，或一次被丢弃的请求，过去会让面板停在「正在读取」，直到有人按下重试按钮。现在客户端会自行重试：共四次尝试，间隔 400 ms、1.6 s、3.6 s 和 6.4 s，首次成功时重置，切换会话时重置，视图卸载时清理。第四次失败后，它停留在手动重试状态，不再一直转圈。

控件遵循原型的文本语言，而不是浏览器默认样式：一个 32 px 高的开关，轨道 30×18，旋钮 12 px；文本链接的点击区域为 32 px；一个 2 px 焦点环，取自 --dsw-focus-ring-；不使用填充式胶囊按钮。面板的颜色取自宿主的 --dsw- token，因此浅色、深色和窄布局都无需单独规则。

一轮是产品层面的单位，不是一次对话轮次或一个步骤。一次回复会结束一轮，但「已回复」从不意味着「已验证」。验证列表为空时显示「尚未明确」，绝不默认通过。

安装

插件是单个包；Host 半边（index.js）折叠会话事件，并提供七个精确路由，客户端半边（client.js）在对话的视图切换器中注册 vantage 视图。

用插件管理器（install_bundle）安装该文件夹，它会将其链接到你的配置档，并请求 Cordis 应用其 bundle 补丁。应用补丁会插入一个 id，dsh-vantage；不修改任何现有条目。视图会在下次插件重载后出现——按刷新按钮，或重启应用一次。

要手动接线，请将检出目录添加到配置档的 dependencies，并将 dsh-vantage 放在 dsh.profile.bundles 的末尾。

需要 DSH >=0.2.1-rc.3。

配置

所有选项都是可选的。默认值刻意保持安静。

| key | default | meaning |
| enabled | true | 是否提供快照；每个会话的开关仍然默认关闭 |
| summary.enabled | true | 允许为开关已打开的会话生成模型摘要 |
| summary.cadenceMs | 180000 | 摘要之间的最小间隔，下限为 60 s |
| summary.firstEligibleMs | 60000 | 一轮开始后最早可生成首次摘要的时间 |
| summary.maxInputTokens | 2400 | 整个请求的上限，包括系统提示词 |
| summary.maxOutputTokens | 400 | 回答的上限 |
| summary.maxTopics | 3 | 摘要可返回的主题数 |
| summary.requestDeadlineMs | 25000 | 单次摘要器调用的硬性截止时间 |
| summary.provider | "" | 模型服务商；为空则使用会话默认值 |
| summary.model | "" | 模型名称；为空则使用会话默认值 |

未配置模型时，视图会降级为基于折叠事实构建的事实摘要。摘要失败时保留上一个有效摘要及其真实更新时间；绝不回退到命令清单。

接线

Host 在 /api/dsh-vantage 下提供四个 GET 读取和三个 POST 调用：snapshot、history、round、evidence；然后是 summaryRequest、enable 和 open，后者将交付的文件交给系统查看器会拒绝所有路径，不返回任何轮次。信封、代码、水印和开关状态记录在 WIRE.md。每条路由都仅限所有者访问：调用方不是会话所有者时收到 403 forbidden；请求缺少 Harness 认证 cookie 时，在插件运行前就以 401 拒绝。

隐私

一切都在本地。插件每个会话最多存 20 轮，全局最多存 200 轮，从不复制完整轨迹，只向摘要器发送有界的事实包——不含凭据、环境变量或回放数据。视图从不参与调度或完成决策，会话被禁用时不会发起模型调用，也不会存储轮次。

开发

node test/run.mjs # 107 tests: reducer, summaries, storage, routes
node scripts/lint.mjs # tests, zh-lint, style-lint, ui-copy-lint

Boot a throwaway profile with this checkout installed, then check that the
Host lists and serves the client module and that its route answers.
node scripts/accept-installed.mjs

文案检查器把 JS 对象字面量当作 key: value 状态转储来读，所以它有意标记的行会带上它文档里说明的 ui-copy-ignore 标记。三个检查器都内置在 scripts/vendor/ 下；scripts/lint.mjs 从仓库里解析它们，所以干净的检出不需要自身之外的任何文件。.zh-lint.json 里豁免了 zh-ellipsis，因为这条规则触发于 JavaScript 展开语法，而不是正文。

设计约束写在源码里：面板只用宿主 --dsw-* token，单列 720 px（桌面内边距 32/32/48 px，560 px 以下为 24/20/36 px），使用作用域内的 .ov- 类，不加载远程字体，最多两种圆角，不用阴影，不用渐变。

许可证

MIT