前言¶
在 DeepSeek Harness（DSH）裏日常對話或開發時，若要確認 Platform 賬戶裏還剩多少充值與贈金，通常需要打開 Settings → Account。對經常切換會話、盯用量的使用者來說，多一步設置頁既打斷節奏，也容易在側邊欄已展開的情況下忘記去看。
Sidebar Balance（倉庫名 dsh-sidebar-balance）是社區維護者 Qliphoth11 發佈的 客戶端 Web 插件：把與 Account 頁相同來源的餘額讀數，放到側邊欄底部操作區，並隨主題與中英文界面切換展示格式。它不自行髮網絡請求、不上報遙測，數據經 Host 自帶的 account Remote 命名空間取得。
這是什麼¶
- 定位：DeepSeek Harness Web 插件（Cordis bundle），在瀏覽器或 Desktop 的 Web UI 中運行。
- 維護者：Qliphoth11（MIT 許可證，
package.json版本1.0.0）。 - 解決的問題：登錄 DeepSeek 賬戶後，無需進入 Account 設置頁即可在側邊欄 foot 看到餘額摘要；點擊可刷新，懸停可看各幣種錢包與正數贈金明細。
插件與 DeepSeek / 幻方無隸屬或背書關係；社區目錄見 SkillHub 條目，源碼在 GitHub。
核心功能¶
下面介紹 README 中已說明、且與 Harness 內置能力對齊的行爲。
展示位置¶
- 在插槽
sidebar.footer.action註冊一枚餘額「藥丸」，位於賬戶/設置行上方（示意：Plugins 行與頭像行之間）。 - 未登錄時隱藏。側邊欄收折爲 56 px 窄條時，同一讀數會改到 composer 狀態行，以緊湊 pill 形式出現在 turn / token 統計旁；兩處共用一份狀態，任一處刷新會同步另一處。
數據來源與刷新¶
- 通過 Host 提供的
accountRemote（getBalance與watch快照流），與 Settings → Account 頁面一致；不復制、緩存或持久化憑據。 - 在掛載時、登錄/登出變化時、點擊 pill 時、以及窗口重新可見時刷新（可見性路徑帶 30 秒節流）；不做輪詢。
- 金額按 Platform 賬戶錢包（充值與各贈金錢包）彙總，以整分相加後再格式化；不是第三方提供商或純 API Key 場景的消耗計數。
界面與文案¶
- 樣式僅使用
--dsw-*主題 token，隨淺色/深色與宿主調色板變化。 - 可見文案走 Client locale（
sidebar.balance命名空間，en/zh）；貨幣格式隨當前 UI 語言（兩位小數、千分位、窄符號¥/$）。 - Tooltip 列出各幣種錢包與正數 bonus，並提示可點擊刷新。
環境與限制¶
- 需要帶 Web UI 的 DeepSeek Harness（Desktop 或瀏覽器）；README 寫明在
0.2.1-rc.5上構建並驗證。 - 須已登錄 DeepSeek 賬戶（Settings → Account）；僅 API Key、無 Platform 餘額的配置下無內容可顯示。
- 依賴當前發行版中的
sidebar.footer.action與accountRemote API；若 Harness 更名或移除這些接口，需插件跟進更新。
安裝與啓用¶
本倉庫是 Cordis bundle：cordis.patch.yml 插入一條 Host Loader 行；package.json 裏 dsh.client 將 client.js 發佈到瀏覽器。安裝前建議瀏覽倉庫源碼與 MIT 許可證；插件在 當前 DSH 進程權限 下運行，與任何社區插件一樣，應自行評估信任邊界。
從本地 bundle 目錄（README 推薦路徑）¶
先在本地取得倉庫內容後，讓 Harness 智能體安裝 bundle 目錄的絕對路徑（智能體調用插件管理器的 install_bundle，安裝會鏈接到該目錄，改 client.js 後重載頁面即可生效）：
Install the bundle at
/absolute/path/to/sidebar-balance
資料中的克隆地址爲：
git clone https://github.com/Qliphoth11/sidebar-balance.git
克隆完成後，將上句中的路徑替換爲你的 checkout 絕對路徑即可。
從 GitHub 直接安裝¶
若你的 Harness 支持對 bundle 使用 pnpm spec，可讓智能體安裝：
github:Qliphoth11/sidebar-balance
不支持時，改用上面的本地 bundle 路徑方式。
卸載¶
讓智能體移除 dsh-sidebar-balance bundle，或在 Settings → Plugins 中關閉 Sidebar Balance。
典型用法¶
安裝並啓用後，登錄 DeepSeek 賬戶即可在側邊欄底部看到餘額 pill（例如界面中可能出現「餘額 ¥12.34」一類摘要，具體數值以賬戶爲準）。
- 日常查看：展開側邊欄時在 foot 操作區直接讀數，無需打開 Account 頁。
- 刷新：單擊 pill；或切換窗口回到前臺（受 30 秒節流約束）；登錄狀態變化時會自動更新。
- 明細：鼠標懸停查看各錢包與贈金條目。
- 窄側邊欄：收折側邊欄後，到輸入區狀態行查看同一餘額 pill。
開發側可在倉庫根目錄執行語法檢查：
npm run check
在 Harness 源碼 checkout 中跑 Web 開發監視（pnpm run dev:web）時，客戶端插件可熱更新；已安裝的應用裏修改 client.js 後需重載頁面。
適用場景與注意¶
適合：長期在 DSH Web UI 中使用、已綁定 DeepSeek Platform 賬戶、希望在側邊欄或 composer 狀態行快速確認充值/贈金餘額的用戶。
不太適合：僅 API Key、無 Platform 錢包數據的部署；需要第三方模型提供商用量統計的場景（本插件只反映 DeepSeek Platform 賬戶錢包）。
安全與隱私（README 明確）：插件不自帶遙測、不發起獨立網絡請求；讀取均經 Host account 服務。仍建議在安裝前閱讀 client.js 與 bundle 補丁，確認行爲符合預期。
結尾¶
Sidebar Balance 把 Account 頁同源的餘額讀數嵌進側邊欄 foot（及窄欄下的 composer 狀態行），減少進設置頁的次數，並跟隨主題與中英文界面。若要在目錄中查看元信息或跟蹤 issue，可訪問 SkillHub 插件頁 與 GitHub 倉庫。
