@zhin.js/scaffold-wizard 0.1.2 → 0.1.4

package/src/adapter-configurers.ts

@@ -13,19 +13,19 @@ export const ADAPTERS_ESSENTIALS_URL = 'https://zhin.js.org/essentials/adapters'
 /** 各适配器文档页（与 docs/adapters/*.md 同步） */
 export const adapterDocsUrl = (slug: string) => `https://zhin.js.org/adapters/${slug}`;
 
-export interface BotConfigureContext {
+export interface EndpointConfigureContext {
   envVars: Record<string, string>;
   markRequiresDatabase: () => void;
 }
 
-export async function configureTelegramBot(ctx: BotConfigureContext): Promise<Record<string, unknown>> {
+export async function configureTelegramEndpoint(ctx: EndpointConfigureContext): Promise<Record<string, unknown>> {
   console.log(chalk.gray('     文档: ' + adapterDocsUrl('telegram')));
 
-  const { botName } = await inquirer.prompt([
+  const { endpointName } = await inquirer.prompt([
     {
       type: 'input',
-      name: 'botName',
-      message: '  Bot 标识名称:',
+      name: 'endpointName',
+      message: '  Endpoint 标识名称:',
       default: 'telegram-bot',
       validate: (v: string) => (v.trim() ? true : '名称不能为空'),
     },
@@ -35,7 +35,7 @@ export async function configureTelegramBot(ctx: BotConfigureContext): Promise<Re
     {
       type: 'password',
       name: 'token',
-      message: '  Telegram Bot Token（@BotFather 获取）:',
+      message: '  Telegram Endpoint Token（@BotFather 获取）:',
       validate: (v: string) => (v.trim() ? true : 'Token 不能为空'),
     },
   ]);
@@ -60,9 +60,9 @@ export async function configureTelegramBot(ctx: BotConfigureContext): Promise<Re
     },
   ]);
 
-  const botConfig: Record<string, unknown> = {
+  const endpointConfig: Record<string, unknown> = {
     context: 'telegram',
-    name: botName.trim(),
+    name: endpointName.trim(),
     token: '${TELEGRAM_TOKEN}',
     polling: transport === 'polling',
   };
@@ -70,7 +70,7 @@ export async function configureTelegramBot(ctx: BotConfigureContext): Promise<Re
   if (transport === 'webhook') {
     console.log('');
     console.log(chalk.yellow('     Webhook 前置条件：'));
-    console.log(chalk.gray('     • Bot 进程需绑定可被 Telegram 访问的 HTTPS 域名（有效 TLS 证书）'));
+    console.log(chalk.gray('     • Endpoint 进程需绑定可被 Telegram 访问的 HTTPS 域名（有效 TLS 证书）'));
     console.log(chalk.gray('     • 在 @BotFather 可配合 setWebhook，或由 Telegraf 在 launch 时注册'));
     console.log(chalk.gray('     • 防火墙/反向代理需放行 webhook.port（默认由 Telegraf 监听）'));
 
@@ -104,26 +104,26 @@ export async function configureTelegramBot(ctx: BotConfigureContext): Promise<Re
       },
     ]);
 
-    botConfig.polling = false;
-    botConfig.webhook = {
+    endpointConfig.polling = false;
+    endpointConfig.webhook = {
       domain: webhook.domain.trim(),
       path: webhook.path.trim(),
       port: parseInt(webhook.port, 10),
     };
   }
 
-  return botConfig;
+  return endpointConfig;
 }
 
