前言¶
DeepSeek Harness (DSH) 采用插件化架构，所有功能模块均通过插件实现。在开发智能体或使用火山方舟的 Coding Plan / Agent Plan 时，实时监控额度消耗是必要的环节。dsh-ark-quota 插件旨在解决在 DSH Web GUI 中持久化查看火山方舟用量的问题，通过悬浮窗和后台刷新机制，提供直观的用量概览。
插件简介¶
dsh-ark-quota 是一个运行在 DSH Web 端的本地插件，由用户 zpliao123 维护。它通过读取火山引擎的 IAM 访问密钥，调用 OpenAPI 获取用量数据，并将结果持久化存储在本地配置文件中。
核心功能¶
该插件提供以下核心能力：
- 右侧悬浮窗：在页面右侧提供一个可开关的悬浮窗（
shell.overlay）。点击展开后，根据选择的 Plan 类型显示不同的时间档位：- Coding Plan：当前会话 / 近 1 周 / 近 1 月
- Agent Plan：近 5 小时 / 近 1 周 / 近 1 月
- 设置页配置：在 DSH 设置页中提供「火山方舟用量」选项。用户需在此处填写火山引擎的 AccessKey ID 和 Secret Access Key，并控制浮窗的显示与隐藏，同时设置自动刷新的间隔。
- 定时自动刷新：插件通过 Host 后台按设定间隔调用 OpenAPI 接口获取数据，同时客户端会每 30 秒进行一次同步，确保数据时效性。
- 本地持久化：所有敏感凭证（AK/SK）及配置项（浮窗开关、刷新间隔）均保存在
~/.dsh/dsh-ark-quota/config.json。重启 DSH 后，配置自动加载，无需重复输入。 - 模型工具支持：插件提供名为
ark_coding_plan_usage的模型工具，可在对话中直接调用用量查询。
安装与启用¶
由于未提供标准安装命令行指令，需通过手动配置本地插件包的方式启用：
- 将插件包解压或克隆至 DSH 的 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或使用桌面端应用），插件生效。
典型用法¶
- 初次配置：重启 DSH 后，点击页面右侧的悬浮窗或在设置页的「火山方舟用量」中，填入火山引擎的 AccessKey ID 和 Secret Access Key。首次填入后，凭证将保存在本地。
- 工具调用：在 DSH 的对话中，可以直接调用模型工具
ark_coding_plan_usage获取用量数据。
注意事项¶
- 凭证类型：此处填写的凭证为火山引擎「访问控制(IAM) → 访问密钥」的 AccessKey，而非模型推理专用的 Ark API Key。
- 安全限制：插件通过本地 HTTP 接口与后台通信，接口仅允许本机 loopback 访问。Secret Access Key 永不下发至浏览器，仅在本地内存中使用。
结语¶
dsh-ark-quota 通过悬浮窗与配置页结合的方式，为 DSH 用户提供了监控火山方舟用量的基础能力。其凭证持久化和自动刷新机制降低了日常使用的维护成本。如需查看目录或源码，可访问：插件目录 | GitHub
