dsh-plugin-cost

在 DeepSeek Harness (DSH) 的對話界面中，通常無法直接查看單次對話花費、會話累計花費以及賬戶餘額。xiaml666/dsh-plugin-cost 解決了這個問題。它提供基於官方價格表的精確計價，支持自動刷新價格與匯率、高峯/低谷時段同步，以及多幣種顯示。

安裝與啓用¶

安裝此插件無需運行時依賴，支持從 GitHub、npm 或本地路徑安裝。安裝完成後必須重啓 dsh web 進程，客戶端 bundle 名冊僅在啓動時組裝一次。

# 從 GitHub 安裝
dsh plugin --profile web add github:xiaml666/dsh-plugin-cost

# 本地開發安裝
dsh plugin --profile web add link:/absolute/path/to/dsh-plugin-cost

注意：pnpm 默認會攔截 git 託管包的 prepare 構建腳本。若首次安裝失敗，請將報錯信息中的 key 加入 pnpm-workspace.yaml 的 allowBuilds 配置中重試。本包本身無需構建。

安裝完成後執行重啓腳本：

node scripts/restart-web.mjs

核心功能¶

該插件在 DSH 界面中提供三種維度的花費顯示：

每輪對話花費
顯示在助手回答收尾動作行，位於 token 用量、耗時之後。默認摺疊，點擊展開可查看模型路由、調用次數與 token 拆分明細。
會話累計花費
顯示在輸入框下方，默認每 3 秒刷新。點擊後顯示輪次、模型調用、已用 token、當前模型及其單價等信息。面板右下角提供設置入口。
賬戶餘額
讀取 /user/balance 接口數據，每 9 秒刷新一次（約 3 次會話刷新間隔）。餘額顯示的幣種與會話累計保持一致，切換幣種時會自動換算。

高峯與低谷時段¶

金額按官方價格表計算，並自動同步高峯/低谷時段。

時段判定：高峯/低谷是模型屬性，非全局開關。插件會根據當前模型的費率行判斷是否有低谷價。有低谷價的模型顯示時段與實時單價；無低谷價的模型顯示“全天同價”。
時區處理：插件解析官方頁面的時段說明，並按用戶所在時區進行展示。官網頁面（中英文）的時段描述在邏輯上等價（如北京時間與 UTC+8）。
空閒時段：官網僅描述爲“其餘爲空閒時段”，插件會根據高峯區間取補集反推，顯示星期一到週五高峯之外的時間，以及週六、週日全天。
自動更新：官網改了時段，插件會在下一次刷新時自動跟上，無需更新插件。

幣種與匯率¶

插件支持多幣種顯示，默認跟隨賬戶幣種。

主幣種：可在面板中選擇“跟隨賬戶”（默認，即餘額接口報的幣種）或指定三字母代碼。
輔助幣種：可配置 secondaryCurrency，例如主顯示人民幣，括號顯示美元。
匯率換算：匯率來自公開 per-USD 匯率表，按 fxRefreshHours 刷新。餘額讀數會按當前幣種換算顯示，確保餘額與會話累計同幣種。

配置與設置¶

配置文件位於 $DSH_HOME/plugin-cost.json（Windows 通常爲 C:\Users\<你>\.dsh\plugin-cost.json）。首次啓動自動生成。

面板提供以下設置分區：

當前模型：只讀，顯示模型名稱、高峯/低谷狀態、單價詳情（含未命中輸入、緩存命中、輸出）。
幣種：主幣種選擇、輔助幣種、自定義代碼。
高峯/低谷：跟隨官網或自定義時段（時區、星期、區間、低谷倍率）。
顯示：控制賬戶餘額、token 明細、高峯說明的顯示。
自動更新：配置目錄地址、刷新間隔及各通道狀態。

注意：面板不提供費率編輯器。費率相關配置（如 routes、models）需直接修改配置文件或通過價格目錄更新，面板保存時不會發送這些字段。

價格目錄與路由¶

插件支持通配符路由配置，允許靈活覆蓋第三方渠道的計價規則。

通配符支持：
- deepseek-official/deepseek-flash：精確匹配
- deepseek-official/*：該供應商下所有模型
- */deepseek-flash：所有供應商下同名的模型
倍率套餐：支持通過 multiplier 字段對已知路由進行倍率調整。
價格目錄：catalog/prices.json 是帶外更新通道。插件內置目錄，可將 catalogUrl 指向網絡上的同結構 JSON 文件，從而在不發版的情況下更新價格。目錄支持 retiredAt 和 billAs 字段，用於模型下線後的自動切換計價。

注意事項¶

插件以當前 dsh web 進程權限運行，安裝前應檢查源碼與許可證。
餘額讀數與當前幣種一致，不會出現分裂狀態。
價格目錄中，openai 與 google 等供應商在默認目錄中僅有元數據，無價格數據，需手動補充或通過配置文件設置。