前言¶
在 DeepSeek Harness (DSH) 中追蹤使用成本時，需要針對不同模型和時間段設定價格。dsh-ui-pricing 插件解決了這個問題：它提供了一個用戶可配置的定價系統，支持按模型設定列表價格，並允許通過時間策略和乘數來調整每日成本，同時通過 CostLine 在 composer 界面實時展示支出。
插件定位¶
這是 DeepSeek Harness 的一個用戶可配置成本定價插件，由 ivvan3016 維護，類別爲 admin-security，使用 MIT 許可證。
安裝與啓用¶
該插件通過 npm 包分發，包含預構建的工件，安裝後無需額外設置。
dsh plugin --profile web add dsh-ui-pricing
安裝或更新後，必須重啓 dsh web 進程。這是因爲客戶端插件清單和預測註冊表是在服務器啓動時構建的。
配置¶
在插件頁面卡片中，可以配置定價設置。該設置包含模型列表價格、默認時間策略以及每日例外。
模型價格¶
設置每百萬個 tokens 的貨幣單位價格。緩存寫入費用按緩存未命中輸入率計算（DeepSeek 暫無單獨的寫入價格）。未在列表中定義的模型價格爲 0。
時間策略¶
默認策略爲 00:00–24:00 的一個時間段，乘數爲 1.0。在插件頁面卡片中，可以爲每個工作日定義自己的時間表，每個時間段包含一個 HH:MM 窗口和一個 multiplier。乘數爲 1.0 時爲原價，0.5 時爲半價。
pnpm 允許列表¶
如果從 GitHub 源碼安裝，構建過程可能被 pnpm 阻塞。如果遇到 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 錯誤，需要複製 pnpm 打印的精確鍵值到配置文件的 pnpm-workspace.yaml 中：
allowBuilds:
dsh-ui-pricing@https://codeload.github.com/ivvan3016/dsh-ui-pricing/tar.gz/<commit-hash>: true
該鍵綁定到某個具體的提交哈希，包名不匹配，且僅在更新依賴到新提交時變化。
CostLine 使用¶
插件在 composer dock 註冊了一個 CostLine 組件，用於顯示所有活躍會話的總支出。
查看與修正¶
CostLine 顯示帶有“估算”徽章的總計。點擊金額（在可寫部署中）可打開就地編輯器，預填充當前總計。輸入修正後的總數會替換估算值，且後續使用量仍會在此基礎上累加。修正值與自動計算值的差值會作爲 manualSpend 保存。
24小時乘數條帶¶
右側顯示當前本地時間和生效的乘數，以及一條 24 小時的乘數條帶，標記當前分鐘的位置。條帶中的顏色表示折扣（低於原價）、溢價（高於原價）或中性（原價）。
注意事項¶
- 未列出模型：價格默認爲 0，直到在設置中定義。
- 時間線對齊：拖動或點擊時間線邊界時，它們會吸附到整點，分鐘級調整需在設置文檔中完成。
- 覆蓋機制：每日例外是默認時間表的副本，後續對默認時間表的修改不會影響已存在的例外。
- 數據刷新：CostLine 的總計會在當前會話發出事件或重新打開時刷新，以讀取最新的會話預測。
