modelquota 0.1.0

package/README.md

@@ -0,0 +1,98 @@
+# modelquota
+
+opencode 插件：在 TUI 右侧栏实时显示**当前正在使用的模型供应商**的套餐余量。
+
+## 功能
+
+- **按当前模型显示**：右侧栏只显示当前会话正在使用的模型对应供应商（跟随模型切换，发消息后立即更新）
+- **多供应商支持**：DeepSeek / Kimi For Coding / MiniMax / 智谱 GLM / OpenCode Go
+- **已用视角**：统一显示"已用 X%"或"已用 used/total"，颜色随使用率变化（>80% 红 / >50% 黄）
+- **配置零侵入**：直接复用 opencode 现有的 provider 配置（apiKey/baseURL），不额外存储
+
+## 安装
+
+```bash
+npm i -g opencode-ai   # 需要 opencode 1.18+
+```
+
+在 `~/.config/opencode/opencode.json`（全局）或项目 `opencode.json` 的 `plugin` 数组加：
+
+```json
+{
+  "plugin": ["modelquota"]
+}
+```
+
+在 `~/.config/opencode/tui.json` 加（TUI 插件，需要和 server 插件一起注册）：
+
+```json
+{
+  "plugin": ["modelquota"]
+}
+```
+
+重启 opencode 生效。
+
+## 配置
+
+### 1. 供应商 API Key（复用 opencode 配置，无需额外设置）
+
+在 opencode.json 的 `provider` 里配置了对应供应商即可自动显示（有 key 才显示）：
+
+| 供应商 | provider id | 显示内容 |
+|--------|------------|---------|
+| DeepSeek | `deepseek` | 余额（CNY） |
+| Kimi For Coding | `kimiforcoding` | 周 / 5h 配额（次）+ 并发 |
+| MiniMax | `minimax` | 5h / 周 已用百分比 + 加成 x1.5 |
+| 智谱 GLM | `zhipu` | 5h / 周 已用百分比 |
+| OpenCode Go | （见下文） | 5h / 周 / 月 已用百分比 |
+
+### 2. OpenCode Go 用量（需要额外配置）
+
+OpenCode Go 没有公开的 API 查询接口，插件通过浏览器登录态 cookie 调用官方控制台的 server action 获取用量。
+
+在 `~/.config/opencode/modelquota.json` 配置：
+
+```json
+{
+  "opencodeGo": {
+    "cookie": "你的 auth cookie",
+    "serverId": "控制台 server action 的 id",
+    "workspaceId": "你的 workspace id"
+  }
+}
+```
+
+**获取方法**：
+1. 浏览器登录 https://opencode.ai/auth
+2. 打开 https://opencode.ai/workspace/<你的workspaceID>/go 页面
+3. F12 → Network 面板，刷新页面，找到 `_server?id=xxx&args=...` 的请求
+4. `id=` 后面的值 → `serverId`；请求头里的 Cookie `auth=xxx` → `cookie`；URL 中的 `wrk_xxx` → `workspaceId`
+
+> cookie 有效期约 1 年，过期后重新抓取一次即可。
+
+## 工作原理
+
+```
+┌─────────────────────────┐     mirror JSON      ┌─────────────────────────┐
+│  server plugin          │  ───────────────────▶ │  TUI plugin             │
+│  循环查各供应商套餐 API   │  ~/.local/share/     │  渲染到 sidebar_content │
+│  写快照 + 当前模型       │  opencode/storage/   │  slot（跟随当前模型）    │
+└─────────────────────────┘  modelquota/<hash>.json                        │
+```
+
+- 当前模型通过 `chat.message` 事件实时记录（每次发消息更新）
+- TUI 端从 sync 缓存（Solid 响应式）读取消息流，自动跟随模型切换
+
+## 开发
+
+```bash
+npm install
+npm run typecheck   # 类型检查
+npm run build       # 编译到 dist/
+npm run deploy      # 部署到本地全局插件目录（开发用）
+```
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+import type { GoQueryConfig } from "./providers/opencode-go.js";
+export type ModelQuotaConfig = {
+    opencodeGo?: GoQueryConfig;
+};
+export declare function modelQuotaConfigPath(): string;
+export declare function readModelQuotaConfig(): ModelQuotaConfig;

package/dist/config.js

@@ -0,0 +1,17 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+export function modelQuotaConfigPath() {
+    return join(homedir(), ".config", "opencode", "modelquota.json");
+}
+export function readModelQuotaConfig() {
+    const path = modelQuotaConfigPath();
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}

package/dist/db.d.ts

@@ -0,0 +1,8 @@
+export declare function opencodeDbPath(): string;
+export type LatestSessionModel = {
+    sessionID: string;
+    providerID: string;
+    modelID: string;
+} | null;
+export declare function queryLatestSessionModel(): Promise<LatestSessionModel>;
+export declare function queryGoUsageFromDb(): Promise<number[]>;

package/dist/db.js

