dsh-minimax-usage
在 DeepSeek Harness (DSH) Web UI 中显示 MiniMax Token Plan 订阅用量。
插件读取官方 Token Plan 用量接口
GET /v1/token_plan/remains，在对话框模型选择器旁显示紧凑的 5h / 7d 用量条。
密钥复用 DSH 设置 → 模型 里已配置的订阅 Key，浏览器拿不到明文。
安装
推荐：从 npm 安装
npx @deepseek-ai/dsh plugin --profile web add dsh-minimax-usage
> ⚠️ 别用 npx dsh plugin——npm 上 dsh 这个名字早在 2016 年就被一个不相关的 JS shell 包占了（dsh@1.0.1，作者 infusion），它没暴露 CLI bin，会报 could not determine executable to run。DSH 的 CLI 在 scoped 包 @deepseek-ai/dsh 下，必须用完整名。
web 换成你的 profile 名。装完 重启 DSH。
备选：从 GitHub 装
锁定版本：
npx @deepseek-ai/dsh plugin --profile web add github:pan17/dsh-minimax-usage#v0.1.2
或默认分支最新：
npx @deepseek-ai/dsh plugin --profile web add github:pan17/dsh-minimax-usage
构建脚本授权
如果 pnpm 提示不允许跑构建脚本（ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED），在该 profile 的 pnpm-workspace.yaml 加上再重跑同一条命令：
allowBuilds:
dsh-minimax-usage: true
然后：
- 打开 Web UI（默认
http://127.0.0.1:3080） - 设置 → 模型 填写 Token Plan 订阅 Key（不是普通按量付费 API Key）
- 在对话框中选择 MiniMax Token Plan 模型后，模型选择器左侧会出现用量条；悬停看详情，点击用量条刷新
功能
- 内联用量条：显示在对话框模型选择器左侧，按截图样式显示 5h / 7d 两条剩余进度
- 按 provider 显示：只有当前选择
minimax-cn或minimaxToken Plan provider 时显示；其他 provider 即使模型名含 MiniMax 也隐藏 - 悬停详情：鼠标悬停或键盘聚焦可查看国内站 / 国际站、套餐名、窗口进度和重置倒计时
- 点击刷新：点一下用量条强制刷新，不改变模型选择或发送操作
- 密钥来源：
MINIMAX_API_KEY（国际）与MINIMAX_CN_API_KEY（国内），优先ctx.credentials，其次进程环境变量 - 自动刷新：只有实际运行中的 Agent 使用
minimax/minimax-cnToken Plan provider 时，才会每 30 秒强制拉取官方用量；切换到其他 provider 或 Agent 回到空闲后停止这条循环。整轮 Agent 回到空闲且这轮用过 MiniMax 后，再等 15 秒执行一次空闲刷新；之后心跳从 2 分钟起每次翻倍，上限 24 小时，再用 MiniMax 并空闲后心跳重置回 2 分钟。每轮快照还会按 5 小时窗口的重置时刻 + 30 秒再触发一次"重置后刷新"，第一时间拉取翻页后的额度。用量条每 15 秒只读 Host 缓存。点击立即强制刷新。
接口
| 区域 | 凭据 | 用量 URL |
|---|---|---|
| 国际 | MINIMAX_API_KEY |
www.minimax.io，失败则回退 api.minimax.io |
| 国内 | MINIMAX_CN_API_KEY |
api.minimaxi.com，失败则回退 www.minimaxi.com |
只查询已配置的区域。两把 Key 都有时，悬停详情中会并排展示两张账号卡。
注意
- 订阅 Key 与普通开放平台 API Key 不能混用。用量接口拒绝普通 Key 时，页面会提示改用订阅 Key。
- 插件原样展示官方剩余额度，不本地「修正」扣费；
remains_time的语义以 MiniMax 控制台为准。 *_quota = 0的模型会标成「未包含」，而不是 0%。
发布
参见 PUBLISH.md：tag push 触发 GitHub Actions，自动 pack → GitHub Release → 等 CI 绿 → publish 到 npm。
开发
npm install
npm test
npm run build
本地未推送时也可以按路径装：
npx @deepseek-ai/dsh plugin --profile web add /path/to/dsh-minimax-usage
