@gnahz77/opencode-copilot-multi-auth 0.1.4 → 0.1.5

package/README.md

@@ -1,5 +1,7 @@
 # opencode-copilot-multi-auth
 
+[中文文档](README.zh.md)
+
 Package on npm: https://www.npmjs.com/package/@gnahz77/opencode-copilot-multi-auth
 
 This fork replaces the older GitHub Copilot chat-auth flow with the newer Copilot CLI-style OAuth flow and makes `opencode` use the live Copilot model metadata for your account.
@@ -12,7 +14,7 @@ Add the plugin to your `opencode` config:
 {
   "$schema": "https://opencode.ai/config.json",
   "plugin": [
-    "@gnahz77/opencode-copilot-multi-auth@0.1.4"
+    "@gnahz77/opencode-copilot-multi-auth@0.1.5"
   ]
 }
 ```
@@ -25,7 +27,7 @@ If you also want the TUI command support provided by this package, add the same
 {
   "$schema": "https://opencode.ai/tui.json",
   "plugin": [
-    "@gnahz77/opencode-copilot-multi-auth@0.1.4"
+    "@gnahz77/opencode-copilot-multi-auth@0.1.5"
   ]
 }
 ```

package/README.zh.md

@@ -0,0 +1,218 @@
+# opencode-copilot-multi-auth
+
+[English](README.md)
+
+npm 上的包主页: https://www.npmjs.com/package/@gnahz77/opencode-copilot-multi-auth
+
+这个分支（fork）将旧的 GitHub Copilot chat-auth 流程替换为更新的 Copilot CLI 风格的 OAuth 流程，并使 `opencode` 使用您的账户实时获取的 Copilot 模型元数据。
+
+## 如何使用
+
+将该插件添加到您的 `opencode` 配置中：
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    "@gnahz77/opencode-copilot-multi-auth@0.1.5"
+  ]
+}
+```
+
+然后启动 `opencode` 并登录到 `github-copilot` 供应商。该插件处理类似 Copilot CLI 风格的设备授权流程，并在之后重用存储的 GitHub OAuth 令牌。
+
+如果您还希望使用该包提供的 TUI 命令支持，请将相同的插件添加到您的 `tui.json` 或 `tui.jsonc` 中：
+
+```json
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "plugin": [
+    "@gnahz77/opencode-copilot-multi-auth@0.1.5"
+  ]
+}
+```
+
+重新启动 OpenCode TUI 后，您可以打开命令面板并运行 `copilot-usage`，或直接输入 `/copilot-usage`。
+插件会打开一个弹窗，显示从拆分的本地存储中加载的所有账户：
+
+- OAuth/账户数据：`~/.local/share/opencode/copilot-auth.json`
+- 单账户路由策略：`~/.config/opencode/copilot-auth.json`
+
+对于发布前的本地开发，您可以直接加载该文件：
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    "file:///absolute/path/to/dist/index.js"
+  ]
+}
+```
+
+重要提示：如果文件路径包含 `opencode-copilot-auth`，当前的 `opencode` 构建可能会因为硬编码的插件名称过滤器而跳过加载它。请使用不包含该子字符串的路径。
+
+如果您在开发过程中在本地加载插件并希望使用 `copilot-usage`，请同时将构建的 TUI 入口添加到您的 TUI 配置中：
+
+```json
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "plugin": [
+    "file:///absolute/path/to/dist/tui.js"
+  ]
+}
+```
+
+## `copilot-usage` 命令
+
+此包现在包含一个名为 `copilot-usage` 的 TUI 命令。
+
+- 命令面板入口：`copilot-usage`
+- Slash 命令：`/copilot-usage`
+
+它的功能：
+
+- 从合并后的本地池中读取每个 Copilot 账户，池子组装自：
+  - `~/.local/share/opencode/copilot-auth.json` (OAuth/账户数据)
+  - `~/.config/opencode/copilot-auth.json` (路由策略)
+- 使用该账户的 OAuth 令牌，为每个账户调用 GitHub Copilot 的配额端点 `/copilot_internal/user`
+- 打开一个弹窗界面，为每个账户显示：
+  - 账户名称
+  - 已使用 / 总额度条
+  - 使用百分比
+
+注意事项：
+
+- 该命令是此包 TUI 目标的一部分，所以只配置 `opencode.json` 是不够的；`tui.json` 必须也加载此插件。
+- 被禁用的账户仍然会显示在弹窗中，并会被标记为已禁用。
+- 如果某个账户加载使用数据失败，弹窗仍会显示其他账户，并在行内包含该账户的错误消息。
+
+## 这个分支有什么改变
+
+- 授权流程：使用了类似 Copilot CLI 风格的 OAuth 客户端流程，并直接保留了 GitHub OAuth 令牌。
+- 授权配额：获取 `/copilot_internal/user`，并使用授权提供的 Copilot API 基础 URL。
+- 令牌交换：不再调用 `/copilot_internal/v2/token`。
+- 请求配置：使用较新的 `copilot-developer-cli` 请求头，替代了旧版的聊天配置。
+- 模型元数据：通过插件的 `provider.models` 钩子获取实时的 Copilot `/models` 响应，以便最终的 `opencode` 模型列表来源于 Copilot API 所支持的实时配额。
+
+## 上下文窗口与模型限制
+
+与上游的主要实际区别在于，此分支从 Copilot 动态应用实时的按模型限制，而不是仅依赖静态元数据。
+
+这意味着 `opencode` 可以看到 Copilot 宣告的以下各项的值：
+
+- `limit.context`
+- `limit.input`
+- `limit.output`
+
+截至 2026 年 3 月 10 日，此分支使用的实时 GitHub Copilot `/models` 响应暴露了 Copilot CLI 的模型配置。下表比较了实时 Copilot CLI 的上下文窗口与 [`models.dev`](https://models.dev) 上的静态 `github-copilot` 目录。
+
+| 模型                  | 此分支 (CLI 上下文) | `models.dev` 上下文 | 差异    |
+| ------------------- | ----------------------: | -------------------: | ---------: |
+| `claude-opus-4.6`   |                 200,000 |              128,000 |    +72,000 |
+| `claude-sonnet-4.6` |                 200,000 |              128,000 |    +72,000 |
+| `claude-haiku-4.5`  |                 144,000 |              128,000 |    +16,000 |
+
+实际收获是，该分支比静态的 `models.dev` 值提供了更大的实时 Claude 上下文窗口。
+
+此分支观察到的例子：
+
+- `claude-sonnet-4.6`
+  - context window (上下文窗口): `200000`
+  - prompt/input limit (提示/输入限制): `168000`
+  - output limit (输出限制): `32000`
+- `claude-opus-4.6`
+  - context window (上下文窗口): `200000`
+  - prompt/input limit (提示/输入限制): `168000`
+  - output limit (输出限制): `64000`
+- `claude-haiku-4.5`
+  - context window (上下文窗口): `144000`
+  - prompt/input limit (提示/输入限制): `128000`
+  - output limit (输出限制): `32000`
+
+如果不打这些补丁，`opencode` 可能会因为其使用的初始静态模型目录而显示过期或偏小的限制。
+
+## Claude 思考预算 (thinking budget) 行为
+
+此分支还改变了 Copilot Claude 请求的行为：
+
+- 当选择 `thinking` 变体时，它发送 `thinking_budget: 16000`
+- 当未选择变体时，它完全省略 `thinking_budget`
+
+这不同于上游的 `opencode`，上游目前为内置的 `thinking` 变体发送 `thinking_budget: 4000`。
+
+该插件故意不尝试修改 `opencode` 的核心 UI。所以可见的 Claude 变体列表依然由 `opencode` 本身控制；该分支改变的是请求行为，而不是内置变体选择器的标签。
+
+## 发布 (Publishing)
+
+```zsh
+./script/publish.ts
+```
+
+## 多账户支持
+
+此分支在分离的本地文件中保存 Copilot 的账户状态：
+
+- OAuth 必需的账户数据：`~/.local/share/opencode/copilot-auth.json`
+- 单账户路由策略：`~/.config/opencode/copilot-auth.json`
+
+在启动时，该插件会自动将旧版的单文件存储迁移到这种双文件布局中。
+
+每次成功的 OAuth 登录都会自动更新该池：用一个具有特定作用域部署的新账户登录会追加一条新记录，而在同一部署上用相同的 GitHub 身份再次登录会更新现有记录，而不是创建重复项。
+
+在运行时，插件将这两个文件合并为路由所用的同一内存中 `version: 2` 池结构 (`accounts`)。
+
+| 字段 | 含义 |
+| --- | --- |
+| `id` | 与账户记录一起存储的稳定的人类友好标识符。 |
+| `name` | 账户的显示名称。 |
+| `enabled` | 该账户是否能参与自动路由。被禁用的账户依然会保存，但在挑选赢家时会被忽略。 |
+| `priority` | 当多个已启用的账户都可以提供同一个原始模型 ID 的服务时，较低的值优先（即数字越小优先级越高）。 |
+| `allowlist` | 此账户获准提供服务的原始模型 ID 或 `*` 通配符模式。如果不为空，则账户只能提供与这些条目之一匹配的模型。 |
+| `blocklist` | 此账户绝对不能提供服务的原始模型 ID 或 `*` 通配符模式。如果 `allowlist` 和 `blocklist` 均不为空，插件会首先检查 `allowlist`，然后应用 `blocklist`。 |
+
+自动路由是基于 `opencode` 已经使用的原始 Copilot 模型 ID 来工作的。插件根据 `enabled` 过滤合格的账户，然后首先检查 `allowlist`（当不为空时，模型必须匹配其精确条目或通配符模式之一），然后应用 `blocklist`，最后通过最低的 `priority` 挑选出唯一的一个获胜账户（带有一个稳定的基于 key 的平局决胜机制）。模型 ID 本身没有被重写，因此账户标识不会出现在模型 ID 中。
+
+通配符匹配区分大小写，且目前支持用 `*` 表示模式中任意位置的零个或多个字符。例如，`claude-*` 可以匹配 `claude-sonnet-4.6` 和 `claude-opus-4.6`。
+
+示例授权文件 (`~/.local/share/opencode/copilot-auth.json`)：
+
+```json
+{
+  "version": 2,
+  "accounts": [
+    {
+      "key": "github.com:12345678",
+      "deployment": "github.com",
+      "domain": "github.com",
+      "baseUrl": "https://api.githubcopilot.com",
+      "identity": {
+        "login": "octocat",
+        "userId": 12345678
+      },
+      "auth": {
+        "type": "oauth",
+        "refresh": "<oauth token>"
+      },
+      "createdAt": "2026-04-15T00:00:00.000Z",
+      "updatedAt": "2026-04-15T00:00:00.000Z"
+    }
+  ]
+}
+```
+
+示例策略文件 (`~/.config/opencode/copilot-auth.json`)：
+
+```json
+{
+  "version": 2,
+  "accounts": [
+    {
+      "key": "github.com:12345678",
+      "enabled": true,
+      "priority": 100,
+      "allowlist": ["claude-*"],
+      "blocklist": []
+    }
+  ]
+}
+```

package/dist/auth.d.ts

@@ -18,3 +18,4 @@ export declare function buildHeaders(init: RequestInit | undefined, copilotToken
 export declare function resolveSelectedPoolAccount(pool: AccountPool, accountKey?: string, requestedRawModelId?: string): PoolAccount | null;
 export declare function refreshSelectedAccountBaseURL(accountKey: string): Promise<PoolAccount>;
 export declare function fetchWithSelectedAccount(input: RequestInfo | URL, init: RequestInit | undefined, selectedAccount: PoolAccount): Promise<Response>;
+export declare function fetchWithAccountFallback(input: RequestInfo | URL, init: RequestInit | undefined, candidates: PoolAccount[]): Promise<Response>;

package/dist/auth.js

@@ -237,3 +237,19 @@ export async function fetchWithSelectedAccount(input, init, selectedAccount) {
     }
     return retryResponse;
 }
+export async function fetchWithAccountFallback(input, init, candidates) {
+    if (candidates.length === 0) {
+        throw new Error("[opencode-copilot-cli-auth] No eligible accounts available for this model; re-login required");
+    }
+    let lastError;
+    for (const account of candidates) {
+        try {
+            return await fetchWithSelectedAccount(input, init, account);
+        }
+        catch (error) {
+            lastError = error;
+            console.warn(`[opencode-copilot-cli-auth] Account ${account.key ?? "unknown"} failed, trying next:`, error instanceof Error ? error.message : String(error));
+        }
+    }
+    throw lastError ?? new Error("[opencode-copilot-cli-auth] All candidate accounts exhausted; re-login required");
+}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import type { Plugin } from "@opencode-ai/plugin";
 import { lookupGitHubIdentity } from "./auth.js";
-import { deriveAccountKey, getPolicyPath, getPoolPath, migrateLegacyPoolStorageIfNeeded, readPool, resolveWinnerAccount, upsertAccount, writePool } from "./pool.js";
+import { deriveAccountKey, getPolicyPath, getPoolPath, migrateLegacyPoolStorageIfNeeded, readPool, resolveCandidateAccounts, resolveWinnerAccount, upsertAccount, writePool } from "./pool.js";
 import { injectRoutingHeaders, stripRoutingHeaders } from "./routing.js";
-export { getPoolPath, getPolicyPath, readPool, writePool, migrateLegacyPoolStorageIfNeeded, deriveAccountKey, lookupGitHubIdentity, upsertAccount, resolveWinnerAccount, };
+export { getPoolPath, getPolicyPath, readPool, writePool, migrateLegacyPoolStorageIfNeeded, deriveAccountKey, lookupGitHubIdentity, upsertAccount, resolveCandidateAccounts, resolveWinnerAccount, };
 export { injectRoutingHeaders, stripRoutingHeaders };
 export declare const CopilotAuthPlugin: Plugin;

package/dist/index.js

@@ -1,10 +1,10 @@
 import { CLIENT_ID, OAUTH_POLLING_SAFETY_MARGIN_MS, OAUTH_SCOPES, ROUTING_ACCOUNT_KEY_HEADER, ROUTING_SOURCE_HEADER, } from "./constants.js";
-import { buildHeaders, fetchEntitlement, fetchWithSelectedAccount, getBaseURL, getCopilotToken, getUrls, lookupGitHubIdentity, resolveSelectedPoolAccount, } from "./auth.js";
+import { buildHeaders, fetchEntitlement, fetchWithAccountFallback, fetchWithSelectedAccount, getBaseURL, getCopilotToken, getUrls, lookupGitHubIdentity, resolveSelectedPoolAccount, } from "./auth.js";
 import { buildPoolBackedModels, normalizeExistingModels, resolveProviderModels } from "./models.js";
-import { deriveAccountKey, getPolicyPath, getPoolPath, migrateLegacyPoolStorageIfNeeded, readPool, resolveWinnerAccount, upsertAccount, writePool, } from "./pool.js";
+import { deriveAccountKey, getPolicyPath, getPoolPath, migrateLegacyPoolStorageIfNeeded, readPool, resolveCandidateAccounts, resolveWinnerAccount, upsertAccount, writePool, } from "./pool.js";
 import { injectRoutingHeaders, stripRoutingHeaders } from "./routing.js";
 import { applyBaseURLToRequestInput, getHeader, getConversationMetadata, getRequestedRawModelId, normalizeDomain, resolveClaudeThinkingBudget, } from "./utils.js";
-export { getPoolPath, getPolicyPath, readPool, writePool, migrateLegacyPoolStorageIfNeeded, deriveAccountKey, lookupGitHubIdentity, upsertAccount, resolveWinnerAccount, };
+export { getPoolPath, getPolicyPath, readPool, writePool, migrateLegacyPoolStorageIfNeeded, deriveAccountKey, lookupGitHubIdentity, upsertAccount, resolveCandidateAccounts, resolveWinnerAccount, };
 export { injectRoutingHeaders, stripRoutingHeaders };
 export const CopilotAuthPlugin = async (input) => {
     try {
@@ -65,6 +65,15 @@ export const CopilotAuthPlugin = async (input) => {
                         const accountKey = getHeader(init?.headers, ROUTING_ACCOUNT_KEY_HEADER);
                         const requestedRawModelId = getRequestedRawModelId(init);
                         if (pool.accounts.length > 0) {
+                            if (requestedRawModelId) {
+                                const candidates = resolveCandidateAccounts(requestedRawModelId, pool);
+                                const oauthCandidates = candidates.filter((account) => account.auth?.type === "oauth"
+                                    && typeof account.auth.refresh === "string"
+                                    && account.auth.refresh.trim());
+                                if (oauthCandidates.length > 0) {
+                                    return fetchWithAccountFallback(inputRequest, init, oauthCandidates);
+                                }
+                            }
                             const selectedAccount = resolveSelectedPoolAccount(pool, accountKey, requestedRawModelId);
                             if (selectedAccount?.auth?.type === "oauth") {
                                 return fetchWithSelectedAccount(inputRequest, init, selectedAccount);

package/dist/pool.d.ts

@@ -8,4 +8,5 @@ export declare function writePoolAuthData(pool: AccountPool): void;
 export declare function migrateLegacyPoolStorageIfNeeded(): void;
 export declare function deriveAccountKey(deployment: string, userId: number): string;
 export declare function upsertAccount(pool: AccountPool, accountData: UpsertAccountData): AccountPool;
+export declare function resolveCandidateAccounts(rawModelId: string, pool: AccountPool): PoolAccount[];
 export declare function resolveWinnerAccount(rawModelId: string, pool: AccountPool): PoolAccount;

package/dist/pool.js

@@ -434,7 +434,7 @@ export function upsertAccount(pool, accountData) {
         accounts: nextAccounts,
     };
 }
-export function resolveWinnerAccount(rawModelId, pool) {
+export function resolveCandidateAccounts(rawModelId, pool) {
     const canAccountServeModel = (account) => {
         const allowlist = normalizeList(account?.allowlist);
         if (allowlist.length > 0 && !matchesAnyModelIdPattern(allowlist, rawModelId)) {
@@ -443,7 +443,7 @@ export function resolveWinnerAccount(rawModelId, pool) {
         const blocklist = normalizeList(account?.blocklist);
         return !matchesAnyModelIdPattern(blocklist, rawModelId);
     };
-    const candidates = (Array.isArray(pool?.accounts) ? pool.accounts : [])
+    return (Array.isArray(pool?.accounts) ? pool.accounts : [])
         .filter((account) => account?.enabled !== false)
         .filter(canAccountServeModel)
         .sort((left, right) => {
@@ -453,5 +453,7 @@ export function resolveWinnerAccount(rawModelId, pool) {
         }
         return String(left?.key ?? "").localeCompare(String(right?.key ?? ""));
     });
-    return candidates[0] ?? null;
+}
+export function resolveWinnerAccount(rawModelId, pool) {
+    return resolveCandidateAccounts(rawModelId, pool)[0] ?? null;
 }

package/dist/tui.js

@@ -22,7 +22,7 @@ async function showCopilotUsageDialog(api) {
     }
 }
 const tui = async (api) => {
-    api.command.register(() => [
+    api.command?.register(() => [
         {
             title: "Copilot Usage",
             value: "copilot-usage",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gnahz77/opencode-copilot-multi-auth",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",