前言¶
在 DeepSeek Harness（DSH）里長時間跑會話時，模型供應商的餘額、額度窗口是否夠用，往往要切到控制台或第三方頁面單獨查；同時，工具等待授權、模型追問、回合結束或生成失敗時，若窗口不在前臺，也容易錯過。社區裏曾有 dsh-model-usage 與 dsh-reminding 兩個獨立插件分別承擔用量與提醒。維護者 liuchaoxu 將二者合併爲 dsh-assistant-suite（助手套件）：會話頭部查看用量，設置 → 助手套件 統一管理通知與面板顯示。下文介紹其定位、能力與安裝用法；事實以 GitHub 倉庫 README 爲準。
這是什麼¶
dsh-assistant-suite 是面向 DeepSeek Harness 的社區插件（npm 包名同 dsh-assistant-suite，當前資料版本 0.1.1，MIT License）。它提供：
- 模型供應商賬戶的用量查詢、餘額消耗趨勢（Command Code）；
- 系統提醒（授權、提問、回合完成、失敗或截斷等）。
界面支持深淺色主題、磨砂玻璃面板與窄屏佈局，中英文隨 DSH 應用語言切換。插件目錄頁：https://www.skillhub.cn/plugins/liuchaoxu/dsh-assistant-suite。SkillHub 爲獨立社區目錄，與 DeepSeek / 幻方無官方從屬關係。
環境要求¶
| 項目 | 要求 |
|---|---|
| DeepSeek Harness | >=0.2.1-rc.2；清單聲明兼容 0.2.1-rc.2、0.2.1-rc.5 |
| Node.js | >=18 |
| 界面 | DSH 桌面應用或 Web 界面 |
| 系統通知 | 瀏覽器或桌面環境支持 Notification API，並允許通知 |
客戶端無 npm 運行時依賴；react、react-dom 由 DSH 提供。
核心功能¶
供應商用量¶
點擊會話頭部的 用量。默認 跟隨會話模型，查詢當前模型對應供應商賬戶的餘額、額度窗口與請求數；通過 查詢對象 可手動切換查詢目標，不改變會話實際使用的模型。密鑰由宿主按供應商憑據引用讀取，瀏覽器不接收密鑰值。
當前 README 列出的適配來源包括 Command Code、DeepSeek API、DeepSeek 登錄賬戶、OpenCode Go、OpenRouter、Moonshot / Kimi、SiliconFlow，以及對帶 baseURL 的 OpenAI 兼容路由嘗試 New API 的 /api/user/self 約定。各供應商返回字段不同，插件只展示實際返回的數據；OpenCode Zen 按量計費路由無對應適配，不應與 OpenCode Go 混淆。
刷新與時效：
- 默認開啓自動刷新，間隔 5 分鐘；可選 1、5、15、30、60 分鐘，或自定義 1–1440 分鐘。
- 刷新時間右側圖標可立即查詢；查詢中按鈕暫時禁用。
- 失敗時保留上次成功數據並顯示錯誤；首次失敗則顯示錯誤與重試入口。
餘額消耗趨勢（Command Code）¶
會話組件運行期間，按系統時鐘每十分鐘整點（:00、:10、:20 等）採樣，與面板自動刷新開關獨立。記錄保存在瀏覽器本地，保留當前自然月及前兩個月。支持今天、昨天、近一週、近一月、自定義日期；點擊圖表可打開獨立大圖。可按月份清理或重置當前賬戶記錄。
系統提醒¶
在 設置 → 助手套件 上方管理通知開關與 測試 權限。提醒時機包括：工具等待授權、模型提問 / 計劃審閱、回合完成、生成失敗或輸出截斷。點擊真實通知可返回對應會話；前臺且正在查看同一會話時會抑制通知。子代理會話不單獨提醒。
下方可配置用量彈框顯示項：餘額與額度 爲固定核心內容，其餘如用量入口、刷新狀態、歷史趨勢、數據來源等可按需顯示或隱藏；修改立即生效並保存在本機。
從舊插件遷移¶
啓用本套件後，應停用原來的 dsh-model-usage 和 dsh-reminding，避免重複入口、提醒及相同路由。套件保留舊功能的本地存儲鍵；在相同瀏覽器配置及站點來源下，原有刷新設置、查詢對象、歷史記錄和提醒開關可繼續讀取。用量顯示選項使用套件獨立的存儲鍵。
安裝與啓用¶
DSH 生態裏插件可通過界面或 CLI 安裝；安裝後需確認已啓用並重新加載界面，必要時重啓應用以加載主機端代碼。
插件頁面¶
在 DSH 的 Plugins / 插件 頁面安裝 dsh-assistant-suite 並啓用。npm 包發佈後可按包名安裝；本地開發可通過插件管理工具的 install_bundle 將目標指向項目目錄。
CLI¶
對允許 CLI 管理的 profile，使用 README 中的命令：
dsh plugin --profile <profile> add dsh-assistant-suite
本地目錄安裝：
dsh plugin --profile <profile> add link:/absolute/path/to/dsh-assistant-suite
安裝後在插件頁面確認已啓用。單獨執行 npm install 只下載 npm 包，不會自動在 DSH 中啓用插件。
典型用法¶
- 安裝並啓用插件，重新加載 DSH 界面。
- 打開任意會話，點擊頭部 用量，確認查詢對象與賬戶數據；需要時點擊刷新圖標或調整自動刷新間隔。
- 使用 Command Code 時，在用量面板查看餘額消耗趨勢；需要大圖或自定義時間段時點擊圖表。
- 打開 設置 → 助手套件，完成通知 測試 授權，按需開關提醒與面板顯示項。
- 若曾安裝獨立用量 / 提醒插件，停用
dsh-model-usage與dsh-reminding，避免重複。
適用場景與注意¶
適合誰： 在 DSH 中頻繁切換模型或供應商、需要就地查看餘額與額度、並希望在前臺外也能收到授權與回合相關提醒的開發者。
權限與安全： 供應商查詢在 宿主進程 執行，會訪問相應供應商 API；提醒通過宿主本地路由傳遞。插件以當前 DSH 進程權限運行，安裝前應閱讀源碼與 MIT 許可證，自行評估憑據與網絡訪問範圍。
數據： 刷新策略、查詢對象、歷史與顯示開關保存在瀏覽器 localStorage，按瀏覽器配置及站點來源隔離；清除站點數據會同時清除本地趨勢歷史。歷史趨勢不同步到其他瀏覽器或站點來源。
常見問題： 無用量入口時檢查插件啓用與顯示設置；收不到通知時檢查助手套件開關、系統與瀏覽器通知權限；餘額失敗時檢查 設置 → 模型 中憑據與地址；重複按鈕或提醒時檢查舊插件或其他通知插件是否仍啓用。
結尾¶
dsh-assistant-suite 把供應商用量面板與系統提醒收進一個插件，並在 設置 → 助手套件 統一配置。需要進一步瞭解或反饋問題，可訪問 SkillHub 目錄頁 與 GitHub 倉庫。
