前言¶
在 DeepSeek Harness（DSH）裏跑長會話、子代理或跨平臺路由時，Token 用量往往能在上下文面板裏看到，但「這次對話大概花了多少錢」「賬號還剩多少」「當前是峯時還是谷時」通常要自己對照官網價目表心算。上游社區插件多按 models.dev 的美元簿計價，DeepSeek 峯桶還會統一乘固定係數，且不區分法定節假日。
下面介紹社區插件 dsh-cost-breakdown（維護者 liaimei）：在保留 dsh-context 上下文洞察能力的基礎上，疊加官方人民幣價目表（峯谷 + 法定節假日）、輸入框下方常駐費用讀數，以及按平臺分幣種的費用匯總。插件歸類爲 admin-security，可在 SkillHub 目錄頁 與 GitHub 倉庫 查看來源與說明。
這是什麼¶
dsh-cost-breakdown 是 DSH 的 Web 側插件（包名 dsh-cost-breakdown，當前版本 0.1.0，許可證 Apache-2.0）。倉庫說明其 src/ 基於 dsh-context（main@209169d）逐字保留上游邏輯，再疊加本倉庫自有的計價與讀數能力；與上游包不同名，理論上可並存，但 README 不建議同時啓用，以免兩套上下文入口在界面上重複。
它要解決的問題可以概括爲三點：餘額可見、峯谷與節假日按官方口徑估算人民幣費用、每個會話（含子代理衍生會話）的消耗構成可對照查看，並通過輸入框下方讀數與右側欄、左側統計頁等多個入口呈現——各入口職責分開，避免 Token 與金額混在同一行裏讓人誤換算。
保留的上游能力¶
安裝後仍可使用 dsh-context 一類能力，例如：
- 上下文儀表盤：組成、趨勢、瀏覽器、事件列表、文件活動、Agent 網絡；
- 左側欄「統計」頁：全部會話 Token 彙總與費用匯總；
/context命令與Ctrl/⌘彈窗；- 每會話 Token 卡（含子 Agent 摺疊）與平臺消費相關展示邏輯的上游基礎。
本插件在此基礎上改寫了計價來源、部分界面分欄與輸入區讀數，詳細差異見倉庫 NOTICE、FORK.md。
核心功能¶
官方人民幣價目表與峯谷¶
計價邏輯在 src/shared/officialRates.ts。對官方表收錄的模型，按元/百萬 Token 分三桶：緩存命中、未命中（含緩存寫入）、輸出；谷價爲峯價一半。
| 模型 | 谷價（緩存命中 / 未命中 / 輸出） | 峯價 |
|---|---|---|
| DeepSeek-V4.1-Flash | 0.02 / 1 / 4 | 0.04 / 2 / 8 |
| DeepSeek-V4-Pro | 0.15 / 4.5 / 13.5 | 0.3 / 9 / 27 |
峯谷判定（北京時間）：週一至週五 09:00–12:00、14:00–18:00 爲高峯，其餘爲空閒。內置 2026 年國務院法定節假日安排（31 天），節假日全天按谷價，與週末一致。宿主配置可覆蓋：
holidays: ['2026-10-01', ...] # YYYY-MM-DD，北京時間
若配置中沒有任何合法日期，會安全回退到內置表，而不是當作「無節假日」（後者會在節假日仍按高峯計價）。官方表未收錄的模型仍走 models.dev 美元分支與回退；峯谷在宿主側完成（src/host/foldMetering.ts 的 isPeakAt），落庫桶攜帶當時適用費率。
計價口徑（重要）：DSH 裏 cacheReadTokens 是緩存命中輸入，inputTokens 是未命中輸入（含緩存寫入），outputTokens 含思考 token，三桶互不重疊。插件按三桶分別計價；費用爲估算值，以平臺賬單爲準。未配置費率的模型會標註「未配置費率」，不會顯示 ¥0。
輸入框下方常駐讀數¶
上游沒有該入口。收起時一行展示：本會話費用 · 餘額 · 當前峯/谷（樣式對齊官方同排 Token 讀數膠囊）。峯/谷爲實時計算，徽標附帶距離下一次翻轉的倒計時；懸停與展開卡內寫全峯時段。週末與法定節假日會直接說明全天谷價原因，而非誤導性倒計時。
點擊可展開詳情卡：內嵌與統計頁相同的 Token 統計、費用統計 兩張卡，以及當前時段官方價目表；浮層 portal 到 document.body，避免被輸入區 overflow 裁剪。
餘額來源按序嘗試：① DSH 賬號登錄（deepseekAccount，桌面端登錄即可，不需要 API key）；② API-key 提供方。讀數先展示緩存值，再按 60 秒週期校正。
各入口各答一件事¶
| 入口 | 回答的問題 |
|---|---|
| 左側欄「統計」頁 | 全部會話 Token 與費用匯總 |
| 會話內「上下文」標籤頁 | 只講上下文與 Token，頁面上不出現金額 |
| 右側欄「本會話彙總」面板 | 本會話 Token 彙總 + 各平臺消費 |
| 輸入框下方讀數 | 當前所用平臺的消費與餘額 |
平臺消費彙總（statsPlatforms.tsx）：一個會話可能跨多平臺，每個平臺一張卡，各自幣種（DeepSeek ¥、第三方 $、積分平臺積分），絕不相加；卡內爲逐模型消費與調用次數。三處費用估算共用 client/cost.ts 的 estimateSessionCostByBucket，減少讀數漂移。
衍生會話與數據來源¶
子代理 / fork 會話在 session/end-seed { inherited: true } 處截斷繼承前綴，只計本會話真實發生的調用，避免重複計費（上游行爲，本倉庫保留）。
| 數據 | 來源 |
|---|---|
| 餘額 | 宿主 host/balance.ts 請求 api.deepseek.com/user/balance（插件不接觸令牌） |
| 用量 | 會話日誌 assistant/message 的 usage，宿主摺疊爲（provider, model, 時段）桶 |
| 價格 | 官方人民幣表；其餘 models.dev |
| 時段 | 北京峯谷規則 + 節假日表 |
安裝與啓用¶
插件面向 web profile，倉庫自帶 lib/ 編譯產物，從 GitHub 安裝時不需要本地構建。package.json 聲明 Node 引擎爲 ^22.19.0 || >=24.0.0，並與 DSH 0.1.7-rc.2、0.2.0-rc.2 標記爲 compatible。
先做安裝，再重啓 DSH（宿主半區不熱生效）：
dsh plugin --profile web add github:liaimei/dsh-cost-breakdown
裝完後輸入框下方應出現常駐費用讀數。若懷疑宿主未加載新代碼，可用帶會話 cookie 的請求檢查：POST /api/dsh-cost-breakdown/skills 應返回 200；404 則重啓 DSH。README 提醒：排查時慎用 dsh plugin list，該命令會觸發 reconcile 並可能改動 lock；只讀狀態時可查看 ~/.dsh/profiles/<profile>/package.json 與 node_modules/。
本地開發可選用 link 安裝（路徑替換爲你的檢出目錄）：
dsh plugin --profile web add "dsh-cost-breakdown@link:/path/to/dsh-cost-breakdown"
典型用法¶
- 看當前會話花了多少、餘額多少：會話輸入框下方讀數；需要明細時點開浮層，查看 Token/費用卡與價目表。
- 看全賬號歷史彙總：左側欄進入「統計」頁，分別查看 Token 段與費用段；DeepSeek 官方用量會話在費用段可見峯谷拆分（僅當前在用平臺）。
- 只看上下文、不看錢：留在「上下文」標籤頁或
/context；金額在右側欄「本會話彙總」的費用段。 - 自定義節假日：在宿主配置中設置
holidays數組；格式錯誤或全非法日期時回退內置 2026 表。
適用場景與注意¶
適合誰：長期在 DSH Web 端使用 DeepSeek 官方或混合路由、需要按人民幣官方峯谷估算會話成本、並希望在 composer 旁持續看到餘額與峯谷狀態的開發者。
務必知曉：
- 插件以當前 DSH 進程權限運行；安裝前應閱讀 源碼與 LICENSE，確認符合你的安全與合規要求。
- 與 dsh-context 功能重疊度高，同時啓用易造成重複入口。
- 社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係；DSH 生態是「一切皆插件」的獨立社區分發模式。
- 費用爲基於日誌 usage 與價目表的估算，實際扣費以平臺賬單爲準。
結尾¶
dsh-cost-breakdown 把 dsh-context 的上下文可視化保留下來，並把 DeepSeek 官方人民幣峯谷、節假日、分平臺分幣種賬單，以及 composer 旁常駐讀數接到同一套數據口徑上。若你需要在 Harness 裏直接對照「本會話多少錢、還剩多少、現在是峯還是谷」，可從目錄頁或 GitHub 按上述命令安裝，重啓後即可在輸入框下方驗證。
- 目錄頁：https://www.skillhub.cn/plugins/liaimei/dsh-cost-breakdown
- GitHub：https://github.com/liaimei/dsh-cost-breakdown
