前言¶
在用 DeepSeek Harness(DSH)做智能體或日常對話時,賬戶餘額和當前計費檔位往往要切到網頁或控制台才能確認。側欄裏只有頭像時,很難在寫流程中判斷「現在是不是忙時、下一檔什麼時候切換、餘額還夠不夠用」。社區插件 dsh-account-glance 把這三類信息收進側欄左下角、頭像正上方的一張緊湊卡片裏,依賴 Harness 自帶的 remote.account 讀餘額,閒忙時段則在本地按北京時間推算,不額外打計費規則接口。
下面按定位、能力、安裝與工作機制說明該插件,事實均來自其 GitHub 倉庫 README 與 package.json。
這是什麼¶
dsh-account-glance(npm 包名 @kang7897/dsh-account-glance,當前版本 1.0.0)由維護者 kang7897 發佈,在 SkillHub 目錄中歸類爲客戶端插件。它註冊 DSH Web 客戶端側欄底部(sidebar.footer.action),在賬戶頭像上方渲染單張卡片,展示:
- 已登錄 DeepSeek 賬戶餘額(充值錢包與贈送錢包合計);
- 當前處於閒時還是忙時計費窗口,以及距離下一次切換的倒計時;
- 閒時、忙時兩檔費率,並高亮當前生效的一檔。
主機側 index.js 爲空實現;行爲全部在 client.js 與隨包 locale 中完成。許可證爲 MIT。倉庫在 GitHub 上當前星標數爲 1(以目錄頁線索爲準,安裝與功能說明以 README 爲準)。
核心功能¶
餘額¶
卡片通過內置 Remote API 調用 remote.account.getState() 與 remote.account.getBalance(metadata) 讀取賬戶狀態與餘額。
刷新策略如下:
- 每隔 60 秒自動刷新一次;
- 瀏覽器窗口重新獲得焦點時刷新;
- 頁面從不可見變爲可見時刷新。
若某次刷新失敗,會顯示簡短失敗原因,並保留上一次成功拿到的餘額,避免卡片閃空。
閒時 / 忙時與倒計時¶
計費窗口完全在本地計算,使用北京時間牆鍾,不發起網絡請求。規則與 README 一致:
- 忙時(峯值費率):工作日 09:00–12:00、14:00–18:00;
- 閒時(非峯值):上述區間以外的所有時間;週末全天按閒時處理。
閒時費率爲忙時的 50%(即「半價」);卡片同時展示兩檔費率,當前時段對應的一檔會高亮。界面會實時顯示距離下一次閒忙切換還剩多久。
因此,即使餘額接口暫時不可用,時段與倒計時仍可顯示(僅餘額部分可能沿用舊值或提示失敗)。
語言與其它¶
文案跟隨 DSH 客戶端語言,支持中文 / 英文(locale/*.json)。插件聲明無運行時依賴;除通過官方 Remote API 讀取賬戶狀態與餘額外,不向別處回寫或上報數據(README 原話)。
安裝與啓用¶
需要 DeepSeek Harness 0.2.x,且客戶端已登錄 DeepSeek 賬戶。
在 Harness 中打開 Settings → Plugins → Install,填入倉庫安裝標識:
github:kang7897/dsh-account-glance
安裝後,客戶端會根據 package.json 中的 dsh.client 配置注入 @deepseek-ai/dsh-api-remotes、@deepseek-ai/dsh-client-locale、@deepseek-ai/dsh-client-ui-sidebar,並以 immediately: true 在 Web 平臺加載客戶端模塊。無需額外配置文件或環境變量。
安全與權限說明:與其它 DSH 插件一樣,該擴展以當前 Harness 進程及你所授予的客戶端能力運行;安裝前建議瀏覽 GitHub 倉庫 源碼並確認 MIT 許可證。社區目錄站點與 DeepSeek / 幻方無官方從屬關係,並非官方應用商店。
典型用法¶
本插件沒有獨立 CLI 或配置面板;安裝並登錄後即可使用。
- 完成上述插件安裝,確認 Harness 版本爲 0.2.x。
- 在 Web 客戶端登錄 DeepSeek 賬戶。
- 展開側欄,在左下角頭像上方查看賬戶卡片:上方爲餘額,中間爲當前閒/忙時段與倒計時,下方爲兩檔費率及當前高亮。
若需覈對展示效果,倉庫 assets/screenshot-card.png 提供了卡片示意圖(README 內引用)。
工作機制簡述¶
README 對實現方式的說明可概括爲:
| 部分 | 作用 |
|---|---|
index.js |
主機側佔位,無實際操作 |
client.js |
通過模塊加載器註冊側欄 footer 槽位,注入 remote、remote.account、locale 與 UI 槽位 |
| 計費邏輯 | 純本地算術,基於北京時間的忙閒規則 |
cordis.patch.yml |
由 dsh.bundle.patch 引用,用於客戶端打包補丁 |
這種拆分保證主機模塊保持輕量,同時讓卡片在離線或餘額 API 異常時仍能提示時段信息。
適用場景與注意¶
適合:長期在 DSH Web 側欄工作的開發者或用戶,希望在同一界面內掌握餘額、當前是否忙時計費,以及下一檔切換時間,減少切換頁面的次數。
注意:
- 忙閒規則以插件內置的北京時間邏輯爲準,若平臺側計費政策調整,需等待插件更新規則。
- 餘額依賴
remote.account;網絡或鑑權異常時僅影響餘額刷新,不應影響本地倒計時。 - 目錄分類爲「客戶端」,不適用於無 Web 側欄的純主機場景。
結尾¶
dsh-account-glance 把 DeepSeek 賬戶餘額、閒忙計費窗口、切換倒計時與兩檔費率合併到 DSH 側欄頭像上方一張卡片中,刷新策略與本地時段計算在 README 中寫得很清楚,安裝一條 github:kang7897/dsh-account-glance 即可。