MIT 授權、本地優先的 DeepSeek Harness（`dsh web`）外掛，提供常駐餘額/用量停靠面板與活動熱力圖，對比 DSH 與 Claude Code 通道，且訊息文字絕不離開本機。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-08-30
授權條款
MIT
01它能幫你完成什麼？
Keep DeepSeek Harness balance, credit and token usage permanently visible inside the dsh web GUI
A persistent floating dock plus a customizable balance / token-usage panel (today, month, cache hit) that glows green when healthy and folds into a balance pill on collapse
DeepSeek Harness (dsh web) users who want their balance and token stats glanceable at all times instead of buried in logs
Compare DSH vs Claude Code channel usage and inspect cache hit rates locally
A channel-share ratio bar, a 14-day usage log with per-model drilldown, and a 28-day activity heatmap
Users who run both DeepSeek Harness and Claude Code and want a local-only dashboard of cross-channel token usage
02如何將外掛接入 DeepSeek Harness？
先決條件
- DeepSeek Harness `web` profile with `@deepseek-ai/dsh >= 0.1.0-rc.6`
安裝步驟
- 01
$ dsh plugin --profile web add "github:Aisland-SJL/dsh-usage"
- 02
Restart `dsh web`, then hard-refresh the browser.
$ dsh web
驗證整合成功
- After restarting `dsh web` and hard-refreshing the browser, the dock appears at the bottom-left.
復原
- dsh plugin --profile web remove dsh-usage
03DSH 整合程度與能力邊界
Installed as a `dsh web` plugin via `dsh plugin --profile web add`; runs a persistent floating dock and balance/usage panel inside the DeepSeek Harness web GUI (`dsh web`).
Persistent floating dock
DeepSeek Harness web GUI (`dsh web`)→Always-visible balance pill/dock at bottom-left that mirrors your pins and folds into a tiny pill when the sidebar collapses
Persists widget layout, accent, background and panel opacity in localStorageBalance & usage panel (seven widgets)
Credential references from `~/.dsh/.credentials.yaml`→Balance breakdown, today/month token totals, cache hit rates, channel share and usage log with per-model drilldown
Local-only usage API
Loopback-only GET requests→JSON provider list, unified balance snapshot and per-day/per-model token aggregates via `/api/usage/*`
Serves three loopback-only GET endpoints; non-loopback callers get `403`Credentials resolved server-side through Harness's credentials seam; secrets are never cached or echoedActivity heatmap & dual-channel comparison
DSH token usage and Claude Code `~/.claude/projects` JSONL→28-day × 6-band activity heatmap and a DSH-vs-Claude Code channel ratio bar
Parses and discards Claude Code logs line-by-line; only aggregated numbers reach the cache
04適合誰？何時不該用？
適合
- DeepSeek Harness (dsh web) users who want their balance and token stats glanceable at all times instead of buried in logs
- Users who run both DeepSeek Harness and Claude Code and want a local-only dashboard of cross-channel token usage
不適合
- Do not expose these loopback endpoints through a reverse proxy to LAN or the public internet.
- Requires the DeepSeek Harness `web` profile with `@deepseek-ai/dsh >= 0.1.0-rc.6`.
05相容性、維護與安全提醒
- Do not expose these loopback endpoints through a reverse proxy to LAN or the public internet.
- Requires the DeepSeek Harness `web` profile with `@deepseek-ai/dsh >= 0.1.0-rc.6`.
- Providers without a public balance API show an explicit "no public balance interface" state — the plugin never guesses a balance.
MIT — actively maintained (latest release v0.2.0, 2026-08-16)
06常見問題
如何在 DeepSeek Harness 中安裝 dsh-usage？
執行 `dsh plugin --profile web add "github:Aisland-SJL/dsh-usage"`，接著重啟 `dsh web` 並硬重新整理瀏覽器。停靠面板會出現在左下角。需要 DeepSeek Harness 的 `web` 設定檔（`@deepseek-ai/dsh >= 0.1.0-rc.6`）。
dsh-usage 有什麼前置要求？
需要 DeepSeek Harness 的 `web` 設定檔，且 `@deepseek-ai/dsh >= 0.1.0-rc.6`。各提供方的憑證（如 `DEEPSEEK_API_KEY`）存放在 `~/.dsh/.credentials.yaml`；此軟體只讀取憑證參照，絕不直接接觸密鑰。
dsh-usage 如何與 DeepSeek Harness 連線？
它是一個 `dsh web` GUI 外掛。它提供三個僅限 loopback 的 GET 端點，並透過 Harness 的憑證通道在伺服器端解析憑證；上游呼叫強制 HTTPS 並做 DNS 鎖定。它不在 agent 內部執行，而是在 `dsh web` 介面中渲染懸浮停靠面板。
dsh-usage 與一般的用量統計工具有什麼不同？
它專為 DeepSeek Harness 打造：鏡像你的固定項（pins），對比 DSH 通道與 Claude Code 通道（解析 `~/.claude/projects` 的 JSONL），並且全程本地優先——訊息文字絕不離開本機，採用隱私優先、僅 loopback 的設計。
如何更新或移除 dsh-usage？
更新用 `dsh plugin --profile web update dsh-usage`，移除用 `dsh plugin --profile web remove dsh-usage`。移除後，下次重啟 `dsh web` 時停靠面板即消失；若需復原，重新執行 add 指令即可。
07相關的 DSH 工作流程
dsh-tui
作者 ccch1mneyyy
DSH's officially top-recommended TUI plugin — high performance, low overhead, cute pixel whale, smooth mouse interaction. One-command install via npm. / DSH 官方首推的 TUI 外掛，高效能低佔用，可愛畫素鯨魚，流暢滑鼠互動，npm 一鍵安裝
dsh-better-sidebar
作者 omdsh-dev
開放的側邊欄底座，支援三方拓展註冊新側邊欄頁面。內建檔案渲染編輯/終端/側邊對話/Git/子代理頁面 ｜ Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-tianshu-tui
作者 huiliyi37
官方 DeepSeek Harness 的互動式終端 UI 外掛：自研 ANSI 極簡互動渲染、流式 Markdown/工具卡、16+ 主題、slash 命令與選擇器、輸入歷史與本地偏好持久化、LSP 診斷、memory記憶，很絲滑的開發體驗。
dsh-damage-pulse
作者 wssfk12138
DeepSeek Harness Token 餘額監控外掛：鯨魚娘待機/扣費/復甦動畫、峰谷計費、連續扣費飄字與會話費用統計。
08資料與來源
for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web GUI (`dsh web`).
Requires a DeepSeek Harness `web` profile (`@deepseek-ai/dsh >= 0.1.0-rc.6`).
dsh plugin --profile web add "github:Aisland-SJL/dsh-usage"
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-08-30。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。