dsh-ark-quota

在 DeepSeek Harness (DSH) Web GUI 里查看火山方舟 Coding Plan / Agent Plan 用量的持久化插件。

功能

• 页面右侧可开关的悬浮窗（shell.overlay），点击展开三档用量进度条：当前会话 / 近 1 周 / 近 1 月（Agent Plan 为 近 5 小时 / 近 1 周 / 近 1 月）。
• 设置页「火山方舟用量」：填写火山引擎 AccessKey ID / Secret Access Key、切换浮窗显示、设置自动刷新间隔。
• 定时自动刷新：host 后台按设定间隔（默认 5 分钟，可选 1/5/15/30）调用 OpenAPI；客户端每 30 秒同步一次。
• 持久化：AK/SK、浮窗开关、刷新间隔保存在 ~/.dsh/dsh-ark-quota/config.json，重启后自动加载。HTTP 接口仅允许本机 loopback 访问，SK 永不下发到浏览器。
• 提供模型工具 ark_coding_plan_usage。

数据源

• POST https://open.volcengineapi.com/?Action=GetCodingPlanUsage&Version=2024-01-01（Coding Plan）
• 回退 Action=GetAFPUsage（Agent Plan）
• 火山引擎 SigV4 签名，service ark，region 默认 cn-beijing。

安装 / 加载

作为 web profile 的本地插件包安装在 profiles/web/node_modules/dsh-ark-quota/， 并在 profiles/web/cordis.patch.yml 中：

- insert:
    - id: ark-quota
      name: dsh-ark-quota

重启 DSH Web（dsh web / 桌面端）后生效。首次使用在浮窗或设置页填入 AK/SK 一次即可。

凭证为火山引擎「访问控制(IAM) → 访问密钥」的 AccessKey，不是模型推理用的 Ark API Key。