@zhin.js/adapter-github 0.1.20 → 0.1.21

package/src/api.ts

@@ -0,0 +1,353 @@
+/**
+ * GitHub REST API 客户端
+ *
+ * 两种认证方式：
+ *  1. GitHub App (JWT): app_id + private_key → JWT → Installation Access Token
+ *  2. OAuth User: access_token → 以用户身份调用 API
+ *
+ * 零外部依赖，使用 Node.js 原生 crypto + fetch
+ */
+
+import crypto from 'node:crypto';
+
+const API_BASE = 'https://api.github.com';
+const ACCEPT = 'application/vnd.github+json';
+const API_VERSION = '2022-11-28';
+
+// ── JWT ──────────────────────────────────────────────────────────────
+
+function createAppJWT(appId: number, privateKey: string): string {
+  const now = Math.floor(Date.now() / 1000);
+  const header = Buffer.from(JSON.stringify({ alg: 'RS256', typ: 'JWT' })).toString('base64url');
+  const payload = Buffer.from(JSON.stringify({
+    iss: appId,
+    iat: now - 60,
+    exp: now + 600,
+  })).toString('base64url');
+
+  const sign = crypto.createSign('RSA-SHA256');
+  sign.update(`${header}.${payload}`);
+  const signature = sign.sign(privateKey, 'base64url');
+
+  return `${header}.${payload}.${signature}`;
+}
+
+// ── API Client ───────────────────────────────────────────────────────
+
+export class GitHubAPI {
+  private installationToken: string | null = null;
+  private tokenExpiresAt = 0;
+  private _user: string | null = null;
+
+  constructor(
+    private appId: number,
+    private privateKey: string,
+    private installationId?: number,
+  ) {}
+
+  get authenticatedUser() { return this._user; }
+
+  private async getToken(): Promise<string> {
+    if (this.installationToken && Date.now() < this.tokenExpiresAt - 60_000) {
+      return this.installationToken;
+    }
+
+    const jwt = createAppJWT(this.appId, this.privateKey);
+
+    if (!this.installationId) {
+      const res = await fetch(`${API_BASE}/app/installations`, {
+        headers: { Authorization: `Bearer ${jwt}`, Accept: ACCEPT, 'X-GitHub-Api-Version': API_VERSION },
+      });
+      if (!res.ok) throw new Error(`获取 installations 失败: ${res.status} ${await res.text()}`);
+      const installations = await res.json() as any[];
+      if (!installations.length) throw new Error('此 GitHub App 没有任何 installation');
+      this.installationId = installations[0].id;
+    }
+
+    const res = await fetch(`${API_BASE}/app/installations/${this.installationId}/access_tokens`, {
+      method: 'POST',
+      headers: { Authorization: `Bearer ${jwt}`, Accept: ACCEPT, 'X-GitHub-Api-Version': API_VERSION },
+    });
+    if (!res.ok) throw new Error(`获取 installation token 失败: ${res.status} ${await res.text()}`);
+    const data = await res.json() as { token: string; expires_at: string };
+    this.installationToken = data.token;
+    this.tokenExpiresAt = new Date(data.expires_at).getTime();
+    return this.installationToken;
+  }
+
+  async request<T = any>(method: string, path: string, body?: any): Promise<{ ok: boolean; status: number; data: T }> {
+    const token = await this.getToken();
+    const url = path.startsWith('http') ? path : `${API_BASE}${path}`;
+    const res = await fetch(url, {
+      method,
+      headers: {
+        Authorization: `Bearer ${token}`,
+        Accept: ACCEPT,
+        'X-GitHub-Api-Version': API_VERSION,
+        ...(body ? { 'Content-Type': 'application/json' } : {}),
+      },
+      body: body ? JSON.stringify(body) : undefined,
+    });
+    const text = await res.text();
+    let data: any;
+    try { data = JSON.parse(text); } catch { data = text; }
+    return { ok: res.ok, status: res.status, data };
+  }
+
+  private async get<T = any>(path: string) { return this.request<T>('GET', path); }
+  private async post<T = any>(path: string, body?: any) { return this.request<T>('POST', path, body); }
+  private async patch<T = any>(path: string, body?: any) { return this.request<T>('PATCH', path, body); }
+  private async put<T = any>(path: string, body?: any) { return this.request<T>('PUT', path, body); }
+  private async del<T = any>(path: string, body?: any) { return this.request<T>('DELETE', path, body); }
+
+  // ── 连接验证 ──────────────────────────────────────────────────────
+
+  async verifyAuth(): Promise<{ ok: boolean; user: string; message: string }> {
+    try {
+      await this.getToken();
+      const jwt = createAppJWT(this.appId, this.privateKey);
+      const res = await fetch(`${API_BASE}/app`, {
+        headers: { Authorization: `Bearer ${jwt}`, Accept: ACCEPT, 'X-GitHub-Api-Version': API_VERSION },
+      });
+      if (!res.ok) return { ok: false, user: '', message: `App 认证失败: ${res.status}` };
+      const app = await res.json() as { name: string; slug: string };
+      this._user = `${app.slug}[bot]`;
+      return { ok: true, user: this._user, message: `GitHub App: ${app.name}` };
+    } catch (e: any) {
+      return { ok: false, user: '', message: e.message };
+    }
+  }
+
+  // ── Issue 评论 (聊天核心) ─────────────────────────────────────────
+
+  async createIssueComment(repo: string, issueNumber: number, body: string) {
+    return this.post<{ id: number; html_url: string }>(`/repos/${repo}/issues/${issueNumber}/comments`, { body });
+  }
+
+  async deleteIssueComment(repo: string, commentId: number) {
+    return this.del(`/repos/${repo}/issues/comments/${commentId}`);
+  }
+
+  async createPRComment(repo: string, prNumber: number, body: string) {
+    return this.createIssueComment(repo, prNumber, body);
+  }
+
+  async deletePRReviewComment(repo: string, commentId: number) {
+    return this.del(`/repos/${repo}/pulls/comments/${commentId}`);
+  }
+
+  // ── Pull Requests ─────────────────────────────────────────────────
+
+  async listPRs(repo: string, state: string = 'open', limit: number = 15) {
+    return this.get<any[]>(`/repos/${repo}/pulls?state=${state}&per_page=${limit}`);
+  }
+
+  async getPR(repo: string, number: number) {
+    return this.get<any>(`/repos/${repo}/pulls/${number}`);
+  }
+
+  async getPRDiff(repo: string, number: number): Promise<{ ok: boolean; data: string }> {
+    const token = await this.getToken();
+    const res = await fetch(`${API_BASE}/repos/${repo}/pulls/${number}`, {
+      headers: {
+        Authorization: `Bearer ${token}`,
+        Accept: 'application/vnd.github.diff',
+        'X-GitHub-Api-Version': API_VERSION,
+      },
+    });
+    return { ok: res.ok, data: await res.text() };
+  }
+
+  async mergePR(repo: string, number: number, method: string = 'squash') {
+    return this.put<any>(`/repos/${repo}/pulls/${number}/merge`, { merge_method: method });
+  }
+
+  async createPR(repo: string, title: string, body: string, head: string, base: string = 'main') {
+    return this.post<any>(`/repos/${repo}/pulls`, { title, body, head, base });
+  }
+
+  async createPRReview(repo: string, number: number, event: 'APPROVE' | 'REQUEST_CHANGES' | 'COMMENT', body?: string) {
+    return this.post<any>(`/repos/${repo}/pulls/${number}/reviews`, { event, body: body || '' });
+  }
+
+  async closePR(repo: string, number: number) {
+    return this.patch<any>(`/repos/${repo}/pulls/${number}`, { state: 'closed' });
+  }
+
+  // ── Issues ────────────────────────────────────────────────────────
+
+  async listIssues(repo: string, state: string = 'open', limit: number = 15) {
+    return this.get<any[]>(`/repos/${repo}/issues?state=${state}&per_page=${limit}&direction=desc`);
+  }
+
+  async getIssue(repo: string, number: number) {
+    return this.get<any>(`/repos/${repo}/issues/${number}`);
+  }
+
+  async createIssue(repo: string, title: string, body?: string, labels?: string[]) {
+    return this.post<any>(`/repos/${repo}/issues`, { title, body, labels });
+  }
+
+  async closeIssue(repo: string, number: number) {
+    return this.patch<any>(`/repos/${repo}/issues/${number}`, { state: 'closed', state_reason: 'completed' });
+  }
+
+  // ── Repository ────────────────────────────────────────────────────
+
+  async getRepo(repo: string) {
+    return this.get<any>(`/repos/${repo}`);
+  }
+
+  async listBranches(repo: string, limit: number = 30) {
+    return this.get<any[]>(`/repos/${repo}/branches?per_page=${limit}`);
+  }
+
+  async listReleases(repo: string, limit: number = 10) {
+    return this.get<any[]>(`/repos/${repo}/releases?per_page=${limit}`);
+  }
+
+  async listWorkflowRuns(repo: string, limit: number = 10) {
+    return this.get<{ total_count: number; workflow_runs: any[] }>(`/repos/${repo}/actions/runs?per_page=${limit}`);
+  }
+
+  // ── Search ───────────────────────────────────────────────────────
+
+  async searchIssues(query: string, limit: number = 15) {
+    return this.get<{ total_count: number; items: any[] }>(`/search/issues?q=${encodeURIComponent(query)}&per_page=${limit}`);
+  }
+
+  async searchRepos(query: string, limit: number = 15) {
+    return this.get<{ total_count: number; items: any[] }>(`/search/repositories?q=${encodeURIComponent(query)}&per_page=${limit}`);
+  }
+
+  async searchCode(query: string, limit: number = 15) {
+    return this.get<{ total_count: number; items: any[] }>(`/search/code?q=${encodeURIComponent(query)}&per_page=${limit}`);
+  }
+
+  // ── Labels ───────────────────────────────────────────────────────
+
+  async listLabels(repo: string) {
+    return this.get<any[]>(`/repos/${repo}/labels?per_page=100`);
+  }
+
+  async addLabels(repo: string, issueNumber: number, labels: string[]) {
+    return this.post<any[]>(`/repos/${repo}/issues/${issueNumber}/labels`, { labels });
+  }
+
+  async removeLabel(repo: string, issueNumber: number, label: string) {
+    return this.del(`/repos/${repo}/issues/${issueNumber}/labels/${encodeURIComponent(label)}`);
+  }
+
+  // ── Assignees ────────────────────────────────────────────────────
+
+  async addAssignees(repo: string, issueNumber: number, assignees: string[]) {
+    return this.post<any>(`/repos/${repo}/issues/${issueNumber}/assignees`, { assignees });
+  }
+
+  async removeAssignees(repo: string, issueNumber: number, assignees: string[]) {
+    return this.del<any>(`/repos/${repo}/issues/${issueNumber}/assignees`, { assignees });
+  }
+
+  // ── File Content ─────────────────────────────────────────────────
+
+  async getFileContent(repo: string, filePath: string, ref?: string) {
+    const qs = ref ? `?ref=${encodeURIComponent(ref)}` : '';
+    return this.get<any>(`/repos/${repo}/contents/${filePath}${qs}`);
+  }
+
+  // ── Commits ──────────────────────────────────────────────────────
+
+  async listCommits(repo: string, sha?: string, filePath?: string, limit: number = 15) {
+    const params = new URLSearchParams({ per_page: String(limit) });
+    if (sha) params.set('sha', sha);
+    if (filePath) params.set('path', filePath);
+    return this.get<any[]>(`/repos/${repo}/commits?${params}`);
+  }
+
+  async compareCommits(repo: string, base: string, head: string) {
+    return this.get<any>(`/repos/${repo}/compare/${encodeURIComponent(base)}...${encodeURIComponent(head)}`);
+  }
+
+  // ── Update Issue / PR ────────────────────────────────────────────
+
+  async updateIssue(repo: string, number: number, data: { title?: string; body?: string; state?: string; labels?: string[]; assignees?: string[] }) {
+    return this.patch<any>(`/repos/${repo}/issues/${number}`, data);
+  }
+
+  async updatePR(repo: string, number: number, data: { title?: string; body?: string; state?: string; base?: string }) {
+    return this.patch<any>(`/repos/${repo}/pulls/${number}`, data);
+  }
+}
+
+// ── OAuth Token Exchange ─────────────────────────────────────────────
+
+export async function exchangeOAuthCode(
+  clientId: string,
+  clientSecret: string,
+  code: string,
+): Promise<{ access_token: string; scope: string; token_type: string }> {
+  const res = await fetch('https://github.com/login/oauth/access_token', {
+    method: 'POST',
+    headers: { Accept: 'application/json', 'Content-Type': 'application/json' },
+    body: JSON.stringify({ client_id: clientId, client_secret: clientSecret, code }),
+  });
+  if (!res.ok) throw new Error(`OAuth token exchange failed: ${res.status}`);
+  const data = await res.json() as any;
+  if (data.error) throw new Error(`OAuth error: ${data.error_description || data.error}`);
+  return data;
+}
+
+// ── OAuth User API Client ────────────────────────────────────────────
+
+type ApiResult<T = any> = { ok: boolean; status: number; data: T };
+
+export class GitHubOAuthClient {
+  constructor(private accessToken: string) {}
+
+  async request<T = any>(method: string, path: string, body?: any): Promise<ApiResult<T>> {
+    const url = path.startsWith('http') ? path : `${API_BASE}${path}`;
+    const res = await fetch(url, {
+      method,
+      headers: {
+        Authorization: `Bearer ${this.accessToken}`,
+        Accept: ACCEPT,
+        'X-GitHub-Api-Version': API_VERSION,
+        ...(body ? { 'Content-Type': 'application/json' } : {}),
+      },
+      body: body ? JSON.stringify(body) : undefined,
+    });
+    const text = await res.text();
+    let data: any;
+    try { data = JSON.parse(text); } catch { data = text; }
+    return { ok: res.ok, status: res.status, data };
+  }
+
+  async getUser(): Promise<ApiResult<{ login: string; id: number; name: string | null; avatar_url: string }>> {
+    return this.request('GET', '/user');
+  }
+
+  async starRepo(repo: string): Promise<ApiResult> {
+    return this.request('PUT', `/user/starred/${repo}`);
+  }
+
+  async unstarRepo(repo: string): Promise<ApiResult> {
+    return this.request('DELETE', `/user/starred/${repo}`);
+  }
+
+  async isStarred(repo: string): Promise<boolean> {
+    const res = await this.request('GET', `/user/starred/${repo}`);
+    return res.status === 204;
+  }
+
+  async forkRepo(repo: string): Promise<ApiResult> {
+    return this.request('POST', `/repos/${repo}/forks`);
+  }
+
+  async createIssue(repo: string, title: string, body?: string, labels?: string[]): Promise<ApiResult> {
+    return this.request('POST', `/repos/${repo}/issues`, { title, body, labels });
+  }
+
+  async createPR(repo: string, title: string, body: string, head: string, base: string = 'main'): Promise<ApiResult> {
+    return this.request('POST', `/repos/${repo}/pulls`, { title, body, head, base });
+  }
+}

