MiniMax 额度监控ovensi/dsh-plugin-minimax-usage

📊 MiniMax 额度监控

一款 DeepSeek Harness 插件，在侧边栏实时展示 MiniMax 编程计划的额度使用情况。

DeepSeek Harness Plugin
DSH Client Plugin
npm compatible
MIT License

English · 中文 · 日本語 · Español

✨ 功能特性

- 5 小时额度条 — 实时显示当前计费周期的剩余额度
- 每周额度条 — 一目了然查看每周配额使用情况
- 重置倒计时 — 精确显示额度窗口重置时间（如 重置于 2h 17m）
- 可折叠面板 — 点击箭头展开/收起，收起时显示紧凑摘要
- 自动刷新 — 每 60 秒通过服务端缓存自动更新
- 侧边栏集成 — 渲染在 sidebar.footer.action 位置，紧邻「设置」按钮上方
- 轻量实现 — 纯 React.createElement，无 CSS 框架，无外部图片

📸 预览

┌──────────────────────────────┐
│  ▼ MINIMAX                   │
│  5 小时   42 / 100 (42%)     │
│  ████████████░░░░░░░░░░░░░░  │
│  重置于 2h 17m                │
│  本周     78 / 100 (78%)     │
│  ████████████████████████░░  │
│  重置于 3d 12h               │
└──────────────────────────────┘
↕ 点击切换
┌──────────────────────────────┐
│  ▶ MINIMAX  5h: 42% · 周: 78%│
└──────────────────────────────┘

🚀 安装

快速安装（推荐）

cd ~/.dsh/profiles/web
npm link /path/to/this/plugin
然后添加 patch 条目（见下文）

使用 pnpm

cd ~/.dsh/profiles/web
pnpm add /path/to/this/plugin

通过 npm 注册表安装（发布后可用）

cd ~/.dsh/profiles/web
pnpm add @dsh-external/minimax-usage

1. 添加到 cordis.patch.yml

在 ~/.dsh/profiles/web/cordis.patch.yml 末尾追加：

- insert:
- id: minimax-usage
name: '@dsh-external/minimax-usage'

2. 设置 API 密钥

插件会从 ~/.zshrc.secret（或你的 shell 密钥文件）读取 MINIMAX_API_KEY：

在 ~/.zshrc.secret 或 ~/.bashrc.secret 中
export MINIMAX_API_KEY="你的-minimax-api-密钥"

在 MiniMax 开放平台 获取你的 API 密钥。

3. 重启并刷新

重启 DSH Web 服务器
dsh web
硬刷新浏览器（Cmd+Shift+R / Ctrl+Shift+R）

⚙️ 配置

| 环境变量 | 说明 | 默认值 |
|---|---|---|
| MINIMAX_API_KEY | 你的 MiniMax API 密钥 | （必填） |

API 密钥在每次请求时通过 source ~/.zshrc.secret 动态加载。如果密钥未设置，插件会在侧边栏显示错误信息，而不会崩溃。

🏗️ 架构

┌─────────────────────────────────┐
│  宿主端 (Node.js)               │
│  lib/index.js                   │
│  ├─ 注册 /api/minimax/quota    │
│  ├─ 读取 MINIMAX_API_KEY        │
│  ├─ 调用 MiniMax REST API       │
│  └─ 60 秒服务端缓存             │
└──────────┬──────────────────────┘
│ fetch('/api/minimax/quota')
▼
┌─────────────────────────────────┐
│  客户端 (浏览器)                 │
│  lib/client.js                  │
│  ├─ 插槽: sidebar.footer.action │
│  ├─ 可折叠 QuotaCard 组件       │
│  └─ 60 秒自动刷新               │
└─────────────────────────────────┘

🤝 贡献

1. Fork 本仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 发起 Pull Request

📝 技术说明

- MiniMax API 返回的 remains_time / weekly_remains_time 字段不可靠（可能在 5 小时窗口返回 ~96 天）。本插件通过 end_time - Date.now() 计算重置倒计时，结果更准确。
- end_time、start_time、weekly_end_time、weekly_start_time 虽然字段名看似秒级时间戳，实际为 毫秒级 Unix 时间戳。
- 额度百分比由 API 以 0–100 的整数返回。

📋 DSH 插件清单

本插件专为 DeepSeek Harness 设计，遵循 DSH npm-package 插件格式：

- dsh.bundle.patch — Cordis 补丁文件，用于自动注册
- dsh.client.inject — 无外部服务依赖
- dsh.client.platform — web（仅浏览器端客户端）
- 插槽 — sidebar.footer.action

标签 / 关键词

deepseek-harness · dsh · dsh-plugin · dsh-client-plugin · minimax · quota · usage-monitor · sidebar · coding-plan

📜 许可证

MIT © 2026 ovensi

专为 DeepSeek Harness 构建 🚀