前言¶
在 DeepSeek Harness（DSH）里長期開着 Web 界面時，若想隨時確認賬戶餘額，往往需要切到設置頁的「賬戶」卡片。對經常在 Harness 裏調試智能體、切標籤頁的開發者來說，這一條路徑不算長，但也不算順手。dsh-account-statusbar 是 SenhoiBot 維護的客戶端類本地插件：在界面最底部佔用 shell.bottom 槽位，左側第一個條目直接展示 DeepSeek 賬戶餘額，並通過 Harness 自帶的 account Remote 讀取數據，插件本身不接觸 token。
這是什麼¶
包名在倉庫中爲 @local/dsh-account-statusbar（package.json 版本 1.0.0，MIT 許可證）。歸類爲客戶端插件：在瀏覽器側註冊底部狀態欄，Host 半僅通過 cordis.patch.yml 插入 Loader 行，index.js 的 apply 爲空。維護者 SenhoiBot；社區目錄頁見 Skillhub 條目，源碼見 GitHub。
核心功能¶
下面介紹插件在頁面上實際提供的能力，均來自倉庫 README 與 package.json 中的 dsh.client 配置。
狀態欄佈局與展示¶
- 佔用 root 作用域的
shell.bottom槽位，橫跨三列下方整行，高度 26px，隨主題明暗。 - 左側首個條目形如：
● DeepSeek 餘額 ¥123.45。 - 圓點顏色：綠色表示已讀到；灰色未登錄；藍色讀取中；紅色失敗。
- 懸停顯示刷新時間與失敗原因；點擊條目立即刷新。
- 賬戶有贈送額度時，追加
+¥x.xx。 - 未登錄顯示「未登錄」；讀取失敗顯示「餘額不可用」，並灰顯保留上一次成功讀到的金額。
餘額數據來源與刷新節奏¶
餘額通過 ctx.remote.account.getBalance（account Remote 命名空間）獲取，與設置頁「賬戶」卡片共用同一條 Host 通道；登錄憑證、平臺請求與 401 失效處理由 Host 負責。
刷新時機包括：
- 頁面打開後約 0.4s 首次讀取；
- 之後每 60s 自動刷新；
- 切回標籤頁且數據超過 30s 時再讀；
- 點擊狀態欄條目時立即刷新。
擴展更多條目¶
狀態欄爲「左側條目行 + 右側條目行」的 flex 容器。README 說明：新條目可加入 StatusBar 的條目行；高度、分隔線與懸停由 .dsh-account-statusbar 統一提供，單條目使用 button.dsh-account-statusbar__item 即可。
安裝與啓用¶
DSH 生態裏插件常以本地目錄或 GitHub 引用方式添加；本插件 README 給出兩種路徑。安裝後需刷新頁面，底部應出現 26px 狀態欄。
方式一（本地目錄）：Web 界面 插件 → 添加插件，填入本倉庫目錄的絕對路徑，安裝後刷新頁面。
方式二（GitHub）：在 CLI 或同一添加插件對話框中填寫下列引用（將 <你的 profile> 換成實際 profile 名）：
dsh plugin --profile <你的 profile> add github:SenhoiBot/dsh-account-statusbar
也可在 插件 → 添加插件 裏直接填 github:SenhoiBot/dsh-account-statusbar，裝完刷新頁面。
典型用法與驗證¶
安裝並刷新後，在已登錄 DeepSeek 賬戶的前提下，底部狀態欄第一個條目應顯示餘額；未登錄時爲灰色圓點與「未登錄」文案。點擊條目可手動觸發刷新；懸停可查看時間與錯誤信息。
倉庫說明本插件無獨立構建步驟：client.js 爲手寫瀏覽器模塊。無瀏覽器時可做部分校驗：
node --check
node test/statusbar.test.mjs
README 提到該測試覆蓋槽位註冊、Remote 結果到狀態的映射與文案（16 項斷言）；實際渲染效果仍需在頁面刷新後人工確認。
適用場景與注意¶
適合需要在 Harness Web UI 中常駐查看餘額、又不想反覆打開設置頁賬戶卡片的用戶。插件以當前 DSH 進程及其 Web 客戶端權限運行；安裝前應閱讀 源碼 與 MIT 許可證，自行判斷是否納入環境。
社區目錄 Skillhub 與 DeepSeek、幻方無官方從屬關係；DSH 奉行「一切皆插件」，本條目爲社區維護的客戶端擴展。
結尾¶
經過上面的步驟，你可以在 Harness 底部用一條狀態欄持續看到 DeepSeek 餘額，刷新策略與賬戶 Remote 與 Host 內置邏輯一致。進一步細節見 GitHub README 與 Skillhub 插件頁。
