dsh-ark-balance
DeepSeek Harness 插件：在 Web 界面左下角展示火山方舟协作奖励计划免费资源包余量（基于 @volcengine/ark-cli）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-ark-balance@0.1.1
Ark Balance 以 dsh-ark-balance 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness（DSH）插件：在 Web 界面以常驻挂件展示火山方舟协作奖励计划各模型的免费资源包余量（总量 / 已用 / 剩余 / 发布日期），数据来自官方 @volcengine/ark-cli。
console.volcengine.com/ark 的 favicon），纯白底、无多余特效localStorage，卡片自动避让视口边缘primary_version 解析，目录缓存 6 小时）min(560px, 70vh)），筛选时窗口不跳变需要先在本机安装官方 CLI 并登录一次：
npm i -g @volcengine/ark-cli@latest
arkcli auth login volc-sso # 浏览器扫码授权（或 arkcli auth login --no-browser 跨设备登录）
arkcli auth status
arkcli usage balance --type free-quota # 能看到 JSON 即就绪
dsh plugin --profile web add dsh-ark-balance
git clone https://github.com/key8023lala/dsh-ark-balance.git
cd dsh-ark-balance
dsh plugin --profile web add link:.
link: 会把 profile 的 node_modules/dsh-ark-balance 链接到源码目录，方便改代码dsh-ark-balance 自动进入 dsh.profile.bundles，重启 dsh web 后浏览器 F5dsh plugin --profile web remove dsh-ark-balance
dsh web 后，浏览器左下角出现火山方舟图标（折叠态）arkcli usage balance --type free-quota --format json --page-size 200ListModelChargeItems（火山方舟控制台「模型广场 → 免费额度」）type 分两类：
FreeInference（免费推理）：协作奖励计划赠送的 token 额度，主进度条DataPermission（数据权限）：声音复刻等数据授权额度，meta 行拆分展示models search 目录一次拉取并缓存 6 小时，从 primary_version（YYMMDD）解析，缺失模型 models get 兜底刷新延迟由 arkcli 上游决定（控制台通常 5–30 分钟）。
# 插件在配置树中
dsh --profile web --dump-config | Select-String "ark-balance"
# 宿主路由
curl http://127.0.0.1:3080/dsh-ark/status.json
curl http://127.0.0.1:3080/dsh-ark/balance.json
dsh-ark-balance/
├── package.json # DSH bundle 元数据 + dshhub 市场信息
├── cordis.patch.yml # 挂载声明
├── README.md
├── LICENSE # MIT
├── assets/ # 官方图标源文件
└── lib/
├── index.js # 宿主：spawn arkcli、缓存、日期富化、HTTP 路由
└── widget.js # 前端挂件（拖拽 / 筛选 / 排序 / 列表渲染）
改 lib/widget.js（挂件）后浏览器 F5 即可生效；改 lib/index.js（宿主）后需重启 dsh web。
dsh plugin add 成功、dsh --profile web --dump-config 里有 ark-balance、重启后 F5npm i -g @volcengine/ark-cli@latestarkcli auth login volc-ssousage balance --type free-quota 正常（插件会一次拉全 49 个已开通模型）欢迎提交 Issue 与 PR：
git checkout -b feat/xxx）本项目与火山引擎无隶属关系，插件展示的数据以火山方舟控制台为准。
