方舟用量侧栏 Barry-Liu-001/dsh_ark_plan_usage

dsh-ark-plan-usage

DeepSeek Harness (DSH) 侧边栏插件：在 Web UI 左侧边栏底部实时展示 火山方舟 Agent Plan 用量（5h / weekly / monthly），数据来自本机 arkcli，与 ark-5h-prompt 终端提示符挂件 同源。

- 侧边栏展开：一张用量卡片 —— ⬡ 六边形状态图标、5h 进度条、百分比、已用/总量、窗口重置时间，下方附带 weekly / monthly 小进度条
- 侧边栏收起（轨道模式）：六边形小图标 + 百分比，hover 显示完整信息
- 🟢 插件通过 cordis.patch.yml 向 Loader 树插入 Node 服务（arkPlanUsage Typert Remote），浏览器 bundle 由 package.json 的 dsh.client + exports["./client"] 自动发现并挂到 sidebar.footer.action 插槽。

方式 A/B/C 都会把包解包进 profile 的 node_modules，依赖可正常向上解析，无需任何额外操作；只有方式 D（源码 link）需要按文末「开发说明」补一个 @deepseek-ai 软链。

工作原理

浏览器侧边栏卡片 │ ctx.remote.arkPlanUsage.getUsage() (Typert RPC, /api/arkPlanUsage/getUsage) ▼ Node 端 ArkPlanUsageService（dsh-ark-plan-usage/index.js） │ 缓存有效（.tgz，只含 package.json files 白名单里的 6 个文件）
npm pack
→ 附到 GitHub Release，用户用「方式 C」安装；也可直接发给同事

2) 发布到 npm（公共 registry，所有人可装）
npm login --registry https://registry.npmjs.org
npm publish --registry https://registry.npmjs.org
→ 用户用「方式 B」：dsh plugin --profile web add dsh-ark-plan-usage

3) 什么都不用发：代码推到 GitHub 后，用户直接用「方式 A」从 git 安装（本插件无 prepare 构建脚本，git 安装不会触发 pnpm 的 allowBuilds 拦截）

发布前检查清单：

- [ ] package.json 的 version 已按 semver bump（npm 不允许覆盖已发布版本）
- [ ] npm pack --dry-run 确认 tarball 内容（应只有 LICENSE / README.md / client.js / cordis.patch.yml / index.js / package.json，不含 node_modules）
- [ ] 改动已合入 main 并推送到 GitHub（方式 A 始终装默认分支最新代码）
- [ ] 发布后在 GitHub 建同名 tag / Release（如 v0.1.0），tgz 可挂在 Release 资产里

文件说明

| 文件 | 作用 |
| index.js | Node 端 Typert Remote 服务：arkcli 用量调用、5 分钟缓存、错误分类降级、一键重登录（spawn auth login volc-sso） |
| client.js | 浏览器端 bundle：注册 sidebar.footer.action 插槽 UI（用量卡片 + 「重新登录」按钮）与 RPC 调用 |
| cordis.patch.yml | 向 Loader 树插入本插件的 Node 条目 |
| package.json | 插件清单（dsh.bundle.patch + dsh.client） |