前言¶
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。
