前言¶
在 DSH「一切皆插件」的扩展思路下，会话过程中的上下文窗口、token 明细和账户余额常常分散在不同位置。dsh-sonar 面向使用 DeepSeek Harness web profile 的开发者，提供一个可拖拽的会话仪表盘，把上下文占用、accounted-token 构成和 DeepSeek 余额集中展示出来。它由 Howe829 维护，许可证为 MIT。
这是什么¶
dsh-sonar 是一个只读 UI 插件，用于 DeepSeek Harness 的 web 客户端场景。它不添加工具、提示、命令、持久会话事件或模型可见上下文，也不改变请求信封或 KV cache 行为。
核心功能¶
下面介绍 dsh-sonar 已核实的界面与数据能力。
- 提供 Fish 图标浮动启动器，不压缩对话区域；点击打开会话仪表盘，可拖拽到视口任意位置。
- 仪表盘自动选择可容纳的方向；按
Escape或再次点击 Fish 可收起。 - 显示绿色、琥珀色、红色上下文窗口仪表。
- 显示未缓存输入、缓存读、缓存写、输出、推理的
accounted-token环形图；推理项仅在已安装 Harness 暴露该信息时显示。 - 启发式展示系统提示、工具 schema 和会话组成。
- 显示轮次、步数、模型时间、工具时间、缓存命中率和累计 tokens。
- 在每轮完成或手动刷新时获取并显示 DeepSeek
total_balance精确余额。
安装与启用¶
建议固定发布标签 v0.1.0，以便可重复安装：
dsh plugin --profile web add github:Howe829/dsh-sonar#v0.1.0
dsh --profile web
如果要移除：
dsh plugin --profile web remove dsh-sonar
插件默认使用托管 DEEPSEEK_API_KEY 凭据和公共 DeepSeek API。配置行如下：
- id: dsh-sonar
name: dsh-sonar
config:
apiKeyEnv: DEEPSEEK_API_KEY
baseURL: https://api.deepseek.com
后续 profile 或 home patch 可以替换这一行。注意 Harness patch 配置按行替换；如果修改配置，需要重写所有希望保留的字段。
典型用法¶
典型流程是先安装固定版本，再启动 web profile。
- 安装固定版本：
dsh plugin --profile web add github:Howe829/dsh-sonar#v0.1.0
- 运行 web profile：
dsh --profile web
- 在 Harness web 会话中使用 Fish 图标打开仪表盘，查看上下文仪表、token 环形图、会话组成和
total_balance。 - 不再需要时移除：
dsh plugin --profile web remove dsh-sonar
开发侧验证可以执行：
pnpm install; pnpm run verify; pnpm pack --pack-destination .artifacts
适用场景与注意¶
适合当前使用 public DeepSeek Harness 0.1.0-rc.6 包家族，并希望在 web profile 中查看会话 token 和余额的开发者。当前稳定版本是 v0.1.0；DeepSeek Harness 仍为 developer preview，后续 Harness 版本可能需要兼容更新。
安全与模型影响方面：
- API key 保留在 Host。
- 浏览器仅调用同源
dsh-sonar路由，并只返回{ totalBalance }。 - 跨站以及非 IP/localhost Host 请求会被拒绝。
- 响应永不缓存。
- 插件是只读 UI，不添加工具、提示、命令、持久会话事件或模型可见上下文。
- 插件不修改请求信封或 KV cache 行为。
它会以当前 dsh 进程权限运行；安装前建议检查源码、依赖和 MIT 许可证，确认满足内部使用要求。
结尾¶
dsh-sonar 的价值在于把 DeepSeek Harness 会话中的上下文、token 明细和余额放在一个可拖拽的只读面板中。已核实的项目仓库为：
