前言¶
在 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 明細和餘額放在一個可拖拽的只讀面板中。已覈實的項目倉庫爲：
