ovensi / dsh-plugin-minimax-usage

📊 MiniMax Quota Monitor

A DeepSeek Harness plugin that displays your MiniMax Coding Plan quota usage directly in the sidebar.

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

---

✨ Features

• 5-Hour Quota Bar — real-time progress of your current interval remaining
• Weekly Quota Bar — weekly allowance usage at a glance
• Reset Countdown — shows exactly when each window resets (e.g. 重置于 2h 17m)
• Collapsible Panel — click the arrow to collapse/expand; collapsed state shows a compact summary
• Auto Refresh — updates every 60 seconds via server-side cache
• Sidebar Integration — renders in sidebar.footer.action, right above the Settings button
• Lightweight — pure React.createElement, no CSS frameworks, no external images

📸 Preview

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

🚀 Installation

Quick Install (recommended)

cd ~/.dsh/profiles/web
npm link /path/to/this/plugin
# then add the patch entry (see below)

Using pnpm

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

Via npm registry (when published)

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

1. Add to cordis.patch.yml

Append this to ~/.dsh/profiles/web/cordis.patch.yml:

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

2. Set your API key

The plugin reads MINIMAX_API_KEY from ~/.zshrc.secret (or your shell secrets file):

# In ~/.zshrc.secret or ~/.bashrc.secret
export MINIMAX_API_KEY="your-minimax-api-key-here"

Get your API key from MiniMax Open Platform.

3. Restart & Refresh

# Restart the DSH web server
dsh web
# Hard-refresh your browser (Cmd+Shift+R / Ctrl+Shift+R)

⚙️ Configuration

Environment Variable	Description	Default
MINIMAX_API_KEY	Your MiniMax API key	(required)

The API key is loaded at request time from ~/.zshrc.secret via source. If the key is not set, the plugin will display an error message in the sidebar instead of crashing.

🏗️ Architecture

┌─────────────────────────────────┐
│  Host (Node.js)                 │
│  lib/index.js                   │
│  ├─ registers /api/minimax/quota│
│  ├─ reads MINIMAX_API_KEY       │
│  ├─ calls MiniMax REST API      │
│  └─ 60s server-side cache       │
└──────────┬──────────────────────┘
           │ fetch('/api/minimax/quota')
           ▼
┌─────────────────────────────────┐
│  Client (Browser)               │
│  lib/client.js                  │
│  ├─ Slot: sidebar.footer.action │
│  ├─ Collapsible QuotaCard       │
│  └─ 60s auto-refresh            │
└─────────────────────────────────┘

🤝 Contributing

1. Fork this repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 Notes

• The MiniMax API's remains_time / weekly_remains_time fields are unreliable (may return ~96 days for a 5h window). This plugin derives reset countdowns from end_time - Date.now() instead, which is accurate.
• The end_time, start_time, weekly_end_time, and weekly_start_time fields are unix-millisecond timestamps despite the field names.
• Quota percentages are reported by the API as 0–100 integers.

📋 DSH Plugin Manifest

This plugin is designed for DeepSeek Harness and follows the DSH npm-package plugin format:

• dsh.bundle.patch — Cordis patch file for automatic registration
• dsh.client.inject — No external service dependencies
• dsh.client.platform — web (browser-only client)
• Slot — sidebar.footer.action

Tags / Keywords

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

📜 License

MIT © 2026 ovensi

---

Built for DeepSeek Harness 🚀