前言¶
用 DeepSeek Harness（DSH）跑長會話時，token 用量條往往能看到規模，卻很難立刻對應「這一輪對話大概花了多少錢」。峯谷時段、緩存命中與否、模型不同，單價會變；若還開了原生 DeepSeek 搜索，那部分調用又不進同一條會話賬本。下面介紹社區插件 dsh-turn-usage（維護者 WhAIthere），它在 Web 界面裏把單輪花費和本輪 / 今日 / 會話合計標出來，並按模型與時間（高峯、節假日）計價；搜索費在配合 Host 插件時可併入顯示。
這是什麼¶
dsh-turn-usage 是 DSH 的 Web 插件（分類：模型推理），自帶 Host 半邊：從官方會話節點的 node.usage 與 Host 內存裏的會話事件算錢，只讀、不寫盤改數據（賬本落盤是 Host 側留檔，插件本身不聯網）。版本 0.1.0，許可證 MIT，要求 Node >= 20。
目錄頁：skillhub.cn/plugins/WhAIthere/dsh-turn-usage
源碼：github.com/WhAIthere/dsh-turn-usage
社區插件目錄由 SkillHub 等站點維護，與 DeepSeek / 幻方無官方從屬關係；安裝前請自行查看源碼與許可證。插件以當前 dsh 進程權限運行。
界面上會看到什麼¶
每條回覆的操作行¶
在「複製」「分支」等操作之間（插件槽位，靠 order 排序），會出現類似：
複製 · … · 開銷 0.2066 ¥ · 分支 · 用量 12.4K tok · 用時 42s · 10:32
鼠標懸停可看該輪分桶明細（命中/未命中輸入、輸出、模型、峯谷說明等），並註明估算值，非賬單。
輸入框上方通欄¶
居中常駐一行，例如：本輪 0.0123 ¥ · 今日 0.0456 ¥ · 會話 0.7890 ¥（半透明底襯與描邊）。只統計當前打開的會話；切走不渲染，切回來爲最新。單輪超過 ¥0.5 時「本輪」會變紅。子代理不計入。
原生 DeepSeek 搜索（可選）¶
官方 DeepSeek 搜索的模型調用不進會話賬本；配套 Host 插件 dsh-search-audit 旁路記到 ~/.dsh/search-usage.jsonl。本插件經 GET /api/turn-usage/search-usage 取數，在每條回覆後標 （搜索 0.0180 ¥），通欄顯示對話 + 搜索總價（約 2 秒輪詢），搜索明細在懸停裏。是否顯示由客戶端看到的 web_search 工具調用決定；有調用但無記賬時顯示 （搜索 數據缺失）。
核心功能（已文檔說明的能力）¶
- 按輪計價：一輪多步會求和；歷史輪在節點仍加載時同樣有值。按該輪
node.time選價錶行（lib/client.js的PRICES，帶生效起止）；高峯爲工作日北京時間 09:00–12:00、14:00–18:00，週末與內置 2026 法定節假日全天算空閒。 - 模型識別：默認從
usage.routes/provenance.model自動認；認不出用默認deepseek-flash。價目表未收錄的模型不顯示（不按 0 計）。 - Host 合計：
GET /api/turn-usage/totals?session=<id>供腳本消費；會話合計由 Host 讀ownEvents()逐輪求和；「今日」是本會話今天的花費（北京日期），不是全站所有會話。 - 開關：
chip（每條回覆開銷）、dock（通欄）、search（併入搜索費），存於~/.dsh/turn-usage.json，經/api/turn-usage/config讀寫，改動立刻生效。 - 不含：餘額、跨會話歷史統計、子代理（獨立會話）。
安裝與啓用¶
README 中的安裝示例使用本地目錄路徑（已註冊可跳過，直接重啓）：
# 安裝（已註冊過就跳過，直接重啓）
dsh.cmd plugin --profile desktop add "C:\Users\57870\Desktop\753\0-ds_harness_0\tool\dsh-turn-cost"
dsh.cmd plugin --profile web add "C:\Users\57870\Desktop\753\0-ds_harness_0\tool\dsh-turn-cost"
# 改過代碼 / 剛從市場裏打開：必須重啓 dsh web，然後瀏覽器 Ctrl+Shift+R
卸載：
dsh.cmd plugin --profile desktop remove dsh-turn-usage
dsh.cmd plugin --profile web remove dsh-turn-usage
不需要 API key、不需要改 settings。從市場安裝時以你本機實際插件路徑爲準，勿憑倉庫名自行拼接未在文檔出現的命令。
可選配置¶
插件頁開關¶
插件管理 → dsh-turn-usage：chip、dock、search 默認均爲開；關掉後對應 UI 不再顯示或不再併入搜索費。
強制指定計價模型¶
在 profile 的 cordis.patch.yml 裏用同 id 覆蓋：
- id: turn-cost
config:
model: deepseek-v4-pro
2027 及以後節假日¶
內置表到 2026；之後可在 ~/.dsh/turn-usage-holidays.json 追加放假日（鍵 YYYY-MM-DD 北京時間），Host 經 config 下發，客戶端約 30 秒內生效。只需列放假日；調休上班日仍按假期低谷價算。
典型用法與擴展¶
- 只看對話 token 開銷：安裝並啓用
chip/dock即可。 - 搜索費併入總價：安裝 dsh-search-audit 且記賬文件非空；保持
search爲開。可用性由 Host 在/api/turn-usage/config的available字段探測。 - 外部統計源（預留）：向
~/.dsh/turn-usage-external.json寫入{"sessions":{"<sessionId>":1.23}}後，「全面統計」選項可用（文檔標明該拓展尚未完全實現 agent 接入）。
Agent 無需 skill，只需知道上述 API 與文件路徑即可參與統計。排障 Host 路由時可查看 ~/.dsh/turn-usage-route.log。
適用場景與注意¶
適合需要在 DSH Web 裏即時感知單輪與當前會話成本的開發者或重度用戶。數值爲估算，跨峯谷切換點的一輪可能有偏差；free-search 等已在會話賬本里的工具不會重複計搜索插件口徑。
單測（資料原文）：
node tests/run_tests.mjs # 220 項斷言，退出碼 0 = PASS
原理與約束見倉庫內 DESIGN.md、CODE.md。
結尾¶
dsh-turn-usage 把 DeepSeek 推理與可選原生搜索開銷拉到操作行和輸入框通欄，並按會話隔離合計，便於在長對話裏控制花費預期。安裝與細節以 README 爲準：
- 目錄頁：https://www.skillhub.cn/plugins/WhAIthere/dsh-turn-usage
- GitHub：https://github.com/WhAIthere/dsh-turn-usage
