前言¶
DeepSeek Harness (DSH) 是一個基於插件架構的智能體開發與調試工具。開發者在使用 arckep.ru 等第三方充值服務進行 API 調用充值時，通常需要切換到外部網頁查看餘額和消費明細。dsh-arckep 插件將這一信息集成到 DSH 的 Web UI 中，通過徽章和麪板實時展示賬戶狀態，無需離開開發環境。
核心功能¶
- 徽章顯示：在 DSH 會話頭部和側邊欄底部顯示餘額（格式如
1 234,50 ₽）。當餘額低於閾值（默認 100 ₽）或預測餘額不足 3 天時，徽章會顯示警告顏色。點擊徽章可打開詳情面板。 - 詳情面板：顯示當前餘額（支持企業錢包備註）、今日/7天/30天消費統計、消費最高的前 5 個模型、剩餘可用天數及最後更新時間。
- 設置項：在 Settings -> Arckep 中管理 API Key，支持設置輪詢間隔（默認 300 秒）、警告閾值、僅統計特定 Key 的消費、側邊欄顯示開關及界面語言（跟隨 DSH 語言）。
- 主題支持：界面顏色跟隨 DSH 主題，支持深色與淺色模式。
安裝與啓用¶
使用官方 CLI 安裝插件，安裝後啓動 DSH Web UI 即可生效。
dsh plugin --profile web add dsh-arckep
dsh web
配置 API Key¶
- 在 arckep.ru 後臺的 Settings -> API 創建 Key，權限範圍需包含
balance:read。 - 在 DSH 的 Settings -> Arckep 中粘貼 Key 並保存。保存後字段會被清空，僅提示“Key is set”。
- Key 也可以通過環境變量
ARCKEP_API_KEY設置，環境變量優先級高於設置頁。
隱私與安全¶
- 插件運行時，由 DSH 服務器端發起對 arckep.ru 的請求（
GET /api/v1/balance和GET /api/v1/usage），瀏覽器端只與 DSH 通信。 - 不包含任何遙測、分析或第三方請求。
- Key 僅在請求 arckep.ru 時通過
Authorization: Bearer頭部傳輸，不存儲在配置文件或日誌中。 - Key 存儲在 DSH 的本地憑據存儲中（文件模式 600），僅限當前用戶讀取。
注意事項¶
- 需要 DSH 版本 0.2.0-rc.2 或更高，且 Web UI 必須啓用。
- 這是一個非官方社區插件，由開發者 gmen1057 維護。
- 需要擁有 arckep.ru 賬戶及有效的 API Key。
- 在 DSH Desktop 模式下，由於配置檢查命令受限，需依賴 UI 中的側邊欄徽章確認狀態。
總結¶
該插件將餘額監控直接集成到 DSH 開發環境中，減少切換窗口的頻率。插件目錄見 SkillHub，源碼見 GitHub。
