@zhin.js/adapter-github 0.1.0

package/lib/index.js

@@ -0,0 +1,705 @@
+/**
+ * @zhin.js/adapter-github
+ *
+ * 把 GitHub 当聊天通道 — Issue/PR 评论区 = 群聊
+ * 通过 GitHub App 认证 (JWT → Installation Token)，纯 REST API 对接，零 CLI 依赖
+ *
+ * 查询 · 管理 · 通知 三合一
+ */
+import { Adapter, Message, usePlugin, ZhinTool, } from 'zhin.js';
+import { parseChannelId, buildChannelId } from './types.js';
+import { GitHubAPI } from './api.js';
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+// ============================================================================
+// Plugin 初始化
+// ============================================================================
+const plugin = usePlugin();
+const { provide, defineModel, useContext, root, logger } = plugin;
+defineModel('github_subscriptions', {
+    id: { type: 'integer', primary: true },
+    repo: { type: 'text', nullable: false },
+    events: { type: 'json', default: [] },
+    target_id: { type: 'text', nullable: false },
+    target_type: { type: 'text', nullable: false },
+    adapter: { type: 'text', nullable: false },
+    bot: { type: 'text', nullable: false },
+});
+defineModel('github_events', {
+    id: { type: 'integer', primary: true },
+    repo: { type: 'text', nullable: false },
+    event_type: { type: 'text', nullable: false },
+    payload: { type: 'json', default: {} },
+});
+const VALID_EVENTS = ['push', 'issue', 'star', 'fork', 'unstar', 'pull_request'];
+// ============================================================================
+// GitHubBot
+// ============================================================================
+function resolvePrivateKey(raw) {
+    if (raw.includes('-----BEGIN'))
+        return raw;
+    const resolved = path.resolve(raw);
+    if (fs.existsSync(resolved))
+        return fs.readFileSync(resolved, 'utf-8');
+    throw new Error(`private_key 既不是 PEM 内容也不是有效的文件路径: ${raw}`);
+}
+export class GitHubBot {
+    adapter;
+    $config;
+    $connected = false;
+    api;
+    get $id() { return this.$config.name; }
+    constructor(adapter, $config) {
+        this.adapter = adapter;
+        this.$config = $config;
+        const privateKey = resolvePrivateKey($config.private_key);
+        this.api = new GitHubAPI($config.app_id, privateKey, $config.installation_id);
+    }
+    async $connect() {
+        const result = await this.api.verifyAuth();
+        if (!result.ok)
+            throw new Error(`GitHub 认证失败: ${result.message}`);
+        this.$connected = true;
+        logger.info(`GitHub bot ${this.$id} 已连接 — ${result.message}`);
+    }
+    async $disconnect() {
+        this.$connected = false;
+        logger.info(`GitHub bot ${this.$id} 已断开`);
+    }
+    // ── Webhook → Message ──────────────────────────────────────────────
+    $formatMessage(payload) {
+        const repo = payload.repository.full_name;
+        const number = payload.issue.number;
+        const isPR = 'pull_request' in payload.issue;
+        const channelId = buildChannelId(repo, isPR ? 'pr' : 'issue', number);
+        const api = this.api;
+        const result = Message.from(payload, {
+            $id: payload.comment.id.toString(),
+            $adapter: 'github',
+            $bot: this.$config.name,
+            $sender: { id: payload.sender.login, name: payload.sender.login },
+            $channel: { id: channelId, type: 'group' },
+            $content: parseMarkdown(payload.comment.body),
+            $raw: payload.comment.body,
+            $timestamp: new Date(payload.comment.created_at).getTime(),
+            $recall: async () => { await api.deleteIssueComment(repo, payload.comment.id); },
+            $reply: async (content, quote) => {
+                const text = toMarkdown(content);
+                const finalBody = quote ? `> ${payload.comment.body.split('\n')[0]}\n\n${text}` : text;
+                const r = await api.createIssueComment(repo, number, finalBody);
+                return r.ok ? r.data.id.toString() : '';
+            },
+        });
+        return result;
+    }
+    formatPRReviewComment(payload) {
+        const repo = payload.repository.full_name;
+        const number = payload.pull_request.number;
+        const channelId = buildChannelId(repo, 'pr', number);
+        const api = this.api;
+        const body = payload.comment.path
+            ? `**${payload.comment.path}**\n${payload.comment.diff_hunk ? '```diff\n' + payload.comment.diff_hunk + '\n```\n' : ''}${payload.comment.body}`
+            : payload.comment.body;
+        return Message.from(payload, {
+            $id: payload.comment.id.toString(),
+            $adapter: 'github',
+            $bot: this.$config.name,
+            $sender: { id: payload.sender.login, name: payload.sender.login },
+            $channel: { id: channelId, type: 'group' },
+            $content: parseMarkdown(body),
+            $raw: body,
+            $timestamp: new Date(payload.comment.created_at).getTime(),
+            $recall: async () => { await api.deletePRReviewComment(repo, payload.comment.id); },
+            $reply: async (content) => {
+                const r = await api.createPRComment(repo, number, toMarkdown(content));
+                return r.ok ? r.data.id.toString() : '';
+            },
+        });
+    }
+    formatPRReview(payload) {
+        if (!payload.review.body)
+            return null;
+        const repo = payload.repository.full_name;
+        const number = payload.pull_request.number;
+        const channelId = buildChannelId(repo, 'pr', number);
+        const api = this.api;
+        const stateLabel = {
+            approved: '✅ APPROVED', changes_requested: '🔄 CHANGES REQUESTED',
+            commented: '💬 COMMENTED', dismissed: '❌ DISMISSED',
+        };
+        const body = `**[${stateLabel[payload.review.state] || payload.review.state}]**\n${payload.review.body}`;
+        return Message.from(payload, {
+            $id: payload.review.id.toString(),
+            $adapter: 'github',
+            $bot: this.$config.name,
+            $sender: { id: payload.sender.login, name: payload.sender.login },
+            $channel: { id: channelId, type: 'group' },
+            $content: parseMarkdown(body),
+            $raw: body,
+            $timestamp: new Date(payload.review.submitted_at).getTime(),
+            $recall: async () => { },
+            $reply: async (content) => {
+                const r = await api.createPRComment(repo, number, toMarkdown(content));
+                return r.ok ? r.data.id.toString() : '';
+            },
+        });
+    }
+    // ── 发送 & 撤回 ───────────────────────────────────────────────────
+    async $sendMessage(options) {
+        const parsed = parseChannelId(options.id);
+        if (!parsed)
+            throw new Error(`无效的 GitHub channel ID: ${options.id}`);
+        const text = toMarkdown(options.content);
+        const r = parsed.type === 'issue'
+            ? await this.api.createIssueComment(parsed.repo, parsed.number, text)
+            : await this.api.createPRComment(parsed.repo, parsed.number, text);
+        if (!r.ok)
+            throw new Error(`发送失败: ${JSON.stringify(r.data)}`);
+        logger.debug(`${this.$id} send → ${options.id}: ${text.slice(0, 80)}...`);
+        return r.data.id.toString();
+    }
+    async $recallMessage(id) {
+        logger.warn('$recallMessage 需要 repo 信息，请使用 message.$recall()');
+    }
+}
+// ============================================================================
+// GitHubAdapter
+// ============================================================================
+class GitHubAdapter extends Adapter {
+    constructor(plugin) {
+        super(plugin, 'github', []);
+    }
+    createBot(config) {
+        return new GitHubBot(this, config);
+    }
+    async start() {
+        this.registerGitHubTools();
+        this.declareSkill({
+            description: 'GitHub 全功能适配器：Issue/PR 评论即聊天通道，仓库管理（PR合并/创建/Review、Issue管理）、信息查询（Star/CI/Release/Branch）、Webhook 事件通知订阅。通过 GitHub App 认证，纯 REST API。',
+            keywords: [
+                'github', 'pr', 'pull request', 'issue', 'merge', 'review',
+                'star', 'fork', 'branch', 'release', 'CI', 'workflow', 'repo',
+                '合并', '仓库', '拉取请求', '代码审查',
+            ],
+            tags: ['github', 'development', 'git', 'ci-cd'],
+            conventions: 'channel ID 格式 owner/repo/issues/N 或 owner/repo/pull/N。repo 参数不填则需要手动指定。',
+        });
+        await super.start();
+    }
+    /** 获取第一个可用 bot 的 API (工具用) */
+    getAPI() {
+        const bot = this.bots.values().next().value;
+        return bot?.api || null;
+    }
+    // ── Webhook 路由 (由 useContext('router') 注入) ────────────────────
+    setupWebhook(router) {
+        router.post('/api/github/webhook', async (ctx) => {
+            try {
+                const eventName = ctx.request.headers['x-github-event'];
+                const signature = ctx.request.headers['x-hub-signature-256'];
+                const payload = ctx.body;
+                logger.info(`GitHub Webhook: ${eventName} - ${payload?.repository?.full_name}`);
+                if (signature) {
+                    let verified = false;
+                    for (const bot of this.bots.values()) {
+                        const secret = bot.$config.webhook_secret;
+                        if (!secret)
+                            continue;
+                        const expected = `sha256=${crypto.createHmac('sha256', secret).update(JSON.stringify(ctx.body)).digest('hex')}`;
+                        if (signature === expected) {
+                            verified = true;
+                            break;
+                        }
+                    }
+                    if (!verified) {
+                        const hasSecret = Array.from(this.bots.values()).some(b => b.$config.webhook_secret);
+                        if (hasSecret) {
+                            logger.warn('GitHub Webhook 签名验证失败');
+                            ctx.status = 401;
+                            ctx.body = { error: 'Invalid signature' };
+                            return;
+                        }
+                    }
+                }
+                if (!payload?.repository) {
+                    ctx.status = 400;
+                    ctx.body = { error: 'Invalid payload' };
+                    return;
+                }
+                const db = root.inject('database');
+                const eventsModel = db?.models?.get('github_events');
+                if (eventsModel) {
+                    await eventsModel.insert({ id: Date.now(), repo: payload.repository.full_name, event_type: eventName, payload });
+                }
+                const bot = this.bots.values().next().value;
+                if (bot) {
+                    let message = null;
+                    if (eventName === 'issue_comment' && payload.action === 'created') {
+                        message = bot.$formatMessage(payload);
+                    }
+                    else if (eventName === 'pull_request_review_comment' && payload.action === 'created') {
+                        message = bot.formatPRReviewComment(payload);
+                    }
+                    else if (eventName === 'pull_request_review' && payload.action === 'submitted') {
+                        message = bot.formatPRReview(payload);
+                    }
+                    if (message) {
+                        const botUser = bot.api.authenticatedUser;
+                        if (botUser && message.$sender.id === botUser) {
+                            logger.debug(`忽略 bot 自身评论: ${message.$sender.id}`);
+                        }
+                        else {
+                            this.emit('message.receive', message);
+                        }
+                    }
+                }
+                await this.dispatchNotification(eventName, payload);
+                ctx.status = 200;
+                ctx.body = { message: 'OK' };
+            }
+            catch (error) {
+                logger.error('Webhook 处理失败:', error);
+                ctx.status = 500;
+                ctx.body = { error: 'Internal server error' };
+            }
+        });
+        logger.info('GitHub Webhook: POST /api/github/webhook');
+    }
+    // ── GitHub 管理工具 ────────────────────────────────────────────────
+    registerGitHubTools() {
+        // --- 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;
+            const repo = args.repo;
+            const num = args.number;
+            switch (action) {
+                case 'list': {
+                    const r = await api.listPRs(repo, args.state || 'open');
+                    if (!r.ok)
+                        return `❌ ${JSON.stringify(r.data)}`;
+                    if (!r.data.length)
+                        return `📭 没有 ${args.state || 'open'} 状态的 PR`;
+                    return r.data.map((p) => `#${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 || '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, args.body || '', args.head, args.base || '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, args.body || 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;
+            const repo = args.repo;
+            const num = args.number;
+            switch (action) {
+                case 'list': {
+                    const r = await api.listIssues(repo, args.state || 'open');
+                    if (!r.ok)
+                        return `❌ ${JSON.stringify(r.data)}`;
+                    // 过滤掉 PR (GitHub API 的 issues 接口也返回 PR)
+                    const issues = r.data.filter((i) => !i.pull_request);
+                    if (!issues.length)
+                        return `📭 没有 ${args.state || 'open'} 状态的 Issue`;
+                    return issues.map((i) => {
+                        const labels = i.labels?.map((l) => 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) => 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.split(',').map(s => s.trim()) : undefined;
+                    const r = await api.createIssue(repo, args.title, args.body || 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);
+                    return r.ok ? `✅ 已评论 Issue #${num}` : `❌ ${r.data?.message || 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;
+            const repo = args.repo;
+            const limit = args.limit || 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) => `  • ${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) => `${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) => {
+                        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;
+            const repoStr = repo;
+            if (!repoStr.includes('/'))
+                return '❌ 格式应为 owner/repo';
+            const parsed = [];
+            for (const e of evts) {
+                const n = e.toLowerCase();
+                if (n === 'pr')
+                    parsed.push('pull_request');
+                else if (VALID_EVENTS.includes(n))
+                    parsed.push(n);
+                else
+                    return `❌ 不支持: ${e}`;
+            }
+            const subEvents = parsed.length > 0 ? parsed : VALID_EVENTS;
+            const db = root.inject('database');
+            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);
+            if (existing) {
+                await model.update({ events: subEvents }).where({ id: existing.id });
+                return `✅ 已更新订阅 ${repoStr}\n📢 ${subEvents.join(', ')}`;
+            }
+            const { repo: _r, ...rest } = where;
+            await model.insert({ id: Date.now(), repo: repoStr, events: subEvents, ...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;
+            const db = root.inject('database');
+            const model = db?.models?.get('github_subscriptions');
+            if (!model)
+                return '❌ 数据库未就绪';
+            const [sub] = await model.select().where({ repo: repo, 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;
+            const db = root.inject('database');
+            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, i) => `${i + 1}. ${s.repo}\n   📢 ${(s.events || []).join(', ')}`).join('\n\n');
+        }));
+        logger.debug('GitHub 工具已注册: pr, issue, repo, subscribe, unsubscribe, subscriptions');
+    }
+    // ── 通知推送 ───────────────────────────────────────────────────────
+    async dispatchNotification(eventName, payload) {
+        let eventType = null;
+        switch (eventName) {
+            case 'push':
+                eventType = 'push';
+                break;
+            case 'issues':
+                eventType = 'issue';
+                break;
+            case 'star':
+                eventType = payload.action === 'deleted' ? 'unstar' : 'star';
+                break;
+            case 'fork':
+                eventType = 'fork';
+                break;
+            case 'pull_request':
+                eventType = 'pull_request';
+                break;
+        }
+        if (!eventType)
+            return;
+        const repo = payload.repository.full_name;
+        const db = root.inject('database');
+        const model = db?.models?.get('github_subscriptions');
+        if (!model)
+            return;
+        const subs = await model.select().where({ repo });
+        if (!subs?.length)
+            return;
+        const text = formatNotification(eventName, payload);
+        for (const sub of subs) {
+            const s = sub;
+            if (!s.events.includes(eventType))
+                continue;
+            try {
+                const adapter = root.inject(s.adapter);
+                if (adapter?.sendMessage) {
+                    await adapter.sendMessage({ context: s.adapter, bot: s.bot, id: s.target_id, type: s.target_type, content: text });
+                }
+            }
+            catch (e) {
+                logger.error(`通知推送失败 → ${s.adapter}:${s.target_id}`, e);
+            }
+        }
+    }
+}
+// ── 工具函数 ─────────────────────────────────────────────────────────
+function parseMarkdown(md) {
+    const segments = [];
+    const mentionRe = /@(\w[-\w]*)/g;
+    let lastIdx = 0;
+    let match;
+    while ((match = mentionRe.exec(md)) !== null) {
+        if (match.index > lastIdx)
+            segments.push({ type: 'text', data: { text: md.slice(lastIdx, match.index) } });
+        segments.push({ type: 'at', data: { id: match[1], name: match[1], text: match[0] } });
+        lastIdx = match.index + match[0].length;
+    }
+    if (lastIdx < md.length)
+        segments.push({ type: 'text', data: { text: md.slice(lastIdx) } });
+    return segments.length ? segments : [{ type: 'text', data: { text: md } }];
+}
+function toMarkdown(content) {
+    if (!Array.isArray(content))
+        content = [content];
+    return content.map(seg => {
+        if (typeof seg === 'string')
+            return seg;
+        switch (seg.type) {
+            case 'text': return seg.data.text || '';
+            case 'at': return `@${seg.data.name || seg.data.id}`;
+            case 'image': return seg.data.url ? `![image](${seg.data.url})` : '[image]';
+            case 'link': return `[${seg.data.text || seg.data.url}](${seg.data.url})`;
+            default: return seg.data?.text || `[${seg.type}]`;
+        }
+    }).join('');
+}
+function formatNotification(event, p) {
+    const repo = p.repository.full_name;
+    const sender = p.sender.login;
+    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`;
+            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`;
+            }
+            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}`;
+        }
+        case 'star': {
+            const starred = p.action !== 'deleted';
+            return `${starred ? '⭐' : '💔'} ${repo}\n👤 ${sender} ${starred ? 'starred' : 'unstarred'}`;
+        }
+        case 'fork':
+            return `🍴 ${repo}\n👤 ${sender} forked → ${p.forkee.full_name}`;
+        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}`;
+        }
+        default:
+            return `📬 ${repo}\n${event} by ${sender}`;
+    }
+}
+// ============================================================================
+// 注册适配器
+// ============================================================================
+provide({
+    name: 'github',
+    description: 'GitHub Adapter — Issues/PRs as chat channels, full repo management via GitHub App',
+    mounted: async (p) => {
+        const adapter = new GitHubAdapter(p);
+        await adapter.start();
+        return adapter;
+    },
+    dispose: async (adapter) => {
+        await adapter.stop();
+    },
+});
+useContext('router', 'github', (router, adapter) => {
+    adapter.setupWebhook(router);
+});
+logger.info('GitHub 适配器已加载 (GitHub App 认证)');
+//# sourceMappingURL=index.js.map