Add platform-specific quota implementations and improve error handling

.gitignore

@@ -23,3 +23,12 @@ Thumbs.db
 # Debug
 *.log
 npm-debug.log*
+
+# Other Stuff
+skills-lock.json
+.agent/skills/typescript-best-practices/SKILL.md
+.agents/skills/typescript-best-practices/SKILL.md
+.claude/skills/typescript-best-practices/
+.kilocode/
+.kiro/
+.sisyphus/

AGENTS.md

@@ -0,0 +1,78 @@
+# PROJECT KNOWLEDGE BASE
+
+**Generated:** 2026-02-26
+**Commit:** 196eed3
+**Branch:** main
+
+## OVERVIEW
+
+OpenCode plugin for querying AI platform quotas. TypeScript + Node.js, supports OpenAI, Zhipu AI, Z.ai, GitHub Copilot, Google Antigravity.
+
+## STRUCTURE
+
+```
+./
+├── plugin/           # Source code
+│   ├── mystatus.ts  # Main entry (MyStatusPlugin)
+│   └── lib/         # Platform implementations
+├── command/         # /mystatus command template
+├── assets/         # Banner images
+└── .github/        # CI workflow
+```
+
+## WHERE TO LOOK
+
+| Task             | Location            | Notes                                     |
+| ---------------- | ------------------- | ----------------------------------------- |
+| Add new platform | plugin/lib/         | Copy existing platform module pattern     |
+| Plugin entry     | plugin/mystatus.ts  | Tool definition + parallel query dispatch |
+| Types            | plugin/lib/types.ts | AuthData, QueryResult, platform types     |
+| i18n             | plugin/lib/i18n.ts  | Chinese/English translations              |
+
+## CODE MAP
+
+| Symbol            | Type      | Location       | Role                 |
+| ----------------- | --------- | -------------- | -------------------- |
+| MyStatusPlugin    | Plugin    | mystatus.ts    | Main export          |
+| queryOpenAIUsage  | fn        | lib/openai.ts  | OpenAI quota         |
+| queryZhipuUsage   | fn        | lib/zhipu.ts   | Zhipu AI             |
+| queryZaiUsage     | fn        | lib/zhipu.ts   | Z.ai                 |
+| queryGoogleUsage  | fn        | lib/google.ts  | Google Antigravity   |
+| queryCopilotUsage | fn        | lib/copilot.ts | GitHub Copilot       |
+| QueryResult       | interface | lib/types.ts   | Platform result type |
+| AuthData          | interface | lib/types.ts   | Auth structure       |
+
+## CONVENTIONS
+
+- **Module pattern**: Each platform in own file under lib/
+- **Exports**: Single function `queryXxxUsage(auth)` returning `Promise<QueryResult | null>`
+- **Comments**: JSDoc with [输入][输出][定位][同步] fields
+- **Error handling**: Return `{success: false, error: string}` on failure
+
+## ANTI-PATTERNS (THIS PROJECT)
+
+- NO tests - manual verification only
+- NO `any` types - strict TypeScript
+- NO default exports - named exports only
+
+## UNIQUE STYLES
+
+- Progress bars in output (█ characters)
+- JWT token parsing for email extraction
+- Parallel Promise.all for all platform queries
+- Chinese comments, English UI output
+
+## COMMANDS
+
+```bash
+npm run build     # Compile to dist/
+npm run typecheck # Type check only
+npm run lint      # ESLint
+npm run format    # Prettier
+```
+
+## NOTES
+
+- Auth read from: `~/.local/share/opencode/auth.json`
+- Google reads from: `~/.config/opencode/antigravity-accounts.json`
+- Only plugin/\*.ts included in build (tsconfig.json)

plugin/lib/AGENTS.md

@@ -0,0 +1,55 @@
+# plugin/lib/ - Platform Implementations
+
+**Parent:** ./AGENTS.md
+
+## OVERVIEW
+
+Platform-specific quota query implementations. Each file handles one AI provider.
+
+## FILES
+
+| File       | Platform           | Auth Source          |
+| ---------- | ------------------ | -------------------- |
+| openai.ts  | OpenAI (ChatGPT)   | OAuth access token   |
+| zhipu.ts   | Zhipu AI + Z.ai    | API key              |
+| google.ts  | Google Antigravity | OAuth refresh token  |
+| copilot.ts | GitHub Copilot     | OAuth + optional PAT |
+| types.ts   | Shared types       | -                    |
+| utils.ts   | Helpers            | -                    |
+| i18n.ts    | Translations       | -                    |
+
+## PATTERN (Adding New Platform)
+
+```typescript
+// 1. Add types to types.ts
+export interface XxxAuthData {
+  type: string;
+  key?: string;
+}
+
+// 2. Create lib/xxx.ts with:
+export async function queryXxxUsage(
+  authData: XxxAuthData | undefined,
+): Promise<QueryResult | null> {
+  if (!authData || !authData.key) return null;
+  try {
+    const data = await fetchXxxData(authData.key);
+    return { success: true, output: formatXxxUsage(data) };
+  } catch (err) {
+    return {
+      success: false,
+      error: err instanceof Error ? err.message : String(err),
+    };
+  }
+}
+
+// 3. Export from mystatus.ts and add to Promise.all
+```
+
+## CONVENTIONS
+
+- Return `null` if auth missing (skip silently)
+- Return `{success: false, error}` on API failures
+- Use `fetchWithTimeout` from utils.ts for API calls
+- Format output with progress bars (█ chars)
+- JWT parsing in openai.ts - reuse pattern if needed