package/src/bot.ts

@@ -0,0 +1,187 @@
+/**
+ * GitHub Bot 实现
+ */
+import path from 'node:path';
+import fs from 'node:fs';
+import {
+  Bot,
+  Message,
+  SendOptions,
+  SendContent,
+  segment,
+  type MessageSegment,
+} from 'zhin.js';
+import type {
+  GitHubBotConfig,
+  IssueCommentPayload,
+  PRReviewCommentPayload,
+  PRReviewPayload,
+} from './types.js';
+import { buildChannelId, parseChannelId } from './types.js';
+import type { GitHubAdapter } from './adapter.js';
+import { GitHubAPI } from './api.js';
+
+function resolvePrivateKey(raw: string): string {
+  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 function parseMarkdown(md: string): MessageSegment[] {
+  const segments: MessageSegment[] = [];
+  const mentionRe = /@(\w[-\w]*)/g;
+  let lastIdx = 0;
+  let match: RegExpExecArray | null;
+  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 } }];
+}
+
+export function toMarkdown(content: SendContent): string {
+  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('');
+}
+
+export class GitHubBot implements Bot<GitHubBotConfig, IssueCommentPayload> {
+  $connected = false;
+  api: GitHubAPI;
+
+  get $id() { return this.$config.name; }
+
+  get logger() {
+    return this.adapter.plugin.logger;
+  }
+
+  constructor(public adapter: GitHubAdapter, public $config: GitHubBotConfig) {
+    const privateKey = resolvePrivateKey($config.private_key);
+    this.api = new GitHubAPI($config.app_id, privateKey, $config.installation_id);
+  }
+
+  async $connect(): Promise<void> {
+    const result = await this.api.verifyAuth();
+    if (!result.ok) throw new Error(`GitHub 认证失败: ${result.message}`);
+    this.$connected = true;
+    this.logger.info(`GitHub bot ${this.$id} 已连接 — ${result.message}`);
+  }
+
+  async $disconnect(): Promise<void> {
+    this.$connected = false;
+    this.logger.info(`GitHub bot ${this.$id} 已断开`);
+  }
+
+  $formatMessage(payload: IssueCommentPayload): Message<IssueCommentPayload> {
+    const repo = payload.repository.full_name;
+    const number = payload.issue.number;
+    const isPR = 'pull_request' in (payload.issue as any);
+    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: SendContent, quote?: boolean | string): Promise<string> => {
+        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: PRReviewCommentPayload): Message<PRReviewCommentPayload> {
+    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: SendContent): Promise<string> => {
+        const r = await api.createPRComment(repo, number, toMarkdown(content));
+        return r.ok ? r.data.id.toString() : '';
+      },
+    });
+  }
+
+  formatPRReview(payload: PRReviewPayload): Message<PRReviewPayload> | null {
+    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: Record<string, string> = {
+      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: SendContent): Promise<string> => {
+        const r = await api.createPRComment(repo, number, toMarkdown(content));
+        return r.ok ? r.data.id.toString() : '';
+      },
+    });
+  }
+
+  async $sendMessage(options: SendOptions): Promise<string> {
+    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)}`);
+
+    this.logger.debug(`${this.$id} send → ${options.id}: ${text.slice(0, 80)}...`);
+    return r.data.id.toString();
+  }
+
+  async $recallMessage(id: string): Promise<void> {
+    this.logger.warn('$recallMessage 需要 repo 信息，请使用 message.$recall()');
+  }
+}

package/src/index.ts

@@ -0,0 +1,90 @@
+/**
+ * GitHub 适配器入口：类型扩展、模型、导出、注册
+ */
+import { usePlugin, type Plugin, type Context } from 'zhin.js';
+import { GitHubAdapter } from './adapter.js';
+
+declare module 'zhin.js' {
+  namespace Plugin {
+    interface Contexts {
+      router: import('@zhin.js/http').Router;
+    }
+  }
+  interface Adapters {
+    github: GitHubAdapter;
+  }
+  interface Models {
+    github_subscriptions: {
+      id: number;
+      repo: string;
+      events: import('./types.js').EventType[];
+      target_id: string;
+      target_type: 'private' | 'group' | 'channel';
+      adapter: string;
+      bot: string;
+    };
+    github_events: {
+      id: number;
+      repo: string;
+      event_type: string;
+      payload: any;
+    };
+    github_oauth_users: import('./types.js').GitHubOAuthUser;
+  }
+}
+
+export * from './types.js';
+export { GitHubBot, parseMarkdown, toMarkdown } from './bot.js';
+export { GitHubAdapter } from './adapter.js';
+
+const plugin = usePlugin();
+const { provide, defineModel, useContext, 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: {} },
+});
+
+defineModel('github_oauth_users', {
+  id: { type: 'integer', primary: true },
+  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 },
+});
+
+provide({
+  name: 'github',
+  description: 'GitHub Adapter — Issues/PRs as chat channels, full repo management via GitHub App',
+  mounted: async (p: Plugin) => {
+    const adapter = new GitHubAdapter(p);
+    await adapter.start();
+    return adapter;
+  },
+  dispose: async (adapter: GitHubAdapter) => {
+    await adapter.stop();
+  },
+} as Context<'github'>);
+
+useContext('router', 'github', (router, adapter) => {
+  adapter.setupWebhook(router);
+  adapter.setupOAuth(router);
+});
+
+logger.debug('GitHub 适配器已加载 (GitHub App 认证)');