-export async function configureGitHubBot(ctx: BotConfigureContext): Promise<Record<string, unknown>> {
+export async function configureGitHubEndpoint(ctx: EndpointConfigureContext): Promise<Record<string, unknown>> {
   console.log(chalk.gray('     文档: ' + adapterDocsUrl('github')));
   ctx.markRequiresDatabase();
 
-  const { botName } = await inquirer.prompt([
+  const { endpointName } = await inquirer.prompt([
     {
       type: 'input',
-      name: 'botName',
-      message: '  Bot 标识名称:',
+      name: 'endpointName',
+      message: '  Endpoint 标识名称:',
       default: 'github-bot',
       validate: (v: string) => (v.trim() ? true : '名称不能为空'),
     },
@@ -148,9 +148,9 @@ export async function configureGitHubBot(ctx: BotConfigureContext): Promise<Reco
     },
   ]);
 
-  const botConfig: Record<string, unknown> = {
+  const endpointConfig: Record<string, unknown> = {
     context: 'github',
-    name: botName.trim(),
+    name: endpointName.trim(),
   };
 
   if (authMode === 'github_app') {
@@ -173,8 +173,8 @@ export async function configureGitHubBot(ctx: BotConfigureContext): Promise<Reco
     ]);
 
     ctx.envVars.GITHUB_APP_ID = appConfig.app_id.trim();
-    botConfig.app_id = '${GITHUB_APP_ID}';
-    botConfig.private_key = appConfig.private_key.trim();
+    endpointConfig.app_id = '${GITHUB_APP_ID}';
+    endpointConfig.private_key = appConfig.private_key.trim();
   } else {
     console.log(chalk.gray('     请确保已执行 gh auth login，且 gh 在 PATH 中'));
   }
@@ -221,8 +221,8 @@ export async function configureGitHubBot(ctx: BotConfigureContext): Promise<Reco
     ]);
 
     ctx.envVars.GITHUB_WEBHOOK_SECRET = webhook.webhook_secret;
-    botConfig.webhook_secret = '${GITHUB_WEBHOOK_SECRET}';
-    botConfig.webhook_path = webhook.webhook_path.trim();
+    endpointConfig.webhook_secret = '${GITHUB_WEBHOOK_SECRET}';
+    endpointConfig.webhook_path = webhook.webhook_path.trim();
   } else {
     const { poll_interval } = await inquirer.prompt([
       {
@@ -237,7 +237,7 @@ export async function configureGitHubBot(ctx: BotConfigureContext): Promise<Reco
         },
       },
     ]);
-    botConfig.poll_interval = parseInt(poll_interval, 10);
+    endpointConfig.poll_interval = parseInt(poll_interval, 10);
   }
 
   const { enableMcp } = await inquirer.prompt([
@@ -261,10 +261,10 @@ export async function configureGitHubBot(ctx: BotConfigureContext): Promise<Reco
     ctx.envVars.GITHUB_PERSONAL_ACCESS_TOKEN = pat;
   }
 
-  return botConfig;
+  return endpointConfig;
 }
 
-export async function configureOneBot11Bot(ctx: BotConfigureContext): Promise<Record<string, unknown>> {
+export async function configureOneBot11Bot(ctx: EndpointConfigureContext): Promise<Record<string, unknown>> {
   console.log(chalk.gray('     文档: ' + adapterDocsUrl('onebot11')));
 
   const { connection } = await inquirer.prompt([
@@ -273,27 +273,27 @@ export async function configureOneBot11Bot(ctx: BotConfigureContext): Promise<Re
       name: 'connection',
       message: '  连接方式:',
       choices: [
-        { name: '正向 WebSocket (ws) — 本 Bot 连接 OneBot 实现', value: 'ws' },
+        { name: '正向 WebSocket (ws) — 本 Endpoint 连接 OneBot 实现', value: 'ws' },
         { name: '反向 WebSocket (wss) — OneBot 实现连本 Bot（需 host-router）', value: 'wss' },
       ],
       default: 'ws',
     },
   ]);
 
-  const { botName } = await inquirer.prompt([
+  const { endpointName } = await inquirer.prompt([
     {
       type: 'input',
-      name: 'botName',
-      message: '  Bot 标识名称:',
+      name: 'endpointName',
+      message: '  Endpoint 标识名称:',
       default: 'onebot-bot',
       validate: (v: string) => (v.trim() ? true : '名称不能为空'),
     },
   ]);
 
-  const botConfig: Record<string, unknown> = {
+  const endpointConfig: Record<string, unknown> = {
     context: 'onebot11',
     connection,
-    name: botName.trim(),
+    name: endpointName.trim(),
   };
 
   if (connection === 'ws') {
@@ -306,7 +306,7 @@ export async function configureOneBot11Bot(ctx: BotConfigureContext): Promise<Re
         validate: (v: string) => (v.trim() ? true : '地址不能为空'),
       },
     ]);
-    botConfig.url = url.trim();
+    endpointConfig.url = url.trim();
   } else {
     console.log(chalk.gray('     反向 WS 需启用 @zhin.js/host-router，OneBot 实现配置连接到此 Bot'));
     const { path: wsPath } = await inquirer.prompt([
@@ -318,7 +318,7 @@ export async function configureOneBot11Bot(ctx: BotConfigureContext): Promise<Re
         validate: (v: string) => (v.trim() ? true : '路径不能为空'),
       },
     ]);
-    botConfig.path = wsPath.trim();
+    endpointConfig.path = wsPath.trim();
   }
 
   const { accessToken } = await inquirer.prompt([
@@ -331,20 +331,20 @@ export async function configureOneBot11Bot(ctx: BotConfigureContext): Promise<Re
   ]);
   if (accessToken?.trim()) {
     ctx.envVars.ONEBOT11_ACCESS_TOKEN = accessToken.trim();
-    botConfig.access_token = '${ONEBOT11_ACCESS_TOKEN}';
+    endpointConfig.access_token = '${ONEBOT11_ACCESS_TOKEN}';
   }
 