plugin/lib/copilot.ts

@@ -145,7 +145,8 @@ function readQuotaConfig(): CopilotQuotaConfig | null {
     }
 
     return config;
-  } catch {
+  } catch (err) {
+    console.error("[Copilot] Failed to read quota config:", err);
     return null;
   }
 }
@@ -202,7 +203,8 @@ async function exchangeForCopilotToken(
 
     const tokenData: CopilotTokenResponse = await response.json();
     return tokenData.token;
-  } catch {
+  } catch (err) {
+    console.error("[Copilot] Token exchange failed:", err);
     return null;
   }
 }

plugin/lib/i18n.ts

@@ -117,7 +117,8 @@ const translations = {
       "1. 创建一个 fine-grained PAT (访问 https://github.com/settings/tokens?type=beta)\n" +
       "2. 在 'Account permissions' 中将 'Plan' 设为 'Read-only'\n" +
       "3. 创建配置文件 ~/.config/opencode/copilot-quota-token.json:\n" +
-      '   {"token": "github_pat_xxx...", "username": "你的用户名"}\n\n' +
+      '   {"token": "github_pat_xxx...", "username": "你的用户名", "tier": "pro"}\n' +
+      "有效 tier 值: free, pro, pro+, business, enterprise (需与你的订阅计划匹配)\n\n" +
       "其他方法:\n" +
       "• 在 VS Code 中点击状态栏的 Copilot 图标查看配额\n" +
       "• 访问 https://github.com/settings/billing 查看使用情况",
@@ -195,7 +196,8 @@ const translations = {
       "1. Create a fine-grained PAT (visit https://github.com/settings/tokens?type=beta)\n" +
       "2. Under 'Account permissions', set 'Plan' to 'Read-only'\n" +
       "3. Create config file ~/.config/opencode/copilot-quota-token.json:\n" +
-      '   {"token": "github_pat_xxx...", "username": "YourUsername"}\n\n' +
+      '   {"token": "github_pat_xxx...", "username": "YourUsername", "tier": "pro"}\n' +
+      "Valid tier values: free, pro, pro+, business, enterprise (must match your subscription plan)\n\n" +
       "Alternatives:\n" +
       "• Click the Copilot icon in VS Code status bar to view quota\n" +
       "• Visit https://github.com/settings/billing for usage info",

plugin/lib/openai.ts

@@ -67,7 +67,8 @@ function parseJwt(token: string): JwtPayload | null {
     if (parts.length !== 3) return null;
     const payloadJson = base64UrlDecode(parts[1]);
     return JSON.parse(payloadJson) as JwtPayload;
-  } catch {
+  } catch (err) {
+    console.error("[OpenAI] Failed to parse JWT:", err);
     return null;
   }
 }

plugin/mystatus.ts

@@ -13,12 +13,58 @@ import { homedir } from "os";
 import { join } from "path";
 
 import { t } from "./lib/i18n";
-import { type AuthData, type QueryResult } from "./lib/types";
+import { type AuthData, type QueryResult, REQUEST_TIMEOUT_MS } from "./lib/types";
 import { queryOpenAIUsage } from "./lib/openai";
 import { queryZaiUsage, queryZhipuUsage } from "./lib/zhipu";
 import { queryGoogleUsage } from "./lib/google";
 import { queryCopilotUsage } from "./lib/copilot";
 
+// ============================================================================
+// 平台查询配置
+// ============================================================================
+
+/**
+ * 平台查询配置
+ */
+interface PlatformQuery {
+  name: string;
+  title: string;
+  queryFn: () => Promise<QueryResult | null>;
+  timeoutMs: number;
+}
+
+/**
+ * 带超时的平台查询包装器
+ * 确保每个平台查询有独立超时，失败不影响其他平台
+ */
+async function queryWithTimeout(
+  queryFn: () => Promise<QueryResult | null>,
+  timeoutMs: number,
+  platformName: string,
+): Promise<QueryResult | null> {
+  try {
+    const result = await Promise.race([
+      queryFn(),
+      new Promise<QueryResult>((resolve) =>
+        setTimeout(
+          () =>
+            resolve({
+              success: false,
+              error: `[${platformName}] ${t.timeoutError(timeoutMs / 1000)}`,
+            }),
+          timeoutMs,
+        ),
+      ),
+    ]);
+    return result;
+  } catch (err) {
+    return {
+      success: false,
+      error: `[${platformName}] ${err instanceof Error ? err.message : String(err)}`,
+    };
+  }
+}
+
 // ============================================================================
 // 插件导出（唯一导出，避免其他函数被当作插件加载）
 // ============================================================================
@@ -45,41 +91,81 @@ export const MyStatusPlugin: Plugin = async () => {
             );
           }
 
