前言¶
在 DeepSeek Harness（DSH）裏跑智能體或對話時，百鍊 Token Plan 的額度往往要在阿里雲控制台裏單獨打開頁面查看。月窗口、周窗口和 5 小時窗口各自刷新，疊加包、訂閱到期和重置倒計時分散在不同區塊，和本地開發節奏對不上。下面介紹的 dsh-token-meter（npm 包名 dsh-plan-meter）是社區維護者 lkpsg 發佈的 DSH 客戶端插件：在 Web UI 側邊欄和頁腳提供用量面板，通過官方百鍊 CLI 登錄態讀取額度，不要求控制台 Cookie、API Key 或 RAM AccessKey。
這是什麼¶
dsh-token-meter 面向已訂閱百鍊 Token Plan、並在 DSH Desktop 或 web profile 下工作的開發者。插件在 DSH 內展示控制台同源的用量摘要：月 / 周 / 5 小時窗口的已用與剩餘比例、下次重置時間及倒計時、訂閱計劃與續費狀態、加購 credits、重置卡信息等；並標註最近一次成功拉取時間，支持手動刷新與可配置的自動刷新間隔。數據經同源 API 由宿主側 Node 讀取 ~/.bailian/config.json 中的 CLI token，再請求百鍊控制台網關；token 不會寫入插件自有存儲，也不會返回給瀏覽器。
核心功能¶
面板爲獨立側邊欄頁 Plan usage，頁腳另有緊湊 chip 顯示月剩餘比例並可點開同一頁面。已覈實展示項包括：
- 月 / 周 / 5 小時窗口：與控制台一致的百分比、剩餘額度、下次重置時間與實時倒計時。
- 訂閱：計劃代碼、狀態、剩餘天數、到期日與自動續費標記。
- 加購 credits：剩餘 / 已用 / 總量及有效加購項數量。
- 重置卡：若計劃具備，顯示最近生效時間與過期時間。
- 新鮮度：上次成功讀取時間、過期標記、手動刷新；背景輪詢與可配置刷新間隔（默認 10 分鐘，範圍 1–1440 分鐘）。
插件無運行時 npm 依賴；出站請求僅指向百鍊控制台主機，無遙測或第三方分析。當前版本僅支持個人 Token Plan；團隊 Token Plan 需 OpenAPI AK/SK，本插件不讀取。
環境與依賴¶
- DSH 版本 >= 0.2.0（Desktop 或
webprofile）。 - 已全局安裝並登錄官方百鍊 CLI（與持有 Token Plan 的賬號一致）：
npm i -g bailian-cli
bl auth login
登錄會打開瀏覽器完成阿里雲賬號認證，CLI 將控制台 token 寫入 ~/.bailian/config.json。若使用國際站控制台：
bl auth login --console --console-site international
安裝與啓用¶
DSH Desktop（推薦）¶
- 打開 Settings → Plugins。
- 選擇 Install from GitHub（或目錄/market 列出後從市場安裝）。
- 填寫倉庫地址：
https://github.com/lkpsg/dsh-token-meter。 - 若宿主提示，重新加載窗口。
Desktop 使用應用自帶 profile，一般無需再執行下面的 CLI 安裝命令。
CLI（web / headless profile）¶
dsh plugin --profile web add github:lkpsg/dsh-token-meter
本地開發時可指向目錄：
dsh plugin --profile web add link:/absolute/path/to/dsh-token-meter
插件以當前 DSH 進程權限運行；安裝前建議在 GitHub 查看源碼與 MIT 許可證（package.json 當前發佈版本爲 0.2.0）。
典型用法¶
- 按上文完成百鍊 CLI 安裝與
bl auth login。 - 在 DSH 側邊欄打開 Plan usage。
- 若仍提示 “Connect the Bailian CLI”，點擊 Check again。
每次拉取都會重新讀取 CLI token，因此重新執行 bl auth login 後無需重啓 DSH 即可生效。登出使用 bl auth logout，面板會回到 setup 卡片。
在面板設置中可調整：
- Region：中國大陸或阿里雲國際站，須與
bl auth login使用的控制台站點一致。 - Refresh interval：1–1440 分鐘；點擊 Refresh 會繞過緩存。頁面可見時每 30 秒輪詢一次，但宿主僅在配置的間隔後纔會再次請求百鍊；失敗請求會節流 30 秒。
可選環境變量（資料原文）：
| 變量 | 用途 |
|---|---|
BAILIAN_CONFIG_DIR |
CLI 的 config.json 所在目錄（默認 ~/.bailian） |
DSH_PLAN_METER_STATE_DIR |
插件狀態目錄（默認 $DSH_HOME/storages/dsh-plan-meter，主要用於測試 hook，僅存展示設置） |
適用場景與注意¶
適合：已在 DSH 中日常開發、訂閱個人百鍊 Token Plan，並希望在本機 DSH 界面內對照 5 小時 / 周 / 月窗口與 credits，避免頻繁切控制台的用戶。
務必知曉：
- 必須有可用的
bl auth login；無 Cookie、API Key、AccessKey 回退路徑。 - CLI token 可能過期，需重新登錄；
sk-...類 API Key 無法讀取 Token Plan 額度，屬平臺限制而非插件開關。 - 控制台內部 API 可能變更，解析失敗時需等待插件更新；插件與阿里雲無隸屬關係。
- 團隊 Token Plan、模型推理與 API Key 管理仍應在百鍊控制台處理。
結尾¶
dsh-token-meter 把百鍊 Token Plan 的多窗口用量、訂閱與加購信息收斂到 DSH 側邊欄與頁腳，依賴官方 CLI 登錄，不額外收集憑證。目錄與分類信息可在社區插件頁查看；源碼、截圖與中文 README 見 GitHub。
- 插件目錄頁：https://www.skillhub.cn/plugins/lkpsg/dsh-token-meter
- GitHub：https://github.com/lkpsg/dsh-token-meter
