前言¶
在 DeepSeek Harness（DSH）裏做會話式開發時，常見的問題是：當前會話已經消耗了多少 token，對應大概多少錢，今天不同模型各用了多少，agent 自己能不能直接查詢這些數字。
dsh-agent-pricing 由 Way2LOose4 維護，面向 DeepSeek Harness Web profile，提供 composer 下方的即時成本預覽、今日用量浮層，以及 price_estimate / session_cost 兩個 agent 工具，價格與 DeepSeek official pricing page 保持同步，並支持 peak / off-peak 感知。
這是什麼¶
dsh-agent-pricing 是 DSH 插件，定位爲“即時會話成本預覽”。它把當前會話累計成本顯示在輸入區附近，把今日 token 用量整理成浮層圖表，並讓 agent 可以在任務中查詢預估價格和完整會話成本。
該插件使用 MIT 許可證。已覈實資料標記它在 DeepSeek Harness Web profile、0.1.0-rc.6 下爲 verified。
核心功能¶
即時成本顯示¶
打開任意會話後，composer 下方會出現一條緊湊成本行，顯示當前會話累計成本。它每 5 秒刷新一次，並支持 CNY ⇄ USD 切換。
今日用量浮層¶
點擊 ▸ 圖表 可打開今日用量浮層。浮層展示今日 input/output/cache tokens、按小時的使用柱狀圖、按模型拆分、價格來源、最近覈驗時間，以及當前是否適用 peak 或 off-peak 檔位。
Agent 工具¶
插件註冊兩個模型工具：
price_estimate：用於單次調用預估。session_cost：用於讀取完整會話用量。
這樣可以對 agent 問 “how much have we spent?”，它可以用 session_cost 回答當前會話成本，也可以用 price_estimate 先給出事前估算。
價格同步與回退¶
插件在激活時以及之後每 30 分鐘抓取 DeepSeek official pricing page。若抓取失敗，會回退到倉庫的 prices.json，再回退到內置表。失敗時按這條回退鏈處理，估算不依賴某一次抓取成功。
安裝與啓用¶
先確認環境爲 DeepSeek Harness Web profile，並且版本滿足已覈實的 0.1.0-rc.6 verified。使用 DSH CLI 安裝命令：
dsh plugin --profile web add github:Way2LOose4/dsh-agent-pricing
執行後重啓 DSH，使插件隨啓動加載。插件會註冊進 Web profile，並隨 DSH 啓動加載，所以啓用和更新後以重啓後的實例爲準。
典型用法¶
- 打開任意會話，在 composer 下方看到當前會話累計成本行。
- 點擊
CNY/USD切換幣種；點擊▸ 圖表打開今日用量浮層。 - 在會話中問 agent：“how much have we spent?”，它會用
session_cost返回當前會話成本；需要事前估算時，它會調用price_estimate。 - 如果需要用本地價格表覆蓋，可在 workspace root 放置
agent-pricing.json，該文件用於完全覆蓋價格表。
適用場景與注意¶
適合使用 DeepSeek Harness Web profile，並且希望把會話成本、今日用量和 agent 價格查詢放在同一個工作臺裏的開發者。它不需要 API key，也不讀取賬戶餘額或 negotiated rates；所有數字都是 estimates，鏡像 official public price table。
使用前注意：
- 插件會註冊進 Web profile，並隨每次 DSH 啓動加載，因此相當於在 DSH 進程環境中運行。只安裝你信任的插件，安裝前檢查源碼、依賴與 MIT 許可證。
- 成本歷史來自本地 session logs；對外網絡請求限定爲 DeepSeek official pricing page 和倉庫 raw
prices.json。 - 價格同步依賴 official pricing page 的公開數據，抓取失敗時按倉庫
prices.json和內置表回退。 - 若工作區根目錄放入
agent-pricing.json，它會完全覆蓋價格表。
結尾¶
dsh-agent-pricing 將“當前會話花了多少”“今天用了多少”“agent 能不能自己查價格”這三件事合併到 DeepSeek Harness Web profile 中。已覈實資料未提供目錄頁 URL，可使用 GitHub 倉庫地址：Way2LOose4/dsh-agent-pricing。
