dsh-sonar

English | 中文

面向 DeepSeek Harness Web UI 的简洁、可拖动深海用量 Dashboard。

dsh-sonar 通过 Fish 图标浮动入口提供完整会话用量界面，不会压缩对话区域。点击 Fish 展开 Dashboard，拖动可改变位置；面板会自动选择能够完整展示的方向，再次点击 Fish 或按 Escape 收起。模型回答时，入口周围会升起轻量气泡。

Dashboard 包含：

• 绿／橙／红三色上下文窗口仪表盘；
• 未缓存输入、缓存读写、模型输出及可用推理分项的 Token 环图；
• 系统提示词、工具定义和对话消息的启发式组成；
• 轮次、步骤、模型耗时、工具耗时、缓存命中率和累计 Token；
• DeepSeek 精确 total_balance，支持每轮结束自动刷新和手动刷新。

API Key 始终留在 Host。浏览器只调用 dsh-sonar 的同源接口并取得 { totalBalance }；接口拒绝跨站请求和非 IP／localhost Host，响应禁止缓存。

从 GitHub 安装

仓库提交了构建后的 lib/ 产物，因此 Git 安装不需要执行构建脚本：

dsh plugin --profile web add github:Howe829/dsh-sonar#
dsh --profile web

建议固定 commit，确保安装可重复。移除命令：

dsh plugin --profile web remove dsh-sonar

配置

组合包插入一条 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 会整体替换一行的配置，因此需要重述仍要保留的所有字段。

开发

pnpm install
pnpm run verify
pnpm pack --pack-destination .artifacts

插件面向已公开的 DeepSeek Harness 0.1.0-rc.6 包族。Harness 仍处于 Developer Preview，未来版本可能需要兼容更新。

隐私与模型影响

这是只读 UI 插件，不会添加工具、提示词、命令、持久会话事件或模型可见上下文，也不会改变请求 envelope 或 KV Cache 行为。

License

MIT