-          // 2. 并行查询所有平台（Google 不依赖 authData）
-          const [openaiResult, zhipuResult, zaiResult, googleResult, copilotResult] =
-            await Promise.all([
-              queryOpenAIUsage(authData.openai),
-              queryZhipuUsage(authData["zhipuai-coding-plan"]),
-              queryZaiUsage(authData["zai-coding-plan"]),
-              queryGoogleUsage(),
-              queryCopilotUsage(authData["github-copilot"]),
-            ]);
-
-          // 3. 收集结果
-          const results: string[] = [];
-          const errors: string[] = [];
-
-          // 处理 OpenAI 结果
-          collectResult(openaiResult, t.openaiTitle, results, errors);
-
-          // 处理智谱结果
-          collectResult(zhipuResult, t.zhipuTitle, results, errors);
-
-          // 处理 Z.ai 结果
-          collectResult(zaiResult, t.zaiTitle, results, errors);
+          // 2. 系统化并行查询所有平台（每个平台有独立超时）
+          const platforms: PlatformQuery[] = [
+            {
+              name: "OpenAI",
+              title: t.openaiTitle,
+              queryFn: () => queryOpenAIUsage(authData.openai),
+              timeoutMs: REQUEST_TIMEOUT_MS,
+            },
+            {
+              name: "ZhipuAI",
+              title: t.zhipuTitle,
+              queryFn: () => queryZhipuUsage(authData["zhipuai-coding-plan"]),
+              timeoutMs: REQUEST_TIMEOUT_MS,
+            },
+            {
+              name: "Z.ai",
+              title: t.zaiTitle,
+              queryFn: () => queryZaiUsage(authData["zai-coding-plan"]),
+              timeoutMs: REQUEST_TIMEOUT_MS,
+            },
+            {
+              name: "Google",
+              title: t.googleTitle,
+              queryFn: () => queryGoogleUsage(),
+              timeoutMs: REQUEST_TIMEOUT_MS,
+            },
+            {
+              name: "Copilot",
+              title: t.copilotTitle,
+              queryFn: () => queryCopilotUsage(authData["github-copilot"]),
+              timeoutMs: REQUEST_TIMEOUT_MS,
+            },
+          ];
+
+          // 使用 Promise.allSettled 确保即使一个平台失败也会继续查询其他平台
+          const settledResults = await Promise.allSettled(
+            platforms.map((p) => queryWithTimeout(p.queryFn, p.timeoutMs, p.name)),
+          );
+
+          // 将 settled results 转换为统一的结果数组
+          const queryResults: Array<{ platform: PlatformQuery; result: QueryResult | null }> = [];
+
+          for (let i = 0; i < platforms.length; i++) {
+            const platform = platforms[i];
+            const settled = settledResults[i];
+
+            let result: QueryResult | null = null;
+
+            if (settled.status === "fulfilled") {
+              result = settled.value;
+            } else {
+              // Promise 被拒绝（理论上不应该发生，因为 queryWithTimeout 已捕获错误）
+              result = {
+                success: false,
+                error: `[${platform.name}] ${settled.reason}`,
+              };
+            }
+
+            queryResults.push({ platform, result });
+          }
 
-          // 处理 Google 结果
-          collectResult(googleResult, t.googleTitle, results, errors);
+          // 3. 系统化收集结果 - 每个平台独立处理，确保一个失败不影响其他
+          const outputResults: string[] = [];
+          const errors: string[] = [];
 
-          // 处理 GitHub Copilot 结果
-          collectResult(copilotResult, t.copilotTitle, results, errors);
+          for (const { platform, result } of queryResults) {
+            collectResult(result, platform.title, outputResults, errors);
+          }
 
           // 4. 汇总输出
-          if (results.length === 0 && errors.length === 0) {
+          if (outputResults.length === 0 && errors.length === 0) {
             return t.noAccounts;
           }
 
-          let output = results.join("\n");
+          let output = outputResults.join("\n");
 
           if (errors.length > 0) {
             if (output) output += "\n\n";