前言¶
在 DeepSeek Harness（DSH）里長時間跑對話或智能體任務時，花費往往分散在官網「用量」頁、各輪次的 token 統計和賬號餘額之間，很難在寫提示詞的同時一眼看到「這輪花了多少、今天還剩多少預算」。社區插件目錄裏有不少客戶端擴展；skyrocks/dsh-deepseek-cost 由維護者 skyrocks 發佈，分類爲客戶端，目標是把 DeepSeek 賬號餘額 與 本輪 / 今日 / 本週 / 本月 / 累計 花費固定在對話輸入框下方，懸浮可看明細，點擊可刷新。
這是什麼¶
dsh-deepseek-cost（npm 包名 @skyrocks/dsh-deepseek-cost，當前版本 0.2.3，MIT 許可證）是 DSH 的 Host + 客戶端插件，要求運行環境 dsh 版本 >=0.2.1-rc.2 <0.3.0。顯示區域與樣式沿用同作者 dsh-go-quota 的輸入框下方 dock（同一 conversation.composer.dock 槽位、同一套主題變量）。插件通過 GitHub 分發；npm 上另有同名包 dsh-deepseek-cost（作者 miaoxintechnology），與該項目無關。
核心功能¶
安裝並選用官方 DeepSeek 模型後，輸入框下方會出現一行摘要，例如：
DS -¥0.49 │ 輪 ¥0.02 │ 日 ¥0 │ 周 ¥0 │ 月 ¥18.77 │ 總 ¥129.65
鼠標懸停可打開明細麪板，展示餘額（含充值與贈送拆分）、本輪 in/out token 與估算金額、日/周/月/累計及更新時間；點擊可立即刷新。
顯示條件： 僅在當前會話 provider 爲 deepseek-official 或 deepseek-account 時出現。使用 opencode-go、自建中轉等非官方訂閱渠道時，整條 dock 隱藏。
數據來源概覽：
| 顯示項 | 來源 |
|---|---|
| 餘額 | 官網 GET /api/v0/users/get_user_summary（充值 + 贈送；透支可爲負） |
| 累計 | 同上接口的 total_costs（官網賬號維度累計，含其它客戶端與更早歷史） |
| 今日 / 本週 / 本月 | 官網 GET /api/v0/usage/by_api_key/cost，按本機時區切天，週一爲周起點 |
| 本輪 | 本地估算：當前會話最新一輪 assistant usage × 內置官方價目表（官網無此粒度） |
未登錄官網賬號時，餘額可回退到 DSH 配置的 API Key 調用 /user/balance；日/周/月/累計顯示 —（官網側數據需要登錄態）。「本輪」是唯一本地算出的項，會隨對話落賬更新，不與官網逐條一一對應。
安裝與啓用¶
DSH 生態採用「一切皆插件」思路；社區目錄站點 skillhub.cn 與 DeepSeek / 幻方無官方從屬關係，安裝前建議自行查看 GitHub 倉庫 源碼與許可證。插件以當前 DSH 進程權限訪問官網接口與本地會話數據。
桌面端（推薦）¶
- 打開 DSH 設置 →「插件」→「添加插件」。
- 粘貼倉庫標識：
github:skyrocks/dsh-deepseek-cost
- 完全退出 DSH 再重新打開（Host 插件只在啓動時加載）。
- 在會話中選擇官方 DeepSeek 模型，確認輸入框下方出現
DS 餘額 … ｜ 輪 … ｜ 日 …。
命令行（可選）¶
桌面版 profile 示例：
dsh plugin --profile desktop add github:skyrocks/dsh-deepseek-cost
若使用 dsh web，將 --profile desktop 換成 --profile web。裝完後同樣需要完全退出並重啓。
配置（可選）¶
在 profile 的 cordis.patch.yml 中按插件 id deepseek-cost 覆蓋，例如：
- id: deepseek-cost
config:
cacheMs: 60000
prices:
deepseek-flash: { input: 2, cacheRead: 0.04, output: 8 }
常用字段：refreshMs（默認 30000，輪詢間隔）、cacheMs（默認 60000，官網數據緩存）、prices（僅影響本輪估算，單位每百萬 tokens）、currency、cnyToUsd、timeoutMs、clientVersion。默認價目表覆蓋 deepseek-flash 與 deepseek-v4-pro，並按北京時間工作日高峯/空閒雙檔計價。
典型用法與排錯¶
看不到 dock： 確認當前模型走官方路由（deepseek-official / deepseek-account），而非中轉或第三方訂閱。
日/周/月爲 —： 在 設置 →「賬戶」 登錄 DeepSeek 官網賬號；僅配置 API Key 時只能看到 Key 餘額路徑。
餘額、累計與官網不一致： 文檔說明這兩項直接讀官網同源接口；若仍異常，可在 dock 上點擊刷新，並覈對登錄態與網絡。
「本輪」與其它工具不同： 屬預期行爲，該項按本地價目表估算，高峯時段爲北京時間週一至週五 9:00–12:00、14:00–18:00（法定節假日本地無法判斷時按高峯處理）。
結尾¶
dsh-deepseek-cost 把官網餘額與多時間維度的花費收到輸入框下方，適合需要在 DSH 裏持續開發、又不想反覆打開官網用量頁的開發者。目錄頁：https://www.skillhub.cn/plugins/skyrocks/dsh-deepseek-cost；源碼與 README：https://github.com/skyrocks/dsh-deepseek-cost。