@@ -0,0 +1,71 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+export function opencodeDbPath() {
+    return join(process.env.XDG_DATA_HOME ?? join(homedir(), ".local", "share"), "opencode", "opencode.db");
+}
+// 兼容 bun:sqlite（opencode 运行时）与 node:sqlite（本地验证）
+async function openDb(path) {
+    try {
+        const mod = await import("node:sqlite");
+        const db = new mod.DatabaseSync(path, { readOnly: true });
+        return {
+            prepare: (sql) => ({ all: () => db.prepare(sql).all() }),
+            close: () => db.close(),
+        };
+    }
+    catch {
+        const mod = await import("bun:sqlite");
+        const db = new mod.Database(path, { readonly: true });
+        return {
+            prepare: (sql) => ({ all: () => db.query(sql).all() }),
+            close: () => db.close(),
+        };
+    }
+}
+// 从 opencode 本地 SQLite 查最近更新的 session 的模型（/model 切换后立即生效）
+export async function queryLatestSessionModel() {
+    let db = null;
+    try {
+        db = await openDb(opencodeDbPath());
+        const rows = db.prepare("SELECT id, model FROM session WHERE model IS NOT NULL AND model != '' ORDER BY time_updated DESC LIMIT 1").all();
+        const row = rows[0];
+        if (!row?.id || !row.model)
+            return null;
+        const model = JSON.parse(String(row.model));
+        if (!model.providerID || !model.id)
+            return null;
+        return {
+            sessionID: String(row.id),
+            providerID: model.providerID,
+            modelID: model.id,
+        };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        db?.close();
+    }
+}
+export async function queryGoUsageFromDb() {
+    const windows = [
+        { label: "5h", ms: 5 * 3_600_000, total: 12 },
+        { label: "周", ms: 7 * 24 * 3_600_000, total: 30 },
+        { label: "月", ms: 30 * 24 * 3_600_000, total: 60 },
+    ];
+    let db = null;
+    try {
+        db = await openDb(opencodeDbPath());
+        const rows = db.prepare("SELECT cost, time_created FROM session WHERE model LIKE '%opencode-go%' AND cost IS NOT NULL AND cost > 0").all();
+        const now = Date.now();
+        return windows.map((window) => rows
+            .filter((row) => Number(row.time_created) >= now - window.ms)
+            .reduce((sum, row) => sum + Number(row.cost ?? 0), 0));
+    }
+    catch {
+        return [0, 0, 0];
+    }
+    finally {
+        db?.close();
+    }
+}

package/dist/mirror/path.d.ts

@@ -0,0 +1,3 @@
+export declare function canonicalProjectDir(directory: string): string;
+export declare function mirrorStorageDir(): string;
+export declare function mirrorFilePath(projectDir: string): string;

package/dist/mirror/path.js

@@ -0,0 +1,15 @@
+import { createHash } from "node:crypto";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const STORAGE_DIR = "modelquota";
+export function canonicalProjectDir(directory) {
+    // 统一正斜杠 + 去尾部斜杠，保证 server/TUI 两侧 hash 一致
+    return directory.replace(/\\/g, "/").replace(/\/$/, "");
+}
+export function mirrorStorageDir() {
+    return join(process.env.XDG_DATA_HOME ?? join(homedir(), ".local", "share"), "opencode", "storage", STORAGE_DIR);
+}
+export function mirrorFilePath(projectDir) {
+    const projectHash = createHash("sha1").update(canonicalProjectDir(projectDir)).digest("hex").slice(0, 16);
+    return join(mirrorStorageDir(), `${projectHash}.json`);
+}

package/dist/mirror/reader.d.ts

@@ -0,0 +1,2 @@
+import type { MirrorSnapshot } from "../types.js";
+export declare function readMirror(filePath: string): MirrorSnapshot | null;

package/dist/mirror/reader.js

