Arckep 余额 gmen1057/dsh-arckep

dsh-arckep

在 DeepSeek Harness（DSH）网页界面里，直接显示你的 arckep.ru 账户余额和消费情况：会话标题栏里有个小徽章显示余额，一个面板展示明细，还有一个设置页用来填 API key。

非官方。 这是社区插件，不是 DeepSeek 做的，也没得到 DeepSeek 认可，与 DeepSeek 无关。arckep.ru 是插件连接的第三方服务；你需要有自己的 arckep.ru 账户和 API key。

你能得到什么

- 打开的会话标题栏里的徽章：余额显示为 1 234,50 ₽。余额低于你设的阈值（默认 100 ₽），或者预测显示钱撑不过 3 天时，它会变成警告色。点它打开面板。
- 面板：余额（企业钱包会有备注）、今天 / 7 天 / 30 天的消费、花费最高的前 5 个模型、「大约还够 N 天」、「N 分钟前更新」和一个刷新按钮。
- 设置 → Arckep：API key 输入框（保存后会清空，只显示已设置 key）、保存 / 删除 key、「只统计这个 key 的消费」、轮询间隔（默认 300 秒，最小 60 秒）、警告阈值和界面语言。
- 界面支持俄语和英语，跟随 DSH 语言（无法判断时用俄语，其他 DSH 语言用英语）。DSH 本身只带英语和中文，所以俄语用户可以在设置 → Arckep 里把插件切成俄语。颜色取自 DSH 主题，所以浅色和深色主题都能用。
- 如果连不上 arckep.ru，屏幕上会保留最后一次的正常数据，并标注「数据已过期」。

徽章在会话标题栏里，所以打开会话后才会出现（空白的起始页上没有）。

环境要求

- DSH 0.2.0-rc.2 或更新版本，且带网页界面（dsh web）。DSH 还是开发者预览版，插件 API 仍在变动，见兼容性。DSH 本身需要 Node.js 22.19+（或 24+）；插件没有其他要求。
- 一个包含 web 应用的 DSH 配置档（自带的 web 配置档就包含）。
- 一个带 balance:read 权限范围的 arckep.ru API key。

安装

这个包还没上 npm；从 GitHub 安装：

dsh plugin --profile web add github:gmen1057/dsh-arckep
dsh web

（web 是配置档名字；你有自己的配置档就用你自己的。）没有构建步骤，也没有安装脚本，所以不需要额外允许或构建什么。想锁定具体版本，就加上 commit 或 tag：github:gmen1057/dsh-arckep#<commit-or-tag>。

发布到 npm 之后，命令会是：

dsh plugin --profile web add dsh-arckep

用 dsh --profile web --dump-config 检查这一层是否生效（找 # == dsh-arckep 块）。卸载插件用 dsh plugin --profile web remove dsh-arckep。

设置 key

1. 打开 arckep.ru，进入 Settings → API，创建一个密钥。它需要访问 balance（balance:read）。新密钥默认就有这个权限；最稳妥的做法是单独建一个只带这个 scope 的密钥。
2. 在 DSH 里打开 Settings → Arckep，粘贴密钥，按 Save。输入框会清空，页面显示「Key is set」。

另一种做法：启动 DSH 前导出 ARCKEP_API_KEY。DSH 的规则照样生效：环境变量优先于已保存的密钥，此时设置页会把密钥显示为只读。

设置

| 设置项 | 默认值 | 存储位置 |
| API key | 无 | DSH 凭据存储（ARCKEP_API_KEY），见「隐私」 |
| Count spending for this key only | 关 | 当前浏览器 |
| Polling interval | 300 s（最小 60 s） | 当前浏览器 |
| Warn when the balance is below | 100 ₽ | 当前浏览器 |
| Interface language | 与 DSH 相同 | 当前浏览器 |

语言上方的三项显示设置，也可以在你的配置档里覆盖 arckep 那一行，设置成整个部署的默认值（$DSH_HOME/profiles/<profile>/cordis.patch.yml）：

- id: arckep
config:
refreshSeconds: 600
warnBelowRub: 300
keyOnly: false

用户在 Settings → Arckep 里改过的任何值，都会在那个浏览器里覆盖这些默认值。

行为方式

- 调用 arckep.ru 的是 DSH 服务器，不是浏览器。浏览器只跟 DSH 通信。
- 只有在 DSH 页面打开且可见时才发请求，而且只有缓存结果比轮询间隔更旧时才发。服务器上没有后台定时器。
- 一次只发一个请求，超时 10 s，不跟随重定向。出错后，下一次自动尝试会延迟 30 s、60 s、120 s……最长 30 分钟（HTTP 429 时按 Retry-After 处理）。
- 401（密钥错误）和 403（缺少 scope）不会自动重试；修好密钥后按 Refresh。
- 消费明细来自 GET /api/v1/usage。如果 arckep.ru 服务器还没提供这个端点（HTTP 404），插件会继续显示余额，隐藏消费区块，不报任何错误。它会时不时再探测一次。

