前言¶

在使用 DeepSeek Harness（DSH）時，訂閱服務（如 Cline / ClinePass）的額度、餘額與消耗往往分散在不同界面。開發者需要頻繁切換上下文查看資源狀態，打斷工作流。下面介紹一個能在會話頁頭實時展示這些信息的 DSH 插件。

這是什麼¶

dsh-cline-quota 是一個爲 DeepSeek Harness 提供的客戶端插件，由維護者 Wei-l-w 開發。它把 Cline / ClinePass 的訂閱額度、Credits 餘額與 token 消耗直接顯示在 DSH 會話頁頭，並支持多賬號切換。零依賴、無構建步驟，使用 Node 內置模塊與手寫模塊包。

核心功能¶

插件在會話頁頭顯示一個 chip，展示最緊的 5 小時窗口占用百分比。按壓力變色：超過 70% 爲琥珀色，超過 90% 爲紅色。鼠標懸停會給出三個窗口（5 小時 / 本週 / 本月）的進度條、百分比與重置倒計時，以及 Credits 餘額。多賬號時會帶上賬號名。

點擊 chip 會彈出詳情面板，包含：
- 三個窗口的進度條、百分比與重置倒計時
- Credits（按量付費）餘額
- Token 消耗：支持日期區間選擇（預設 24h / 7 天 / 14 天 / 30 天），顯示合計 token 與金額、柱狀圖，以及可點選的模型列表

插件統計 aiModelTypeName === 'cline-pass' 的用量，與 ClinePass 額度口徑一致。

安裝與啓用¶

插件已發佈到 npm 與 GitHub，兩個源內容一致。

方式一：插件面板（推薦）

DSH 側邊欄 →「插件」→「添加插件」，填 dsh-cline-quota（或 github:Wei-l-w/dsh-cline-quota；也可以填本地目錄 / .tgz 的絕對路徑）。

方式二：命令行

dsh plugin --profile <profile> add dsh-cline-quota

桌面版佔用的 desktop profile 不能從命令行管理（會報 profile "desktop" is managed exclusively by the Electron application）；這種情況請用上面的插件面板。

安裝完成後刷新窗口即可看到 chip；host 半邊的改動需要重啓 DSH 纔會重新加載。

配置賬號¶

插件不自帶任何賬號，也不依賴你 DSH 裏配置了 cline provider。打開面板點擊 ＋ 粘貼一個 Cline API key 就能用。

方式一：面板裏粘貼（默認，推薦）

在賬號行右側 ＋ → 粘貼 key → 保存。插件會用 GET /users/me 驗證這個 key，通過後：

• key 存進插件自己的名單文件 $DSH_HOME/cline-quota.accounts.json（權限 0600，與 $DSH_HOME/.credentials.yaml 同爲明文，但完全不會觸碰 DSH 憑據庫）
• 面板自動切換到這個新賬號，賬號名默認取該賬號郵箱
• 刪除賬號（行尾 ✕）會連同保存的 key 一起刪除

方式二：複用 DSH 憑據庫的引用（可選）

如果你已在 DSH 憑據庫裏配置了 Cline 的 key，也可以讓插件按引用名去取：

- id: cline-quota
  config:
    accounts:
      - label: 主號
        keyRef: CLINE_API_KEY

key 本體放在 $DSH_HOME/.credentials.yaml 的 refs: 下，或 $DSH_HOME/.env（只讀回退層）。配置改完不必重啓（loader 會帶新配置重新 apply）。

沒有任何配置、也沒添加過賬號時，面板顯示「還沒有賬號 · 點 ＋ 粘貼 Cline API key」——這是正常的初始狀態。

關於金額¶

三個百分比是 Cline API 提供的（按參考價加權的配額佔用），不是本地用 token 數算的。Token 消耗塊裏的 $ 是 Cline 按參考價折算的用量價值，不是賬單：ClinePass 是訂閱制，參考價不等於實付金額。

對 cline-pass/deepseek-v4.1-flash，Cline 的參考價 = DeepSeek 官方高峯價（輸入 $0.30 / 緩存命中 $0.006 / 輸出 $1.20 每百萬 token）；DeepSeek 空閒價是它的一半。

版本 0.1.0 曾把 Cline 的 usage/caps 金額字段當成 micro-USD，金額放大 100 倍；0.2.0 已修正（usage/caps 按 1e-8 折算，Credits 餘額仍是 micro-USD）。

上游口徑變化：Cline 在 2026-10 把訂閱用量的 aiModelTypeName 從 cline-pass 改成了 cline（模型名仍是 cline-pass/deepseek-v4.1-flash-1017，creditsUsed 爲 0、走 vercel 推理）。0.2.3 起，「類型是 cline-pass」或「模型名以 cline-pass/ 開頭」都算訂閱用量，否則新一天的數據會被整段漏掉。

安全與隱私¶

面板粘貼的 key 存在插件自己的 $DSH_HOME/cline-quota.accounts.json（0600）；配置的賬號才按引用名從 DSH 憑據庫取。瀏覽器只會拿到額度數字、賬號郵箱與標籤，任何 key 都不會回傳給瀏覽器。

粘貼時 key 只在本機 loopback 的 POST body 裏出現一次：不回顯、不寫日誌（診斷日誌只記方法、是否強制刷新、賬號名、區間、UA、origin）。

插件不做任何遙測；host 進程只直連 https://api.cline.bot。路由在本機 loopback 上無鑑權（與 DSH 中其它精確路由一致）：同機進程可以讀到額度數字與郵箱，但讀不到 key。

兼容性¶

需要帶 conversation.session.header.utilities 座位的 DSH；在版本 0.2.1-rc.2（桌面版內置版本）上驗證。需要 Node >= 22。

適用場景¶

適合使用 Cline / ClinePass 作爲推理服務的開發者，尤其是需要同時管理多個賬號、頻繁查看額度與消耗的場景。插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證（MIT）。

短結尾¶

這個插件讓 Cline / ClinePass 的資源狀態一目瞭然，減少切換成本。更多細節可在社區目錄查看：https://www.skillhub.cn/plugins/Wei-l-w/dsh-cline-quota，源碼在 GitHub：https://github.com/Wei-l-w/dsh-cline-quota