@@ -0,0 +1,14 @@
+import { readFileSync } from "node:fs";
+export function readMirror(filePath) {
+    try {
+        const raw = readFileSync(filePath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (parsed && parsed.version === 1 && Array.isArray(parsed.providers)) {
+            return parsed;
+        }
+    }
+    catch {
+        // 文件不存在或损坏：返回 null
+    }
+    return null;
+}

package/dist/mirror/writer.d.ts

@@ -0,0 +1,2 @@
+import type { MirrorSnapshot } from "../types.js";
+export declare function writeMirror(filePath: string, snapshot: MirrorSnapshot): void;

package/dist/mirror/writer.js

@@ -0,0 +1,15 @@
+import { mkdirSync, renameSync, writeFileSync, rmSync } from "node:fs";
+import { dirname, join } from "node:path";
+export function writeMirror(filePath, snapshot) {
+    mkdirSync(dirname(filePath), { recursive: true });
+    // 原子写入：先写临时文件再 rename，避免 TUI 读到半截 JSON
+    const tmpPath = join(dirname(filePath), `.${filePath.split(/[\\/]/).pop()}.tmp`);
+    writeFileSync(tmpPath, JSON.stringify(snapshot, null, 2));
+    try {
+        renameSync(tmpPath, filePath);
+    }
+    catch {
+        rmSync(tmpPath, { force: true });
+        writeFileSync(filePath, JSON.stringify(snapshot, null, 2));
+    }
+}

package/dist/providers/deepseek.d.ts

@@ -0,0 +1,2 @@
+import type { QuotaProvider } from "./types.js";
+export declare const deepseekProvider: QuotaProvider;

package/dist/providers/deepseek.js

@@ -0,0 +1,48 @@
+function formatCny(value) {
+    const num = Number.parseFloat(value);
+    if (Number.isNaN(num))
+        return value;
+    return num.toFixed(2);
+}
+export const deepseekProvider = {
+    id: "deepseek",
+    name: "DeepSeek",
+    async fetch(config) {
+        if (!config.apiKey) {
+            throw new Error("missing apiKey in opencode.json provider.deepseek");
+        }
+        const baseURL = config.baseURL ?? "https://api.deepseek.com";
+        const url = `${baseURL.replace(/\/$/, "")}/user/balance`;
+        const response = await fetch(url, {
+            headers: {
+                Accept: "application/json",
+                Authorization: `Bearer ${config.apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${await response.text()}`);
+        }
+        const body = (await response.json());
+        const infos = body.balance_infos ?? [];
+        const total = infos.reduce((sum, info) => sum + (Number.parseFloat(info.total_balance) || 0), 0);
+        const toppedUp = infos.reduce((sum, info) => sum + (Number.parseFloat(info.topped_up_balance) || 0), 0);
+        const granted = infos.reduce((sum, info) => sum + (Number.parseFloat(info.granted_balance) || 0), 0);
+        const metrics = [
+            { label: "余额", used: undefined, total: total, unit: "CNY" },
+        ];
+        if (toppedUp > 0) {
+            metrics.push({ label: "充值", used: undefined, total: toppedUp, unit: "CNY" });
+        }
+        if (granted > 0) {
+            metrics.push({ label: "赠送", used: undefined, total: granted, unit: "CNY" });
+        }
+        return {
+            id: "deepseek",
+            name: "DeepSeek",
+            plan: "API",
+            metrics,
+            status: total <= 0 ? "low" : total < 10 ? "warn" : "ok",
+            updatedAt: Date.now(),
+        };
+    },
+};

package/dist/providers/kimi.d.ts

@@ -0,0 +1,2 @@
+import type { QuotaProvider } from "./types.js";
+export declare const kimiProvider: QuotaProvider;

package/dist/providers/kimi.js

@@ -0,0 +1,87 @@
+function num(value) {
+    if (value === undefined)
+        return 0;
+    const parsed = Number.parseFloat(String(value));
+    return Number.isNaN(parsed) ? 0 : parsed;
+}
+// usage 总览是周窗口（resetTime 约 7 天后），limits[] 是 5h 窗口
+function windowLabel(unit, resetTime) {
+    if (unit) {
+        switch (unit) {
+            case "TIME_UNIT_MINUTE":
+                return "5h";
+            case "TIME_UNIT_HOUR":
+                return "h";
+            case "TIME_UNIT_DAY":
+                return "天";
+            default:
+                break;
+        }
+    }
+    if (resetTime) {
+        const days = (Date.parse(resetTime) - Date.now()) / 86_400_000;
+        if (days >= 6)
+            return "周";
+        if (days >= 0.2)
+            return "h";
+    }
+    return "窗口";
+}
+function quotaMetric(label, limit, remaining, used) {
+    if (limit <= 0)
+        return null;
+    const effectiveUsed = used > 0 ? used : Math.max(0, limit - remaining);
+    return { label, used: effectiveUsed, total: limit, unit: "次" };
+}
+export const kimiProvider = {
+    id: "kimiforcoding",
+    name: "Kimi For Coding",
+    async fetch(config) {
+        if (!config.apiKey) {
+            throw new Error("missing apiKey in opencode.json provider.kimiforcoding");
+        }
+        const baseURL = config.baseURL ?? "https://api.kimi.com/coding/v1";
+        const url = `${baseURL.replace(/\/$/, "")}/usages`;
+        const response = await fetch(url, {
+            headers: {
+                Accept: "application/json",
+                Authorization: `Bearer ${config.apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${await response.text()}`);
+        }
+        const body = (await response.json());
+        const metrics = [];
+        // 周窗口（usage 总览）
+        const usage = body.usage;
+        if (usage) {
+            const metric = quotaMetric(windowLabel(undefined, usage.resetTime), num(usage.limit), num(usage.remaining), num(usage.used));
+            if (metric)
+                metrics.push(metric);
+        }
+        // 5h 窗口（limits[]）
+        for (const lim of body.limits ?? []) {
+            const detail = lim.detail;
+            if (!detail)
+                continue;
+            const metric = quotaMetric(windowLabel(lim.window?.timeUnit, detail.resetTime), num(detail.limit), num(detail.remaining), num(detail.used));
+            if (metric)
+                metrics.push(metric);
+        }
+        const parallel = num(body.parallel?.limit);
+        if (parallel > 0) {
+            metrics.push({ label: "并发", used: undefined, total: parallel, unit: "次" });
+        }
+        const first = metrics.find((metric) => metric.used !== undefined && metric.total !== undefined);
+        const ratio = first && first.total ? first.used / first.total : 0;
+        return {
+            id: "kimiforcoding",
+            name: "Kimi For Coding",
+            plan: "Coding Plan",
+            metrics,
+            status: ratio >= 0.8 ? "low" : ratio >= 0.5 ? "warn" : "ok",
+            updatedAt: Date.now(),
+        };
+    },
+};

package/dist/providers/minimax.d.ts

@@ -0,0 +1,2 @@
+import type { QuotaProvider } from "./types.js";
+export declare const minimaxProvider: QuotaProvider;

package/dist/providers/minimax.js

@@ -0,0 +1,79 @@
+// cc-switch 解析逻辑：剩余百分比反转为已用；status 1=激活 3=无周限额
+function statusOf(usedPercent) {
+    if (usedPercent > 80)
+        return "low";
+    if (usedPercent > 50)
+        return "warn";
+    return "ok";
+}
+function fmtRemaining(ms) {
+    if (ms <= 0)
+        return "0h";
+    const hours = Math.floor(ms / 3_600_000);
+    const minutes = Math.floor((ms % 3_600_000) / 60_000);
+    if (hours > 0)
+        return `${hours}h${minutes}m`;
+    return `${minutes}m`;
+}
+export const minimaxProvider = {
+    id: "minimax",
+    name: "MiniMax",
+    async fetch(config) {
+        if (!config.apiKey) {
+            throw new Error("missing apiKey in opencode.json provider.minimax");
+        }
+        const baseURL = config.baseURL ?? "https://api.minimaxi.com/v1";
+        // cc-switch 使用的接口（与 /v1/token_plan/remains 不同）
+        const url = `${baseURL.replace(/\/$/, "")}/api/openplatform/coding_plan/remains`;
+        const response = await fetch(url, {
+            headers: {
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                Authorization: `Bearer ${config.apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${await response.text()}`);
+        }
+        const body = (await response.json());
+        if (body.base_resp && body.base_resp.status_code !== 0) {
+            throw new Error(body.base_resp.status_msg ?? `code ${body.base_resp.status_code}`);
+        }
+        // 只取 general（编程额度），跳过 video 等非编程模型
+        const general = (body.model_remains ?? []).find((model) => model.model_name === "general");
+        if (!general) {
+            throw new Error("no general quota in response");
+        }
+        const metrics = [];
+        // 5h 桶：剩余百分比 → 已用百分比
+        if (general.current_interval_remaining_percent !== undefined) {
+            metrics.push({
+                label: "5h",
+                remainingPercent: general.current_interval_remaining_percent,
+                unit: "%",
+            });
+        }
+        // 周桶：仅当 current_weekly_status == 1 激活（=3 无周限额）
+        if (general.current_weekly_status === 1) {
+            metrics.push({
+                label: "周",
+                remainingPercent: general.current_weekly_remaining_percent,
+                unit: "%",
+                boostPermille: general.weekly_boost_permille > 1000 ? general.weekly_boost_permille : undefined,
+            });
+        }
+        // 状态取两桶已用百分比的最大值
+        const intervalUsed = 100 - (general.current_interval_remaining_percent ?? 100);
+        const weeklyUsed = general.current_weekly_status === 1 ? 100 - (general.current_weekly_remaining_percent ?? 100) : 0;
+        const maxUsed = Math.max(intervalUsed, weeklyUsed);
+        return {
+            id: "minimax",
+            name: "MiniMax",
+            plan: "Token Plan",
+            metrics,
+            status: statusOf(maxUsed),
+            message: `重置 ${fmtRemaining(general.remains_time)}`,
+            updatedAt: Date.now(),
+        };
+    },
+};

package/dist/providers/opencode-go.d.ts

@@ -0,0 +1,13 @@
+import type { QuotaProvider } from "./types.js";
+export declare const GO_LIMITS: {
+    label: string;
+    total: number;
+    field: string;
+}[];
+export type GoQueryConfig = {
+    cookie: string;
+    serverId: string;
+    workspaceId: string;
+};
+export declare function opencodeAuthCookiePath(): string;
+export declare const opencodeGoProvider: QuotaProvider;

package/dist/providers/opencode-go.js

@@ -0,0 +1,119 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const GO_LIMITS = [
+    { label: "5h", total: 12, field: "rollingUsage" },
+    { label: "周", total: 30, field: "weeklyUsage" },
+    { label: "月", total: 60, field: "monthlyUsage" },
+];
+// 从 SolidStart 序列化响应中提取用量字段
+// 序列化协议非严格 JSON（键无引号、布尔用 !0/!1），需做轻量转换
+function parseGoUsage(raw) {
+    const fieldPattern = /(rollingUsage|weeklyUsage|monthlyUsage):\$\w+\[\d+\]=\{([^}]*)\}/g;
+    const result = {};
+    let match;
+    let found = false;
+    while ((match = fieldPattern.exec(raw)) !== null) {
+        found = true;
+        const name = match[1];
+        // match[2] 不含开头 `{`（被正则消耗），补上后再做键引号转换
+        const body = `{${match[2]}}`
+            .replace(/([{,]\s*)([A-Za-z_$][\w$]*)\s*:/g, '$1"$2":') // 键加引号
+            .replace(/!0/g, "true")
+            .replace(/!1/g, "false");
+        try {
+            result[name] = JSON.parse(body);
+        }
+        catch {
+            // 单字段解析失败跳过
+        }
+    }
+    return found ? result : null;
+}
+// 官方用量 server action 参数（workspace 嵌入 args）
+function buildArgs(workspaceId) {
+    const args = {
+        t: { t: 9, i: 0, l: 1, a: [{ t: 1, s: workspaceId }], o: 0 },
+        f: 31,
+        m: [],
+    };
+    return encodeURIComponent(JSON.stringify(args));
+}
+export function opencodeAuthCookiePath() {
+    return join(process.env.XDG_DATA_HOME ?? join(homedir(), ".local", "share"), "opencode", "auth.json");
+}
+function fmtDuration(sec) {
+    if (sec <= 0)
+        return "已重置";
+    if (sec < 3600)
+        return `${Math.floor(sec / 60)}m`;
+    if (sec < 86400)
+        return `${Math.floor(sec / 3600)}h${Math.floor((sec % 3600) / 60)}m`;
+    return `${Math.floor(sec / 86400)}天`;
+}
+export const opencodeGoProvider = {
+    id: "opencode-go",
+    name: "OpenCode Go",
+    async fetch(config) {
+        const query = config.options;
+        if (!query?.cookie || !query.serverId || !query.workspaceId) {
+            throw new Error("Go 余量不可用：未配置 cookie，请按 README 指引抓取后写入 modelquota.json");
+        }
+        const url = `https://opencode.ai/_server?id=${encodeURIComponent(query.serverId)}&args=${buildArgs(query.workspaceId)}`;
+        let response;
+        try {
+            response = await fetch(url, {
+                headers: {
+                    Accept: "*/*",
+                    Cookie: `oc_locale=zh; auth=${query.cookie}`,
+                    "x-server-id": query.serverId,
+                    "x-server-instance": "server-fn:5",
+                    Referer: `https://opencode.ai/workspace/${query.workspaceId}/go`,
+                    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36",
+                },
+            });
+        }
+        catch {
+            throw new Error("Go 余量不可用：网络请求失败（可能未开代理），请检查网络后重试");
+        }
+        if (!response.ok) {
+            // 401/403 = cookie 过期；其余（404/500）= 接口变更
+            if (response.status === 401 || response.status === 403 || response.status === 302) {
+                throw new Error("Go 余量不可用：登录已过期，请更新 modelquota.json 的 cookie");
+            }
+            throw new Error(`Go 余量不可用：查询接口异常（HTTP ${response.status}），请重新抓包 serverId`);
+        }
+        const raw = await response.text();
+        // 响应是 SolidStart 序列化协议（含 $R[n]= 引用赋值，非严格 JSON），
+        // 直接正则提取三个用量字段的 JSON 对象
+        const usage = parseGoUsage(raw);
+        if (!usage) {
+            throw new Error("Go 余量不可用：响应格式异常（接口可能已变更），请重新抓包 serverId");
+        }
+        const metrics = GO_LIMITS.map((limit) => {
+            const fieldUsage = usage[limit.field];
+            const usedPercent = fieldUsage?.usagePercent ?? 0;
+            return {
+                label: limit.label,
+                remainingPercent: Math.max(0, 100 - usedPercent),
+                unit: "%",
+            };
+        });
+        const firstUsage = usage.rollingUsage;
+        const resetText = firstUsage?.resetInSec !== undefined ? `重置 ${fmtDuration(firstUsage.resetInSec)}` : undefined;
+        // 状态按官方 usagePercent：>80 红 / >50 黄
+        const percents = GO_LIMITS.map((limit) => {
+            const fieldUsage = usage[limit.field];
+            return fieldUsage?.usagePercent ?? 0;
+        });
+        const maxUsed = Math.max(...percents);
+        return {
+            id: "opencode-go",
+            name: "OpenCode Go",
+            plan: "$10/mo",
+            metrics,
+            status: maxUsed > 80 ? "low" : maxUsed > 50 ? "warn" : "ok",
+            message: resetText,
+            updatedAt: Date.now(),
+        };
+    },
+};

package/dist/providers/types.d.ts

@@ -0,0 +1,12 @@
+import type { ProviderSnapshot } from "../types.js";
+export type ProviderConfig = {
+    id: string;
+    apiKey?: string;
+    baseURL?: string;
+    options?: Record<string, unknown>;
+};
+export interface QuotaProvider {
+    readonly id: string;
+    readonly name: string;
+    fetch(config: ProviderConfig): Promise<ProviderSnapshot>;
+}

package/dist/providers/types.js

@@ -0,0 +1 @@
+export {};

package/dist/providers/zhipu.d.ts

@@ -0,0 +1,2 @@
+import type { QuotaProvider } from "./types.js";
+export declare const zhipuProvider: QuotaProvider;

package/dist/providers/zhipu.js

@@ -0,0 +1,79 @@
+// cc-switch 解析：unit:3 → 5h 桶，unit:6 → 周桶；只认 TOKENS_LIMIT
+function statusOf(usedPercent) {
+    if (usedPercent > 80)
+        return "low";
+    if (usedPercent > 50)
+        return "warn";
+    return "ok";
+}
+function fmtResetTime(value) {
+    if (value === undefined)
+        return undefined;
+    const num = typeof value === "number" ? value : Number.parseInt(value, 10);
+    if (!Number.isFinite(num))
+        return undefined;
+    const hours = (num - Date.now()) / 3_600_000;
+    if (hours <= 0)
+        return undefined;
+    if (hours < 24)
+        return `${Math.floor(hours)}h${Math.floor((hours % 1) * 60)}m`;
+    return `${Math.floor(hours / 24)}天`;
+}
+export const zhipuProvider = {
+    id: "zhipu",
+    name: "智谱 GLM",
+    async fetch(config) {
+        if (!config.apiKey) {
+            throw new Error("missing apiKey in opencode.json provider.zhipu");
+        }
+        // cc-switch：智谱不加 Bearer 前缀，key 直接放 Authorization
+        // 查询接口在域名根路径（不是 /v4 或 /api/paas），需从 baseURL 提取 host
+        const baseURL = config.baseURL ?? "https://open.bigmodel.cn";
+        const host = new URL(baseURL).host;
+        const url = `https://${host}/api/monitor/usage/quota/limit`;
+        const response = await fetch(url, {
+            headers: {
+                Authorization: config.apiKey,
+                "Content-Type": "application/json",
+                "Accept-Language": "en-US,en",
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${await response.text()}`);
+        }
+        const body = (await response.json());
+        if (body.success === false || (body.code !== undefined && body.code !== 200)) {
+            throw new Error(body.msg ?? `code ${body.code}`);
+        }
+        const limits = body.data?.limits ?? [];
+        const metrics = [];
+        let maxUsed = 0;
+        for (const limit of limits) {
+            if ((limit.type ?? "").toUpperCase() !== "TOKENS_LIMIT")
+                continue;
+            const usedPercent = limit.percentage ?? 0;
+            if (limit.unit === 3) {
+                // 5h 桶
+                metrics.push({ label: "5h", remainingPercent: Math.max(0, 100 - usedPercent), unit: "%" });
+                maxUsed = Math.max(maxUsed, usedPercent);
+            }
+            else if (limit.unit === 6) {
+                // 周桶
+                metrics.push({ label: "周", remainingPercent: Math.max(0, 100 - usedPercent), unit: "%" });
+                maxUsed = Math.max(maxUsed, usedPercent);
+            }
+        }
+        const level = body.data?.level;
+        return {
+            id: "zhipu",
+            name: "智谱 GLM",
+            plan: level ? `GLM ${level}` : "Coding Plan",
+            metrics,
+            status: statusOf(maxUsed),
+            message: fmtResetTime(limits.find((l) => l.unit === 6)?.nextResetTime)
+                ? `重置 ${fmtResetTime(limits.find((l) => l.unit === 6)?.nextResetTime)}`
+                : undefined,
+            updatedAt: Date.now(),
+        };
+    },
+};

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import type { PluginModule } from "@opencode-ai/plugin";
+declare const module: PluginModule;
+export default module;

package/dist/server.js

@@ -0,0 +1,117 @@
+import { readModelQuotaConfig } from "./config.js";
+import { queryLatestSessionModel } from "./db.js";
+import { mirrorFilePath } from "./mirror/path.js";
+import { writeMirror } from "./mirror/writer.js";
+import { deepseekProvider } from "./providers/deepseek.js";
+import { kimiProvider } from "./providers/kimi.js";
+import { minimaxProvider } from "./providers/minimax.js";
+import { zhipuProvider } from "./providers/zhipu.js";
+import { opencodeGoProvider } from "./providers/opencode-go.js";
+const REFRESH_INTERVAL_MS = 60_000;
+function providerOptions(config, providerID) {
+    const provider = config.provider?.[providerID];
+    return provider?.options ?? {};
+}
+function buildProviders(config) {
+    const list = [];
+    const deepseek = providerOptions(config, "deepseek");
+    if (deepseek.apiKey) {
+        list.push({
+            id: deepseekProvider.id,
+            name: deepseekProvider.name,
+            fetch: () => deepseekProvider.fetch({ id: "deepseek", ...deepseek }),
+        });
+    }
+    const kimi = providerOptions(config, "kimiforcoding");
+    if (kimi.apiKey) {
+        list.push({
+            id: kimiProvider.id,
+            name: kimiProvider.name,
+            fetch: () => kimiProvider.fetch({ id: "kimiforcoding", ...kimi }),
+        });
+    }
+    const minimax = providerOptions(config, "minimax");
+    if (minimax.apiKey) {
+        list.push({
+            id: minimaxProvider.id,
+            name: minimaxProvider.name,
+            fetch: () => minimaxProvider.fetch({ id: "minimax", ...minimax }),
+        });
+    }
+    const zhipu = providerOptions(config, "zhipu");
+    if (zhipu.apiKey) {
+        list.push({
+            id: zhipuProvider.id,
+            name: zhipuProvider.name,
+            fetch: () => zhipuProvider.fetch({ id: "zhipu", ...zhipu }),
+        });
+    }
+    // OpenCode Go：官方 server action 查询（cookie + serverId + workspaceId 在 modelquota.json）
+    // 未配置也注册，fetch 时给出友好提示
+    const goConfig = readModelQuotaConfig().opencodeGo;
+    list.push({
+        id: opencodeGoProvider.id,
+        name: opencodeGoProvider.name,
+        fetch: () => opencodeGoProvider.fetch({ id: "opencode-go", options: goConfig }),
+    });
+    return list;
+}
+const server = async ({ directory, client }) => {
+    let providers = [];
+    async function refresh() {
+        const filePath = mirrorFilePath(directory);
+        const providerSnapshots = await Promise.all(providers.map(async (provider) => {
+            const config = { id: provider.id };
+            try {
+                return await provider.fetch(config);
+            }
+            catch (error) {
+                await client.app.log({
+                    body: {
+                        service: "modelquota",
+                        level: "error",
+                        message: `${provider.id} fetch failed: ${String(error)}`,
+                    },
+                });
+                const failed = {
+                    id: provider.id,
+                    name: provider.name,
+                    metrics: [],
+                    status: "error",
+                    message: String(error),
+                    updatedAt: Date.now(),
+                };
+                return failed;
+            }
+        }));
+        // /model 切换后 session 表立即更新，从这里查当前模型最可靠
+        const latest = await queryLatestSessionModel();
+        const snapshot = {
+            version: 1,
+            generatedAt: Date.now(),
+            providers: providerSnapshots,
+            current: latest,
+        };
+        writeMirror(filePath, snapshot);
+    }
+    const timer = setInterval(() => void refresh(), REFRESH_INTERVAL_MS);
+    return {
+        config: async (input) => {
+            providers = buildProviders(input);
+            void refresh();
+        },
+        event: async ({ event }) => {
+            if (event.type === "session.idle" ||
+                event.type === "session.created" ||
+                event.type === "session.updated" ||
+                event.type === "message.updated") {
+                void refresh();
+            }
+        },
+    };
+};
+const module = {
+    id: "modelquota",
+    server,
+};
+export default module;

package/dist/tui.d.ts

@@ -0,0 +1,3 @@
+import type { TuiPluginModule } from "@opencode-ai/plugin/tui";
+declare const module: TuiPluginModule;
+export default module;

package/dist/tui.js

@@ -0,0 +1,76 @@
+import { mirrorFilePath } from "./mirror/path.js";
+import { readMirror } from "./mirror/reader.js";
+import { buildViewNodes } from "./ui/panel.js";
+const POLL_INTERVAL_MS = 1_000;
+const STALE_MS = 30_000;
+function materialize(nodes, solid) {
+    const root = solid.createElement("box");
+    solid.setProp(root, "flexDirection", "column");
+    for (const node of nodes) {
+        solid.insert(root, materializeNode(node, solid));
+    }
+    return root;
+}
+function materializeNode(node, solid) {
+    const element = solid.createElement(node.kind);
+    for (const [name, value] of Object.entries(node.props)) {
+        solid.setProp(element, name, value);
+    }
+    if (node.kind === "text") {
+        solid.insert(element, node.text ?? "");
+    }
+    for (const child of node.children ?? []) {
+        solid.insert(element, materializeNode(child, solid));
+    }
+    return element;
+}
+function viewKey(snapshot, currentProvider) {
+    if (!snapshot)
+        return `null|${currentProvider ?? "-"}`;
+    return `${currentProvider ?? "-"}|${JSON.stringify(snapshot.providers)}|${JSON.stringify(snapshot.current)}`;
+}
+// 从 sync 缓存消息流推断当前 provider（响应式数据源）
+function providerFromSyncMessages(api) {
+    const route = api.route.current;
+    if (route.name !== "session")
+        return null;
+    const sessionID = route.params?.sessionID;
+    if (typeof sessionID !== "string")
+        return null;
+    const messages = api.state.session.messages(sessionID);
+    // 找最后一条 assistant 消息
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const message = messages[i];
+        if (message.role === "assistant" && typeof message.providerID === "string" && message.providerID.length > 0) {
+            return message.providerID;
+        }
+    }
+    return null;
+}
+function resolveProviderFromSync(api) {
+    return providerFromSyncMessages(api);
+}
+const module = {
+    id: "modelquota:tui",
+    tui: async (api) => {
+        const solid = await import("@opentui/solid").catch(() => null);
+        if (!solid) {
+            return;
+        }
+        const directory = api.state.path.directory;
+        const filePath = mirrorFilePath(directory);
+        // 渲染只读 sync 缓存（响应式 → Solid 自动重渲），不用 mirror 文件
+        api.slots.register({
+            order: 1000,
+            slots: {
+                sidebar_content: () => {
+                    const snapshot = readMirror(filePath); // 只取 providers 列表，current 从 sync 取
+                    const provider = resolveProviderFromSync(api) || snapshot?.current?.providerID || null;
+                    return materialize(buildViewNodes(snapshot, api.theme.current, provider), solid);
+                },
+            },
+        });
+        api.renderer.requestRender();
+    },
+};
+export default module;

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+export type ProviderStatus = "ok" | "warn" | "low" | "error";
+export type Metric = {
+    label: string;
+    used?: number;
+    total?: number;
+    unit: string;
+    remainingPercent?: number;
+    boostPermille?: number;
+};
+export type ProviderSnapshot = {
+    id: string;
+    name: string;
+    plan?: string;
+    metrics: Metric[];
+    status: ProviderStatus;
+    message?: string;
+    updatedAt: number;
+};
+export type MirrorSnapshot = {
+    version: 1;
+    generatedAt: number;
+    providers: ProviderSnapshot[];
+    current?: {
+        sessionID: string;
+        providerID: string;
+        modelID?: string;
+    } | null;
+};

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/ui/panel.d.ts

@@ -0,0 +1,6 @@
+import type { TuiThemeCurrent } from "@opencode-ai/plugin/tui";
+import type { MirrorSnapshot } from "../types.js";
+import type { ViewNode } from "./view.js";
+type ThemeLike = Pick<TuiThemeCurrent, "text" | "textMuted" | "error" | "warning" | "success" | "info" | "accent" | "borderSubtle">;
+export declare function buildViewNodes(snapshot: MirrorSnapshot | null, theme: ThemeLike, currentProviderID?: string | null): ViewNode[];
+export {};

package/dist/ui/panel.js

@@ -0,0 +1,120 @@
+import { box, text } from "./view.js";
+function pct(used, total) {
+    if (used === undefined || total === undefined || total <= 0)
+        return 0;
+    return Math.min(1, used / total);
+}
+function bar(ratio, width = 10) {
+    const filled = Math.round(ratio * width);
+    return `${"█".repeat(filled)}${"░".repeat(width - filled)}`;
+}
+// 剩余百分比着色（对齐 MiniMax mmx-cli：剩余 >=50 绿 / >=20 黄 / <20 红）
+function remainingColor(percent, theme) {
+    if (percent < 20)
+        return theme.error;
+    if (percent < 50)
+        return theme.warning;
+    return theme.success;
+}
+// 已用百分比着色（与剩余对称：已用 >80 红 / >50 黄 / 其余正常）
+function usedColor(percent, theme) {
+    if (percent > 80)
+        return theme.error;
+    if (percent > 50)
+        return theme.warning;
+    return theme.text;
+}
+function statusColor(status, theme) {
+    switch (status) {
+        case "ok":
+            return theme.success;
+        case "warn":
+            return theme.warning;
+        case "low":
+            return theme.error;
+        case "error":
+            return theme.error;
+    }
+}
+function currencySymbol(unit) {
+    if (unit === "USD")
+        return "$";
+    if (unit === "CNY")
+        return "¥";
+    return unit;
+}
+function formatNumber(value) {
+    if (value >= 1_000_000)
+        return `${(value / 1_000_000).toFixed(1)}M`;
+    if (value >= 1_000)
+        return `${(value / 1_000).toFixed(1)}k`;
+    return Number.isInteger(value) ? String(value) : value.toFixed(2);
+}
+function metricNodes(metrics, theme) {
+    return metrics.flatMap((metric) => {
+        // 剩余百分比型（无固定总量，如 MiniMax general 5h/周）
+        if (metric.remainingPercent !== undefined) {
+            const remaining = Math.min(100, Math.max(0, metric.remainingPercent));
+            const used = 100 - remaining;
+            const color = usedColor(used, theme);
+            const boost = metric.boostPermille ? ` x${(metric.boostPermille / 1000).toFixed(1)}` : "";
+            return [text({ fg: color }, `  ${metric.label} ${bar(used / 100)} 已用 ${used}%${boost}`)];
+        }
+        // 余额型
+        if (metric.used === undefined || metric.total === undefined) {
+            const value = metric.total ?? metric.used ?? 0;
+            const color = value < 20 ? theme.warning : value < 5 ? theme.error : theme.text;
+            return [
+                text({ fg: color }, `  ${metric.label}: ${currencySymbol(metric.unit)}${formatNumber(value)}`),
+            ];
+        }
+        // 配额型（used/total）
+        const ratio = pct(metric.used, metric.total);
+        const usedPercent = ratio * 100;
+        const color = usedColor(usedPercent, theme);
+        return [
+            text({ fg: color }, `  ${metric.label} ${bar(ratio)} 已用 ${formatNumber(metric.used ?? 0)}/${formatNumber(metric.total ?? 0)}`),
+        ];
+    });
+}
+function providerNodes(provider, theme, isCurrent = false) {
+    const nameColor = statusColor(provider.status, theme);
+    const prefix = isCurrent ? "● " : "  ";
+    const nameNode = text({ fg: isCurrent ? theme.accent : nameColor }, `${prefix}${provider.name}${provider.plan ? ` (${provider.plan})` : ""}${isCurrent ? " *" : ""}`);
+    if (provider.status === "error") {
+        return [
+            box({ flexDirection: "column" }, [
+                nameNode,
+                text({ fg: theme.error }, `  error: ${provider.message ?? "unknown"}`),
+            ]),
+        ];
+    }
+    const head = provider.metrics.length > 0 ? nameNode : text({ fg: theme.textMuted }, `${provider.name} (no data)`);
+    return [
+        box({ flexDirection: "column" }, [
+            head,
+            ...metricNodes(provider.metrics, theme),
+        ]),
+    ];
+}
+export function buildViewNodes(snapshot, theme, currentProviderID = null) {
+    if (!snapshot || snapshot.providers.length === 0) {
+        return [
+            box({ flexDirection: "column", gap: 1 }, [
+                text({ fg: theme.textMuted }, "modelquota"),
+                text({ fg: theme.textMuted }, "  waiting for data..."),
+            ]),
+        ];
+    }
+    const current = snapshot.providers.find((provider) => provider.id === currentProviderID);
+    const others = snapshot.providers.filter((provider) => provider.id !== currentProviderID);
+    // 有当前使用的供应商时：只显示它（顶置高亮）；否则显示全部
+    const ordered = current ? [current, ...others] : snapshot.providers;
+    const visible = current ? [current] : ordered;
+    return [
+        box({ flexDirection: "column", gap: 1 }, [
+            text({ fg: theme.info }, "Quota"),
+            ...visible.flatMap((provider) => providerNodes(provider, theme, current?.id === provider.id)),
+        ]),
+    ];
+}

package/dist/ui/view.d.ts

@@ -0,0 +1,9 @@
+export type ViewNodeKind = "box" | "text";
+export type ViewNode = {
+    readonly kind: ViewNodeKind;
+    readonly props: Readonly<Record<string, unknown>>;
+    readonly text?: string;
+    readonly children?: readonly ViewNode[];
+};
+export declare function box(props: Readonly<Record<string, unknown>>, children?: readonly ViewNode[]): ViewNode;
+export declare function text(props: Readonly<Record<string, unknown>>, value: string): ViewNode;

package/dist/ui/view.js

@@ -0,0 +1,6 @@
+export function box(props, children = []) {
+    return { kind: "box", props, children };
+}
+export function text(props, value) {
+    return { kind: "text", props, text: value };
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "modelquota",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "opencode 插件：在 TUI 右侧栏显示当前使用的模型供应商套餐余量",
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "quota",
+    "usage",
+    "tokens",
+    "deepseek",
+    "kimi",
+    "minimax",
+    "zhipu",
+    "glm",
+    "opencode-go"
+  ],
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "import": "./dist/server.js",
+      "types": "./dist/server.d.ts"
+    },
+    "./tui": {
+      "import": "./dist/tui.js",
+      "types": "./dist/tui.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsc -p tsconfig.build.json",
+    "deploy": "node scripts/deploy.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "1.14.30"
+  },
+  "devDependencies": {
+    "@opentui/core": "^0.2.16",
+    "@opentui/solid": "^0.2.16",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.8.0"
+  }
+}