隐私与安全

- 插件只跟 https://arckep.ru 通信：GET /api/v1/balance 和 GET /api/v1/usage?days=30&key_only=...。主机名和 https 协议在代码里校验；重定向（任何 3xx 响应）都当作错误处理，绝不跟随。
- 没有遥测，没有分析，没有第三方请求。 插件不写自己的文件；DSH 唯一持久化的东西就是密钥，存在凭据存储里。显示设置放在浏览器的 localStorage。
- 密钥只通过 Authorization: Bearer 请求头发给 arckep.ru，不发往别处。它绝不会出现在 cordis.patch.yml、URL、日志、错误信息里，也不会出现在发给浏览器的任何内容中；浏览器只知道是否设置了密钥、以及密钥来自哪里。
- 插件的四条路由挂在 DSH 自己带认证的 /api 通道上，因此受到保护由 DSH 的 Host/Origin 校验和浏览器会话 cookie 保护。改动状态的请求还要求 JSON 内容类型，并且是同源请求。
- 清楚密钥存在哪里。 DSH 的本地凭据存储是 $DSH_HOME 下的一个文件（~/.dsh/.credentials.yaml，权限 600）。DSH 的智能体运行的工具以同一个 OS 用户身份执行，所以它们能读到这个文件。这是 DSH 自身的特性，不是本插件的。把损失控制住：创建一个只有 balance:read 权限的密钥，一旦怀疑它泄露，就去 arckep.ru 吊销它。
- DSH 支持的标准代理变量（见 DSH 的网络代理指南）同样适用，因为插件用的是宿主的常规 fetch。我没有测试过走代理的配置。

私下报告漏洞，见 SECURITY.md。

故障排查

| 你看到 | 含义 |
| "arckep.ru rejected the key (401)" | 密钥错误或已被吊销；粘贴一个新密钥 |
| "The key lacks the required access (balance:read)" | 创建一个带 balance 权限范围的密钥 |
| "Cannot reach arckep.ru" / "did not answer within 10 seconds" | 网络问题；上次的数字会保留，并标记为已过期 |
| "Spending details are not available on arckep.ru yet" | 服务器还没有 /usage 端点；余额仍然可用 |
| 完全没有徽标 | 打开一个会话（徽标在会话头部）；确认 dsh --profile web --dump-config 列出了这个插件 |
| "The key comes from an environment variable" | 取消设置 ARCKEP_API_KEY，改在设置里管理密钥 |

兼容性

DSH 还是开发者预览版；它的插件接口可能随版本变化，而本插件依赖 web 客户端的插槽（conversation.session.header.utilities、settings.section），以及 Host 的 ctx.connection.fetch 和 ctx.credentials。

| DSH 版本 | 状态 |
| 0.2.0-rc.2（latest） | 已测试：安装（从本地路径、tarball 和 git URL）、加载、徽标、面板、设置、密钥存储、实时禁用/启用 |
| 0.2.1-alpha.2（alpha） | 已测试：从 tarball 安装、加载、徽标、面板、设置、密钥存储 |

只验证过 web UI（dsh web）。TUI 没有 web 客户端，不受支持；桌面应用没有测试。

开发

npm ci
npm run check # syntax + manifest checks
npm test # node --test, no network
node scripts/mock-arckep.mjs 39100 # a local stand-in for the API
DSH_ARCKEP_TEST_ORIGIN=http://127.0.0.1:39100 dsh web # point DSH at the mock

DSH_ARCKEP_TEST_ORIGIN 仅供开发使用。只有当它指向回环地址、走明文 http、端口为 1024 或更大时才会被接受（例如 http://127.0.0.1:39100）；其他任何值都会被忽略并记录日志。它无法通过插件配置设置，所以配置文件无法重定向密钥。不要在真实环境里设置它。

客户端那一半（lib/client.js）是 DSH 的 lazy-CommonJS 客户端里一个手写的文件模块格式，所以仓库从 GitHub 安装时不需要构建步骤。

致谢

公开插件 dsh-cost-meter 和 dsh-web-billing 提供了有用的参考，展示了 DSH Web 插件如何接线（插槽、凭据存储、客户端模块格式）。没有从它们复制任何代码。

许可证

MIT © 2026 gmen1057