MiniMax StatusBar

MiniMax coding-plan 使用状态监控工具，支持 CLI 命令和 Claude Code 状态栏集成。

特性

• ✅ 实时状态监控: 显示 MiniMax coding-plan 使用额度、剩余次数、重置时间
• ✅ 上下文窗口跟踪: 智能解析转录文件，准确显示当前会话的上下文使用量
• ✅ 多种显示模式: 详细模式、紧凑模式、持续状态栏
• ✅ Claude Code 集成: 可在 Claude Code 底部状态栏显示
• ✅ 智能颜色编码: 根据使用率自动切换颜色和图标
• ✅ 跨会话支持: 自动从项目历史中查找上下文信息
• ✅ 简洁命令: minimax status 查看状态
• ✅ 安全存储: 凭据存储在独立的配置文件中

快速开始

1. 安装

npm install -g minimax-status

2. 更新(如果已经安装)

npm update -g minimax-status

3. 配置认证

minimax auth <token> <groupId>

配置信息将保存在 ~/.minimax-config.json 文件中。

获取令牌和组 ID:

1. 访问 MiniMax 开放平台
2. 登录并进入控制台
3. 账户信息中复制 groupID
4. Coding Plan 中创建或获取 API Key

4. 查看状态

# 详细模式
minimax status

# 紧凑模式
minimax status --compact

# 持续监控模式
minimax status --watch

VSCode 扩展

提供 VSCode 扩展版本，支持在 VSCode 底部状态栏显示使用状态。

安装方式

方式一：下载 VSIX 文件

1. 访问 GitHub Releases
2. 下载最新的 .vsix 文件
3. 在 VSCode 中按 Ctrl+Shift+P
4. 输入 "Extensions: Install from VSIX..."
5. 选择下载的 VSIX 文件

方式二：从源码构建

git clone https://github.com/JochenYang/minimax-status.git
cd minimax-status/vscode-extension
npm install
npm run package
# 在 VSCode 中安装生成的 .vsix 文件

配置步骤

1. 安装扩展后，点击状态栏的 "MiniMax 未配置" 按钮
2. 或使用命令 "MiniMax Status: 配置向导"
3. 输入您的 API Key 和 GroupID
4. 配置完成后，状态栏将显示实时使用状态

注意: 扩展尚未发布到 VSCode 市场，需要手动安装

Claude Code 集成

将 MiniMax 使用状态显示在 Claude Code 底部状态栏。

配置步骤

1. 安装和配置工具:

   npm install -g minimax-status
   minimax auth <token> <groupId>

2. 配置 Claude Code:

   编辑 ~/.claude/settings.json:

   {
     "statusLine": {
       "command": "minimax statusline"
     }
   }

3. 重启 Claude Code

集成成功后，底部状态栏将显示:

📁 my-app | 🤖 MiniMax-M2 | 40% | ↻ 2690/4500 | ⚡ 15% · 30k/200K | ⏱️ 35m

显示格式：📁 目录 | 🤖 模型 | 使用率 | ↻ 剩余次数/总数 | 上下文窗口 | ⏱️ 剩余时间

上下文窗口显示说明

状态栏会智能显示当前会话的上下文窗口使用情况：

• 有转录数据时: 显示 ⚡ 百分比 · 已用tokens/总容量

  • 例如: ⚡ 15% · 30k/200K 表示已使用 30k tokens，占 200K 容量的 15%

• 无转录数据时: 仅显示上下文窗口总容量

  • 例如: 200K 表示当前模型的上下文窗口大小

智能特性:

• ✅ 自动解析 Claude Code 转录文件（transcript）
• ✅ 支持 Anthropic 和 OpenAI 两种 token 格式
• ✅ 正确计算缓存 tokens（cache creation + cache read）
• ✅ 跨会话查找：当前会话无数据时，自动从项目历史中查找
• ✅ 处理 summary 类型条目和 leafUuid 引用

注意: MiniMax 的配置独立存储在 ~/.minimax-config.json，与 Claude Code 的配置分离。

显示示例

详细模式

┌─────────────────────────────────────────────────────────────┐
│ MiniMax Claude Code 使用状态                        │
│                                                             │
│ 当前模型: MiniMax-M2                          │
│ 时间窗口: 10:00-15:00(UTC+8)                          │
│ 剩余时间: 1 小时 26 分钟后重置                  │
│                                                             │
│ 已用额度: █████████████████████░░░░░░░░░ 27% │
│      剩余: 3307/4500 次调用                   │
│                                                             │
│ 状态: ✓ 正常使用                                   │
└─────────────────────────────────────────────────────────────┘

紧凑模式

● MiniMax-M2 27% • 1 小时 26 分钟后重置 • ✓ 正常使用

持续状态栏模式

✓ MiniMax 状态栏已启动
按 Ctrl+C 退出

[?25l● MiniMax-M2 27% • 3307/4500 • 1h26m ⚡

命令说明

命令	描述	示例
minimax auth	设置认证凭据	minimax auth <token> <groupId>
minimax status	显示当前使用状态（支持 --compact、--watch）	minimax status
minimax bar	终端底部持续状态栏	minimax bar
minimax statusline	Claude Code 状态栏集成	用于 Claude Code 配置

状态说明

状态图标

使用率	图标	含义
< 60%	✓	正常使用
60-85%	⚡	注意使用
≥ 85%	⚠	危险状态

配置文件

默认位置

• 独立配置文件: ~/.minimax-config.json

配置示例

{
  "token": "your_access_token_here",
  "groupId": "your_group_id_here"
}

Claude Code 配置

Claude Code 只需要配置状态栏命令，不包含 MiniMax 配置：

// ~/.claude/settings.json
{
  "statusLine": {
    "command": "minimax statusline"
  }
}

安全说明

凭据仅存储在本地，不会上传到任何服务器。

故障排除

命令未找到

# 确保已全局安装
npm install -g minimax-status

# 重新打开终端

认证失败

# 检查令牌和组 ID
minimax status

# 重新设置认证
minimax auth <new_token> <new_groupId>

状态栏不显示

1. 检查 Claude Code 配置
2. 重启 Claude Code
3. 手动测试: minimax statusline

开发

构建项目

git clone <repository>
cd minimax-status
npm install

测试

# 运行示例
node cli/example.js

# 测试 CLI 命令
node cli/index.js status

许可证

MIT License - 详见 LICENSE 文件

贡献

欢迎提交 Issue 和 Pull Request！

相关链接

• MiniMax 开放平台

---

注意: 本工具仅用于监控 MiniMax coding-plan 用量使用状态，不存储或传输任何用户数据。