@zhin.js/adapter-github 0.1.28 → 0.1.31

package/src/adapter.ts

@@ -6,10 +6,9 @@ import {
   Adapter,
   Plugin,
   Message,
-  ZhinTool,
 } from 'zhin.js';
 import { GitHubBot } from './bot.js';
-import type { GitHubBotConfig, EventType, GenericWebhookPayload, Subscription, PrAction, IssueAction, RepoAction } from './types.js';
+import type { GitHubBotConfig, EventType, GenericWebhookPayload, Subscription } from './types.js';
 import { GitHubAPI, GitHubOAuthClient, exchangeOAuthCode } from './api.js';
 import type { IssueCommentPayload, PRReviewCommentPayload, PRReviewPayload } from './types.js';
 
@@ -29,36 +28,50 @@ const OAUTH_STATE_TTL = 5 * 60 * 1000;
 function formatNotification(event: string, p: GenericWebhookPayload): string {
   const repo = p.repository.full_name;
   const sender = p.sender.login;
+  const repoUrl = p.repository.html_url;
   switch (event) {
     case 'push': {
       const branch = p.ref?.replace('refs/heads/', '') || '?';
       const commits = p.commits || [];
-      let msg = `📦 ${repo}\n🌿 ${sender} pushed to ${branch}\n\n`;
+      const compareUrl = commits.length >= 2
+        ? `${repoUrl}/compare/${commits[0].id.substring(0, 12)}...${commits[commits.length - 1].id.substring(0, 12)}`
+        : commits.length === 1 ? `${repoUrl}/commit/${commits[0].id}` : '';
+      let msg = `📦 ${repo}\n🌿 ${sender} pushed ${commits.length} commit(s) to \`${branch}\`\n`;
       if (commits.length) {
-        msg += `📝 ${commits.length} commit(s):\n`;
-        msg += commits.slice(0, 3).map(c => `  • ${c.id.substring(0, 7)} ${c.message.split('\n')[0]}`).join('\n');
-        if (commits.length > 3) msg += `\n  ... +${commits.length - 3} more`;
+        msg += '\n';
+        msg += commits.slice(0, 5).map(c =>
+          `  • [\`${c.id.substring(0, 7)}\`](${repoUrl}/commit/${c.id}) ${c.message.split('\n')[0]}`
+        ).join('\n');
+        if (commits.length > 5) msg += `\n  ... +${commits.length - 5} more`;
       }
+      if (compareUrl) msg += `\n\n🔗 ${compareUrl}`;
       return msg;
     }
     case 'issues': {
       const i = p.issue!;
-      const act = p.action === 'opened' ? 'opened' : p.action === 'closed' ? 'closed' : 'updated';
-      return `🐛 ${repo}\n👤 ${sender} ${act} issue #${i.number}\n📌 ${i.title}`;
+      const act = p.action === 'opened' ? '📝 opened' : p.action === 'closed' ? '✅ closed' : `🔄 ${p.action || 'updated'}`;
+      let msg = `🐛 ${repo}\n👤 ${sender} ${act} issue #${i.number}\n📌 ${i.title}`;
+      msg += `\n🔗 ${i.html_url}`;
+      return msg;
     }
     case 'star': {
       const starred = p.action !== 'deleted';
-      return `${starred ? '⭐' : '💔'} ${repo}\n👤 ${sender} ${starred ? 'starred' : 'unstarred'}`;
+      return `${starred ? '⭐' : '💔'} ${repo}\n👤 ${sender} ${starred ? 'starred' : 'unstarred'}\n🔗 ${repoUrl}`;
     }
     case 'fork':
-      return `🍴 ${repo}\n👤 ${sender} forked → ${p.forkee!.full_name}`;
+      return `🍴 ${repo}\n👤 ${sender} forked → ${p.forkee!.full_name}\n🔗 ${p.forkee!.html_url}`;
     case 'pull_request': {
       const pr = p.pull_request!;
-      const act = p.action === 'opened' ? 'opened' : p.action === 'closed' ? 'closed' : 'updated';
-      return `🔀 ${repo}\n👤 ${sender} ${act} PR #${pr.number}\n📌 ${pr.title}`;
+      const act = p.action === 'opened' ? '📝 opened'
+        : p.action === 'closed' ? (pr.state === 'closed' ? '❌ closed' : '✅ merged')
+        : `🔄 ${p.action || 'updated'}`;
+      let msg = `🔀 ${repo}\n👤 ${sender} ${act} PR #${pr.number}\n📌 ${pr.title}`;
+      msg += `\n🌿 ${pr.head.ref} → ${pr.base.ref}`;
+      msg += `\n🔗 ${pr.html_url}`;
+      return msg;
     }
     default:
-      return `📬 ${repo}\n${event} by ${sender}`;
+      return `📬 ${repo}\n📡 ${event}${p.action ? ` (${p.action})` : ''} by ${sender}\n🔗 ${repoUrl}`;
   }
 }
 
@@ -77,12 +90,11 @@ export class GitHubAdapter extends Adapter<GitHubBot> {
   }
 
   async start(): Promise<void> {
-    this.registerGitHubTools();
     await super.start();
   }
 
   /** 获取第一个可用 bot 的 API (工具用) */
