前言¶
DeepSeek Harness（DSH）擅長在長對話裏維持上下文，開發者往往要到賬單出來才發現花費超出預期。DSH 官方界面能看到上下文壓力和 token 計數，但很難直接回答：哪類調用最貴、哪些時段在峯價、應該先改 compaction、輸出長度還是錯峯。dsh-token-audit 針對這三類問題，只讀本地 ~/.dsh/sessions 裏的會話日誌，按 DeepSeek 官方峯/閒時單價逐筆計價，輸出一次性的審計報告和排序後的「Savings plan」，而不是再做一個常駐儀表盤。
這是什麼¶
維護者爲 GitHub 用戶 lengrufeng2008，倉庫 lengrufeng2008/dsh-token-audit，npm 包名 dsh-token-audit（當前資料中版本爲 0.2.0），許可證 MIT。社區目錄分類爲 admin-security，SkillHub 目錄頁：https://www.skillhub.cn/plugins/lengrufeng2008/dsh-token-audit。
工具定位：Audit DeepSeek Harness session logs: exact token cost, waste patterns, and a data-driven savings plan。實現形態是 本地 CLI + 可選 DSH 插件；默認零配置、不上傳、無遙測。
核心功能¶
精確記賬¶
從會話日誌裏每條 assistant/message 讀取 provider 上報的用量：
cacheReadTokens：命中 prompt cache 的輸入（便宜）inputTokens：未緩存輸入（貴）outputTokens：生成內容（含 reasoning，通常最貴）
按每條調用的北京時間選擇峯時或閒時單價，支持 deepseek-flash 與 deepseek-v4-pro；未知模型按 Flash 費率估算並在報告中標記。
峯時定義爲北京時間工作日 09:00–12:00、14:00–18:00（不含 2026 年中國法定節假日）；週末一律閒時。資料中的單價（CNY / 百萬 token，截至 2026-10-31）如下：
| Model | Cache hit | Cache miss | Output |
|---|---|---|---|
deepseek-flash idle |
0.02 | 1.00 | 4.00 |
deepseek-flash peak |
0.04 | 2.00 | 8.00 |
deepseek-v4-pro idle |
0.15 | 4.50 | 13.50 |
deepseek-v4-pro peak |
0.30 | 9.00 | 27.00 |
報告內容¶
終端默認報告包含：時間窗口、會話數、模型調用次數、總費用與日/月 extrapolation；費用拆分（cache read、output、cache miss、峯時佔比）；上下文長度分佈；Savings plan（如 context cap、output 減量、錯峯等項的估算節省比例）；以及「What to do first」行爲建議（例如高 context 調用佔比、峯時花費佔比）。
完整佈局示例見倉庫內 docs/demo.html，可在瀏覽器中打開查看。
省錢方案與驗證¶
Savings plan 在行爲不變的前提下給出 gross 估算，各項可能重疊，文檔明確不應視爲承諾。常見槓桿包括：縮小上下文（compaction 更早觸發）、輸出紀律（如 reasoningEffort 從 max 降到 high）、錯峯跑批處理、壓縮工具輸出（如 bash 日誌進上下文）。
改配置前後可用 JSON 報告對比，比較時以 單次調用成本 爲先，避免「總費降了但工作量減半」被誤判爲優化：
dsh-token-audit --format json > before.json
# ... 調整 compaction / effort / 錯峯，等待可比時間窗口 ...
dsh-token-audit --format json > after.json
dsh-token-audit compare before.json after.json
生成 Lean preset¶
審計給出問題形狀後，可導出一份 Lean 預設目錄並作爲 DSH 插件加載：標準工具集保留，compaction 觸發從 80% 調到 45%、縮短保留尾部、工具結果截斷到 4k 字符，並附帶 cost-discipline persona。可用 --threshold、--retain、--prune 微調；新會話選用 Lean preset，已有會話仍用原 preset。
dsh-token-audit preset --out ./dsh-lean-preset
dsh plugin --profile web add ./dsh-lean-preset
DSH 插件形態¶
npm 包同時是 DSH bundle，註冊只讀 agent 工具 token_audit。在 agent 裏請求類似「Audit my token spend for the last 30 days and tell me what to change.」即可得到與 CLI 相同的報告；不會將會話數據發往外部。
安裝與啓用¶
環境要求：Node.js 20+。若系統 PATH 中有 zstdcat，解碼日誌更快；否則使用內置純 JS 解碼器（Windows 走純 JS 路徑）。
零安裝運行：
npx dsh-token-audit
或全局安裝：
npm i -g dsh-token-audit
dsh-token-audit --days 7
作爲 DSH 插件安裝（資料原文命令）：
dsh plugin --profile web add dsh-token-audit
安裝插件前建議自行查看倉庫源碼與 MIT 許可證。插件工具在 當前 dsh 進程權限 下運行，只讀本地會話目錄；與其它 DSH 插件一樣，啓用即信任其代碼路徑。
典型用法¶
默認審計最近 30 天，輸出到終端：
dsh-token-audit
常用參數（節選，完整表見 README）：
dsh-token-audit --days 7
dsh-token-audit --since 2026-10-01 --until 2026-10-31
dsh-token-audit --all
dsh-token-audit --cwd Miner
dsh-token-audit --session 4160cf07
dsh-token-audit --format markdown --out report.md
dsh-token-audit --format html --out report.html --open
dsh-token-audit --format json > audit.json
會話根目錄默認爲 $DSH_HOME/sessions 或 ~/.dsh/sessions，可用 --sessions <dir> 覆蓋。對外分享報告前可使用 --redact 隱藏會話標題、路徑、命令與文件名，保留全部數字。
適用場景與注意¶
適合誰： 長期用 DSH 做 agent 開發、希望從已有日誌裏量化「錢花在 cache、輸出還是峯時」、並想按數據排優先級改 compaction / effort / 調度的人。適合每月或某周賬單異常後 跑一次 審計，而不是替代官方賬單。
隱私： 全程本地計算，除你指定的報告文件外不寫盤、無網絡調用。插件工具只讀。
侷限（資料原文）： 結果是基於日誌的 估算，不是發票；訂閱、贈額、退款、折扣不在日誌裏。峯/閒節假日按中國 2026 硬編碼。第三方 provider 按 Flash 費率 fallback（README 截斷處仍以此爲準理解）。
DeepSeek Harness 生態強調「一切皆插件」；SkillHub 等社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。本插件 star 數在目錄線索中爲 0，是否採用應基於上述能力與你的合規要求自行判斷。
結尾¶
dsh-token-audit 把 DSH 已落盤的會話日誌轉成可操作的 token 成本視圖：官方單價、浪費模式排序、以及可選的 Lean preset 與 before/after 對比。需要零安裝試用時執行 npx dsh-token-audit；要在對話裏讓 agent 拉同一份報告，用 dsh plugin --profile web add dsh-token-audit 啓用 token_audit 即可。
