dsh-ark-quota

Readme

# 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` 中：

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

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

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