一套 DeepSeek Harness（dsh web）外掛，按請求把 Token 用量歸屬到中轉站，支援按專案分組、餘額、訂閱額度、用量分析、費用估算與 CSV/JSON 匯出——零設定、不用憑證。
DSH 整合
相容
作者聲明
安全稽核
未稽核
最後核實
2026-08-24
授權條款
MIT
01它能幫你完成什麼？
把 DeepSeek Harness 的 Token 用量歸屬到實際服務本次請求的中轉站，並按專案分組、估算費用
Web 面板「用量帳本」：中轉站歸因、按專案用量、餘額、訂閱額度、用量分析與 CSV/JSON 匯出
透過中轉站（New API / Sub2API / 官方 DeepSeek）跑流量的 DeepSeek Harness（dsh web）使用者，需要對 Token 花費做帳的人
02如何將外掛接入 DeepSeek Harness？
先決條件
- DeepSeek Harness 的 `web` profile —— `@deepseek-ai/dsh >= 0.1.0-rc.6`
- 中轉站已經在宿主的 provider 設定裡寫好 `baseURL`（外掛會自動發現，不用憑證）
安裝步驟
- 01
執行 `dsh plugin --profile web add "github:zh667/TokenLedger"`
$ dsh plugin --profile web add "github:zh667/TokenLedger"
- 02
重啟正在跑的 `dsh web` 並硬重新整理瀏覽器；側邊欄底部出現「用量帳本」入口
$ dsh web
- 03
要釘版本必須用完整的 40 位 commit SHA，如 `github:zh667/TokenLedger#<sha>`
- 04
升級用 `dsh plugin --profile web update dsh-tokenledger`；移除用 `dsh plugin --profile web remove dsh-tokenledger`
$ dsh plugin --profile web update dsh-tokenledger
驗證整合成功
作者未說明
復原
- dsh plugin --profile web remove dsh-tokenledger
03DSH 整合程度與能力邊界
透過 dsh plugin CLI 安裝到 DeepSeek Harness 的 web profile，在側邊欄註冊「用量帳本」入口。要求 `@deepseek-ai/dsh >= 0.1.0-rc.6`。
中轉站歸屬
宿主 provider 設定（各 provider 的 baseURL）→按正規化後的中轉站 origin 分組；同一站多把 key 合成一行，站名即網域
按專案歸屬
會話啟動所在目錄→按會話啟動目錄分組（註冊過的工作區用其標題，否則用目錄名；子目錄起的會話同樣計入）
零設定探索
宿主 provider 設定→從中讀出中轉站，不用再填一次；只讀 `baseURL`，絕不碰憑證
餘額
每個帳戶一把普通 key（官方 DeepSeek / New API / Sub2API）→顯示餘額；不限制額度的 key 報「已用」而非假餘額
訂閱額度
賣套餐不賣餘額的中轉帳戶→5 小時 / 每週 / 每月各自滾動、各自重置，每個視窗一條進度條和一個重置時刻
用量分析
已記錄的用量→今日 / 本月 / 累計三視窗、按站點/模型下鑽、快取命中率、一年活躍度熱力圖
費用估算
生效日期分段的費率表、分桶計價、離峰/尖峰時段→估算費用；未定價模型顯示破折號而非 0
匯出與診斷
已記錄的用量→CSV / JSON 匯出、索引健康度、歸因不上的列數單獨列出
唯讀回環
回環 GET 請求→兩個端點僅接受回環 GET，並在 peer socket 位址上設防；從不讀取提示詞、工具參數或回應內容
暴露兩個僅限回環的 GET 端點
04適合誰？何時不該用？
適合
- 透過中轉站（New API / Sub2API / 官方 DeepSeek）跑流量的 DeepSeek Harness（dsh web）使用者，需要對 Token 花費做帳的人
不適合
- 要釘版本必須用完整的 40 位 commit SHA。套件管理程式拿 ref 跟 `git ls-remote` 廣播的參照清單比對，短 SHA 什麼都對不上，會直接報 `Could not resolve`。
05相容性、維護與安全提醒
- 外掛絕對不會把 API Key 或上游原始回應送到瀏覽器，也從不讀取提示詞、工具參數或回應內容。
- 要釘版本必須用完整的 40 位 commit SHA。套件管理程式拿 ref 跟 `git ls-remote` 廣播的參照清單比對，短 SHA 什麼都對不上，會直接報 `Could not resolve`。
- 需要 DeepSeek Harness 的 web profile（`@deepseek-ai/dsh >= 0.1.0-rc.6`）。面板只會在 `dsh web` 裡顯示。
MIT · 活躍維護中（最新版本 v0.1.0，2026-08-15）
06常見問題
我需要把 API key 填進 TokenLedger 嗎？
不用。外掛只從宿主的 provider 設定讀取 `baseURL` 來發現中轉站；它絕對不碰旁邊的憑證，也不會把 API Key 或上游原始回應送到瀏覽器。
安裝時要怎麼釘某個具體版本？
在 spec 裡用完整的 40 位 commit SHA，例如 `github:zh667/TokenLedger#<sha>`。套件管理程式是拿 ref 跟 `git ls-remote` 的參照清單比對的，短 SHA 不在清單裡，會報 `Could not resolve`。
餘額和額度支援哪些中轉站？
官方 DeepSeek、New API、Sub2API——每個帳戶一把普通 key。不限制額度的 key 報「已用」而非假造的餘額；賣套餐的帳戶會顯示滾動的 5 小時 / 每週 / 每月額度進度條。
TokenLedger 什麼都不讀也不送？
它的兩個端點只接受回環 GET，並在 peer socket 位址上設防。它從不讀取提示詞、工具參數或回應內容，也從不把 API Key 或上游原始回應送到瀏覽器。
要怎麼升級或移除這個外掛？
升級請執行 `dsh plugin --profile web update dsh-tokenledger`，移除請執行 `dsh plugin --profile web remove dsh-tokenledger`。重新 add 同一個 spec 會重新解析最新的 `main`。
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資料與來源
需要 DeepSeek Harness `web` profile（`@deepseek-ai/dsh >= 0.1.0-rc.6`）。
dsh plugin --profile web add "github:zh667/TokenLedger"
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-08-24。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。