MIT 授權的 dsh bundle 外掛程式:從工作階段日誌做唯讀 token 計帳,含 fork 去重、UTC 日桶、10 分鐘新鮮度視窗與 JSON/CSV 匯出。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-10
授權條款
MIT
01它能幫你完成什麼?
看清一套 DeepSeek Harness 實際用掉多少 token,並依模型、provider 與日期拆開看
設定 → Usage 頁面:全期間總計、快取命中率、半年活躍熱力圖、每日堆疊柱、Top 工作階段、provider 長條圖、模型環圈圖,以及 JSON/CSV 匯出
想掌握成本、又不想加代理或改動工作階段日誌的 DeepSeek Harness 使用者與團隊
把用量資料匯出,用於結算、預算或試算表分析
完整 JSON、依日 CSV、依模型 CSV——已做公式注入防護,遵循 RFC 4180,帶 UTF-8 BOM
需要在 DSH 之外核對 token 開銷的人
02如何將外掛接入 DeepSeek Harness?
先決條件
- 一個 `web` profile——頁面在 設定 → Usage 下
- README 的實作說明:對照 DeepSeek Harness `0.1.5-rc.1` 開發
安裝步驟
- 01
從 npm 安裝(建議):`dsh plugin --profile web add dsh-usage-panel`
$ dsh plugin --profile web add dsh-usage-panel
- 02
或從 GitHub 安裝:`dsh plugin --profile web add github:AlfredChaos/dsh-usage-panel`
$ dsh plugin --profile web add github:AlfredChaos/dsh-usage-panel
- 03
或從本機 checkout 安裝:`dsh plugin --profile web add ./dsh-usage-panel`
$ dsh plugin --profile web add ./dsh-usage-panel
- 04
重新啟動 `dsh --profile web`,開啟 設定 → Usage
$ dsh --profile web
驗證整合成功
- 首次載入時 Usage 頁面通常直接從快取渲染出 KPI 卡片與熱力圖
- 重新整理按鈕會強制發起一次同步掃描
復原
- `dsh plugin --profile web remove dsh-usage-panel`
03DSH 整合程度與能力邊界
原生 dsh bundle 外掛程式:`dsh plugin add` 會將它加入 profile 的 bundle 名單,patch 列啟用主機半;主機半在共用 `/api` 傳輸上提供 `/api/usage-stats/overview`,用戶端半則渲染 設定 → Usage 頁面。
增量工作階段投影
已提交的工作階段事件→四個互斥桶(未快取輸入、輸出、快取讀、快取寫),外加依模型、依 provider、依日(UTC)的對應
檢查點持久化,重新啟動與 keep-warm 幾乎不需要重播外掛程式從不向工作階段日誌寫回任何內容計費口徑
`request/header`、`request/context`、`assistant/message`、`llm/retry`、`compaction/summary` 事件→模型歸屬取 context 基準/header 覆寫,步驟用量取代串流暫引用量,重試計為次數而非 token,壓縮用量歸到自己的模型
reasoning token 已包含在 output 內,不會重複相加Fork 去重
落在持久化 seed 前綴(`inheritedEventCount`)內的事件→fork 出來的工作階段不會把父工作階段的用量重複計一遍
`session/end-seed` 標記只用來劃分 resume/fork 的計費紀元帶過期標記的快取載荷
瀏覽器的載荷要求→10 分鐘內視為新鮮;更舊的立即回傳並帶 `stale` 標記,同時背景重掃更新快取
keep-warm 計時器每 10 分鐘重掃一次瀏覽器另把最近一次成功載荷存進 localStorage,帶版本與結構驗證
04適合誰?何時不該用?
適合
- 想掌握成本、又不想加代理或改動工作階段日誌的 DeepSeek Harness 使用者與團隊
- 需要在 DSH 之外核對 token 開銷的人
不適合
- README 說明外掛程式是對照 DeepSeek Harness `0.1.5-rc.1` 開發的;README 中沒有宣告相容性矩陣。
05相容性、維護與安全提醒
- README 說明外掛程式是對照 DeepSeek Harness `0.1.5-rc.1` 開發的;README 中沒有宣告相容性矩陣。
- 依日分桶與匯出使用 UTC 日曆日(`YYYY-MM-DD`),熱力圖副標題也會標明口徑(「last 6 months · UTC」)。
- 投影服務不可用時,外掛程式會退回透過唯讀的 `sessionQuery` 服務重播全部工作階段日誌,比增量路徑慢。
- 統計只涵蓋已持久化的工作階段日誌;README 並未宣稱這是帳單級準確資料,也不承諾與 provider 帳單對帳。
MIT · 持續維護(最新 release v0.2.3,2026-09-15)
06常見問題
外掛程式會改動我的工作階段日誌嗎?
不會。它透過工作階段投影(不可用時退回全量重掃)彙總已持久化的工作階段日誌,從不寫回,因此統計能跨重新啟動保留,也涵蓋外掛程式安裝之前的工作階段。
快取命中率怎麼算?
`cache read ÷ (uncached input + cache read + cache write)`,旁邊同時給出讀與寫的量級。
fork 出來的工作階段會重複計嗎?
不會。落在持久化 seed 前綴(`inheritedEventCount`)內的事件永不計入,所以 fork 工作階段不會把父工作階段的用量重複計一遍;`session/end-seed` 標記只用來劃分 resume/fork 的計費紀元。
為什麼有時數字顯示為過期?
載荷在 10 分鐘內算新鮮;更舊的會立即回傳並帶 `stale` 標記,同時在背景重掃更新快取。keep-warm 計時器每 10 分鐘重掃一次,重新整理按鈕則始終強制同步掃描。
每日分桶用的是哪個時區?
分桶與匯出都用 UTC 日曆日(`YYYY-MM-DD`);熱力圖副標題會標明口徑為 「last 6 months · UTC」。
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-media-desk
作者 woniuniuniu
DeepSeek Harness 自媒體工作臺外掛:一句話記靈感,一鍵生成指令碼、封面、配圖和分鏡
dsh-drawai
作者 fourzkw
DSH 右側欄裡的可編輯畫布 —— 加上讓模型直接改圖的兩個工具
08資料與來源
The plugin aggregates persisted session logs (incrementally, via the session-projection mechanism) and never writes anyt…
The plugin ships as a bundle: `dsh plugin add` appends it to the profile's bundle list
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-10。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
