DeepSeek Harness Web UI Token Billing 插件

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」，通過擴展組件增強 Web UI 的功能。dsh-client-ui-token-billing 是一個客戶端插件，它通過注入浮動面板的方式，直接在 DeepSeek Harness Web UI 中展示 Token 用量、上下文壓力、推理等級控制以及費用估算。它不修改模型輸入，也不讀取 API Key，完全在瀏覽器端運行。

功能特性¶

該插件主要解決開發者在使用 DSH 進行智能體開發時，無法直觀監控 Token 消耗、上下文壓力以及實時成本的問題。

數據展示：讀取官方 session.list RPC 返回的投影數據，展示 tokenUsage（輸入/輸出/緩存讀/緩存寫）、contextPressure（壓力與窗口占用）以及 sessionStats（步驟數與耗時）。
推理控制：顯示當前模型及支持的推理等級，提供拖拽條以切換 off、high、max 等級，內部調用 session.selectModel RPC。
費用估算：Host 半側抓取 DeepSeek 官方價格頁，提供同源路由供瀏覽器讀取。支持峯谷價格自動切換（高峯 9:00-12:00 / 14:00-18:00），並允許手動覆蓋價格。
自動刷新：面板每 4 秒自動刷新一次數據。
安全性：純瀏覽器端展示，不讀取 API Key，不修改模型輸入。

安裝與啓用¶

該插件是一個標準的 dsh.client 雙面包，必須能被 profile 的 ctx.baseUrl 解析到（通常位於 profile 自身的 node_modules 目錄）。

方法一：作爲 profile bundle 安裝（推薦）¶

複製插件目錄到 <DSH_HOME>/profiles/web/node_modules/dsh-client-ui-token-billing。
編輯 <DSH_HOME>/profiles/web/package.json，添加依賴：

{
  "dependencies": {
    "dsh-client-ui-token-billing": "github:LucasleeCN/dsh-token-api"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-client-ui-token-billing"
      ]
    }
  }
}

重啓 DeepSeek Harness Web。

方法二：通過 cordis.patch.yml 安裝¶

複製插件目錄到 <DSH_HOME>/profiles/web/node_modules/dsh-client-ui-token-billing。
編輯 <DSH_HOME>/profiles/web/cordis.patch.yml：

- insert:
    - id: ui-token-billing
      name: 'dsh-client-ui-token-billing'
      config:
        enabled: true

重啓 DeepSeek Harness Web。

使用說明¶

安裝並重啓後，DeepSeek Harness Web 右下角會出現一個 Token 膠囊按鈕。點擊該按鈕可展開面板，查看當前會話的用量和費用估算。

驗證數據源¶

也可以直接調用 RPC 驗證數據源是否可用：

POST /api/session.list
Content-Type: application/json

{
  "type": "client-request",
  "rpcId": "manual-check",
  "method": "session.list",
  "payload": {}
}

返回數據中的 items[].projections.values.tokenUsage 即爲本插件展示的原始數據。

價格設置¶

Host 半側會每 30 分鐘重新抓取一次官方價格頁。面板右上角會顯示當前價格所處的時段（當前 / 高峯 / 空閒 / 手動）。點擊面板右上角的 ⚙ 圖標，可以手動覆蓋單個模型的價格，覆蓋後的價格會保存在瀏覽器的 localStorage 中（鍵名爲 dsh-client-ui-token-billing.prices.v1）。

適用場景¶

該插件適合需要在開發過程中實時監控 Token 消耗、上下文窗口壓力，並希望精確控制推理等級和成本的 DSH 用戶。

注意事項：
* 插件安裝前請檢查源碼與許可證（MIT）。
* 插件以當前 DSH 進程的權限運行，需確保 profile 的 ctx.baseUrl 能正確解析到插件目錄。