-  return botConfig;
+  return endpointConfig;
 }
 
-export async function configureQQBot(ctx: BotConfigureContext): Promise<Record<string, unknown>> {
+export async function configureQQBot(ctx: EndpointConfigureContext): Promise<Record<string, unknown>> {
   console.log(chalk.gray('     文档: ' + adapterDocsUrl('qq')));
 
   const credentials = await inquirer.prompt([
     {
       type: 'input',
       name: 'name',
-      message: '  Bot 标识名称:',
+      message: '  Endpoint 标识名称:',
       default: 'qq-bot',
       validate: (v: string) => (v.trim() ? true : '名称不能为空'),
     },
@@ -403,7 +403,7 @@ export async function configureQQBot(ctx: BotConfigureContext): Promise<Record<s
   };
 }
 
-export async function configureDiscordBot(ctx: BotConfigureContext): Promise<Record<string, unknown>> {
+export async function configureDiscordEndpoint(ctx: EndpointConfigureContext): Promise<Record<string, unknown>> {
   console.log(chalk.gray('     文档: ' + adapterDocsUrl('discord')));
 
   const { connection } = await inquirer.prompt([
@@ -419,27 +419,27 @@ export async function configureDiscordBot(ctx: BotConfigureContext): Promise<Rec
     },
   ]);
 
-  const { botName, token } = await inquirer.prompt([
+  const { endpointName, token } = await inquirer.prompt([
     {
       type: 'input',
-      name: 'botName',
-      message: '  Bot 标识名称:',
+      name: 'endpointName',
+      message: '  Endpoint 标识名称:',
       default: 'discord-bot',
       validate: (v: string) => (v.trim() ? true : '名称不能为空'),
     },
     {
       type: 'password',
       name: 'token',
-      message: '  Bot Token:',
+      message: '  Endpoint Token:',
       validate: (v: string) => (v.trim() ? true : 'Token 不能为空'),
     },
   ]);
   ctx.envVars.DISCORD_TOKEN = token;
 
-  const botConfig: Record<string, unknown> = {
+  const endpointConfig: Record<string, unknown> = {
     context: 'discord',
     connection,
-    name: botName.trim(),
+    name: endpointName.trim(),
     token: '${DISCORD_TOKEN}',
   };
 
@@ -465,15 +465,15 @@ export async function configureDiscordBot(ctx: BotConfigureContext): Promise<Rec
         default: '/discord/interactions',
       },
     ]);
-    botConfig.applicationId = interactions.applicationId.trim();
-    botConfig.publicKey = interactions.publicKey.trim();
-    botConfig.interactionsPath = interactions.interactionsPath.trim();
+    endpointConfig.applicationId = interactions.applicationId.trim();
+    endpointConfig.publicKey = interactions.publicKey.trim();
+    endpointConfig.interactionsPath = interactions.interactionsPath.trim();
   }
 
-  return botConfig;
+  return endpointConfig;
 }
 
-export async function configureSlackBot(ctx: BotConfigureContext): Promise<Record<string, unknown>> {
+export async function configureSlackEndpoint(ctx: EndpointConfigureContext): Promise<Record<string, unknown>> {
   console.log(chalk.gray('     文档: ' + adapterDocsUrl('slack')));
 
   const { socketMode } = await inquirer.prompt([
@@ -489,18 +489,18 @@ export async function configureSlackBot(ctx: BotConfigureContext): Promise<Recor
     },
   ]);
 
-  const { botName, token, signingSecret } = await inquirer.prompt([
+  const { endpointName, token, signingSecret } = await inquirer.prompt([
     {
       type: 'input',
-      name: 'botName',
-      message: '  Bot 标识名称:',
+      name: 'endpointName',
+      message: '  Endpoint 标识名称:',
       default: 'slack-bot',
       validate: (v: string) => (v.trim() ? true : '名称不能为空'),
     },
     {
       type: 'password',
       name: 'token',
-      message: '  Bot Token (xoxb-...):',
+      message: '  Endpoint Token (xoxb-...):',
       validate: (v: string) => (v.trim() ? true : '不能为空'),
     },
     {
@@ -514,9 +514,9 @@ export async function configureSlackBot(ctx: BotConfigureContext): Promise<Recor
   ctx.envVars.SLACK_BOT_TOKEN = token;
   ctx.envVars.SLACK_SIGNING_SECRET = signingSecret;
 
-  const botConfig: Record<string, unknown> = {
+  const endpointConfig: Record<string, unknown> = {
     context: 'slack',
-    name: botName.trim(),
+    name: endpointName.trim(),
     token: '${SLACK_BOT_TOKEN}',
     signingSecret: '${SLACK_SIGNING_SECRET}',
     socketMode: socketMode === 'true',
@@ -532,7 +532,7 @@ export async function configureSlackBot(ctx: BotConfigureContext): Promise<Recor
       },
     ]);
     ctx.envVars.SLACK_APP_TOKEN = appToken;
-    botConfig.appToken = '${SLACK_APP_TOKEN}';
+    endpointConfig.appToken = '${SLACK_APP_TOKEN}';
   } else {
     console.log(chalk.yellow('     HTTP 模式需公网可达并配置 Slack Event Subscriptions URL'));
     const { port } = await inquirer.prompt([
@@ -543,8 +543,8 @@ export async function configureSlackBot(ctx: BotConfigureContext): Promise<Recor
         default: '3000',
       },
     ]);
-    botConfig.port = parseInt(port, 10);
+    endpointConfig.port = parseInt(port, 10);
   }
 
-  return botConfig;
+  return endpointConfig;
 }

package/src/adapter.ts

@@ -3,18 +3,18 @@ import chalk from 'chalk';
 import {
   ADAPTERS_DOCS_URL,
   adapterDocsUrl,
-  configureDiscordBot,
-  configureGitHubBot,
+  configureDiscordEndpoint,
+  configureGitHubEndpoint,
   configureOneBot11Bot,
   configureQQBot,
-  configureSlackBot,
-  configureTelegramBot,
+  configureSlackEndpoint,
+  configureTelegramEndpoint,
 } from './adapter-configurers.js';
 
 export interface AdapterSetupResult {
   packages: string[];
   plugins: string[];
-  bots: Array<Record<string, any>>;
+  endpoints: Array<Record<string, any>>;
   envVars: Record<string, string>;
   /** 所选适配器需要 database 插件（如 GitHub 订阅/OAuth 表） */
   requiresDatabase?: boolean;
@@ -33,7 +33,7 @@ interface AdapterDefinition {
   /** 文档：zhin.js.org/adapters/<slug>；索引见 ADAPTERS_DOCS_URL */
   docUrl?: string;
   requiresDatabase?: boolean;
-  configure?: (ctx: import('./adapter-configurers.js').BotConfigureContext) => Promise<Record<string, unknown>>;
+  configure?: (ctx: import('./adapter-configurers.js').EndpointConfigureContext) => Promise<Record<string, unknown>>;
   fields: AdapterField[];
 }
 
@@ -89,10 +89,10 @@ const ADAPTERS: AdapterDefinition[] = [
     package: '@zhin.js/adapter-kook',
     plugin: '@zhin.js/adapter-kook',
     needsHttp: true,
-    description: 'KOOK 语音平台 Bot',
-    setupHint: '在 KOOK 开发者中心创建 Bot 并复制 Token；需配置 Webhook 回调地址（公网或内网穿透）。',
+    description: 'KOOK 语音平台 Endpoint',
+    setupHint: '在 KOOK 开发者中心创建 Endpoint 并复制 Token；需配置 Webhook 回调地址（公网或内网穿透）。',
     fields: [
-      { key: 'token', message: 'KOOK Bot Token:', required: true, type: 'password', envKey: 'KOOK_TOKEN' },
+      { key: 'token', message: 'KOOK Endpoint Token:', required: true, type: 'password', envKey: 'KOOK_TOKEN' },
     ],
   },
   {
@@ -104,7 +104,7 @@ const ADAPTERS: AdapterDefinition[] = [
     description: 'Discord（Gateway 或 Interactions）',
     setupHint: 'Developer Portal 创建 Bot；Gateway 用 Token，Interactions 需 Application ID + Public Key。',
     docUrl: adapterDocsUrl('discord'),
-    configure: configureDiscordBot,
+    configure: configureDiscordEndpoint,
     fields: [],
   },
   {
@@ -116,7 +116,7 @@ const ADAPTERS: AdapterDefinition[] = [
     description: 'Telegram Bot（polling / webhook 可选）',
     setupHint: '@BotFather 获取 Token；polling 适合本地，webhook 需 HTTPS 公网域名。',
     docUrl: adapterDocsUrl('telegram'),
-    configure: configureTelegramBot,
+    configure: configureTelegramEndpoint,
     fields: [],
   },
   {
@@ -128,7 +128,7 @@ const ADAPTERS: AdapterDefinition[] = [
     description: 'Slack（Socket Mode 或 HTTP Events）',
     setupHint: 'Socket Mode 无需公网；HTTP 模式需配置 Event Subscriptions URL。',
     docUrl: adapterDocsUrl('slack'),
-    configure: configureSlackBot,
+    configure: configureSlackEndpoint,
     fields: [],
   },
   {
@@ -213,19 +213,19 @@ const ADAPTERS: AdapterDefinition[] = [
     setupHint: 'GitHub App 或 gh CLI；Webhook 用 /pub/github/webhook；需 database 存订阅与 OAuth。',
     docUrl: adapterDocsUrl('github'),
     requiresDatabase: true,
-    configure: configureGitHubBot,
+    configure: configureGitHubEndpoint,
     fields: [],
   },
 ];
 
 /**
- * 适配器选择与 Bot 配置引导向导
+ * 适配器选择与 Endpoint 配置引导向导
  */
 export async function configureAdapters(): Promise<AdapterSetupResult> {
   console.log('');
   console.log(chalk.blue('🔌 配置聊天适配器'));
   console.log(chalk.gray('  Sandbox 适合本地调试；生产环境请额外勾选目标 IM 平台。'));
-  console.log(chalk.gray('  带 Webhook 的适配器需要 Bot 可被公网访问（或使用内网穿透）。'));
+  console.log(chalk.gray('  带 Webhook 的适配器需要 Endpoint 可被公网访问（或使用内网穿透）。'));
 
   const { selectedAdapters } = await inquirer.prompt([
     {
@@ -266,7 +266,7 @@ export async function configureAdapters(): Promise<AdapterSetupResult> {
   const result: AdapterSetupResult = {
     packages: [],
     plugins: [],
-    bots: [],
+    endpoints: [],
     envVars: {},
     requiresDatabase: false,
   };
@@ -303,7 +303,7 @@ export async function configureAdapters(): Promise<AdapterSetupResult> {
 
     if (adapterDef.configure) {
       let markedDb = false;
-      const botConfig = await adapterDef.configure({
+      const endpointConfig = await adapterDef.configure({
         envVars: result.envVars,
         markRequiresDatabase: () => {
           markedDb = true;
@@ -311,11 +311,11 @@ export async function configureAdapters(): Promise<AdapterSetupResult> {
         },
       });
       if (markedDb) result.requiresDatabase = true;
-      result.bots.push(botConfig);
+      result.endpoints.push(endpointConfig);
       continue;
     }
 
-    const botConfig: Record<string, any> = {
+    const endpointConfig: Record<string, any> = {
       context: adapterDef.value,
     };
 
@@ -343,13 +343,13 @@ export async function configureAdapters(): Promise<AdapterSetupResult> {
       if (field.envKey) {
         // 敏感信息存 .env，配置引用环境变量
         result.envVars[field.envKey] = value || '';
-        botConfig[field.key] = `\${${field.envKey}}`;
+        endpointConfig[field.key] = `\${${field.envKey}}`;
       } else {
-        botConfig[field.key] = value;
+        endpointConfig[field.key] = value;
       }
     }
 
-    result.bots.push(botConfig);
+    result.endpoints.push(endpointConfig);
   }
 
   return result;
@@ -370,7 +370,7 @@ export function generateAdapterEnvVars(result: AdapterSetupResult): string {
 }
 
 /**
- * 将 bot 配置项格式化为 YAML 行
+ * 将 Endpoint 配置项格式化为 YAML 行
  */
 function appendYamlValue(lines: string[], key: string, value: unknown, indent: number): void {
   const pad = '  '.repeat(indent);
@@ -405,20 +405,20 @@ function appendYamlValue(lines: string[], key: string, value: unknown, indent: n
 }
 
 /**
- * 生成 YAML 格式的 bots 配置段
+ * 生成 YAML 格式的 endpoints 配置段
  */
-export function generateBotsConfigYaml(result: AdapterSetupResult): string {
-  if (result.bots.length === 0) {
+export function generateEndpointsConfigYaml(result: AdapterSetupResult): string {
+  if (result.endpoints.length === 0) {
     return `
 
-# Sandbox：Remote Console 打开「沙盒」页并通过 WebSocket 连接时自动创建 bot
-bots: []
+# Sandbox：Remote Console 打开「沙盒」页并通过 WebSocket 连接时自动创建 Endpoint
+endpoints: []
 `;
   }
 
-  const lines: string[] = ['', 'bots:'];
-  for (const bot of result.bots) {
-    const { context, ...config } = bot;
+  const lines: string[] = ['', 'endpoints:'];
+  for (const entry of result.endpoints) {
+    const { context, ...config } = entry;
     lines.push(`  - context: ${context}`);
     for (const [key, value] of Object.entries(config)) {
       appendYamlValue(lines, key, value, 2);
@@ -429,15 +429,15 @@ bots: []
 }
 
 /**
- * 生成 TOML 格式的 bots 配置段
+ * 生成 TOML 格式的 endpoints 配置段
  */
-export function generateBotsConfigToml(result: AdapterSetupResult): string {
-  if (result.bots.length === 0) return '';
+export function generateEndpointsConfigToml(result: AdapterSetupResult): string {
+  if (result.endpoints.length === 0) return '';
 
   const lines: string[] = [''];
-  for (const bot of result.bots) {
-    lines.push('[[bots]]');
-    for (const [key, value] of Object.entries(bot)) {
+  for (const entry of result.endpoints) {
+    lines.push('[[endpoints]]');
+    for (const [key, value] of Object.entries(entry)) {
       if (typeof value === 'string') {
         lines.push(`${key} = "${value.replace(/"/g, '\\"')}"`);
       } else {
@@ -450,11 +450,11 @@ export function generateBotsConfigToml(result: AdapterSetupResult): string {
 }
 
 /**
- * 生成 JSON 格式的 bots 配置段
+ * 生成 JSON 格式的 endpoints 配置段
  */
-export function generateBotsConfigJSON(result: AdapterSetupResult): string {
-  if (result.bots.length === 0) return '';
-  return `  "bots": ${JSON.stringify(result.bots, null, 4).replace(/^/gm, '  ').trimStart()},`;
+export function generateEndpointsConfigJSON(result: AdapterSetupResult): string {
+  if (result.endpoints.length === 0) return '';
+  return `  "endpoints": ${JSON.stringify(result.endpoints, null, 4).replace(/^/gm, '  ').trimStart()},`;
 }
 
 /**
@@ -462,21 +462,21 @@ export function generateBotsConfigJSON(result: AdapterSetupResult): string {
  */
 export function getAdapterSetupNotes(result: AdapterSetupResult): string[] {
   const notes: string[] = [];
-  for (const bot of result.bots) {
-    const context = bot.context as string;
-    if (context === 'telegram' && bot.polling === false) {
+  for (const entry of result.endpoints) {
+    const context = entry.context as string;
+    if (context === 'telegram' && entry.polling === false) {
       notes.push('Telegram Webhook: 确保 HTTPS 域名可从公网访问，且 webhook.port 已放行');
     }
-    if (context === 'telegram' && bot.polling !== false) {
+    if (context === 'telegram' && entry.polling !== false) {
       notes.push('Telegram polling: 本地开发可直接 pnpm dev，无需公网');
     }
     if (context === 'github') {
-      if (bot.webhook_secret) {
+      if (entry.webhook_secret) {
         notes.push('GitHub Webhook: App 设置 URL 为 https://<域名>/pub/github/webhook');
       } else {
         notes.push('GitHub polling: 无 Webhook 时将轮询 Events API（默认 60s）');
       }
-      if (bot.app_id) {
+      if (entry.app_id) {
         notes.push('GitHub App: 私钥路径需存在，且 App 已安装到目标仓库');
       } else {
         notes.push('GitHub gh CLI: 运行 gh auth login 完成认证');

package/src/ai.ts

@@ -76,6 +76,22 @@ const PROVIDERS = [
   },
 ] as const;
 
+function providerApiFor(name: string): string {
+  switch (name) {
+    case 'anthropic':
+      return 'anthropic-messages';
+    case 'google':
+    case 'gemini':
+      return 'google-generative-ai';
+    case 'ollama':
+      return 'ollama-chat';
+    case 'cloudflare':
+      return 'cloudflare-workers-ai';
+    default:
+      return 'openai-completions';
+  }
+}
+
 function defaultModelForProvider(driver: string): string {
   const entry = PROVIDERS.find(p => p.value === driver);
   return entry?.defaultModel ?? '';
@@ -207,7 +223,7 @@ export async function configureAI(): Promise<AISetupConfig> {
 
   console.log('');
   console.log(chalk.blue('⚡ 配置 AI 触发方式'));
-  console.log(chalk.gray('  决定 Bot 何时自动调用大模型；命令（/ 开头）不会被 AI 拦截。'));
+  console.log(chalk.gray('  决定 Endpoint 何时自动调用大模型；命令（/ 开头）不会被 AI 拦截。'));
 
   const triggerConfig = await inquirer.prompt([
     {
@@ -332,7 +348,7 @@ export function generateAIConfigYaml(config: AISetupConfig): string {
   if (config.providers) {
     for (const [name, providerConfig] of Object.entries(config.providers)) {
       lines.push(`    ${name}:`);
-      lines.push(`      driver: ${name}`);
+      lines.push(`      api: ${providerApiFor(name)}`);
       if (providerConfig.apiKey) {
         lines.push(`      apiKey: ${providerConfig.apiKey}`);
       }

package/src/apply.ts

@@ -30,9 +30,9 @@ export function applyAdaptersToConfig(config: Record<string, unknown>, result: A
   }
   config.plugins = plugins;
 
-  const bots = Array.isArray(config.bots) ? [...config.bots as Record<string, unknown>[]] : [];
-  bots.push(...result.bots);
-  config.bots = bots;
+  const endpoints = Array.isArray(config.endpoints) ? [...config.endpoints as Record<string, unknown>[]] : [];
+  endpoints.push(...result.endpoints);
+  config.endpoints = endpoints;
 }
 
 export function applyAIToConfig(config: Record<string, unknown>, ai: AISetupConfig): void {

package/src/index.ts

@@ -5,9 +5,9 @@ export type { AdapterSetupResult } from './adapter.js';
 export {
   configureAdapters,
   generateAdapterEnvVars,
-  generateBotsConfigYaml,
-  generateBotsConfigJSON,
-  generateBotsConfigToml,
+  generateEndpointsConfigYaml,
+  generateEndpointsConfigJSON,
+  generateEndpointsConfigToml,
   getAdapterDependencies,
   getAdapterSetupNotes,
 } from './adapter.js';