前言¶
在 DeepSeek Harness(DSH)里長時間對話或跑智能體時,賬戶裏還剩多少額度往往要切到 Account 設置頁才能看清。內置界面側重上下文用量等指標,不會在輸入框下方的狀態欄裏直接給出各幣種餘額。若希望在寫 prompt 的同一視線裏看到充值與贈送錢包的讀數,需要一個掛在客戶端 UI 上的輕量展示。pourii83 維護的 dsh-account-usage(npm 包名 @local/dsh-account-usage)正是做這件事:在 Composer 狀態行中、緊挨宿主自帶的 context meter 之後,以純文本顯示與設置頁一致的餘額彙總。
這是什麼¶
dsh-account-usage 是 DSH 的客戶端 UI 插件(分類:客戶端)。維護者爲 Pourii83,源碼與說明見 GitHub 倉庫,社區目錄頁爲 skillhub.cn 上的插件條目。當前資料中的版本爲 1.1.0,許可證 MIT。
插件不新增環形圖或可點擊控件,只在 conversation.composer.dock 裏註冊獨立單元格 account-usage(order 2),並在該行內用 flex order: 1 排在宿主 context meter 之後,字號、顏色與 tabular figures 與宿主統計一致,讀起來像狀態行的一部分。
核心功能¶
界面上看到什麼¶
- 一行純文本,例如
$2.00 · ¥0.55,渲染在 Composer 下方的 dock 狀態行。 - 無圓環、無點擊行爲;可訪問名稱形如
Usage: <amount>。 - 未登錄或首次讀取尚未返回時不顯示任何內容。
- 曾成功讀取後若刷新失敗,會保留上次金額並以偏暗樣式標示;若從未成功讀取則顯示
—。
數據從哪來¶
讀數與 Account 設置頁使用同一套賬戶投影,通過既有 Remote 調用完成,插件側不做服務端緩存:
ctx.remote.account.getState()— 登錄狀態。ctx.remote.account.getBalance(clientMetadata)— 充值與贈送錢包,按幣種彙總並按設置頁相同規則格式化。
餘額會在組件掛載、窗口重新獲得焦點或可見性、以及每 5 分鐘 時重新拉取。傳給平臺的 client 身份由頁面 boot manifest 的 release 版本、當前 UI 語言與 UTC 偏移共同組成。
隱私¶
插件僅通過既有 account Remote 讀取當前已登錄賬戶的餘額,不存儲數據、不記錄憑據,也不在瀏覽器內自行向平臺發起額外請求。
安裝與啓用¶
安裝前提是使用具備 Full access 的 DSH profile。資料中的安裝方式如下,不要憑倉庫名自行拼接其他 CLI 子命令:
- 在本地準備好插件目錄(即包含
index.js、client.js、cordis.patch.yml等的 bundle 根目錄)。 - 在 profile 中執行:
plugin_manager install_bundle <absolute path to this directory>
或將該目錄加入 profile 的 bundle 列表。該 bundle 爲 僅客戶端;Host 側僅用於保持 Loader 行存活。
package.json 中 dsh.client 標明平臺爲 web,immediately: true,並注入 @deepseek-ai/dsh-client-ui-conversation 與 @deepseek-ai/dsh-client-ui-settings-account,無需額外配置文件名出現在 README 中。
典型用法¶
無需單獨配置項或 API 調用:在 profile 中安裝並啓用 bundle 後,使用已登錄賬戶打開帶 Composer 的對話界面即可。
- 確認 profile 爲 Full access,並完成
install_bundle或 bundle 列表掛載。 - 重啓或重載 DSH 客戶端 UI,使 Cordis patch 生效。
- 登錄 DeepSeek 賬戶後進入對話頁,在輸入框下方狀態行中,於 context meter 右側查看餘額文本;失焦再聚焦或等待至多 5 分鐘可觀察自動刷新。
適用場景與注意¶
適合誰: 經常在 DSH Composer 裏寫 prompt、希望減少切頁查餘額的開發者或日常用戶;只需要只讀展示、不需要在狀態欄裏做餘額相關交互的場景。
運行與信任邊界: 插件隨當前 DSH 進程與 profile 權限運行,會調用賬戶 Remote 讀取餘額。安裝前應閱讀倉庫源碼與 MIT 許可證,自行判斷是否納入所用 profile。社區目錄站點與 DeepSeek / 幻方無官方從屬關係,插件來自社區維護者,非官方應用商店內置能力。
侷限: 展示依賴登錄態與 Remote 讀取成功與否;未登錄時不渲染。資料中 GitHub 星標爲 0,不代表功能完備度,僅作生態索引參考。
結尾¶
dsh-account-usage 把 Account 設置頁同源餘額搬到 Composer 狀態行,純文本、無額外控件,適合「寫的時候順便看一眼額度」的習慣。進一步瞭解可訪問 社區目錄頁 與 GitHub 倉庫。