前言¶
在使用 DeepSeek Harness（DSH）Web 界面進行開發或調試時，直觀查看單次交互的 Token 消耗和累計費用有助於控制成本。arthur20150522/dsh-token-usage-cost 插件提供純 UI 展示，不進入模型上下文，不影響會話與 token 統計。
功能概覽¶
該插件在 DSH Web 界面提供以下能力：
- 每輪費用 chip：在每輪（提問 → 回答 + 工具調用）結束後，在複製/反饋操作欄中常駐顯示本輪費用、輸入輸出 token 數及模型短名。支持按模型着色，懸浮可查看明細。
- 會話累計行：在輸入條上方狀態行下方，顯示整場會話累計費用與 token。切換模型時會顯示“多模型”。
- 自動拉取價格表：從 LiteLLM 社區表、OpenRouter、models.dev 等權威源併發拉取價格，自動識別格式併合併成表，Host 側支持磁盤緩存。
- 一鍵對賬同步：通過點會話累計行末尾的 ⚙，進入配置界面。使用 ⟳ 同步按鈕可拉取全部價格源並枚舉已配置模型，自動匹配後寫回
modelMap配置。 - 多維度費用配置：支持按模型配置費用、幣種與匯率換算、峯谷/時段價配置、歷史模型歸因。
- REST API：提供配置讀寫、價格查詢、強制刷新和對賬接口。
安裝與啓用¶
通過官方 CLI 安裝：
dsh plugin --profile web add github:arthur20150522/dsh-token-usage-cost
# 然後重啓 dsh web
安裝包自帶 dsh.bundle 和 cordis.patch.yml，會自動掛載，無需手動修改 profile 的 patch 文件。
使用方法¶
- 查看每輪費用：每輪交互結束後，觀察複製/反饋操作欄中的 chip，顯示格式爲
本輪 · 費用 · ↑輸入 ↓輸出 · 模型短名。 - 編輯配置：點擊會話累計行末尾的 ⚙，進入頁面內置的迷你編輯器。在這裏可以修改幣種/匯率、峯谷時段規則、模型映射或手動覆蓋價格。
- 對賬同步：在配置界面點擊 ⟳ 同步按鈕，插件會強拉價格源並匹配當前已配置的模型，將命中的映射自動寫回配置，同時列出未匹配的清單。
注意事項¶
- 零構建鏈：插件無需構建，源碼爲
lib/index.js(host, ESM) 和lib/client.js(client, factory CJS classic script)。修改 host 代碼需重啓，修改 client 代碼刷新頁面即可。 - 數據源：費用優先讀取 DSH 全量
session.history中每條assistant/message的usage、message.source與事件時間。 - 許可證：MIT License。
開發與維護¶
該插件遵循零依賴原則，主要文件位於 lib/ 目錄。開發者可通過本機 Node ≥ 18 環境直接運行測試（node test\run-tests.mjs）。
