前言¶
DSH 的擴展方式偏“一切皆插件”：Web 界面的功能可以通過插件接入，而不是把每個需求都寫進主程序。對於使用 dsh 做智能體開發的場景，一個具體問題是：不同提供方、不同模型的 token 單價不同，還可能設置高峯時段；會話運行後，如何在 Web 界面裏直接看到本次輸入、輸出和總費用，而不只是看到 token 數？
dsh-token-pricing 是一個社區維護的第三方插件，用於在 dsh Web 界面中配置按提供方/模型的 token 價格，並提供費用讀數、費用浮窗和跨項目費用統計。它不向模型請求添加工具、提示段或設置值；資料稱 Token 影響爲零。
這是什麼¶
dsh-token-pricing 是面向 dsh Web 界面的第三方（非官方）插件，由社區維護，與 deepseek-ai 官方發佈無關。它主要解決三件事：
- 按提供方/模型配置美元價格，包括未命中輸入、緩存命中輸入和輸出。
- 在會話底部數據欄、費用浮窗中查看會話費用。
- 在跨項目費用統計面板中按項目和按模型彙總。
包名是 dsh-token-pricing，倉庫地址是 https://github.com/LightClear/dsh-token-pricing，許可證爲 MIT。
核心功能¶
- 按提供方/模型配置美元價格：輸入未命中、緩存命中輸入、輸出。
- 支持任意多個高峯時段，並在時段內使用高峯價格檔。
- 會話底部數據欄顯示輸入、輸出和總費用。
- 提供可摺疊、可拖拽的費用浮窗，包含「按輪計價」和「按模型計價」兩種視圖。
- 提供跨項目費用統計面板，按項目和按模型兩個維度彙總。
- 會話詳情頁支持逐步明細、時間窗過濾和 CSV 導出。
- 修改價格條目後，會按新價重算曆史會話費用。
- 不向模型請求添加工具、提示段或設置值；資料稱 Token 影響爲零。
安裝與啓用¶
下面按“先確認環境，再安裝插件，最後啓動驗證”的順序說明。
前置條件¶
需要 Node ≥ 22、pnpm，以及一個可用的 dsh 安裝。官方 CLI 可安裝爲：
npm i -g @deepseek-ai/dsh
也可以從源碼啓動：
pnpm dsh
安裝到 web profile¶
先執行包名安裝命令：
dsh plugin --profile web add dsh-token-pricing
資料同時給出 git 源安裝方式：
dsh plugin --profile web add github:LightClear/dsh-token-pricing
啓動與驗證¶
經過上面的步驟後，啓動或重啓 dsh Web：
dsh web
啓動後打開「設置 → 模型定價」配置價格。資料描述的成功表現是：右下角出現費用小球，對話底部數據欄顯示費用讀數。
更新與卸載¶
如需更新或卸載：
dsh plugin --profile web update dsh-token-pricing
dsh plugin --profile web remove dsh-token-pricing
典型用法¶
- 打開「設置 → 模型定價」，爲某個模型配置輸入未命中、輸入命中和輸出費率。
- 如需要高峯計價，添加多個高峯時段；時段內使用高峯價格檔。
- 在會話底部數據欄查看本次會話的輸入、輸出和總費用。
- 展開費用浮窗，在「按輪計價」與「按模型計價」之間切換。
- 打開跨項目費用統計面板，使用時間窗（全部/今天/7天/30天）、含歸檔開關，並導出 CSV。
注意：未配置計價路由或計價規則的模型用量不計入費用讀數，或在視圖中提示「未設置計價」。
適用場景與注意¶
適合在 dsh Web 界面中查看多個模型、多個項目 token 費用的開發者。它不向模型請求添加工具、提示段或設置值；資料稱 Token 影響爲零。
使用前注意：
- 它是第三方非官方插件，由社區維護，與 deepseek-ai 官方發佈無關。
- 插件以當前 dsh 進程權限運行，安裝前應檢查 GitHub 倉庫源碼和
package.json中的MIT許可證。 - 資料稱本包只聲明兩個自用運行時依賴（
schemastery、zod），且安裝不會拉取任何內部包。 - 若 profile 中已存在 id 爲
token-pricing的插件行，安裝後會產生衝突，需移除其一。 - 未配置計價規則或計價路由的用量可能不計入費用讀數，或在視圖中提示「未設置計價」。
結尾¶
dsh-token-pricing 的價值，是把 dsh Web 會話中的 token 用量變成可按模型、按輪次、按項目查看的費用讀數，並在修改價格條目後重算曆史會話費用。本次已覈實資料未提供可引用的社區目錄頁 URL；GitHub 倉庫爲：
https://github.com/LightClear/dsh-token-pricing