-  private getAPI(): GitHubAPI | null {
+  getAPI(): GitHubAPI | null {
     const bot = this.bots.values().next().value as GitHubBot | undefined;
     return bot?.api || null;
   }
@@ -294,684 +306,6 @@ export class GitHubAdapter extends Adapter<GitHubBot> {
     this.plugin.logger.debug('GitHub Webhook: POST /pub/github/webhook');
   }
 
-  // ── GitHub 管理工具 ────────────────────────────────────────────────
-
-  private registerGitHubTools(): void {
-
-    // --- PR ---
-    this.addTool(
-      new ZhinTool('github_pr')
-        .desc('GitHub PR 操作：list/view/diff/merge/create/review/close')
-        .keyword('pr', 'pull request', '合并', 'merge', 'review', '审查', '拉取请求')
-        .tag('github', 'pr')
-        .param('action', { type: 'string', description: 'list|view|diff|merge|create|review|close', enum: ['list','view','diff','merge','create','review','close'] }, true)
-        .param('repo', { type: 'string', description: 'owner/repo (必填)' }, true)
-        .param('number', { type: 'number', description: 'PR 编号' })
-        .param('title', { type: 'string', description: 'PR 标题 (create)' })
-        .param('body', { type: 'string', description: 'PR 描述 / Review 评语' })
-        .param('head', { type: 'string', description: '源分支 (create)' })
-        .param('base', { type: 'string', description: '目标分支 (create，默认 main)' })
-        .param('state', { type: 'string', description: 'open/closed/all (list)' })
-        .param('approve', { type: 'boolean', description: 'review 时 approve' })
-        .param('method', { type: 'string', description: 'squash/merge/rebase (merge)' })
-        .execute(async (args) => {
-          const api = this.getAPI();
-          if (!api) return '❌ 没有可用的 GitHub bot';
-          const action = args.action as PrAction;
-          const repo = args.repo as string;
-          const num = args.number as number | undefined;
-
-          switch (action) {
-            case 'list': {
-              const r = await api.listPRs(repo, (args.state as string) || 'open');
-              if (!r.ok) return `❌ ${JSON.stringify(r.data)}`;
-              if (!r.data.length) return `📭 没有 ${args.state || 'open'} 状态的 PR`;
-              return r.data.map((p: any) =>
-                `#${p.number} ${p.draft ? '[Draft] ' : ''}${p.title}\n   👤 ${p.user.login} | 🌿 ${p.head.ref} → ${p.base.ref} | ${p.state}`
-              ).join('\n\n');
-            }
-            case 'view': {
-              if (!num) return '❌ 请提供 PR 编号';
-              const r = await api.getPR(repo, num);
-              if (!r.ok) return `❌ ${JSON.stringify(r.data)}`;
-              const p = r.data;
-              return [
-                `#${p.number} ${p.title}`,
-                `👤 ${p.user.login} | ${p.state} | 🌿 ${p.head.ref} → ${p.base.ref}`,
-                `📅 ${p.created_at?.split('T')[0]} | +${p.additions} -${p.deletions} (${p.changed_files} files)`,
-                p.body ? `\n${p.body.slice(0, 500)}${p.body.length > 500 ? '...' : ''}` : '',
-                `\n🔗 ${p.html_url}`,
-              ].filter(Boolean).join('\n');
-            }
-            case 'diff': {
-              if (!num) return '❌ 请提供 PR 编号';
-              const r = await api.getPRDiff(repo, num);
-              if (!r.ok) return `❌ 获取 diff 失败`;
-              const lines = r.data.split('\n');
-              return lines.length > 100 ? lines.slice(0, 100).join('\n') + `\n\n... (共 ${lines.length} 行)` : r.data;
-            }
-            case 'merge': {
-              if (!num) return '❌ 请提供 PR 编号';
-              const r = await api.mergePR(repo, num, (args.method as string) || 'squash');
-              return r.ok ? `✅ PR #${num} 已合并` : `❌ ${r.data?.message || JSON.stringify(r.data)}`;
-            }
-            case 'create': {
-              if (!args.title) return '❌ 请提供 PR 标题';
-              if (!args.head) return '❌ 请提供源分支 (head)';
-              const r = await api.createPR(repo, args.title as string, (args.body as string) || '', args.head as string, (args.base as string) || 'main');
-              return r.ok ? `✅ PR 已创建: ${r.data.html_url}` : `❌ ${r.data?.message || JSON.stringify(r.data)}`;
-            }
-            case 'review': {
-              if (!num) return '❌ 请提供 PR 编号';
-              const event = args.approve ? 'APPROVE' : 'COMMENT';
-              const r = await api.createPRReview(repo, num, event as any, (args.body as string) || undefined);
-              return r.ok ? `✅ PR #${num} ${args.approve ? '已批准' : '已评论'}` : `❌ ${r.data?.message}`;
-            }
-            case 'close': {
-              if (!num) return '❌ 请提供 PR 编号';
-              const r = await api.closePR(repo, num);
-              return r.ok ? `✅ PR #${num} 已关闭` : `❌ ${r.data?.message}`;
-            }
-            default: return `❌ 未知操作: ${action}`;
-          }
-        }),
-    );
-
-    // --- Issue ---
-    this.addTool(
-      new ZhinTool('github_issue')
-        .desc('GitHub Issue 操作：list/view/create/close/comment')
-        .keyword('issue', '问题', 'bug', '创建issue', '关闭issue')
-        .tag('github', 'issue')
-        .param('action', { type: 'string', description: 'list|view|create|close|comment', enum: ['list','view','create','close','comment'] }, true)
-        .param('repo', { type: 'string', description: 'owner/repo (必填)' }, true)
-        .param('number', { type: 'number', description: 'Issue 编号' })
-        .param('title', { type: 'string', description: 'Issue 标题 (create)' })
-        .param('body', { type: 'string', description: 'Issue 内容 / 评论内容' })
-        .param('labels', { type: 'string', description: '标签，逗号分隔 (create)' })
-        .param('state', { type: 'string', description: 'open/closed/all (list)' })
-        .execute(async (args) => {
-          const api = this.getAPI();
-          if (!api) return '❌ 没有可用的 GitHub bot';
-          const action = args.action as IssueAction;
-          const repo = args.repo as string;
-          const num = args.number as number | undefined;
-
-          switch (action) {
-            case 'list': {
-              const r = await api.listIssues(repo, (args.state as string) || 'open');
-              if (!r.ok) return `❌ ${JSON.stringify(r.data)}`;
-              // 过滤掉 PR (GitHub API 的 issues 接口也返回 PR)
-              const issues = r.data.filter((i: any) => !i.pull_request);
-              if (!issues.length) return `📭 没有 ${args.state || 'open'} 状态的 Issue`;
-              return issues.map((i: any) => {
-                const labels = i.labels?.map((l: any) => l.name).join(', ') || '';
-                return `#${i.number} ${i.title}\n   👤 ${i.user.login}${labels ? ` | 🏷️ ${labels}` : ''} | ${i.state}`;
-              }).join('\n\n');
-            }
-            case 'view': {
-              if (!num) return '❌ 请提供 Issue 编号';
-              const r = await api.getIssue(repo, num);
-              if (!r.ok) return `❌ ${JSON.stringify(r.data)}`;
-              const i = r.data;
-              return [
-                `#${i.number} ${i.title}`,
-                `👤 ${i.user.login} | ${i.state} | 📅 ${i.created_at?.split('T')[0]}`,
-                i.labels?.length ? `🏷️ ${i.labels.map((l: any) => l.name).join(', ')}` : null,
-                i.body ? `\n${i.body.slice(0, 500)}${i.body.length > 500 ? '...' : ''}` : '',
-                `\n🔗 ${i.html_url}`,
-              ].filter(Boolean).join('\n');
-            }
-            case 'create': {
-              if (!args.title) return '❌ 请提供 Issue 标题';
-              const labels = args.labels ? (args.labels as string).split(',').map(s => s.trim()) : undefined;
-              const r = await api.createIssue(repo, args.title as string, (args.body as string) || undefined, labels);
-              return r.ok ? `✅ Issue 已创建: ${r.data.html_url}` : `❌ ${r.data?.message}`;
-            }
-            case 'close': {
-              if (!num) return '❌ 请提供 Issue 编号';
-              const r = await api.closeIssue(repo, num);
-              return r.ok ? `✅ Issue #${num} 已关闭` : `❌ ${r.data?.message}`;
-            }
-            case 'comment': {
-              if (!num) return '❌ 请提供 Issue 编号';
-              if (!args.body) return '❌ 请提供评论内容';
-              const r = await api.createIssueComment(repo, num, args.body as string);
-              return r.ok ? `✅ 已评论 Issue #${num}` : `❌ ${JSON.stringify(r.data)}`;
-            }
-            default: return `❌ 未知操作: ${action}`;
-          }
-        }),
-    );
-
-    // --- Repo ---
-    this.addTool(
-      new ZhinTool('github_repo')
-        .desc('GitHub 仓库查询：info/branches/releases/runs(CI)/stars')
-        .keyword('仓库', 'repo', 'star', '分支', 'branch', 'release', '发布', 'CI', 'workflow')
-        .tag('github', 'repo')
-        .param('action', { type: 'string', description: 'info|branches|releases|runs|stars', enum: ['info','branches','releases','runs','stars'] }, true)
-        .param('repo', { type: 'string', description: 'owner/repo (必填)' }, true)
-        .param('limit', { type: 'number', description: '返回数量，默认 10' })
-        .execute(async (args) => {
-          const api = this.getAPI();
-          if (!api) return '❌ 没有可用的 GitHub bot';
-          const action = args.action as RepoAction;
-          const repo = args.repo as string;
-          const limit = (args.limit as number) || 10;
-
-          switch (action) {
-            case 'info': {
-              const r = await api.getRepo(repo);
-              if (!r.ok) return `❌ ${JSON.stringify(r.data)}`;
-              const d = r.data;
-              return [
-                `📦 ${d.full_name}${d.private ? ' 🔒' : ''}`,
-                d.description ? `📝 ${d.description}` : null,
-                `⭐ ${d.stargazers_count} | 🍴 ${d.forks_count} | 👀 ${d.watchers_count}`,
-                `🌿 默认分支: ${d.default_branch}`,
-                d.license ? `📄 ${d.license.name}` : null,
-                d.homepage ? `🌐 ${d.homepage}` : null,
-                `📅 创建: ${d.created_at?.split('T')[0]} | 推送: ${d.pushed_at?.split('T')[0]}`,
-              ].filter(Boolean).join('\n');
-            }
-            case 'branches': {
-              const r = await api.listBranches(repo, limit);
-              if (!r.ok) return `❌ ${JSON.stringify(r.data)}`;
-              return r.data.length
-                ? `🌿 分支 (${r.data.length}):\n${r.data.map((b: any) => `  • ${b.name}${b.protected ? ' 🔒' : ''}`).join('\n')}`
-                : '没有找到分支';
-            }
-            case 'releases': {
-              const r = await api.listReleases(repo, limit);
-              if (!r.ok) return `❌ ${JSON.stringify(r.data)}`;
-              if (!r.data.length) return '📭 暂无发布';
-              return r.data.map((rel: any) =>
-                `${rel.prerelease ? '🧪' : '📦'} ${rel.tag_name} — ${rel.name || '(no title)'}\n   📅 ${rel.published_at?.split('T')[0]} | 👤 ${rel.author?.login}`
-              ).join('\n\n');
-            }
-            case 'runs': {
-              const r = await api.listWorkflowRuns(repo, limit);
-              if (!r.ok) return `❌ ${JSON.stringify(r.data)}`;
-              const runs = r.data.workflow_runs || [];
-              if (!runs.length) return '📭 暂无 CI 记录';
-              return runs.map((run: any) => {
-                const icon = run.conclusion === 'success' ? '✅' : run.conclusion === 'failure' ? '❌' : run.status === 'in_progress' ? '🔄' : '⏳';
-                return `${icon} #${run.id} ${run.display_title}\n   🌿 ${run.head_branch} | ${run.status}${run.conclusion ? '/' + run.conclusion : ''}`;
-              }).join('\n\n');
-            }
-            case 'stars': {
-              const r = await api.getRepo(repo);
-              if (!r.ok) return `❌ ${JSON.stringify(r.data)}`;
-              return `⭐ ${r.data.stargazers_count} stars | 🍴 ${r.data.forks_count} forks`;
-            }
-            default: return `❌ 未知查询: ${action}`;
-          }
-        }),
-    );
-
-    // --- Subscribe ---
-    this.addTool(
-      new ZhinTool('github_subscribe')
-        .desc('订阅 GitHub 仓库 Webhook 事件通知（跨平台推送到当前聊天）')
-        .tag('github', 'subscription')
-        .param('repo', { type: 'string', description: 'owner/repo' }, true)
-        .param('events', { type: 'array', description: '事件: push, issue, star, fork, unstar, pr（留空=全部）' })
-        .execute(async ({ repo, events: evts = [] }, ctx) => {
-          if (!ctx?.message) return '❌ 无法获取消息上下文';
-          const msg = ctx.message as Message;
-          const repoStr = repo as string;
-          if (!repoStr.includes('/')) return '❌ 格式应为 owner/repo';
-
-          const parsed: EventType[] = [];
-          for (const e of evts as string[]) {
-            const n = e.toLowerCase();
-            if (n === 'pr') parsed.push('pull_request');
-            else if (VALID_EVENTS.includes(n as EventType)) parsed.push(n as EventType);
-            else return `❌ 不支持: ${e}`;
-          }
-          const subEvents = parsed.length > 0 ? parsed : VALID_EVENTS;
-          const db = this.plugin.root?.inject('database') as any;
-          const model = db?.models?.get('github_subscriptions');
-          if (!model) return '❌ 数据库未就绪';
-
-          const where = { repo: repoStr, target_id: msg.$channel.id, target_type: msg.$channel.type, adapter: msg.$adapter, bot: msg.$bot };
-          const [existing] = await model.select().where(where);
-          const eventsJson = JSON.stringify(subEvents);
-          if (existing) {
-            await model.update({ events: eventsJson }).where({ id: existing.id });
-            return `✅ 已更新订阅 ${repoStr}\n📢 ${subEvents.join(', ')}`;
-          }
-          const { repo: _r, ...rest } = where;
-          await model.insert({ id: Date.now(), repo: repoStr, events: eventsJson, ...rest });
-          return `✅ 已订阅 ${repoStr}\n📢 ${subEvents.join(', ')}\n💡 记得在 GitHub App 或仓库 Settings → Webhooks 中配置 Webhook`;
-        }),
-    );
-
-    // --- Unsubscribe ---
-    this.addTool(
-      new ZhinTool('github_unsubscribe')
-        .desc('取消订阅 GitHub 仓库事件通知')
-        .tag('github', 'subscription')
-        .param('repo', { type: 'string', description: 'owner/repo' }, true)
-        .execute(async ({ repo }, ctx) => {
-          if (!ctx?.message) return '❌ 无法获取消息上下文';
-          const msg = ctx.message as Message;
-          const db = this.plugin.root?.inject('database') as any;
-          const model = db?.models?.get('github_subscriptions');
-          if (!model) return '❌ 数据库未就绪';
-          const [sub] = await model.select().where({ repo: repo as string, target_id: msg.$channel.id, target_type: msg.$channel.type, adapter: msg.$adapter, bot: msg.$bot });
-          if (!sub) return `❌ 未找到订阅: ${repo}`;
-          await model.delete({ id: sub.id });
-          return `✅ 已取消订阅 ${repo}`;
-        }),
-    );
-
-    // --- List subscriptions ---
-    this.addTool(
-      new ZhinTool('github_subscriptions')
-        .desc('查看当前聊天的 GitHub 事件订阅列表')
-        .tag('github', 'subscription')
-        .execute(async (_args, ctx) => {
-          if (!ctx?.message) return '❌ 无法获取消息上下文';
-          const msg = ctx.message as Message;
-          const db = this.plugin.root?.inject('database') as any;
-          const model = db?.models?.get('github_subscriptions');
-          if (!model) return '❌ 数据库未就绪';
-          const subs = await model.select().where({ target_id: msg.$channel.id, target_type: msg.$channel.type, adapter: msg.$adapter, bot: msg.$bot });
-          if (!subs?.length) return '📭 当前没有订阅';
-          return `📋 订阅 (${subs.length}):\n\n` + subs.map((s: any, i: number) => {
-            return `${i + 1}. ${s.repo}\n   📢 ${safeParseEvents(s.events).join(', ')}`;
-          }).join('\n\n');
-        }),
-    );
-
-    // --- GitHub OAuth Bind ---
-    this.addTool(
-      new ZhinTool('github_bind')
-        .desc('绑定 GitHub 账号 — 通过 OAuth 授权，让 bot 以你的身份执行 star/fork 等操作')
-        .keyword('github bind', '绑定github', 'github 绑定', 'github 授权')
-        .tag('github', 'oauth')
-        .execute(async (_args, ctx) => {
-          if (!ctx?.message) return '❌ 无法获取消息上下文';
-          const msg = ctx.message as Message;
-
-          const bot = this.bots.values().next().value as GitHubBot | undefined;
-          if (!bot?.$config.client_id) {
-            return '❌ GitHub OAuth 未配置（需要在 bot 配置中添加 client_id 和 client_secret）';
-          }
-
-          const nonce = crypto.randomBytes(16).toString('hex');
-          const state = `${msg.$adapter}:${msg.$sender.id}:${nonce}`;
-          oauthStates.set(state, {
-            platform: msg.$adapter,
-            platformUid: msg.$sender.id,
-            expires: Date.now() + OAUTH_STATE_TTL,
-          });
-
-          const baseUrl = this.publicUrl;
-          if (!baseUrl) {
-            return '❌ 未配置 public_url，无法生成 OAuth 链接\n💡 请在 bot 配置中添加 public_url（如 https://bot.example.com）';
-          }
-          const link = `${baseUrl}/pub/github/oauth?state=${encodeURIComponent(state)}`;
-          const fullText = `🔗 请点击以下链接授权你的 GitHub 账号：\n\n${link}\n\n⏱️ 链接有效期 5 分钟`;
-
-          // 由工具直接发到用户，避免 AI 总结时把链接吞掉
-          try {
-            const targetAdapter = this.plugin.root?.inject(msg.$adapter)
-            if (targetAdapter instanceof Adapter) {
-              await targetAdapter.sendMessage({
-                context: msg.$adapter,
-                bot: msg.$bot,
-                id: msg.$channel.id,
-                type: msg.$channel.type,
-                content: fullText,
-              });
-            }
-          } catch (e) {
-            this.plugin.logger.warn('github.bind 直发链接失败，将仅通过返回值返回链接', e);
-          }
-
-          return '已向当前会话发送绑定链接，请提醒用户查收并点击链接完成授权。';
-        }),
-    );
-
-    // --- GitHub OAuth Unbind ---
-    this.addTool(
-      new ZhinTool('github_unbind')
-        .desc('解除 GitHub 账号绑定')
-        .keyword('github unbind', '解绑github', 'github 解绑')
-        .tag('github', 'oauth')
-        .execute(async (_args, ctx) => {
-          if (!ctx?.message) return '❌ 无法获取消息上下文';
-          const msg = ctx.message as Message;
-          const db = this.plugin.root?.inject('database') as any;
-          const model = db?.models?.get('github_oauth_users');
-          if (!model) return '❌ 数据库未就绪';
-
-          const [existing] = await model.select().where({ platform: msg.$adapter, platform_uid: msg.$sender.id });
-          if (!existing) return '❌ 你还没有绑定 GitHub 账号';
-
-          await model.delete({ id: existing.id });
-          return `✅ 已解除 GitHub 账号绑定（${existing.github_login}）`;
-        }),
-    );
-
-    // --- GitHub OAuth Whoami ---
-    this.addTool(
-      new ZhinTool('github_whoami')
-        .desc('查看当前绑定的 GitHub 账号信息')
-        .keyword('github whoami', 'github 我是谁', 'github 账号')
-        .tag('github', 'oauth')
-        .execute(async (_args, ctx) => {
-          if (!ctx?.message) return '❌ 无法获取消息上下文';
-          const msg = ctx.message as Message;
-          const db = this.plugin.root?.inject('database') as any;
-          const model = db?.models?.get('github_oauth_users');
-          if (!model) return '❌ 数据库未就绪';
-
-          const [existing] = await model.select().where({ platform: msg.$adapter, platform_uid: msg.$sender.id });
-          if (!existing) return '❌ 你还没有绑定 GitHub 账号\n💡 使用 /github bind 进行绑定';
-
-          const oauthClient = new GitHubOAuthClient(existing.access_token);
-          const userRes = await oauthClient.getUser();
-          if (!userRes.ok) {
-            return `⚠️ 已绑定 ${existing.github_login}，但 token 可能已失效\n💡 请使用 /github bind 重新授权`;
-          }
-
-          const u = userRes.data;
-          return [
-            `🔗 GitHub 账号已绑定`,
-            `👤 ${u.login}${u.name ? ` (${u.name})` : ''}`,
-            `🔑 授权范围: ${existing.scope || 'N/A'}`,
-            `📅 绑定时间: ${new Date(existing.created_at).toLocaleDateString()}`,
-          ].join('\n');
-        }),
-    );
-
-    // --- GitHub Star (用户级操作) ---
-    this.addTool(
-      new ZhinTool('github_star')
-        .desc('Star / Unstar 一个仓库（使用你的 GitHub 账号）')
-        .keyword('star', 'unstar', '收藏', '取消收藏')
-        .tag('github', 'user')
-        .param('repo', { type: 'string', description: 'owner/repo (必填)' }, true)
-        .param('unstar', { type: 'boolean', description: '设为 true 则取消 star' })
-        .execute(async (args, ctx) => {
-          if (!ctx?.message) return '❌ 无法获取消息上下文';
-          const msg = ctx.message as Message;
-          const repo = args.repo as string;
-          if (!repo.includes('/')) return '❌ 格式应为 owner/repo';
-
-          const oauthClient = await this.getOAuthClient(msg.$adapter, msg.$sender.id);
-          if (!oauthClient) {
-            return '❌ 你还没有绑定 GitHub 账号，star 需要使用你自己的身份\n💡 使用 /github bind 绑定';
-          }
-
-          if (args.unstar) {
-            const r = await oauthClient.unstarRepo(repo);
-            return r.ok || r.status === 204 ? `✅ 已取消 star: ${repo}` : `❌ 操作失败: ${JSON.stringify(r.data)}`;
-          } else {
-            const r = await oauthClient.starRepo(repo);
-            return r.ok || r.status === 204 ? `⭐ 已 star: ${repo}` : `❌ 操作失败: ${JSON.stringify(r.data)}`;
-          }
-        }),
-    );
-
-    // --- GitHub Fork (用户级操作) ---
-    this.addTool(
-      new ZhinTool('github_fork')
-        .desc('Fork 一个仓库到你的 GitHub 账号')
-        .keyword('fork', '复刻')
-        .tag('github', 'user')
-        .param('repo', { type: 'string', description: 'owner/repo (必填)' }, true)
-        .execute(async (args, ctx) => {
-          if (!ctx?.message) return '❌ 无法获取消息上下文';
-          const msg = ctx.message as Message;
-          const repo = args.repo as string;
-          if (!repo.includes('/')) return '❌ 格式应为 owner/repo';
-
-          const oauthClient = await this.getOAuthClient(msg.$adapter, msg.$sender.id);
-          if (!oauthClient) {
-            return '❌ 你还没有绑定 GitHub 账号，fork 需要使用你自己的身份\n💡 使用 /github bind 绑定';
-          }
-
-          const r = await oauthClient.forkRepo(repo);
-          return r.ok ? `🍴 已 fork: ${r.data.full_name}\n🔗 ${r.data.html_url}` : `❌ 操作失败: ${r.data?.message || JSON.stringify(r.data)}`;
-        }),
-    );
-
-    // --- Search ---
-    this.addTool(
-      new ZhinTool('github_search')
-        .desc('GitHub 搜索：在 issues/repos/code 中搜索')
-        .keyword('search', '搜索', '查找', 'github search')
-        .tag('github', 'search')
-        .param('action', { type: 'string', description: 'issues|repos|code', enum: ['issues', 'repos', 'code'] }, true)
-        .param('query', { type: 'string', description: '搜索关键词' }, true)
-        .param('limit', { type: 'number', description: '返回数量，默认 10' })
-        .execute(async (args) => {
-          const api = this.getAPI();
-          if (!api) return '❌ 没有可用的 GitHub bot';
-          const q = args.query as string;
-          const limit = (args.limit as number) || 10;
-
-          switch (args.action) {
-            case 'issues': {
-              const r = await api.searchIssues(q, limit);
-              if (!r.ok) return `❌ ${JSON.stringify(r.data)}`;
-              if (!r.data.items.length) return `📭 没有匹配的 Issue/PR`;
-              return `🔍 共 ${r.data.total_count} 条，显示前 ${r.data.items.length}:\n\n` +
-                r.data.items.map((i: any) =>
-                  `${i.pull_request ? '🔀' : '🐛'} ${i.repository_url.replace('https://api.github.com/repos/', '')}#${i.number}\n   ${i.title}\n   👤 ${i.user.login} | ${i.state}`
-                ).join('\n\n');
-            }
-            case 'repos': {
-              const r = await api.searchRepos(q, limit);
-              if (!r.ok) return `❌ ${JSON.stringify(r.data)}`;
-              if (!r.data.items.length) return `📭 没有匹配的仓库`;
-              return `🔍 共 ${r.data.total_count} 条，显示前 ${r.data.items.length}:\n\n` +
-                r.data.items.map((repo: any) =>
-                  `📦 ${repo.full_name}${repo.private ? ' 🔒' : ''}\n   ${repo.description || '(无描述)'}\n   ⭐ ${repo.stargazers_count} | 🍴 ${repo.forks_count} | 📝 ${repo.language || '?'}`
-                ).join('\n\n');
-            }
-            case 'code': {
-              const r = await api.searchCode(q, limit);
-              if (!r.ok) return `❌ ${JSON.stringify(r.data)}`;
-              if (!r.data.items.length) return `📭 没有匹配的代码`;
-              return `🔍 共 ${r.data.total_count} 条，显示前 ${r.data.items.length}:\n\n` +
-                r.data.items.map((c: any) =>
-                  `📄 ${c.repository.full_name}/${c.path}\n   🔗 ${c.html_url}`
-                ).join('\n\n');
-            }
-            default: return `❌ 未知搜索类型: ${args.action}`;
-          }
-        }),
-    );
-
-    // --- Label ---
-    this.addTool(
-      new ZhinTool('github_label')
-        .desc('GitHub 标签管理：查看/添加/移除 Issue/PR 标签')
-        .keyword('label', '标签', 'tag')
-        .tag('github', 'label')
-        .param('action', { type: 'string', description: 'list|add|remove', enum: ['list', 'add', 'remove'] }, true)
-        .param('repo', { type: 'string', description: 'owner/repo (必填)' }, true)
-        .param('number', { type: 'number', description: 'Issue/PR 编号 (add/remove 必填)' })
-        .param('labels', { type: 'string', description: '标签名，逗号分隔 (add/remove)' })
-        .execute(async (args) => {
-          const api = this.getAPI();
-          if (!api) return '❌ 没有可用的 GitHub bot';
-          const repo = args.repo as string;
-
-          switch (args.action) {
-            case 'list': {
-              const r = await api.listLabels(repo);
-              if (!r.ok) return `❌ ${JSON.stringify(r.data)}`;
-              if (!r.data.length) return `📭 仓库没有标签`;
-              return `🏷️ ${repo} 标签 (${r.data.length}):\n` +
-                r.data.map((l: any) => `  • ${l.name}${l.description ? ` — ${l.description}` : ''}`).join('\n');
-            }
-            case 'add': {
-              if (!args.number) return '❌ 请提供 Issue/PR 编号';
-              if (!args.labels) return '❌ 请提供标签名';
-              const labels = (args.labels as string).split(',').map(s => s.trim());
-              const r = await api.addLabels(repo, args.number as number, labels);
-              return r.ok ? `✅ 已添加标签: ${labels.join(', ')}` : `❌ ${JSON.stringify(r.data)}`;
-            }
-            case 'remove': {
-              if (!args.number) return '❌ 请提供 Issue/PR 编号';
-              if (!args.labels) return '❌ 请提供要移除的标签名';
-              const labels = (args.labels as string).split(',').map(s => s.trim());
-              const results: string[] = [];
-              for (const label of labels) {
-                const r = await api.removeLabel(repo, args.number as number, label);
-                results.push(r.ok ? `✅ ${label}` : `❌ ${label}: ${r.data?.message || 'failed'}`);
-              }
-              return results.join('\n');
-            }
-            default: return `❌ 未知操作: ${args.action}`;
-          }
-        }),
-    );
-
-    // --- Assign ---
-    this.addTool(
-      new ZhinTool('github_assign')
-        .desc('GitHub 指派管理：给 Issue/PR 添加/移除指派人')
-        .keyword('assign', '指派', '分配')
-        .tag('github', 'assign')
-        .param('action', { type: 'string', description: 'add|remove', enum: ['add', 'remove'] }, true)
-        .param('repo', { type: 'string', description: 'owner/repo (必填)' }, true)
-        .param('number', { type: 'number', description: 'Issue/PR 编号 (必填)' }, true)
-        .param('assignees', { type: 'string', description: '用户名，逗号分隔 (必填)' }, true)
-        .execute(async (args) => {
-          const api = this.getAPI();
-          if (!api) return '❌ 没有可用的 GitHub bot';
-          const repo = args.repo as string;
-          const num = args.number as number;
-          const assignees = (args.assignees as string).split(',').map(s => s.trim());
-
-          if (args.action === 'add') {
-            const r = await api.addAssignees(repo, num, assignees);
-            return r.ok ? `✅ 已指派: ${assignees.join(', ')}` : `❌ ${r.data?.message || JSON.stringify(r.data)}`;
-          } else {
-            const r = await api.removeAssignees(repo, num, assignees);
-            return r.ok ? `✅ 已移除指派: ${assignees.join(', ')}` : `❌ ${r.data?.message || JSON.stringify(r.data)}`;
-          }
-        }),
-    );
-
-    // --- File ---
-    this.addTool(
-      new ZhinTool('github_file')
-        .desc('读取 GitHub 仓库中的文件内容')
-        .keyword('file', '文件', '查看文件', '读取文件', 'cat')
-        .tag('github', 'file')
-        .param('repo', { type: 'string', description: 'owner/repo (必填)' }, true)
-        .param('path', { type: 'string', description: '文件路径 (必填)' }, true)
-        .param('ref', { type: 'string', description: '分支/tag/commit SHA (可选，默认主分支)' })
-        .execute(async (args) => {
-          const api = this.getAPI();
-          if (!api) return '❌ 没有可用的 GitHub bot';
-          const r = await api.getFileContent(args.repo as string, args.path as string, args.ref as string | undefined);
-          if (!r.ok) return `❌ ${r.data?.message || JSON.stringify(r.data)}`;
-
-          if (Array.isArray(r.data)) {
-            return `📂 ${args.path} (目录，${r.data.length} 项):\n` +
-              r.data.map((f: any) => `  ${f.type === 'dir' ? '📁' : '📄'} ${f.name}`).join('\n');
-          }
-
-          if (r.data.type === 'file' && r.data.content) {
-            const decoded = Buffer.from(r.data.content, 'base64').toString('utf-8');
-            const maxLen = 3000;
-            const truncated = decoded.length > maxLen;
-            return `📄 ${r.data.path} (${r.data.size} bytes)\n\n${decoded.slice(0, maxLen)}${truncated ? `\n\n... (截断，共 ${decoded.length} 字符)` : ''}`;
-          }
-
-          return `📄 ${r.data.path} — ${r.data.type} (${r.data.size} bytes)\n🔗 ${r.data.html_url}`;
-        }),
-    );
-
-    // --- Commits ---
-    this.addTool(
-      new ZhinTool('github_commits')
-        .desc('GitHub 提交查询：列出提交记录或对比两个分支')
-        .keyword('commit', '提交', '历史', 'log', 'compare', '对比')
-        .tag('github', 'commits')
-        .param('action', { type: 'string', description: 'list|compare', enum: ['list', 'compare'] }, true)
-        .param('repo', { type: 'string', description: 'owner/repo (必填)' }, true)
-        .param('sha', { type: 'string', description: '分支/SHA (list)' })
-        .param('path', { type: 'string', description: '按文件路径过滤 (list)' })
-        .param('base', { type: 'string', description: '基准分支 (compare)' })
-        .param('head', { type: 'string', description: '目标分支 (compare)' })
-        .param('limit', { type: 'number', description: '返回数量，默认 10' })
-        .execute(async (args) => {
-          const api = this.getAPI();
-          if (!api) return '❌ 没有可用的 GitHub bot';
-          const repo = args.repo as string;
-
-          if (args.action === 'list') {
-            const r = await api.listCommits(repo, args.sha as string | undefined, args.path as string | undefined, (args.limit as number) || 10);
-            if (!r.ok) return `❌ ${JSON.stringify(r.data)}`;
-            if (!r.data.length) return '📭 没有找到提交记录';
-            return r.data.map((c: any) =>
-              `• ${c.sha.substring(0, 7)} ${c.commit.message.split('\n')[0]}\n  👤 ${c.commit.author?.name || '?'} | 📅 ${c.commit.author?.date?.split('T')[0] || '?'}`
-            ).join('\n\n');
-          } else {
-            if (!args.base || !args.head) return '❌ compare 需要 base 和 head 参数';
-            const r = await api.compareCommits(repo, args.base as string, args.head as string);
-            if (!r.ok) return `❌ ${r.data?.message || JSON.stringify(r.data)}`;
-            const d = r.data;
-            return [
-              `🔀 ${args.base} ← ${args.head}`,
-              `📊 ${d.status} | ${d.ahead_by} ahead, ${d.behind_by} behind`,
-              `📝 ${d.total_commits} commits | ${d.files?.length || 0} files changed`,
-              d.commits?.length ? '\n最近提交:\n' + d.commits.slice(0, 5).map((c: any) =>
-                `  • ${c.sha.substring(0, 7)} ${c.commit.message.split('\n')[0]}`
-              ).join('\n') : '',
-            ].filter(Boolean).join('\n');
-          }
-        }),
-    );
-
-    // --- Edit (Issue/PR) ---
-    this.addTool(
-      new ZhinTool('github_edit')
-        .desc('编辑 GitHub Issue 或 PR 的标题、正文、状态')
-        .keyword('edit', '编辑', '修改', 'update', '更新')
-        .tag('github', 'edit')
-        .param('type', { type: 'string', description: 'issue|pr', enum: ['issue', 'pr'] }, true)
-        .param('repo', { type: 'string', description: 'owner/repo (必填)' }, true)
-        .param('number', { type: 'number', description: 'Issue/PR 编号 (必填)' }, true)
-        .param('title', { type: 'string', description: '新标题' })
-        .param('body', { type: 'string', description: '新正文' })
-        .param('state', { type: 'string', description: 'open|closed' })
-        .execute(async (args) => {
-          const api = this.getAPI();
-          if (!api) return '❌ 没有可用的 GitHub bot';
-          const repo = args.repo as string;
-          const num = args.number as number;
-
-          const data: any = {};
-          if (args.title) data.title = args.title;
-          if (args.body) data.body = args.body;
-          if (args.state) data.state = args.state;
-
-          if (!Object.keys(data).length) return '❌ 请至少提供一个要修改的字段 (title/body/state)';
-
-          const r = args.type === 'pr'
-            ? await api.updatePR(repo, num, data)
-            : await api.updateIssue(repo, num, data);
-
-          if (!r.ok) return `❌ ${r.data?.message || JSON.stringify(r.data)}`;
-          return `✅ ${args.type === 'pr' ? 'PR' : 'Issue'} #${num} 已更新\n🔗 ${r.data.html_url}`;
-        }),
-    );
-
-    this.plugin.logger.debug('GitHub 工具已注册: pr, issue, repo, search, label, assign, file, commits, edit, subscribe, unsubscribe, subscriptions, bind, unbind, whoami, star, fork');
-  }
-
 
   // ── 通知推送 ───────────────────────────────────────────────────────