前言¶
在 DeepSeek Harness（DSH）里跑长任务时，对话流里堆着工具输出、回合与验证结果，想快速回答「这轮在干什么、证据是什么、关没关」往往要往回翻很多消息。社区插件 dsh-vantage（维护者 regrevia）在会话视图切换器里注册名为 vantage 的只读面板，与对话并排展示：当前回合的工作主题、每条主题背后的证据、验证状态，以及有界的历史回合。它不调度、不停止、不替 Harness 做完成决策，只观察已发生的会话事件并渲染。
这是什么¶
dsh-vantage 是 DSH 的客户端类插件：Host 端 index.js 折叠会话事件并提供固定 API；客户端 index.js 注册的 client.js 在对话界面增加总览视图。分类上属于「客户端」；GitHub 仓库 regrevia/dsh-vantage 当前 package 版本为 0.1.38，许可证 MIT，依赖 DSH >=0.2.1-rc.3。
目录页：https://www.skillhub.cn/plugins/regrevia/dsh-vantage（社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系）。
核心功能¶
下面介绍面板展示的内容与行为，均来自项目 README。
当前回合¶
- 一至三个工作主题：描述「改了什么、还在查什么、什么阻塞任务」。主题是工作单元，不是工具名，也不是 test/lint/build 清单。
- 证据：每个主题可展开说明及其背后事实（计划、报告或观察）。原始命令输出默认折叠，仅在展开该行时拉取。
- 验证：收尾检查是通过、失败还是仍开放；通过的检查算作证据，不会单独占一个主题。验证列表为空时显示「尚未明确」，不会默认视为通过。
历史与会话¶
- 历史：以真实回复结束的更早回合，新的在前。历史列表与某一回合详情不会同时出现；在回合内用分页与 ←/→ 一次移动一回合；最新已保存回合的前进操作会变成「回到本轮」。
- 已保存会话：非 live 的会话以只读打开，最后一轮、已交付项与历史来自保存日志，开关隐藏，避免误开录制或模型调用。
- 每会话开关：默认关闭。关闭时不折叠事件、不建快照、不向模型发送任何内容；打开后从该时刻开始录制，历史中已保存回合仍可读。
界面与 Host 协作¶
总览是阅读面：挂载该视图时插件会隐藏消息输入区（composer seat），切回对话即恢复；实现为作用域属性加 Host 自身 seat 上的一条 CSS 规则，不重写 DOM。
挂载时先 GET /snapshot，再轮询。冷加载、Host 路由未就绪或请求失败时，客户端会自动重试四次（间隔 400 ms、1.6 s、3.6 s、6.4 s），首次成功或切换会话时重置；四次仍失败则停在可手动重试状态。控件样式跟随原型文案与 Host 的 --dsw-* 令牌，适配明暗与窄屏。
隐私与边界¶
数据本地处理：每会话最多保留 20 个回合、全局最多 200 个回合；不复制完整轨迹；摘要仅发送有界事实包，不含凭证、环境变量或回放数据。关闭会话的开关时不发起模型调用、不存储新回合。
安装与启用¶
插件为单包结构，通过插件管理器的 install_bundle 安装：将目录链入 profile，并由 Cordis 应用 bundle patch（插入 id dsh-vantage，不修改已有条目）。安装后需下一次插件重载才出现视图——点刷新按钮，或重启应用一次。
手动接线时：把检出目录加入 profile 的 dependencies，并在 dsh.profile.bundles 末尾加入 dsh-vantage。
Host 在 /api/dsh-vantage 下提供七条路由（四个 GET：snapshot、history、round、evidence；三个 POST：summaryRequest、enable、open）。所有路由仅会话 owner 可访问；无 Harness 认证 cookie 返回 401，非 owner 返回 403。细节见仓库 WIRE.md。
配置¶
选项均可选，默认偏安静：
| key | default | 含义 |
|---|---|---|
enabled |
true |
是否提供 snapshot；每会话开关仍默认关 |
summary.enabled |
true |
开关打开时是否允许模型摘要 |
summary.cadenceMs |
180000 |
摘要最小间隔，下限 60 s |
summary.firstEligibleMs |
60000 |
回合开始后最早可摘要时间 |
summary.maxInputTokens |
2400 |
单次请求上限（含 system） |
summary.maxOutputTokens |
400 |
回答 token 上限 |
summary.maxTopics |
3 |
摘要最多主题数 |
summary.requestDeadlineMs |
25000 |
单次摘要硬超时 |
summary.provider |
"" |
空则用会话默认 provider |
summary.model |
"" |
空则用会话默认 model |
未配置可用模型时，视图退化为由折叠事实构成的 factual summary；摘要失败保留上一次有效结果及真实更新时间，不会退化成命令 checklist。
典型用法¶
- 按上文用
install_bundle或手动 bundles 安装，满足 DSH >=0.2.1-rc.3，重载插件后在对话视图切换器中选择 vantage（或 README 中的 overview 视图）。 - 在需要记录的会话里打开每会话开关，从该时刻起 Host 开始折叠事件并可选触发摘要；阅读当前一至三个主题、展开证据、查看验证状态。
- 用历史列表进入更早回合；在回合内用分页或 ←/→ 浏览；对已交付文件可通过
open交给系统查看器（仅允许该回合实际交付的路径）。 - 查看已归档会话时保持只读，无需也无法通过该视图重新开录。
适用场景与注意¶
适合需要在不离开当前 Harness 窗口的情况下，用只读方式把握任务进展、证据与验证、有限历史回合的开发者。不适合把它当作任务调度器或自动收尾工具——README 明确说明视图不参与调度与完成决策。
插件以当前 DSH 进程权限运行；安装前请自行审阅 源码与 MIT 许可证，确认符合你的安全与合规要求。摘要功能在开关打开且配置允许时会调用模型，但发送内容为有界事实包；若完全不想触达模型，可关闭 summary.enabled 或保持每会话开关关闭。
结尾¶
dsh-vantage 把「任务实际进行到哪」收成对话旁一块只读总览：主题、证据、验证与有界历史同屏可读，默认不录、不喊模型，打开开关后才从当下开始观察与可选摘要。
