@zhin.js/scaffold-wizard 0.1.3 → 0.1.5

package/lib/project-deps.js

@@ -1,14 +1,170 @@
+import { createRequire } from 'node:module';
+import fs from 'fs-extra';
+import path from 'node:path';
 /** 与 monorepo 中 agent / test-bot 对齐的 MCP SDK 版本 */
 export const MCP_SDK_VERSION = '^1.29.0';
+const AI_STACK_VERSION = '^4.0.0';
+const ZOD_VERSION = '^4.0.0';
+const VERCEL_AI_VERSION = '^6.0.0';
+const PROVIDER_SDK_PACKAGES = {
+    openai: { pkg: '@ai-sdk/openai', version: '^3.0.0' },
+    anthropic: { pkg: '@ai-sdk/anthropic', version: '^3.0.0' },
+    google: { pkg: '@ai-sdk/google', version: '^3.0.0' },
+    gemini: { pkg: '@ai-sdk/google', version: '^3.0.0' },
+    deepseek: { pkg: '@ai-sdk/deepseek', version: '^1.0.0' },
+    ollama: { pkg: '@ai-sdk/openai-compatible', version: '^1.0.0' },
+    moonshot: { pkg: '@ai-sdk/openai-compatible', version: '^1.0.0' },
+    zhipu: { pkg: '@ai-sdk/openai-compatible', version: '^1.0.0' },
+};
+function providerSdkPackage(provider) {
+    if (!provider)
+        return undefined;
+    return PROVIDER_SDK_PACKAGES[provider];
+}
+/** 启用 AI 时将写入 package.json 的依赖名（用于向导提示与 CLI 输出） */
+export function listAIDependencyNames(provider, options) {
+    const names = ['@zhin.js/agent', 'zod', 'ai'];
+    if (options?.includeMcp !== false) {
+        names.push('@modelcontextprotocol/sdk');
+    }
+    const sdk = providerSdkPackage(provider);
+    if (sdk && !names.includes(sdk.pkg)) {
+        names.push(sdk.pkg);
+    }
+    return names;
+}
+export function formatAIDependencyHint(provider, options) {
+    return listAIDependencyNames(provider, options).join(', ');
+}
+/** zhin.config 中是否启用了 AI（enabled 未显式 false 且存在 agents/providers） */
+export function isAiEnabledInConfig(config) {
+    const ai = config.ai;
+    if (!ai || typeof ai !== 'object' || Array.isArray(ai))
+        return false;
+    const rec = ai;
+    if (rec.enabled === false)
+        return false;
+    if (rec.enabled === true)
+        return true;
+    const agents = rec.agents;
+    if (agents && typeof agents === 'object' && !Array.isArray(agents) && Object.keys(agents).length > 0) {
+        return true;
+    }
+    const providers = rec.providers;
+    if (providers && typeof providers === 'object' && !Array.isArray(providers) && Object.keys(providers).length > 0) {
+        return true;
+    }
+    return false;
+}
+export function resolveDefaultProviderFromConfig(config) {
+    const ai = config.ai;
+    if (!ai || typeof ai !== 'object' || Array.isArray(ai))
+        return undefined;
+    const rec = ai;
+    const agents = rec.agents;
+    if (agents && typeof agents === 'object' && !Array.isArray(agents)) {
+        const zhin = agents.zhin;
+        if (zhin?.provider)
+            return String(zhin.provider);
+        const firstAgent = Object.values(agents)[0];
+        if (firstAgent?.provider)
+            return String(firstAgent.provider);
+    }
+    const providers = rec.providers;
+    if (providers && typeof providers === 'object' && !Array.isArray(providers)) {
+        const first = Object.keys(providers)[0];
+        if (first)
+            return first;
+    }
+    if (rec.defaultProvider != null)
+        return String(rec.defaultProvider);
+    return undefined;
+}
+function aiConfigNeedsMcp(ai) {
+    if (ai.memoryMcp === true)
+        return true;
+    const servers = ai.mcpServers;
+    return Array.isArray(servers) && servers.length > 0;
+}
+/** 根据 zhin.config 的 ai 段推导应安装的 production 依赖 */
+export function getRequiredAIDependenciesForConfig(config) {
+    if (!isAiEnabledInConfig(config))
+        return {};
+    const ai = config.ai;
+    const setup = {
+        enabled: true,
+        defaultProvider: resolveDefaultProviderFromConfig(config),
+        memoryMcp: aiConfigNeedsMcp(ai),
+    };
+    const deps = getAIDependencies(setup);
+    if (!aiConfigNeedsMcp(ai)) {
+        delete deps['@modelcontextprotocol/sdk'];
+    }
+    return deps;
+}
+export function findMissingPackageDependencies(pkg, required) {
+    const declared = new Set([
+        ...Object.keys(pkg.dependencies ?? {}),
+        ...Object.keys(pkg.devDependencies ?? {}),
+    ]);
+    return Object.keys(required).filter((name) => !declared.has(name));
+}
+export function findUnresolvedPackageInstalls(cwd, packageNames) {
+    const pkgJson = path.join(cwd, 'package.json');
+    if (!fs.existsSync(pkgJson))
+        return [...packageNames];
+    const req = createRequire(pkgJson);
+    const missing = [];
+    for (const name of packageNames) {
+        try {
+            req.resolve(`${name}/package.json`);
+        }
+        catch {
+            missing.push(name);
+        }
+    }
+    return missing;
+}
+export function diagnoseAIDependencies(cwd, config, pkg) {
+    if (!isAiEnabledInConfig(config))
+        return null;
+    const required = getRequiredAIDependenciesForConfig(config);
+    const packageJsonPath = path.join(cwd, 'package.json');
+    const packageJson = pkg ?? (fs.existsSync(packageJsonPath) ? fs.readJsonSync(packageJsonPath) : {});
+    const missingFromPackageJson = findMissingPackageDependencies(packageJson, required);
+    const declared = Object.keys(required).filter((name) => !missingFromPackageJson.includes(name));
+    const notInstalled = findUnresolvedPackageInstalls(cwd, declared);
+    return {
+        enabled: true,
+        provider: resolveDefaultProviderFromConfig(config),
+        required,
+        missingFromPackageJson,
+        notInstalled,
+    };
+}
+export function formatAIDependencyFixCommand(missing, required) {
+    if (missing.length === 0)
+        return 'pnpm install';
+    const specs = missing.map((name) => `${name}@${required[name] ?? 'latest'}`);
+    return `pnpm add ${specs.join(' ')}`;
+}
 /**
- * AI 启用时预装 MCP SDK，避免 memoryMcp / mcpServers 运行时报 optional peer 缺失。
+ * AI 启用时安装 agent 栈 + 所选 provider 的 @ai-sdk/* + 可选 MCP SDK。
  */
 export function getAIDependencies(ai) {
     if (!ai?.enabled)
         return {};
-    return {
+    const deps = {
+        '@zhin.js/agent': AI_STACK_VERSION,
+        zod: ZOD_VERSION,
+        ai: VERCEL_AI_VERSION,
         '@modelcontextprotocol/sdk': MCP_SDK_VERSION,
     };
+    const sdk = providerSdkPackage(ai.defaultProvider);
+    if (sdk) {
+        deps[sdk.pkg] = sdk.version;
+    }
+    return deps;
 }
 /**
  * AI 会话持久化默认开启时，若用户未选数据库则自动补 SQLite（零配置、与 inbox 一致）。

package/lib/project-deps.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-deps.js","sourceRoot":"","sources":["../src/project-deps.ts"],"names":[],"mappings":"AAGA,mDAAmD;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC;AAEzC;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAkB;IAClD,IAAI,CAAC,EAAE,EAAE,OAAO;QAAE,OAAO,EAAE,CAAC;IAC5B,OAAO;QACL,2BAA2B,EAAE,eAAe;KAC7C,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAoB;IACtD,IAAI,OAAO,CAAC,GAAG;QAAE,OAAO;IACxB,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO;QAAE,OAAO;IACjC,IAAI,OAAO,CAAC,QAAQ;QAAE,OAAO;IAE7B,MAAM,WAAW,GAAG,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,KAAK,CAAC;IAC/D,IAAI,CAAC,WAAW;QAAE,OAAO;IAEzB,OAAO,CAAC,QAAQ,GAAG;QACjB,OAAO,EAAE,QAAQ;QACjB,QAAQ,EAAE,eAAe;QACzB,IAAI,EAAE,KAAK;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAoB;IAC5D,IAAI,OAAO,CAAC,GAAG;QAAE,OAAO;IACxB,IAAI,OAAO,CAAC,QAAQ;QAAE,OAAO;IAC7B,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,gBAAgB;QAAE,OAAO;IAEhD,OAAO,CAAC,QAAQ,GAAG;QACjB,OAAO,EAAE,QAAQ;QACjB,QAAQ,EAAE,eAAe;QACzB,IAAI,EAAE,KAAK;KACZ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"project-deps.js","sourceRoot":"","sources":["../src/project-deps.ts"],"names":[],"mappings":"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"}

package/lib/types.d.ts

@@ -4,6 +4,7 @@ export type { AISetupConfig } from './ai.js';
 export type { AdapterSetupResult } from './adapter.js';
 export interface InitOptions {
     name?: string;
+    template?: 'default' | 'life-assistant';
     config?: 'json' | 'yaml' | 'toml';
     runtime?: 'node' | 'bun';
     yes?: boolean;

package/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,EAAE,CAAC,EAAE,aAAa,CAAC;IACnB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IACzD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAGD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAMnF,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,GAAG,gBAAgB,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,EAAE,CAAC,EAAE,aAAa,CAAC;IACnB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IACzD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAGD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAMnF,CAAC"}

package/lib/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAwBA,gDAAgD;AAChD,MAAM,CAAC,MAAM,iBAAiB,GAA0D;IACtF,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,QAAQ;IACf,EAAE,EAAE,IAAI;IACR,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACf,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAyBA,gDAAgD;AAChD,MAAM,CAAC,MAAM,iBAAiB,GAA0D;IACtF,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,QAAQ;IACf,EAAE,EAAE,IAAI;IACR,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/scaffold-wizard",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Shared interactive scaffold wizard for create-zhin-app and @zhin.js/cli",
   "type": "module",
   "main": "./lib/index.js",
@@ -24,7 +24,7 @@
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
     "@types/inquirer": "^9.0.7",
-    "@types/node": "^25.9.1",
+    "@types/node": "^25.9.2",
     "typescript": "^6.0.3"
   },
   "engines": {
@@ -40,6 +40,11 @@
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "author": {
+    "name": "lc-cn",
+    "email": "admin@liucl.cn",
+    "url": "https://github.com/lc-cn"
+  },
   "scripts": {
     "build": "tsc",
     "clean": "rimraf lib",

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;
 }