@zhin.js/adapter-github 0.1.35 → 0.1.37

package/src/index.ts

@@ -3,17 +3,18 @@
  */
 import { usePlugin, type Plugin, type Context, type ToolFeature, type Tool, type ToolContext } from 'zhin.js';
 import { GitHubAdapter } from './adapter.js';
+import { GhClient } from './gh-client.js';
 import type { EventType } from './types.js';
 
 declare module 'zhin.js' {
+  interface Adapters {
+    github: GitHubAdapter;
+  }
   namespace Plugin {
     interface Contexts {
       router: import('@zhin.js/http').Router;
     }
   }
-  interface Adapters {
-    github: GitHubAdapter;
-  }
   interface Models {
     github_subscriptions: {
       id: number;
@@ -37,6 +38,7 @@ declare module 'zhin.js' {
 export * from './types.js';
 export { GitHubBot, parseMarkdown, toMarkdown } from './bot.js';
 export { GitHubAdapter } from './adapter.js';
+export { GhClient } from './gh-client.js';
 
 const plugin = usePlugin();
 const { provide, defineModel, useContext, logger } = plugin;
@@ -63,16 +65,13 @@ defineModel('github_oauth_users', {
   platform: { type: 'text', nullable: false },
   platform_uid: { type: 'text', nullable: false },
   github_login: { type: 'text', nullable: false },
-  github_id: { type: 'integer', nullable: false },
   access_token: { type: 'text', nullable: false },
-  scope: { type: 'text', default: '' },
-  created_at: { type: 'date', nullable: false },
-  updated_at: { type: 'date', nullable: false },
+  created_at: { type: 'integer', default: 0 },
 });
 
 provide({
   name: 'github',
-  description: 'GitHub Adapter — Issues/PRs as chat channels, full repo management via GitHub App',
+  description: 'GitHub Adapter — Issues/PRs as chat channels, full repo management via gh CLI',
   mounted: async (p: Plugin) => {
     const adapter = new GitHubAdapter(p);
     await adapter.start();
@@ -83,9 +82,28 @@ provide({
   },
 } as Context<'github'>);
 
-useContext('router', 'github', (router, adapter) => {
-  adapter.setupWebhook(router);
-  adapter.setupOAuth(router);
+// 混合模式：有 router + webhook_secret → Webhook 实时；否则 → 轮询降级
+useContext('github', (adapter) => {
+  if (adapter.hasWebhookConfig) {
+    // 尝试注册 Webhook（需要 router Context）
+    const router = plugin.inject('router');
+    if (router) {
+      adapter.setupWebhook(router);
+      logger.info('GitHub 事件源: Webhook (实时)');
+    } else {
+      // router 还没就绪，等它挂载后再注册
+      plugin.useContext('router', (r) => {
+        adapter.setupWebhook(r);
+        logger.info('GitHub 事件源: Webhook (实时, 延迟注册)');
+      });
+    }
+  }
+  // Webhook 未配置或未激活时，总是启动轮询作为兜底
+  if (!adapter.webhookActive) {
+    adapter.startPolling();
+    logger.info('GitHub 事件源: 轮询');
+  }
+  return () => adapter.stopPolling();
 });
 
 // ── Tool 工具注册 ─────────────────────────────────────────────────────────
@@ -113,8 +131,8 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
       },
       platforms: ['github'],
       tags: ['github'],
-      execute: async (args: Record<string, any>) => {
-        const api = adapter.getAPI();
+      execute: async (args: Record<string, any>, context?: ToolContext) => {
+        const api = await adapter.getUserOrDefaultAPI(context?.platform, context?.senderId);
         if (!api) return '❌ 没有可用的 GitHub bot';
         const { action, repo, number: num, title, body, head, base, state, approve, method } = args;
         switch (action) {
@@ -191,8 +209,8 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
       },
       platforms: ['github'],
       tags: ['github'],
-      execute: async (args: Record<string, any>) => {
-        const api = adapter.getAPI();
+      execute: async (args: Record<string, any>, context?: ToolContext) => {
+        const api = await adapter.getUserOrDefaultAPI(context?.platform, context?.senderId);
         if (!api) return '❌ 没有可用的 GitHub bot';
         const { action, repo, number: num, title, body, labels, state } = args;
         switch (action) {
@@ -255,8 +273,8 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
       },
       platforms: ['github'],
       tags: ['github'],
-      execute: async (args: Record<string, any>) => {
-        const api = adapter.getAPI();
+      execute: async (args: Record<string, any>, context?: ToolContext) => {
+        const api = await adapter.getUserOrDefaultAPI(context?.platform, context?.senderId);
         if (!api) return '❌ 没有可用的 GitHub bot';
         const { action, repo, limit: lim } = args;
         const limit = lim || 10;
@@ -324,8 +342,8 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
       },
       platforms: ['github'],
       tags: ['github'],
-      execute: async (args: Record<string, any>) => {
-        const api = adapter.getAPI();
+      execute: async (args: Record<string, any>, context?: ToolContext) => {
+        const api = await adapter.getUserOrDefaultAPI(context?.platform, context?.senderId);
         if (!api) return '❌ 没有可用的 GitHub bot';
         const { action, query: q, limit: lim } = args;
         const limit = lim || 10;
@@ -377,8 +395,8 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
       },
       platforms: ['github'],
       tags: ['github'],
-      execute: async (args: Record<string, any>) => {
-        const api = adapter.getAPI();
+      execute: async (args: Record<string, any>, context?: ToolContext) => {
+        const api = await adapter.getUserOrDefaultAPI(context?.platform, context?.senderId);
         if (!api) return '❌ 没有可用的 GitHub bot';
         const { action, repo, number: num, labels } = args;
         switch (action) {
@@ -427,8 +445,8 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
       },
       platforms: ['github'],
       tags: ['github'],
-      execute: async (args: Record<string, any>) => {
-        const api = adapter.getAPI();
+      execute: async (args: Record<string, any>, context?: ToolContext) => {
+        const api = await adapter.getUserOrDefaultAPI(context?.platform, context?.senderId);
         if (!api) return '❌ 没有可用的 GitHub bot';
         const { action, repo, number: num, assignees } = args;
         const assigneeArr = assignees.split(',').map((s: string) => s.trim());
@@ -456,8 +474,8 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
       },
       platforms: ['github'],
       tags: ['github'],
-      execute: async (args: Record<string, any>) => {
-        const api = adapter.getAPI();
+      execute: async (args: Record<string, any>, context?: ToolContext) => {
+        const api = await adapter.getUserOrDefaultAPI(context?.platform, context?.senderId);
         if (!api) return '❌ 没有可用的 GitHub bot';
         const r = await api.getFileContent(args.repo, args.path, args.ref);
         if (!r.ok) return `❌ ${r.data?.message || JSON.stringify(r.data)}`;
@@ -493,8 +511,8 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
       },
       platforms: ['github'],
       tags: ['github'],
-      execute: async (args: Record<string, any>) => {
-        const api = adapter.getAPI();
+      execute: async (args: Record<string, any>, context?: ToolContext) => {
+        const api = await adapter.getUserOrDefaultAPI(context?.platform, context?.senderId);
         if (!api) return '❌ 没有可用的 GitHub bot';
         const { action, repo, sha, path, base, head, limit: lim } = args;
         if (action === 'list') {
@@ -538,8 +556,8 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
       },
       platforms: ['github'],
       tags: ['github'],
-      execute: async (args: Record<string, any>) => {
-        const api = adapter.getAPI();
+      execute: async (args: Record<string, any>, context?: ToolContext) => {
+        const api = await adapter.getUserOrDefaultAPI(context?.platform, context?.senderId);
         if (!api) return '❌ 没有可用的 GitHub bot';
         const { type: itemType, repo, number: num, title, body, state } = args;
         const data: any = {};
@@ -557,7 +575,7 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
     // --- Star ---
     {
       name: 'github_star',
-      description: 'Star 或取消 Star 一个 GitHub 仓库（需要先 github_bind 绑定账号）',
+      description: 'Star 或取消 Star 一个 GitHub 仓库（使用你绑定的 GitHub 账号，未绑定则用 Bot 默认账号）',
       parameters: {
         type: 'object' as const,
         properties: {
@@ -569,22 +587,21 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
       platforms: ['github'],
       tags: ['github'],
       execute: async (args: Record<string, any>, context?: ToolContext) => {
-        if (!context?.platform || !context?.senderId) return '❌ 无法获取用户信息';
-        const client = await adapter.getOAuthClient(context.platform, context.senderId);
-        if (!client) return '❌ 你还没有绑定 GitHub 账号，请先使用 github_bind';
+        const gh = await adapter.getUserOrDefaultAPI(context?.platform, context?.senderId);
+        if (!gh) return '❌ 没有可用的 GitHub bot';
         const { action, repo } = args;
         switch (action) {
           case 'star': {
-            const r = await client.starRepo(repo);
-            return r.ok || r.status === 204 ? `⭐ 已 Star ${repo}` : `❌ ${r.data?.message || JSON.stringify(r.data)}`;
+            const r = await gh.starRepo(repo);
+            return r.ok ? `⭐ 已 Star ${repo}` : `❌ ${r.data?.message || JSON.stringify(r.data)}`;
           }
           case 'unstar': {
-            const r = await client.unstarRepo(repo);
-            return r.ok || r.status === 204 ? `💔 已取消 Star ${repo}` : `❌ ${r.data?.message || JSON.stringify(r.data)}`;
+            const r = await gh.unstarRepo(repo);
+            return r.ok ? `💔 已取消 Star ${repo}` : `❌ ${r.data?.message || JSON.stringify(r.data)}`;
           }
           case 'check': {
-            const starred = await client.isStarred(repo);
-            return starred ? `⭐ 你已 Star ${repo}` : `☆ 你尚未 Star ${repo}`;
+            const starred = await gh.isStarred(repo);
+            return starred ? `⭐ 已 Star ${repo}` : `☆ 尚未 Star ${repo}`;
           }
           default: return `❌ 未知操作: ${action}`;
         }
@@ -593,7 +610,7 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
     // --- Fork ---
     {
       name: 'github_fork',
-      description: 'Fork 一个 GitHub 仓库到自己的账号下（需要先 github_bind 绑定账号）',
+      description: 'Fork 一个 GitHub 仓库（使用你绑定的 GitHub 账号，未绑定则用 Bot 默认账号）',
       parameters: {
         type: 'object' as const,
         properties: {
@@ -604,14 +621,171 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
       platforms: ['github'],
       tags: ['github'],
       execute: async (args: Record<string, any>, context?: ToolContext) => {
-        if (!context?.platform || !context?.senderId) return '❌ 无法获取用户信息';
-        const client = await adapter.getOAuthClient(context.platform, context.senderId);
-        if (!client) return '❌ 你还没有绑定 GitHub 账号，请先使用 github_bind';
-        const r = await client.forkRepo(args.repo);
+        const gh = await adapter.getUserOrDefaultAPI(context?.platform, context?.senderId);
+        if (!gh) return '❌ 没有可用的 GitHub bot';
+        const r = await gh.forkRepo(args.repo);
         if (!r.ok) return `❌ ${r.data?.message || JSON.stringify(r.data)}`;
         return `🍴 已 Fork ${args.repo} → ${r.data.full_name}\n🔗 ${r.data.html_url}`;
       },
     },
+    // --- Bind (Device Flow) ---
+    {
+      name: 'github_bind',
+      description: '绑定你的 GitHub 账号 — 使用 Device Flow 授权，无需输入密码',
+      parameters: {
+        type: 'object' as const,
+        properties: {},
+      },
+      tags: ['github'],
+      execute: async (_args: Record<string, any>, context?: ToolContext) => {
+        if (!context?.platform || !context?.senderId) {
+          return '❌ 无法获取当前用户信息';
+        }
+        const clientId = adapter.getClientId();
+        if (!clientId) return '❌ Bot 未配置 GitHub App 或 App 无 client_id，无法进行账号绑定';
+
+        const db = plugin.root?.inject('database') as any;
+        const model = db?.models?.get('github_oauth_users');
+        if (!model) return '❌ 数据库未就绪';
+
+        // 检查是否已绑定
+        const [existing] = await model.select().where({ platform: context.platform, platform_uid: context.senderId });
+        if (existing) {
+          return `⚠️ 你已绑定 GitHub 账号: ${existing.github_login}\n如需重新绑定，请先执行 github_unbind`;
+        }
+
+        try {
+          const host = adapter.getHost();
+          const codeResp = await GhClient.deviceFlowRequestCode(clientId, host);
+          // 异步轮询 token（最多等 codeResp.expires_in 秒）
+          const tokenPromise = GhClient.deviceFlowPollToken(
+            clientId, codeResp.device_code, codeResp.interval, codeResp.expires_in, host,
+          );
+
+          // 先回复用户授权链接
+          const replyMsg = [
+            `🔗 请在浏览器中打开以下链接进行授权：`,
+            `   ${codeResp.verification_uri}`,
+            ``,
+            `📋 输入验证码: **${codeResp.user_code}**`,
+            ``,
+            `⏳ 等待授权中…（${Math.floor(codeResp.expires_in / 60)} 分钟内有效）`,
+          ].join('\n');
+
+          // 在后台等待用户授权完成
+          tokenPromise.then(async (tokenData) => {
+            if (!tokenData) {
+              // 授权超时或被拒绝 — 由于 execute 已经返回了，这里只能通过日志记录
+              logger.warn(`GitHub Device Flow 超时/拒绝: ${context.platform}:${context.senderId}`);
+              return;
+            }
+
+            // 使用 token 获取 GitHub 用户名
+            const userGh = new GhClient({ host, token: tokenData.access_token });
+            const authResult = await userGh.verifyAuth();
+            const login = authResult.ok ? authResult.user : 'unknown';
+
+            await model.insert({
+              id: Date.now(),
+              platform: context.platform,
+              platform_uid: context.senderId,
+              github_login: login,
+              access_token: tokenData.access_token,
+              created_at: Date.now(),
+            });
+            logger.info(`GitHub 账号绑定成功: ${context.platform}:${context.senderId} → ${login}`);
+
+            // 尝试回复绑定成功消息
+            if (context.message?.$reply) {
+              await context.message.$reply(`✅ GitHub 账号绑定成功！\n👤 ${login}`);
+            }
+          }).catch(err => {
+            logger.error('GitHub Device Flow 错误:', err);
+          });
+
+          return replyMsg;
+        } catch (e: any) {
+          return `❌ Device Flow 启动失败: ${e.message}`;
+        }
+      },
+    },
+    // --- Unbind ---
+    {
+      name: 'github_unbind',
+      description: '解除你绑定的 GitHub 账号',
+      parameters: {
+        type: 'object' as const,
+        properties: {},
+      },
+      tags: ['github'],
+      execute: async (_args: Record<string, any>, context?: ToolContext) => {
+        if (!context?.platform || !context?.senderId) {
+          return '❌ 无法获取当前用户信息';
+        }
+        const db = plugin.root?.inject('database') as any;
+        const model = db?.models?.get('github_oauth_users');
+        if (!model) return '❌ 数据库未就绪';
+
+        const [existing] = await model.select().where({ platform: context.platform, platform_uid: context.senderId });
+        if (!existing) return '📭 你尚未绑定 GitHub 账号';
+
+        await model.delete().where({ id: existing.id });
+        return `✅ 已解除 GitHub 账号绑定: ${existing.github_login}`;
+      },
+    },
+    // --- Whoami ---
+    {
+      name: 'github_whoami',
+      description: '查看你绑定的 GitHub 账号信息',
+      parameters: {
+        type: 'object' as const,
+        properties: {},
+      },
+      tags: ['github'],
+      execute: async (_args: Record<string, any>, context?: ToolContext) => {
+        if (!context?.platform || !context?.senderId) {
+          return '❌ 无法获取当前用户信息';
+        }
+        const db = plugin.root?.inject('database') as any;
+        const model = db?.models?.get('github_oauth_users');
+        if (!model) return '❌ 数据库未就绪';
+
+        const [existing] = await model.select().where({ platform: context.platform, platform_uid: context.senderId });
+        if (!existing) return '📭 你尚未绑定 GitHub 账号\n🔗 使用 github_bind 绑定你的账号';
+
+        // 验证 token 是否仍然有效
+        const userGh = new GhClient({ host: adapter.getHost(), token: existing.access_token });
+        const auth = await userGh.verifyAuth();
+        if (auth.ok) {
+          return `👤 已绑定 GitHub 账号: ${auth.user}\n📅 绑定时间: ${new Date(existing.created_at).toLocaleString('zh-CN')}`;
+        }
+        return `⚠️ 已绑定账号 ${existing.github_login}，但 Token 已失效\n🔗 请执行 github_unbind 后重新 github_bind`;
+      },
+    },
+    // --- Install App ---
+    {
+      name: 'github_install',
+      description: '获取安装 GitHub App 的链接 — 安装后 Bot 可以访问你的仓库，你也可以使用更多功能',
+      parameters: {
+        type: 'object' as const,
+        properties: {},
+      },
+      tags: ['github'],
+      execute: async () => {
+        const slug = adapter.getAppSlug();
+        if (!slug) return '❌ Bot 未配置 GitHub App';
+        const host = adapter.getHost() || 'github.com';
+        const installations = adapter.getInstallations();
+        let msg = `🔗 请点击以下链接安装 GitHub App 到你的仓库：\n   https://${host}/apps/${slug}/installations/new`;
+        if (installations.length) {
+          msg += `\n\n📋 当前已安装 (${installations.length}):`;
+          for (const inst of installations) {
+            msg += `\n  • ${inst.account.login} (${inst.account.type})`;
+          }
+        }
+        return msg;
+      },
+    },
     // --- Subscribe ---
     {
       name: 'github_subscribe',
@@ -728,84 +902,6 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
           }).join('\n\n');
       },
     },
-    // --- Bind ---
-    {
-      name: 'github_bind',
-      description: '绑定 GitHub 账号，生成 OAuth 授权链接',
-      parameters: {
-        type: 'object' as const,
-        properties: {},
-      },
-      platforms: ['github'],
-      tags: ['github'],
-      execute: async (_args: Record<string, any>, context?: ToolContext) => {
-        if (!context?.platform || !context?.senderId) return '❌ 无法获取用户信息';
-
-        // 检查是否已绑定
-        const db = plugin.root?.inject('database') as any;
-        const model = db?.models?.get('github_oauth_users');
-        if (model) {
-          const [existing] = await model.select().where({ platform: context.platform, platform_uid: context.senderId });
-          if (existing) return `✅ 你已绑定 GitHub 账号: ${existing.github_login}\n如需重新绑定，请先使用 github_unbind 解绑`;
-        }
-
-        const url = adapter.createOAuthState(context.platform, context.senderId);
-        if (!url) return '❌ GitHub App 未配置 OAuth (缺少 client_id)';
-
-        return `🔗 请点击以下链接绑定你的 GitHub 账号:\n${url}\n\n链接有效期 5 分钟`;
-      },
-    },
-    // --- Unbind ---
-    {
-      name: 'github_unbind',
-      description: '解绑 GitHub 账号',
-      parameters: {
-        type: 'object' as const,
-        properties: {},
-      },
-      platforms: ['github'],
-      tags: ['github'],
-      execute: async (_args: Record<string, any>, context?: ToolContext) => {
-        if (!context?.platform || !context?.senderId) return '❌ 无法获取用户信息';
-        const db = plugin.root?.inject('database') as any;
-        const model = db?.models?.get('github_oauth_users');
-        if (!model) return '❌ 数据库未就绪';
-
-        const [existing] = await model.select().where({ platform: context.platform, platform_uid: context.senderId });
-        if (!existing) return '📭 你还没有绑定 GitHub 账号';
-
-        await model.delete().where({ id: existing.id });
-        return `✅ 已解绑 GitHub 账号: ${existing.github_login}`;
-      },
-    },
-    // --- Whoami ---
-    {
-      name: 'github_whoami',
-      description: '查看当前绑定的 GitHub 账号信息',
-      parameters: {
-        type: 'object' as const,
-        properties: {},
-      },
-      platforms: ['github'],
-      tags: ['github'],
-      execute: async (_args: Record<string, any>, context?: ToolContext) => {
-        if (!context?.platform || !context?.senderId) return '❌ 无法获取用户信息';
-        const db = plugin.root?.inject('database') as any;
-        const model = db?.models?.get('github_oauth_users');
-        if (!model) return '❌ 数据库未就绪';
-
-        const [row] = await model.select().where({ platform: context.platform, platform_uid: context.senderId });
-        if (!row) return '📭 你还没有绑定 GitHub 账号，使用 github_bind 进行绑定';
-
-        return [
-          `🐙 GitHub 账号信息`,
-          `👤 用户名: ${row.github_login}`,
-          `🆔 GitHub ID: ${row.github_id}`,
-          `📅 绑定时间: ${row.created_at instanceof Date ? row.created_at.toLocaleDateString() : String(row.created_at).split('T')[0]}`,
-          `🔑 权限: ${row.scope || '(默认)'}`,
-        ].join('\n');
-      },
-    },
   ];
 
   const disposers = tools.map(t => toolService.addTool(t, plugin.name));
@@ -814,4 +910,4 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
   return () => disposers.forEach(d => d());
 });
 
-logger.debug('GitHub 适配器已加载 (GitHub App 认证)');
+logger.debug('GitHub 适配器已加载 (gh CLI 认证)');

package/src/types.ts

@@ -1,45 +1,23 @@
 // ── Bot 配置 ─────────────────────────────────────────────────────────
-//  GitHub App 认证: app_id + private_key → JWT → Installation Token
-//  OAuth 用户授权: client_id + client_secret → 用户绑定 GitHub 账号
+//  基于 gh CLI 认证：需要系统已安装并认证 gh CLI
+//  认证方式：gh auth login
 
 export interface GitHubBotConfig {
   context: 'github';
   /** Bot 标识名称 */
   name: string;
+  /** GitHub Enterprise 主机名（默认 github.com） */
+  host?: string;
   /** GitHub App ID */
-  app_id: number;
-  /** GitHub App 私钥 PEM 内容或文件路径 */
-  private_key: string;
-  /** Installation ID (不填则自动获取第一个) */
-  installation_id?: number;
-  /** Webhook 签名密钥 */
+  app_id?: string | number;
+  /** GitHub App 私钥（PEM 内容或文件路径） */
+  private_key?: string;
+  /** Webhook Secret（配置后启用 Webhook 接收事件，不配置则使用轮询） */
   webhook_secret?: string;
-  /** GitHub App OAuth: Client ID (在 App 设置页获取) */
-  client_id?: string;
-  /** GitHub App OAuth: Client Secret */
-  client_secret?: string;
-  /** 服务公开访问地址，用于 OAuth 回调和绑定链接（如 https://bot.example.com） */
-  public_url?: string;
-}
-
-// ── OAuth 用户绑定 ───────────────────────────────────────────────────
-
-export interface GitHubOAuthUser {
-  id: number;
-  /** 聊天平台名称 (icqq / kook / discord ...) */
-  platform: string;
-  /** 聊天平台用户 ID */
-  platform_uid: string;
-  /** GitHub 用户名 */
-  github_login: string;
-  /** GitHub 用户 ID */
-  github_id: number;
-  /** OAuth access_token */
-  access_token: string;
-  /** 授权范围 */
-  scope: string;
-  created_at: Date;
-  updated_at: Date;
+  /** Webhook 路由路径（默认 /github/webhook） */
+  webhook_path?: string;
+  /** 事件轮询间隔（秒，默认 60，Webhook 模式下作为降级备选） */
+  poll_interval?: number;
 }
 
 // ── Channel ID ───────────────────────────────────────────────────────
@@ -165,3 +143,20 @@ export interface Subscription {
 export type PrAction = 'list' | 'view' | 'diff' | 'merge' | 'create' | 'review' | 'close';
 export type IssueAction = 'list' | 'view' | 'create' | 'close' | 'comment';
 export type RepoAction = 'info' | 'branches' | 'releases' | 'runs' | 'stars';
+
+// ── OAuth 用户绑定 ───────────────────────────────────────────────────
+//  存储各平台用户绑定的 GitHub OAuth Token（Device Flow）
+
+export interface GitHubOAuthUser {
+  id: number;
+  /** 来源平台 (icqq, kook, discord …) */
+  platform: string;
+  /** 该平台上的用户 ID */
+  platform_uid: string;
+  /** GitHub 用户名 */
+  github_login: string;
+  /** OAuth Access Token */
+  access_token: string;
+  /** 绑定时间 (ms) */
+  created_at: number;
+}

package/lib/api.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}