@zhin.js/adapter-github 1.0.0 → 2.0.0

package/src/adapter.ts

@@ -3,9 +3,9 @@
  */
 import { formatCompact, Adapter, Message, Plugin } from 'zhin.js';
 import crypto from 'node:crypto';
-import { GitHubBot } from './bot.js';
+import { GitHubEndpoint } from './endpoint.js';
 import type { Router } from '@zhin.js/host-router';
-import type { GitHubBotConfig, EventType, GenericWebhookPayload, Subscription } from './types.js';
+import type { GitHubEndpointConfig, EventType, GenericWebhookPayload, Subscription } from './types.js';
 import type { GhClient } from './gh-client.js';
 import type { IssueCommentPayload, PRReviewCommentPayload, PRReviewPayload } from './types.js';
 
@@ -69,7 +69,9 @@ function formatNotification(event: string, p: GenericWebhookPayload): string {
   }
 }
 
-export class GitHubAdapter extends Adapter<GitHubBot> {
+export class GitHubAdapter extends Adapter<GitHubEndpoint> {
+  static override readonly capabilities = ['inbound', 'outbound'] as const;
+
   /** 轮询定时器 */
   private _pollTimer: ReturnType<typeof setInterval> | null = null;
   /** 每个 repo 的 ETag 缓存 */
@@ -83,8 +85,8 @@ export class GitHubAdapter extends Adapter<GitHubBot> {
     super(plugin, 'github', []);
   }
 
-  createBot(config: GitHubBotConfig): GitHubBot {
-    return new GitHubBot(this, config);
+  createEndpoint(config: GitHubEndpointConfig): GitHubEndpoint {
+    return new GitHubEndpoint(this, config);
   }
 
   async start(): Promise<void> {
@@ -96,10 +98,10 @@ export class GitHubAdapter extends Adapter<GitHubBot> {
     await super.stop();
   }
 
-  /** 获取第一个可用 bot 的 GhClient (工具用) */
+  /** 获取第一个可用 Endpoint 的 GhClient (工具用) */
   getAPI(): GhClient | null {
-    const bot = this.bots.values().next().value as GitHubBot | undefined;
-    return bot?.gh || null;
+    const endpoint = this.endpoints.values().next().value as GitHubEndpoint | undefined;
+    return endpoint?.gh || null;
   }
 
   /** 获取指定用户绑定的 GhClient；未绑定则返回 null */
@@ -114,7 +116,7 @@ export class GitHubAdapter extends Adapter<GitHubBot> {
     return base.withToken(record.access_token);
   }
 
-  /** 获取用户 API，若未绑定则降级为 bot 默认的 API */
+  /** 获取用户 API，若未绑定则降级为 Endpoint 默认的 API */
   async getUserOrDefaultAPI(platform?: string, platformUid?: string): Promise<GhClient | null> {
     if (platform && platformUid) {
       const userApi = await this.getUserAPI(platform, platformUid);
@@ -123,34 +125,34 @@ export class GitHubAdapter extends Adapter<GitHubBot> {
     return this.getAPI();
   }
 
-  /** 获取第一个 bot 的 client_id（App 认证时从 /app 自动获取） */
+  /** 获取第一个 Endpoint 的 client_id（App 认证时从 /app 自动获取） */
   getClientId(): string | null {
-    const bot = this.bots.values().next().value as GitHubBot | undefined;
-    return bot?.gh.clientId || null;
+    const endpoint = this.endpoints.values().next().value as GitHubEndpoint | undefined;
+    return endpoint?.gh.clientId || null;
   }
 
-  /** 获取第一个 bot 的 host 配置 */
+  /** 获取第一个 Endpoint 的 host 配置 */
   getHost(): string | undefined {
-    const bot = this.bots.values().next().value as GitHubBot | undefined;
-    return bot?.$config.host;
+    const endpoint = this.endpoints.values().next().value as GitHubEndpoint | undefined;
+    return endpoint?.$config.host;
   }
 
   /** 获取 App slug（用于生成安装链接） */
   getAppSlug(): string | null {
-    const bot = this.bots.values().next().value as GitHubBot | undefined;
-    return bot?.gh.appSlug || null;
+    const endpoint = this.endpoints.values().next().value as GitHubEndpoint | undefined;
+    return endpoint?.gh.appSlug || null;
   }
 
   /** 获取所有已发现的安装信息 */
   getInstallations() {
-    const bot = this.bots.values().next().value as GitHubBot | undefined;
-    return bot?.gh.installations || [];
+    const endpoint = this.endpoints.values().next().value as GitHubEndpoint | undefined;
+    return endpoint?.gh.installations || [];
   }
 
-  /** 第一个 bot 是否配置了 Webhook */
+  /** 第一个 Endpoint 是否配置了 Webhook */
   get hasWebhookConfig(): boolean {
-    const bot = this.bots.values().next().value as GitHubBot | undefined;
-    return !!bot?.$config.webhook_secret;
+    const endpoint = this.endpoints.values().next().value as GitHubEndpoint | undefined;
+    return !!endpoint?.$config.webhook_secret;
   }
 
   /** Webhook 是否已激活 */
@@ -162,13 +164,13 @@ export class GitHubAdapter extends Adapter<GitHubBot> {
 
   /** 在 router 上挂载 Webhook 路由（生产环境推荐） */
   setupWebhook(router: Router): void {
-    const bot = this.bots.values().next().value as GitHubBot | undefined;
-    if (!bot?.$config.webhook_secret) {
+    const endpoint = this.endpoints.values().next().value as GitHubEndpoint | undefined;
+    if (!endpoint?.$config.webhook_secret) {
       this.plugin.logger.warn(formatCompact( { op: 'webhook', ok: false, error: 'missing webhook_secret' }));
       return;
     }
-    const secret = bot.$config.webhook_secret;
-    const path = bot.$config.webhook_path || '/github/webhook';
+    const secret = endpoint.$config.webhook_secret;
+    const path = endpoint.$config.webhook_path || '/github/webhook';
 
     router.post(path, async (ctx) => {
       const signature = ctx.get('x-hub-signature-256') as string;
@@ -207,7 +209,7 @@ export class GitHubAdapter extends Adapter<GitHubBot> {
 
   /** 处理 Webhook 推送的事件 */
   async handleWebhookPayload(event: string, payload: any): Promise<void> {
-    const bot = this.bots.values().next().value as GitHubBot | undefined;
+    const endpoint = this.endpoints.values().next().value as GitHubEndpoint | undefined;
     const repo = payload.repository?.full_name;
 
     this.plugin.logger.debug(`Webhook: ${event}${payload.action ? `.${payload.action}` : ''} ${repo || ''}`);
@@ -222,26 +224,26 @@ export class GitHubAdapter extends Adapter<GitHubBot> {
     }
 
     // 处理消息类事件（Issue/PR 评论）
-    if (bot && event === 'issue_comment' && payload.action === 'created' && payload.comment) {
-      const message = bot.$formatMessage(payload as IssueCommentPayload);
-      const botUser = bot.gh.authenticatedUser;
+    if (endpoint && event === 'issue_comment' && payload.action === 'created' && payload.comment) {
+      const message = endpoint.$formatMessage(payload as IssueCommentPayload);
+      const botUser = endpoint.gh.authenticatedUser;
       if (!(botUser && message.$sender.id === botUser)) {
         this.emit('message.receive', message);
       }
     }
 
-    if (bot && event === 'pull_request_review_comment' && payload.action === 'created' && payload.comment) {
-      const message = bot.formatPRReviewComment(payload as PRReviewCommentPayload);
-      const botUser = bot.gh.authenticatedUser;
+    if (endpoint && event === 'pull_request_review_comment' && payload.action === 'created' && payload.comment) {
+      const message = endpoint.formatPRReviewComment(payload as PRReviewCommentPayload);
+      const botUser = endpoint.gh.authenticatedUser;
       if (!(botUser && message.$sender.id === botUser)) {
         this.emit('message.receive', message);
       }
     }
 
-    if (bot && event === 'pull_request_review' && payload.action === 'submitted') {
-      const message = bot.formatPRReview(payload as PRReviewPayload);
+    if (endpoint && event === 'pull_request_review' && payload.action === 'submitted') {
+      const message = endpoint.formatPRReview(payload as PRReviewPayload);
       if (message) {
-        const botUser = bot.gh.authenticatedUser;
+        const botUser = endpoint.gh.authenticatedUser;
         if (!(botUser && message.$sender.id === botUser)) {
           this.emit('message.receive', message);
         }
@@ -269,8 +271,8 @@ export class GitHubAdapter extends Adapter<GitHubBot> {
   /** 启动事件轮询 */
   startPolling(): void {
     if (this._pollTimer) return;
-    const bot = this.bots.values().next().value as GitHubBot | undefined;
-    const interval = (bot?.$config.poll_interval || 60) * 1000;
+    const endpoint = this.endpoints.values().next().value as GitHubEndpoint | undefined;
+    const interval = (endpoint?.$config.poll_interval || 60) * 1000;
     this.plugin.logger.debug(formatCompact( { op: 'poll', interval_s: interval / 1000 }));
 
     // 立即执行一次
@@ -339,7 +341,7 @@ export class GitHubAdapter extends Adapter<GitHubBot> {
 
     this.plugin.logger.debug(`${repo}: ${newEvents.length} 条新事件`);
 
-    const bot = this.bots.values().next().value as GitHubBot | undefined;
+    const endpoint = this.endpoints.values().next().value as GitHubEndpoint | undefined;
 
     // 按时间正序处理（API 返回倒序）
     for (const ev of newEvents.reverse()) {
@@ -366,9 +368,9 @@ export class GitHubAdapter extends Adapter<GitHubBot> {
       }
 
       // 处理消息类事件（Issue/PR 评论）
-      if (bot && eventName === 'issue_comment' && ev.payload?.action === 'created' && ev.payload?.comment) {
-        const message = bot.$formatMessage(ev.payload as IssueCommentPayload);
-        const botUser = bot.gh.authenticatedUser;
+      if (endpoint && eventName === 'issue_comment' && ev.payload?.action === 'created' && ev.payload?.comment) {
+        const message = endpoint.$formatMessage(ev.payload as IssueCommentPayload);
+        const botUser = endpoint.gh.authenticatedUser;
         if (!(botUser && message.$sender.id === botUser)) {
           this.emit('message.receive', message);
         }
@@ -436,8 +438,8 @@ export class GitHubAdapter extends Adapter<GitHubBot> {
           this.plugin.logger.warn(formatCompact( { op: 'notify', ok: false, adapter: s.adapter, error: 'no sendMessage' }));
           continue;
         }
-        this.plugin.logger.debug(formatCompact( { op: 'notify', event: eventType, adapter: s.adapter, bot: s.bot, target: s.target_id }));
-        await targetAdapter.sendMessage({ context: s.adapter, bot: s.bot, id: s.target_id, type: s.target_type, content: text });
+        this.plugin.logger.debug(formatCompact( { op: 'notify', event: eventType, adapter: s.adapter, endpoint: s.endpoint, target: s.target_id }));
+        await targetAdapter.sendMessage({ context: s.adapter, endpoint: s.endpoint, id: s.target_id, type: s.target_type, content: text });
       } catch (e) {
         this.plugin.logger.error(`通知推送失败 → ${s.adapter}:${s.target_id}`, e);
       }

package/src/{bot.ts → endpoint.ts}

@@ -1,9 +1,9 @@
 /**
- * GitHub Bot 实现（基于 gh CLI）
+ * GitHub Endpoint 实现（基于 gh CLI）
  */
-import { formatCompact, Bot, Message, segment, SendContent, SendOptions, type MessageSegment } from 'zhin.js';
+import { formatCompact, Endpoint, Message, segment, SendContent, SendOptions, type MessageSegment } from 'zhin.js';
 import type {
-  GitHubBotConfig,
+  GitHubEndpointConfig,
   IssueCommentPayload,
   PRReviewCommentPayload,
   PRReviewPayload,
@@ -40,7 +40,7 @@ export function toMarkdown(content: SendContent): string {
   }).join('');
 }
 
-export class GitHubBot implements Bot<GitHubBotConfig, IssueCommentPayload> {
+export class GitHubEndpoint implements Endpoint<GitHubEndpointConfig, IssueCommentPayload> {
   $connected = false;
   gh: GhClient;
 
@@ -50,7 +50,7 @@ export class GitHubBot implements Bot<GitHubBotConfig, IssueCommentPayload> {
     return this.adapter.plugin.logger;
   }
 
-  constructor(public adapter: GitHubAdapter, public $config: GitHubBotConfig) {
+  constructor(public adapter: GitHubAdapter, public $config: GitHubEndpointConfig) {
     const { host, app_id, private_key } = $config;
     const appAuth = app_id && private_key
       ? { appId: app_id, privateKey: private_key }
@@ -62,12 +62,12 @@ export class GitHubBot implements Bot<GitHubBotConfig, IssueCommentPayload> {
     const result = await this.gh.verifyAuth();
     if (!result.ok) throw new Error(`GitHub 认证失败: ${result.message}`);
     this.$connected = true;
-    this.logger.info(formatCompact({ bot: this.$id }));
+    this.logger.info(formatCompact({ endpoint: this.$id }));
   }
 
   async $disconnect(): Promise<void> {
     this.$connected = false;
-    this.logger.debug(formatCompact({ bot: this.$id, disconnect: true }));
+    this.logger.debug(formatCompact({ endpoint: this.$id, disconnect: true }));
   }
 
   $formatMessage(payload: IssueCommentPayload): Message<IssueCommentPayload> {
@@ -80,7 +80,7 @@ export class GitHubBot implements Bot<GitHubBotConfig, IssueCommentPayload> {
     const result = Message.from(payload, {
       $id: payload.comment.id.toString(),
       $adapter: 'github',
-      $bot: this.$config.name,
+      $endpoint: this.$config.name,
       $sender: { id: payload.sender.login, name: payload.sender.login },
       $channel: { id: channelId, type: 'group' },
       $content: parseMarkdown(payload.comment.body),
@@ -110,7 +110,7 @@ export class GitHubBot implements Bot<GitHubBotConfig, IssueCommentPayload> {
     return Message.from(payload, {
       $id: payload.comment.id.toString(),
       $adapter: 'github',
-      $bot: this.$config.name,
+      $endpoint: this.$config.name,
       $sender: { id: payload.sender.login, name: payload.sender.login },
       $channel: { id: channelId, type: 'group' },
       $content: parseMarkdown(body),
@@ -140,7 +140,7 @@ export class GitHubBot implements Bot<GitHubBotConfig, IssueCommentPayload> {
     return Message.from(payload, {
       $id: payload.review.id.toString(),
       $adapter: 'github',
-      $bot: this.$config.name,
+      $endpoint: this.$config.name,
       $sender: { id: payload.sender.login, name: payload.sender.login },
       $channel: { id: channelId, type: 'group' },
       $content: parseMarkdown(body),

package/src/gh-client.ts

@@ -162,12 +162,13 @@ export class GhClient {
       let data: any;
       try { data = raw ? JSON.parse(raw) : null; } catch { data = raw; }
       return { ok: true, status: 200, data };
-    } catch (err: any) {
+    } catch (err: unknown) {
       let data: any;
-      try { data = err.stdout ? JSON.parse(err.stdout) : { message: err.message }; } catch {
-        data = { message: err.stderr?.trim() || err.message };
+      const errObj = err instanceof Error ? err : new Error(String(err));
+      try { data = (err as any).stdout ? JSON.parse((err as any).stdout) : { message: errObj.message }; } catch {
+        data = { message: (err as any).stderr?.trim() || errObj.message };
       }
-      return { ok: false, status: err.exitCode || 0, data };
+      return { ok: false, status: (err as any).exitCode || 0, data };
     }
   }
 
@@ -205,8 +206,8 @@ export class GhClient {
         }
         const errBody = await appRes.text();
         return { ok: false, user: '', message: `App Token 验证失败 (${appRes.status}): ${errBody}` };
-      } catch (e: any) {
-        return { ok: false, user: '', message: e.message || 'App 认证失败' };
+      } catch (e: unknown) {
+        return { ok: false, user: '', message: (e instanceof Error ? e.message : String(e)) || 'App 认证失败' };
       }
     }
     // Token 模式（用户绑定）或 gh CLI 默认模式
@@ -225,8 +226,8 @@ export class GhClient {
       const login = raw.trim();
       this._user = login;
       return { ok: true, user: login, message: `gh CLI: ${login}` };
-    } catch (e: any) {
-      return { ok: false, user: '', message: e.message || 'gh 认证检查失败' };
+    } catch (e: unknown) {
+      return { ok: false, user: '', message: (e instanceof Error ? e.message : String(e)) || 'gh 认证检查失败' };
     }
   }
 
@@ -469,9 +470,10 @@ export class GhClient {
       let events: any[];
       try { events = JSON.parse(bodyPart); } catch { events = []; }
       return { events: Array.isArray(events) ? events : [], etag: newEtag };
-    } catch (err: any) {
+    } catch (err: unknown) {
       // 304 Not Modified — gh 会以非 0 退出码返回
-      if (err.stderr?.includes('304') || err.exitCode === 1) {
+      const ghErr = err instanceof Error ? (err as Error & { stderr?: string; exitCode?: number }) : null;
+      if (ghErr?.stderr?.includes('304') || (ghErr as { exitCode?: number } | null)?.exitCode === 1) {
         return { events: [], etag: etag || null };
       }
       throw err;
@@ -506,9 +508,11 @@ export class GhClient {
         body: JSON.stringify({ client_id: clientId }),
         signal: AbortSignal.timeout(15_000),
       });
-    } catch (e: any) {
+    } catch (e: unknown) {
+      const errMsg = e instanceof Error ? e.message : String(e);
+      const errCause = e instanceof Error ? (e as any).cause?.code : undefined;
       throw new Error(
-        `Device Flow 请求失败: 无法连接 ${baseUrl} (${e.cause?.code || e.message})。` +
+        `Device Flow 请求失败: 无法连接 ${baseUrl} (${errCause || errMsg})。` +
         `Device Flow 需要访问 github.com（非 api.github.com），请检查网络/代理设置。`,
       );
     }

package/src/index.ts

@@ -1,7 +1,7 @@
 /**
  * GitHub 适配器入口：类型扩展、模型、导出、注册
  */
-import { formatCompact, registerAgentPromptContributor, type Context, type Plugin, type Tool, type ToolContext, type ToolFeature, unregisterAgentPromptContributor, usePlugin } from 'zhin.js';
+import { formatCompact, registerAgentPromptContributor, type Context, type Message, type Plugin, type Tool, type ToolFeature, unregisterAgentPromptContributor, usePlugin } from 'zhin.js';
 import { createGithubAgentPromptContributor } from './agent-prompt.js';
 import { GitHubAdapter } from './adapter.js';
 import { GhClient } from './gh-client.js';
@@ -25,7 +25,7 @@ declare module 'zhin.js' {
       target_id: string;
       target_type: 'private' | 'group' | 'channel';
       adapter: string;
-      bot: string;
+      endpoint: string;
     };
     github_events: {
       id: number;
@@ -38,7 +38,7 @@ declare module 'zhin.js' {
 }
 
 export * from './types.js';
-export { GitHubBot, parseMarkdown, toMarkdown } from './bot.js';
+export { GitHubEndpoint, parseMarkdown, toMarkdown } from './endpoint.js';
 export { GitHubAdapter } from './adapter.js';
 export { GhClient } from './gh-client.js';
 
@@ -54,7 +54,7 @@ defineModel('github_subscriptions', {
   target_id: { type: 'text', nullable: false },
   target_type: { type: 'text', nullable: false },
   adapter: { type: 'text', nullable: false },
-  bot: { type: 'text', nullable: false },
+  endpoint: { type: 'text', nullable: false },
 });
 
 defineModel('github_events', {
@@ -118,7 +118,7 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
     // --- Star ---
     {
       name: 'github_star',
-      description: 'Star 或取消 Star 一个 GitHub 仓库（使用你绑定的 GitHub 账号，未绑定则用 Bot 默认账号）',
+      description: 'Star 或取消 Star 一个 GitHub 仓库（使用你绑定的 GitHub 账号，未绑定则用 Endpoint 默认账号）',
       parameters: {
         type: 'object' as const,
         properties: {
@@ -128,8 +128,8 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
         required: ['action', 'repo'],
       },
       tags: ['github'],
-      execute: async (args: Record<string, any>, context?: ToolContext) => {
-        const gh = await adapter.getUserOrDefaultAPI(context?.platform, context?.senderId);
+      execute: async (args: Record<string, any>, commMessage?: Message<any>) => {
+        const gh = await adapter.getUserOrDefaultAPI(commMessage?.$adapter, commMessage?.$sender.id);
         if (!gh) return '❌ 没有可用的 GitHub bot';
         const { action, repo } = args;
         switch (action) {
@@ -158,19 +158,19 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
         properties: {},
       },
       tags: ['github'],
-      execute: async (_args: Record<string, any>, context?: ToolContext) => {
-        if (!context?.platform || !context?.senderId) {
+      execute: async (_args: Record<string, any>, commMessage?: Message<any>) => {
+        if (!commMessage?.$adapter || !commMessage?.$sender?.id) {
           return '❌ 无法获取当前用户信息';
         }
         const clientId = adapter.getClientId();
-        if (!clientId) return '❌ Bot 未配置 GitHub App 或 App 无 client_id，无法进行账号绑定';
+        if (!clientId) return '❌ Endpoint 未配置 GitHub App 或 App 无 client_id，无法进行账号绑定';
 
         const db = plugin.root?.inject('database') as any;
         const model = db?.models?.get('github_oauth_users');
         if (!model) return '❌ 数据库未就绪';
 
         // 检查是否已绑定
-        const [existing] = await model.select().where({ platform: context.platform, platform_uid: context.senderId });
+        const [existing] = await model.select().where({ platform: commMessage.$adapter, platform_uid: commMessage.$sender.id });
         if (existing) {
           return `⚠️ 你已绑定 GitHub 账号: ${existing.github_login}\n如需重新绑定，请先执行 github_unbind`;
         }
@@ -197,7 +197,7 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
           tokenPromise.then(async (tokenData) => {
             if (!tokenData) {
               // 授权超时或被拒绝 — 由于 execute 已经返回了，这里只能通过日志记录
-              logger.warn(formatCompact( { op: 'device_flow', ok: false, platform: context.platform, sender: context.senderId }));
+              logger.warn(formatCompact( { op: 'device_flow', ok: false, platform: commMessage.$adapter, sender: commMessage.$sender.id }));
               return;
             }
 
@@ -208,25 +208,25 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
 
             await model.insert({
               id: Date.now(),
-              platform: context.platform,
-              platform_uid: context.senderId,
+              platform: commMessage.$adapter,
+              platform_uid: commMessage.$sender.id,
               github_login: login,
               access_token: tokenData.access_token,
               created_at: Date.now(),
             });
-            logger.info(formatCompact( { op: 'bind', platform: context.platform, sender: context.senderId, login }));
+            logger.info(formatCompact( { op: 'bind', platform: commMessage.$adapter, sender: commMessage.$sender.id, login }));
 
             // 尝试回复绑定成功消息
-            if (context.message?.$reply) {
-              await context.message.$reply(`✅ GitHub 账号绑定成功！\n👤 ${login}`);
+            if (commMessage?.$reply) {
+              await commMessage.$reply(`✅ GitHub 账号绑定成功！\n👤 ${login}`);
             }
           }).catch(err => {
             logger.error('GitHub Device Flow 错误:', err);
           });
 
           return replyMsg;
-        } catch (e: any) {
-          return `❌ Device Flow 启动失败: ${e.message}`;
+        } catch (e: unknown) {
+          return `❌ Device Flow 启动失败: ${e instanceof Error ? e.message : String(e)}`;
         }
       },
     },
@@ -239,15 +239,15 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
         properties: {},
       },
       tags: ['github'],
-      execute: async (_args: Record<string, any>, context?: ToolContext) => {
-        if (!context?.platform || !context?.senderId) {
+      execute: async (_args: Record<string, any>, commMessage?: Message<any>) => {
+        if (!commMessage?.$adapter || !commMessage?.$sender?.id) {
           return '❌ 无法获取当前用户信息';
         }
         const db = plugin.root?.inject('database') as any;
         const model = db?.models?.get('github_oauth_users');
         if (!model) return '❌ 数据库未就绪';
 
-        const [existing] = await model.select().where({ platform: context.platform, platform_uid: context.senderId });
+        const [existing] = await model.select().where({ platform: commMessage.$adapter, platform_uid: commMessage.$sender.id });
         if (!existing) return '📭 你尚未绑定 GitHub 账号';
 
         await model.delete().where({ id: existing.id });
@@ -263,15 +263,15 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
         properties: {},
       },
       tags: ['github'],
-      execute: async (_args: Record<string, any>, context?: ToolContext) => {
-        if (!context?.platform || !context?.senderId) {
+      execute: async (_args: Record<string, any>, commMessage?: Message<any>) => {
+        if (!commMessage?.$adapter || !commMessage?.$sender?.id) {
           return '❌ 无法获取当前用户信息';
         }
         const db = plugin.root?.inject('database') as any;
         const model = db?.models?.get('github_oauth_users');
         if (!model) return '❌ 数据库未就绪';
 
-        const [existing] = await model.select().where({ platform: context.platform, platform_uid: context.senderId });
+        const [existing] = await model.select().where({ platform: commMessage.$adapter, platform_uid: commMessage.$sender.id });
         if (!existing) return '📭 你尚未绑定 GitHub 账号\n🔗 使用 github_bind 绑定你的账号';
 
         // 验证 token 是否仍然有效
@@ -286,7 +286,7 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
     // --- Install App ---
     {
       name: 'github_install',
-      description: '获取安装 GitHub App 的链接 — 安装后 Bot 可以访问你的仓库，你也可以使用更多功能',
+      description: '获取安装 GitHub App 的链接 — 安装后 Endpoint 可以访问你的仓库，你也可以使用更多功能',
       parameters: {
         type: 'object' as const,
         properties: {},
@@ -294,7 +294,7 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
       tags: ['github'],
       execute: async () => {
         const slug = adapter.getAppSlug();
-        if (!slug) return '❌ Bot 未配置 GitHub App';
+        if (!slug) return '❌ Endpoint 未配置 GitHub App';
         const host = adapter.getHost() || 'github.com';
         const installations = adapter.getInstallations();
         let msg = `🔗 请点击以下链接安装 GitHub App 到你的仓库：\n   https://${host}/apps/${slug}/installations/new`;
@@ -321,8 +321,8 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
       },
       platforms: ['github'],
       tags: ['github'],
-      execute: async (args: Record<string, any>, context?: ToolContext) => {
-        if (!context?.platform || !context?.senderId || !context?.sceneId || !context?.botId) {
+      execute: async (args: Record<string, any>, commMessage?: Message<any>) => {
+        if (!commMessage?.$adapter || !commMessage?.$sender.id || !commMessage?.$channel?.id || !commMessage?.$endpoint) {
           return '❌ 无法获取当前聊天通道信息';
         }
         const db = plugin.root?.inject('database') as any;
@@ -337,12 +337,12 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
 
         const [existing] = await model.select().where({
           repo: args.repo,
-          target_id: context.sceneId,
-          adapter: context.platform,
-          bot: context.botId,
+          target_id: commMessage.$channel?.id,
+          adapter: commMessage.$adapter,
+          endpoint: commMessage.$endpoint,
         });
         if (existing) {
-          await model.update({ events, target_type: context.scope || 'private' }).where({ id: existing.id });
+          await model.update({ events, target_type: commMessage.$channel?.type || 'private' }).where({ id: existing.id });
           return `✅ 已更新订阅 ${args.repo}\n📡 事件: ${events.join(', ')}`;
         }
 
@@ -350,10 +350,10 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
           id: Date.now(),
           repo: args.repo,
           events,
-          target_id: context.sceneId,
-          target_type: context.scope || 'private',
-          adapter: context.platform,
-          bot: context.botId,
+          target_id: commMessage.$channel?.id,
+          target_type: commMessage.$channel?.type || 'private',
+          adapter: commMessage.$adapter,
+          endpoint: commMessage.$endpoint,
         });
         return `✅ 已订阅 ${args.repo}\n📡 事件: ${events.join(', ')}\n📌 通知将推送到当前通道`;
       },
@@ -371,8 +371,8 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
       },
       platforms: ['github'],
       tags: ['github'],
-      execute: async (args: Record<string, any>, context?: ToolContext) => {
-        if (!context?.platform || !context?.sceneId || !context?.botId) {
+      execute: async (args: Record<string, any>, commMessage?: Message<any>) => {
+        if (!commMessage?.$adapter || !commMessage?.$channel?.id || !commMessage?.$endpoint) {
           return '❌ 无法获取当前聊天通道信息';
         }
         const db = plugin.root?.inject('database') as any;
@@ -381,9 +381,9 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
 
         const [existing] = await model.select().where({
           repo: args.repo,
-          target_id: context.sceneId,
-          adapter: context.platform,
-          bot: context.botId,
+          target_id: commMessage.$channel?.id,
+          adapter: commMessage.$adapter,
+          endpoint: commMessage.$endpoint,
         });
         if (!existing) return `📭 当前通道未订阅 ${args.repo}`;
 
@@ -401,8 +401,8 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
       },
       platforms: ['github'],
       tags: ['github'],
-      execute: async (_args: Record<string, any>, context?: ToolContext) => {
-        if (!context?.platform || !context?.sceneId || !context?.botId) {
+      execute: async (_args: Record<string, any>, commMessage?: Message<any>) => {
+        if (!commMessage?.$adapter || !commMessage?.$channel?.id || !commMessage?.$endpoint) {
           return '❌ 无法获取当前聊天通道信息';
         }
         const db = plugin.root?.inject('database') as any;
@@ -410,9 +410,9 @@ useContext('tool', 'github', (toolService: ToolFeature, adapter: GitHubAdapter)
         if (!model) return '❌ 数据库未就绪';
 
         const subs = await model.select().where({
-          target_id: context.sceneId,
-          adapter: context.platform,
-          bot: context.botId,
+          target_id: commMessage.$channel?.id,
+          adapter: commMessage.$adapter,
+          endpoint: commMessage.$endpoint,
         });
         if (!subs?.length) return '📭 当前通道没有任何 GitHub 订阅';
 

package/src/types.ts

@@ -1,10 +1,10 @@
-// ── Bot 配置 ─────────────────────────────────────────────────────────
+// ── Endpoint 配置 ─────────────────────────────────────────────────────────
 //  基于 gh CLI 认证：需要系统已安装并认证 gh CLI
 //  认证方式：gh auth login
 
-export interface GitHubBotConfig {
+export interface GitHubEndpointConfig {
   context: 'github';
-  /** Bot 标识名称 */
+  /** Endpoint 标识名称 */
   name: string;
   /** GitHub Enterprise 主机名（默认 github.com） */
   host?: string;
@@ -135,7 +135,7 @@ export interface Subscription {
   target_id: string;
   target_type: 'private' | 'group' | 'channel';
   adapter: string;
-  bot: string;
+  endpoint: string;
 }
 
 // ── Tool Action Types ────────────────────────────────────────────────

package/lib/bot.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAiB,GAAG,EAAE,OAAO,EAAW,WAAW,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9G,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,EAAE,CAY1D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAYvD;AAED,qBAAa,SAAU,YAAW,GAAG,CAAC,eAAe,EAAE,mBAAmB,CAAC;IAUtD,OAAO,EAAE,aAAa;IAAS,OAAO,EAAE,eAAe;IAT1E,UAAU,UAAS;IACnB,EAAE,EAAE,QAAQ,CAAC;IAEb,IAAI,GAAG,WAAgC;IAEvC,IAAI,MAAM,6BAET;gBAEkB,OAAO,EAAE,aAAa,EAAS,OAAO,EAAE,eAAe;IAQpE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAOzB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA2B1E,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA2BvF,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IA8BnE,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAcnD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhD"}