前言¶
在 DeepSeek Harness（DSH）裏和模型多輪對話時，token 會隨每一輪 assistant 消息和流式 attempt 累加，但界面默認並不把「花了多少錢、輸入/輸出/cache 各多少」擺在顯眼位置。若要對賬、控成本，或找出某次對話裏哪一輪最貴，往往得自己翻 session 日誌或事後估算。
下面介紹社區插件 dsh-session-usage（維護者 Cottins-Vanilla）：它只讀已提交的會話日誌，把 assistant/message 與 assistant/attempt 的用量摺疊成「單會話 / 單輪」彙總，並在側邊欄、對話 View、會話標題和每條回答末尾展示價格與 token。分類爲客戶端插件，面向帶 Web UI 的 Harness 使用場景。
這是什麼¶
dsh-session-usage 回答一個問題：這次（或這一輪）對話在金額和 token 上花了多少？
- 倉庫：Cottins-Vanilla/dsh-session-usage
- 社區目錄頁：SkillHub 插件頁
- 許可證：MIT；當前包版本 1.4.0（見
package.json） - 設計原則：只讀 session log，不寫日誌、不改 profile；除登錄時檢查 GitHub Release 外，無第三方網絡與遙測
展示位置（Surfaces）¶
插件在四處接入，無需單獨開新窗口：
| 位置 | 路徑 | 內容 |
|---|---|---|
| 用量面板 | 側邊欄 → 會話用量 / Session usage | 完整儀表盤：KPI、按日/按輪曲線、會話列表 |
| 用量標籤 | 對話 View → 用量 / Usage | 與面板相同，但範圍限定爲當前打開的對話 |
| 會話標題芯片 | 對話標題欄右側 | 當前對話價格與總 token；點擊可打開面板 |
| 輪次價格標記 | 每條已完成回答之後 | 本輪 ¥… · 當前對話 ¥…，先本輪後累計 |
示意：
Sidebar
└─ 會話用量 ← 完整儀表盤
Conversation header
├─ [Chat] [Trajectory] [用量] [Context] [Fleet]
└─ ¥0.1234 · 12.3k tokens ← 標題芯片
End of a completed answer
└─ 本輪 ¥0.1234 · 當前對話 ¥1.2345 ← 輪次標記
核心功能¶
五項指標與三種範圍¶
- 指標：價格、總 token、輸入 token、輸出 token、cache-read token。
- 範圍（面板頂部爲帶標籤控件，不是零散標籤）：
- 當前對話：本頁最後打開的那條會話，顯示標題。
- 當前項目：
cwd與當前對話工作目錄一致的會話；懸停可看完整路徑。 - 全部對話：
sessionQuery可見的全部 live/persisted 會話，顯示數量。
未在本頁打開過對話時，「當前對話」與「當前項目」不可選。
曲線與圖例¶
- 按日曲線：在
chartDays個日曆日內補零，按北京日期截止到當天。 - 按輪值（僅當前對話）：每點爲該輪單獨用量，不累計，默認模式，便於找「最貴的一輪」。
- 按輪累計：當前對話內隨輪次累加；在「當前項目 / 全部對話」下，費用最高的 8 條會話各用一種顏色，其餘合併爲灰色 other conversations；圖例可點擊隱藏/顯示，懸停可看各序列數值。
點擊跳轉¶
會話列表行打開對應對話；在用量標籤裏點擊按輪圖上的點或輪次明細行，會切回 Chat 並定位到該輪。當前對話視圖會列出每一輪。
輪次成本標記與刷新¶
每條完成回答後顯示類似：
● 本輪 ¥0.1234 · 當前對話 ¥1.2345
面板 標記顏色 / Badge color 可設白/預設色/自定義 hex，偏好存在 localStorage 鍵 dsh-session-usage.turnColor。點擊標記可打開該對話的用量面板。
刷新節奏：面板約 15 秒、標題芯片約 8 秒；輪次標記按會話共享一次請求。登錄 Harness 時會檢查一次 GitHub 最新 Release（Host 緩存 6 小時），也可手動 Check for updates。
定價說明¶
價格爲估算。Harness 記錄 token 用量，但不記錄賬單或供應商牌價。默認按 DeepSeek 公佈的 CNY「每百萬 token」表匹配模型名（含 deepseek-flash、deepseek-v4-pro 等及 fallback）；單條消息大致爲：
cost = (cacheRead × hit + input × miss + cacheWrite × miss + output × out) / 1,000,000
具體系數以倉庫 README 中的表格爲準。換模型或牌價變更時，應以 README 與上游定價爲準，勿把面板數字當作正式發票。
安裝與啓用¶
環境要求¶
- DeepSeek Harness 0.2.2-rc.1（README 標明爲已測試）且啓用 Web UI。
- Node.js 22.19+。
- Profile 中已啓用 Web 應用。
插件爲純 bundle，無構建步驟、無運行時依賴；安裝後默認啓用。若 Web 已在運行，刷新頁面即可；Host 端無法通過 HMR 重載時需重啓應用一次。
從 GitHub 安裝¶
在 Web UI：Plugins → Add plugin，來源選 GitHub，填入：
https://github.com/Cottins-Vanilla/dsh-session-usage
或使用 CLI（desktop 換成你實際承載 Web UI 的 profile 名）：
dsh plugin --profile desktop add https://github.com/Cottins-Vanilla/dsh-session-usage
卸載：Web UI 中 Plugins → Session usage → Remove，或：
dsh plugin --profile desktop remove dsh-session-usage
README 另說明可從本地 checkout 用 dsh plugin --profile desktop add ./dsh-session-usage 安裝；應用內市場收錄需向 awesome-dsh-plugin 提 PR，見倉庫 docs/marketplace.md。
典型用法¶
- 安裝並刷新 Web UI 後，在側邊欄打開 會話用量，先看 KPI 與範圍切換。
- 打開某條對話，在 View 中切到 用量，用 每輪值 找單輪峯值，再用 每輪累計 看對話如何變貴。
- 需要按項目彙總時，選 當前項目；需要全局概覽時選 全部對話，曲線在 每日 與 按輪累計 間切換（非當前對話時不提供「每輪值」）。
- 在 Chat 裏閱讀回答時，直接看末尾 本輪 · 當前對話 標記；要改樣式則在用量面板調整 標記顏色。
- 從圖例或會話列表點進目標對話或輪次，減少在 Chat 與用量頁之間手動翻找。
適用場景與注意¶
適合：長期在 DSH Web 裏做 agent 開發、需要按會話/項目/全局觀察 token 與估算成本、希望在不導出日誌的情況下對比各輪開銷的開發者。
注意：
- 插件在當前 DSH 進程權限下運行，安裝前建議瀏覽源碼與 MIT 許可證，確認符合你的安全策略。
- 金額爲模型名 + 默認單價表的估算，不是供應商賬單。
- 只讀設計意味着它不能替你限流或改配額；控成本仍需結合模型選擇與對話習慣。
- 社區目錄（如 SkillHub）爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係；安裝源以你填寫的 GitHub URL 或本地路徑爲準。
界面提供完整中英文文案（Bilingual）。
結尾¶
dsh-session-usage 把 session 裏已有的用量數據收到側邊欄、用量標籤、標題芯片和回答標記裏，用三種範圍和多種曲線回答「這輪/這天/這個項目花了多少」。若你已在用 Harness 0.2.2-rc.1 與 Web UI，可按上文命令從官方倉庫安裝試用。
- 目錄頁：https://www.skillhub.cn/plugins/Cottins-Vanilla/dsh-session-usage
- 源碼與說明：https://github.com/Cottins-Vanilla/dsh-session-usage
