@miloya/oc-minimax-status 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Jochen 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# @miloya/oc-minimax-status
+
+> MiniMax Claude Code 用量查询插件 for OpenCode - 一键安装自动配置
+
+## 功能特性
+
+- 实时用量查询 - 查询 MiniMax Claude Code 套餐使用状态
+- 安全认证 - 安全的 token 和 groupId 管理，配置文件与 CLI 版共享
+- 美观输出 - 终端友好的进度条展示
+- 一键安装 - 自动安装到全局插件目录，无需手动配置
+
+## 安装
+
+```bash
+npm install @miloya/oc-minimax-status
+```
+
+安装过程会自动：
+1. 复制插件到全局插件目录 (~/.config/opencode/plugins)
+2. 添加插件到 opencode.json 配置
+3. 显示使用说明
+
+## 配置认证
+
+插件会复用 Claude Code 版 minimax-status 的配置文件 `~/.minimax-config.json`，如果已配置过则无需重复配置。
+
+如需手动配置，创建 `~/.minimax-config.json`：
+
+```json
+{
+  "token": "your-api-token",
+  "groupId": "your-group-id"
+}
+```
+
+### 如何获取 token 和 groupId
+
+1. 登录 [https://platform.minimaxi.com/user-center/payment/coding-plan](https://platform.minimaxi.com/user-center/payment/coding-plan)
+2. 获取 API Key 和 Group ID
+
+## 使用方法
+
+在 OpenCode 中直接说：
+
+### 查询用量
+```
+@minimax 查看用量
+@minimax status
+minimax_status
+```
+
+### 管理认证
+```
+@minimax auth get
+@minimax auth set <token> <groupId>
+```
+
+## 输出示例
+
+### 用量查询成功
+
+```
+MiniMax Claude Code 用量状态
+==============================
+Model: MiniMax-M2
+已用: 1,500 / 10,000
+进度: [███░░░░░░] 15%
+剩余: 8,500
+重置: 2026/02/26 14:30 (2h 30m)
+==============================
+```
+
+### 未配置认证
+
+```
+请先配置认证信息！
+
+配置方式：
+1. 如果已安装 Claude Code 版 minimax-status，配置文件已自动共享，无需重复配置
+2. 或手动创建 ~/.minimax-config.json:
+{
+  "token": "your-api-token",
+  "groupId": "your-group-id"
+}
+
+获取 token 和 groupId:
+1. 登录 https://platform.minimaxi.com/user-center/payment/coding-plan
+2. 获取 API Key 和 Group ID
+```
+
+## 相关项目
+
+- [minimax-status](https://github.com/JochenYang/minimax-status) - CLI 版用量查询工具
+
+## License
+
+MIT

package/bin/init.js

@@ -0,0 +1,106 @@
+/**
+ * Post-install auto-configuration script
+ * 
+ * Functions:
+ * 1. Copy plugin files to global plugins directory
+ * 2. Add plugin to opencode.json
+ */
+
+import fs from "fs";
+import path from "path";
+import { execSync } from "child_process";
+
+const PLUGIN_NAME = "oc-minimax-status";
+const PLUGIN_PACKAGE_NAME = "@miloya/oc-minimax-status";
+
+function getGlobalPluginsDir() {
+  const home = process.env.HOME || process.env.USERPROFILE;
+  return path.join(home, ".config", "opencode", "plugins");
+}
+
+function getOpencodeConfigPath() {
+  const home = process.env.HOME || process.env.USERPROFILE;
+  return path.join(home, ".config", "opencode", "opencode.json");
+}
+
+function getPackageDir() {
+  return process.cwd();
+}
+
+function updateOpencodeConfig() {
+  const configPath = getOpencodeConfigPath();
+  let config = {};
+  
+  if (fs.existsSync(configPath)) {
+    try {
+      config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+    } catch (e) {
+      console.warn("Warning: Failed to parse opencode.json");
+    }
+  }
+
+  if (!config.plugin) {
+    config.plugin = [];
+  }
+
+  // Use @latest to ensure latest version on each startup
+  const pluginWithLatest = `${PLUGIN_PACKAGE_NAME}@latest`;
+  
+  // Remove old plugin config if exists
+  config.plugin = config.plugin.filter(p => !p.startsWith("@miloya/oc-minimax"));
+  
+  // Add latest version config
+  if (!config.plugin.includes(pluginWithLatest)) {
+    config.plugin.push(pluginWithLatest);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log("   [OK] Added to opencode.json plugins (with @latest)");
+  } else {
+    console.log("   [OK] Already in opencode.json plugins");
+  }
+}
+
+async function init() {
+  console.log("\n-- MiniMax Status Plugin Installing --\n");
+
+  const globalPluginsDir = getGlobalPluginsDir();
+  const packageDir = getPackageDir();
+
+  if (!fs.existsSync(globalPluginsDir)) {
+    fs.mkdirSync(globalPluginsDir, { recursive: true });
+    console.log("[OK] Created global plugins directory");
+  }
+
+  console.log("-- Copying plugin files...");
+  
+  // Copy index.js to plugins directory
+  const srcIndex = path.join(packageDir, "index.js");
+  const destIndex = path.join(globalPluginsDir, `${PLUGIN_NAME}.js`);
+  fs.copyFileSync(srcIndex, destIndex);
+  console.log(`   [OK] Copied ${PLUGIN_NAME}.js`);
+
+  console.log("-- Installing dependencies...");
+  try {
+    execSync("npm install axios", { 
+      cwd: globalPluginsDir, 
+      stdio: "pipe" 
+    });
+    console.log("   [OK] Installed axios");
+  } catch (e) {
+    console.log("   [SKIP] axios already installed");
+  }
+
+  console.log("-- Updating OpenCode config...");
+  updateOpencodeConfig();
+
+  console.log("\n-- Installation complete --\n");
+
+  console.log("Usage:");
+  console.log("   1. Restart OpenCode");
+  console.log("   2. In OpenCode, just say:");
+  console.log("      '@minimax status'");
+  console.log("      or '@minimax 查看用量'");
+  console.log("");
+  console.log("   For more info, see README.md\n");
+}
+
+init().catch(console.error);

package/index.js

@@ -0,0 +1,177 @@
+/**
+ * MiniMax Status OpenCode Plugin
+ * 
+ * Provides custom tools:
+ * - minimax_status: Query usage status
+ * - minimax_auth: Set/view authentication info
+ */
+
+import { tool } from "@opencode-ai/plugin";
+import axios from "axios";
+import fs from "fs";
+import path from "path";
+
+const CONFIG_PATH = path.join(
+  process.env.HOME || process.env.USERPROFILE,
+  ".minimax-config.json"
+);
+
+function getCredentials() {
+  try {
+    if (fs.existsSync(CONFIG_PATH)) {
+      return JSON.parse(fs.readFileSync(CONFIG_PATH, "utf8"));
+    }
+  } catch (error) {
+    console.error("Failed to read config:", error.message);
+  }
+  return null;
+}
+
+function saveCredentials(token, groupId) {
+  const config = { token, groupId };
+  fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
+}
+
+async function fetchUsageStatus(token, groupId) {
+  const response = await axios.get(
+    "https://www.minimaxi.com/v1/api/openplatform/coding_plan/remains",
+    {
+      params: { GroupId: groupId },
+      headers: {
+        Authorization: `Bearer ${token}`,
+        Accept: "application/json",
+      },
+      timeout: 10000,
+    }
+  );
+  return response.data;
+}
+
+function parseUsageData(apiData) {
+  if (!apiData.model_remains || apiData.model_remains.length === 0) {
+    throw new Error("No usage data available");
+  }
+
+  const m = apiData.model_remains[0];
+  const remaining = m.current_interval_usage_count;
+  const total = m.current_interval_total_count;
+  const used = total - remaining;
+  const percentage = Math.round((used / total) * 100);
+
+  const remainingMs = m.remains_time;
+  const hours = Math.floor(remainingMs / (1000 * 60 * 60));
+  const minutes = Math.floor((remainingMs % (1000 * 60 * 60)) / (1000 * 60));
+
+  const resetTime = new Date(m.end_time).toLocaleString("zh-CN", {
+    timeZone: "Asia/Shanghai",
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+  });
+
+  return {
+    modelName: m.model_name,
+    used,
+    total,
+    remaining,
+    percentage,
+    resetTime,
+    hours,
+    minutes,
+  };
+}
+
+function formatOutput(data) {
+  const { modelName, used, total, remaining, percentage, resetTime, hours, minutes } = data;
+  
+  const bar = "#".repeat(Math.floor(percentage / 10)) + "-".repeat(10 - Math.floor(percentage / 10));
+  const timeText = hours > 0 ? `${hours}h ${minutes}m` : `${minutes}min`;
+
+  return `MiniMax Claude Code 用量状态
+==============================
+Model: ${modelName}
+已用: ${used.toLocaleString()} / ${total.toLocaleString()}
+进度: [${bar}] ${percentage}%
+剩余: ${remaining.toLocaleString()}
+重置: ${resetTime} (${timeText})
+==============================`;
+}
+
+export const MiniMaxStatusPlugin = async (ctx) => {
+  return {
+    tool: {
+      minimax_status: tool({
+        description: "查询 MiniMax Claude Code 套餐使用状态，包括已用次数、剩余次数、进度条和重置时间",
+        args: {
+          refresh: tool.schema.boolean().optional().describe("强制刷新缓存"),
+        },
+        async execute(args, context) {
+          try {
+            const credentials = getCredentials();
+            
+            if (!credentials?.token || !credentials?.groupId) {
+              return `请先配置认证信息！
+
+配置方式：
+1. 如果已安装 Claude Code 版 minimax-status，配置文件已自动共享，无需重复配置
+2. 或手动创建 ~/.minimax-config.json:
+{
+  "token": "your-api-token",
+  "groupId": "your-group-id"
+}
+
+获取 token 和 groupId:
+1. 登录 https://platform.minimaxi.com/user-center/payment/coding-plan
+2. 获取 API Key 和 Group ID`;
+            }
+
+            const apiData = await fetchUsageStatus(credentials.token, credentials.groupId);
+            const usageData = parseUsageData(apiData);
+            
+            return formatOutput(usageData);
+          } catch (error) {
+            if (error.response?.status === 401) {
+              return "认证失败，请检查 token 和 groupId 是否正确";
+            }
+            if (error.code === "ECONNABORTED") {
+              return "请求超时，请检查网络连接";
+            }
+            return `获取用量失败: ${error.message}`;
+          }
+        },
+      }),
+
+      minimax_auth: tool({
+        description: "设置或查看 MiniMax 认证信息",
+        args: {
+          action: tool.schema.enum(["set", "get"]).default("get").describe("操作: set 设置, get 查看"),
+          token: tool.schema.string().optional().describe("API Token"),
+          groupId: tool.schema.string().optional().describe("Group ID"),
+        },
+        async execute(args, context) {
+          if (args.action === "get") {
+            const creds = getCredentials();
+            if (!creds || !creds.token || !creds.groupId) {
+              return "未配置认证信息。请使用 action=set 设置 token 和 groupId";
+            }
+            return `当前认证信息:
+- Token: ${creds.token ? "****" + creds.token.slice(-4) : "未设置"}
+- GroupID: ${creds.groupId || "未设置"}`;
+          }
+          
+          if (args.action === "set") {
+            if (!args.token || !args.groupId) {
+              return "设置认证需要提供 token 和 groupId 两个参数";
+            }
+            saveCredentials(args.token, args.groupId);
+            return "认证信息已保存到 ~/.minimax-config.json";
+          }
+        },
+      }),
+    },
+  };
+};
+
+export default MiniMaxStatusPlugin;

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@miloya/oc-minimax-status",
+  "version": "0.0.2",
+  "description": "MiniMax Claude Code 用量查询插件 for OpenCode - 一键安装自动配置",
+  "main": "index.js",
+  "type": "module",
+  "keywords": ["opencode", "plugin", "minimax", "claude-code", "usage"],
+  "author": "Jochen",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JochenYang/minimax-status"
+  },
+  "files": [
+    "index.js",
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "axios": "^1.6.0"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": "*"
+  },
+  "engines": {
+    "opencode": ">=1.0.0"
+  },
+  "scripts": {
+    "postinstall": "node bin/init.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "minimax-status-init": "./bin/init.js"
+  }
+}