@zhin.js/scaffold-wizard 0.1.9 → 0.2.0

package/src/adapter-configurers.ts

@@ -1,5 +1,6 @@
 import inquirer from 'inquirer';
 import chalk from 'chalk';
+import { IlinkQrLoginError, loginWithIlinkQr } from './weixin-ilink-login.js';
 
 /** 平台适配器文档索引 */
 export const ADAPTERS_DOCS_URL = 'https://zhin.js.org/adapters/';
@@ -60,10 +61,10 @@ export async function configureTelegramEndpoint(ctx: EndpointConfigureContext):
     },
   ]);
 
-  const endpointConfig: Record<string, unknown> = {
-    name: endpointName.trim(),
-    token: '${TELEGRAM_TOKEN}',
+  // schema：polling / webhook 为顶层共享字段；name / token 为 endpoint 级
+  const config: Record<string, unknown> = {
     polling: transport === 'polling',
+    endpoints: [{ name: endpointName.trim(), token: '${TELEGRAM_TOKEN}' }],
   };
 
   if (transport === 'webhook') {
@@ -91,14 +92,14 @@ export async function configureTelegramEndpoint(ctx: EndpointConfigureContext):
       },
     ]);
 
-    endpointConfig.polling = false;
-    endpointConfig.webhook = {
+    config.polling = false;
+    config.webhook = {
       domain: webhook.domain.trim(),
       path: webhook.path.trim(),
     };
   }
 
-  return endpointConfig;
+  return config;
 }
 
 export async function configureGitHubEndpoint(ctx: EndpointConfigureContext): Promise<Record<string, unknown>> {
@@ -134,9 +135,11 @@ export async function configureGitHubEndpoint(ctx: EndpointConfigureContext): Pr
     },
   ]);
 
+  // schema：app_id / private_key / webhook_secret 为 endpoint 级；webhook_path / poll_interval 为顶层共享字段
   const endpointConfig: Record<string, unknown> = {
     name: endpointName.trim(),
   };
+  const sharedConfig: Record<string, unknown> = {};
 
   if (authMode === 'github_app') {
     console.log(chalk.gray('     在 github.com/settings/apps 创建 App，记录 App ID 并下载 .pem 私钥'));
@@ -206,7 +209,7 @@ export async function configureGitHubEndpoint(ctx: EndpointConfigureContext): Pr
 
     ctx.envVars.GITHUB_WEBHOOK_SECRET = webhook.webhook_secret;
     endpointConfig.webhook_secret = '${GITHUB_WEBHOOK_SECRET}';
-    endpointConfig.webhook_path = webhook.webhook_path.trim();
+    sharedConfig.webhook_path = webhook.webhook_path.trim();
   } else {
     const { poll_interval } = await inquirer.prompt([
       {
@@ -221,7 +224,7 @@ export async function configureGitHubEndpoint(ctx: EndpointConfigureContext): Pr
         },
       },
     ]);
-    endpointConfig.poll_interval = parseInt(poll_interval, 10);
+    sharedConfig.poll_interval = parseInt(poll_interval, 10);
   }
 
   const { enableMcp } = await inquirer.prompt([
@@ -245,7 +248,7 @@ export async function configureGitHubEndpoint(ctx: EndpointConfigureContext): Pr
     ctx.envVars.GITHUB_PERSONAL_ACCESS_TOKEN = pat;
   }
 
-  return endpointConfig;
+  return { ...sharedConfig, endpoints: [endpointConfig] };
 }
 
 export async function configureOneBot11Bot(ctx: EndpointConfigureContext): Promise<Record<string, unknown>> {
@@ -274,8 +277,8 @@ export async function configureOneBot11Bot(ctx: EndpointConfigureContext): Promi
     },
   ]);
 
+  // schema：connection 为顶层共享字段；name / url / path / access_token 为 endpoint 级
   const endpointConfig: Record<string, unknown> = {
-    connection,
     name: endpointName.trim(),
   };
 
@@ -317,7 +320,7 @@ export async function configureOneBot11Bot(ctx: EndpointConfigureContext): Promi
     endpointConfig.access_token = '${ONEBOT11_ACCESS_TOKEN}';
   }
 
-  return endpointConfig;
+  return { connection, endpoints: [endpointConfig] };
 }
 
 export async function configureQQBot(ctx: EndpointConfigureContext): Promise<Record<string, unknown>> {
@@ -367,12 +370,15 @@ export async function configureQQBot(ctx: EndpointConfigureContext): Promise<Rec
     },
   ]);
 
+  // schema：mode / sandbox 为顶层共享字段；name / appid / secret 为 endpoint 级
   return {
-    name: credentials.name.trim(),
-    appid: '${QQ_APP_ID}',
-    secret: '${QQ_SECRET}',
     mode,
     sandbox,
+    endpoints: [{
+      name: credentials.name.trim(),
+      appid: '${QQ_APP_ID}',
+      secret: '${QQ_SECRET}',
+    }],
   };
 }
 
@@ -409,10 +415,10 @@ export async function configureDiscordEndpoint(ctx: EndpointConfigureContext): P
   ]);
   ctx.envVars.DISCORD_TOKEN = token;
 
-  const endpointConfig: Record<string, unknown> = {
+  // schema：connection / applicationId / publicKey / interactionsPath 为顶层共享字段；name / token 为 endpoint 级
+  const config: Record<string, unknown> = {
     connection,
-    name: endpointName.trim(),
-    token: '${DISCORD_TOKEN}',
+    endpoints: [{ name: endpointName.trim(), token: '${DISCORD_TOKEN}' }],
   };
 
   if (connection === 'interactions') {
@@ -437,12 +443,12 @@ export async function configureDiscordEndpoint(ctx: EndpointConfigureContext): P
         default: '/discord/interactions',
       },
     ]);
-    endpointConfig.applicationId = interactions.applicationId.trim();
-    endpointConfig.publicKey = interactions.publicKey.trim();
-    endpointConfig.interactionsPath = interactions.interactionsPath.trim();
+    config.applicationId = interactions.applicationId.trim();
+    config.publicKey = interactions.publicKey.trim();
+    config.interactionsPath = interactions.interactionsPath.trim();
   }
 
-  return endpointConfig;
+  return config;
 }
 
 export async function configureSlackEndpoint(ctx: EndpointConfigureContext): Promise<Record<string, unknown>> {
@@ -486,11 +492,11 @@ export async function configureSlackEndpoint(ctx: EndpointConfigureContext): Pro
   ctx.envVars.SLACK_BOT_TOKEN = token;
   ctx.envVars.SLACK_SIGNING_SECRET = signingSecret;
 
+  // schema：socketMode 为顶层共享字段；name / token / signingSecret / appToken 为 endpoint 级
   const endpointConfig: Record<string, unknown> = {
     name: endpointName.trim(),
     token: '${SLACK_BOT_TOKEN}',
     signingSecret: '${SLACK_SIGNING_SECRET}',
-    socketMode: socketMode === 'true',
   };
 
   if (socketMode === 'true') {
@@ -508,5 +514,431 @@ export async function configureSlackEndpoint(ctx: EndpointConfigureContext): Pro
     console.log(chalk.yellow('     HTTP 模式由内置 HTTP Host 承接，需公网可达并配置 Slack Event Subscriptions URL'));
   }
 
-  return endpointConfig;
+  return { socketMode: socketMode === 'true', endpoints: [endpointConfig] };
+}
+
+export async function configureNapcatBot(ctx: EndpointConfigureContext): Promise<Record<string, unknown>> {
+  console.log(chalk.gray('     文档: ' + adapterDocsUrl('napcat')));
+
+  const { connection } = await inquirer.prompt([
+    {
+      type: 'select',
+      name: 'connection',
+      message: '  连接方式:',
+      choices: [
+        { name: '正向 WebSocket (ws) — 本 Bot 连接 NapCat', value: 'ws' },
+        { name: '反向 WebSocket (wss) — NapCat 连本 Bot（由内置 HTTP Host 承接）', value: 'wss' },
+        { name: 'HTTP (http) — POST 上报入站 + HTTP API 出站（由内置 HTTP Host 承接）', value: 'http' },
+      ],
+      default: 'ws',
+    },
+  ]);
+
+  const { endpointName } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'endpointName',
+      message: '  Endpoint 标识名称:',
+      default: 'napcat-bot',
+      validate: (v: string) => (v.trim() ? true : '名称不能为空'),
+    },
+  ]);
+
+  // schema：connection 为顶层共享字段；name / url / path / http_url / post_path / access_token 为 endpoint 级
+  const endpointConfig: Record<string, unknown> = {
+    name: endpointName.trim(),
+  };
+
+  if (connection === 'ws') {
+    const { url } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'url',
+        message: '  NapCat WS 地址:',
+        default: 'ws://127.0.0.1:3001',
+        validate: (v: string) => (v.trim() ? true : '地址不能为空'),
+      },
+    ]);
+    endpointConfig.url = url.trim();
+  } else if (connection === 'wss') {
+    console.log(chalk.gray('     反向 WS 由内置 HTTP Host 承接，NapCat 配置连接到此 Bot'));
+    const { path: wsPath } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'path',
+        message: '  反向 WS 路径:',
+        default: '/napcat/ws',
+        validate: (v: string) => (v.trim() ? true : '路径不能为空'),
+      },
+    ]);
+    endpointConfig.path = wsPath.trim();
+  } else {
+    const http = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'http_url',
+        message: '  NapCat HTTP API 地址（出站）:',
+        default: 'http://127.0.0.1:3000',
+        validate: (v: string) => (v.trim() ? true : '地址不能为空'),
+      },
+      {
+        type: 'input',
+        name: 'post_path',
+        message: '  HTTP POST 上报路径（入站）:',
+        default: '/napcat/post',
+        validate: (v: string) => (v.trim() ? true : '路径不能为空'),
+      },
+    ]);
+    endpointConfig.http_url = http.http_url.trim();
+    endpointConfig.post_path = http.post_path.trim();
+  }
+
+  const { accessToken } = await inquirer.prompt([
+    {
+      type: 'password',
+      name: 'accessToken',
+      message: '  access_token（无则留空）:',
+      default: '',
+    },
+  ]);
+  if (accessToken?.trim()) {
+    ctx.envVars.NAPCAT_TOKEN = accessToken.trim();
+    endpointConfig.access_token = '${NAPCAT_TOKEN}';
+  }
+
+  return { connection, endpoints: [endpointConfig] };
+}
+
+export async function configureOneBot12Bot(ctx: EndpointConfigureContext): Promise<Record<string, unknown>> {
+  console.log(chalk.gray('     文档: ' + adapterDocsUrl('onebot12')));
+
+  const { connection } = await inquirer.prompt([
+    {
+      type: 'select',
+      name: 'connection',
+      message: '  连接方式:',
+      choices: [
+        { name: '正向 WebSocket (ws) — 本 Bot 连接 OneBot 实现', value: 'ws' },
+        { name: 'HTTP Webhook (webhook) — POST 入站 + api_url HTTP 出站（由内置 HTTP Host 承接）', value: 'webhook' },
+        { name: '反向 WebSocket (wss) — OneBot 实现连本 Bot（由内置 HTTP Host 承接）', value: 'wss' },
+      ],
+      default: 'ws',
+    },
+  ]);
+
+  const { endpointName } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'endpointName',
+      message: '  Endpoint 标识名称:',
+      default: 'onebot12-bot',
+      validate: (v: string) => (v.trim() ? true : '名称不能为空'),
+    },
+  ]);
+
+  // schema：connection 为顶层共享字段；name / url / path / api_url / access_token 为 endpoint 级
+  const endpointConfig: Record<string, unknown> = {
+    name: endpointName.trim(),
+  };
+
+  if (connection === 'ws') {
+    const { url } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'url',
+        message: '  OneBot WS 地址:',
+        default: 'ws://127.0.0.1:6700',
+        validate: (v: string) => (v.trim() ? true : '地址不能为空'),
+      },
+    ]);
+    endpointConfig.url = url.trim();
+  } else if (connection === 'webhook') {
+    const webhook = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'path',
+        message: '  Webhook POST 路径（入站）:',
+        default: '/onebot12/webhook',
+        validate: (v: string) => (v.trim() ? true : '路径不能为空'),
+      },
+      {
+        type: 'input',
+        name: 'api_url',
+        message: '  HTTP action 地址（出站）:',
+        default: 'http://127.0.0.1:6700',
+        validate: (v: string) => (v.trim() ? true : '地址不能为空'),
+      },
+    ]);
+    endpointConfig.path = webhook.path.trim();
+    endpointConfig.api_url = webhook.api_url.trim();
+  } else {
+    console.log(chalk.gray('     反向 WS 由内置 HTTP Host 承接，OneBot 实现配置连接到此 Bot'));
+    const { path: wsPath } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'path',
+        message: '  反向 WS 路径:',
+        default: '/onebot12/ws',
+        validate: (v: string) => (v.trim() ? true : '路径不能为空'),
+      },
+    ]);
+    endpointConfig.path = wsPath.trim();
+  }
+
+  const { accessToken } = await inquirer.prompt([
+    {
+      type: 'password',
+      name: 'accessToken',
+      message: '  access_token（无则留空）:',
+      default: '',
+    },
+  ]);
+  if (accessToken?.trim()) {
+    ctx.envVars.ONEBOT12_ACCESS_TOKEN = accessToken.trim();
+    endpointConfig.access_token = '${ONEBOT12_ACCESS_TOKEN}';
+  }
+
+  return { connection, endpoints: [endpointConfig] };
+}
+
+export async function configureMilkyBot(ctx: EndpointConfigureContext): Promise<Record<string, unknown>> {
+  console.log(chalk.gray('     文档: ' + adapterDocsUrl('milky')));
+
+  const { connection } = await inquirer.prompt([
+    {
+      type: 'select',
+      name: 'connection',
+      message: '  连接方式:',
+      choices: [
+        { name: '正向 WebSocket (ws) — 本 Bot 连协议端 ws(s)://baseUrl/event', value: 'ws' },
+        { name: 'SSE (sse) — HTTP GET baseUrl/event（text/event-stream）', value: 'sse' },
+        { name: 'Webhook (webhook) — POST 入站 + baseUrl HTTP API 出站（由内置 HTTP Host 承接）', value: 'webhook' },
+        { name: '反向 WebSocket (wss) — 由内置 HTTP Host 承接', value: 'wss' },
+      ],
+      default: 'ws',
+    },
+  ]);
+
+  const { endpointName, baseUrl } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'endpointName',
+      message: '  Endpoint 标识名称:',
+      default: 'milky-bot',
+      validate: (v: string) => (v.trim() ? true : '名称不能为空'),
+    },
+    {
+      type: 'input',
+      name: 'baseUrl',
+      message: '  Milky HTTP API baseUrl:',
+      default: 'http://127.0.0.1:8080',
+      validate: (v: string) => (v.trim() ? true : 'baseUrl 不能为空'),
+    },
+  ]);
+
+  // schema：connection 为顶层共享字段；name / baseUrl / path / access_token 为 endpoint 级
+  const endpointConfig: Record<string, unknown> = {
+    name: endpointName.trim(),
+    baseUrl: baseUrl.trim(),
+  };
+
+  if (connection === 'webhook' || connection === 'wss') {
+    const { path: hookPath } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'path',
+        message: `  ${connection === 'webhook' ? 'Webhook POST' : '反向 WS'} 路径:`,
+        default: connection === 'webhook' ? '/milky/webhook' : '/milky/ws',
+        validate: (v: string) => (v.trim() ? true : '路径不能为空'),
+      },
+    ]);
+    endpointConfig.path = hookPath.trim();
+  }
+
+  const { accessToken } = await inquirer.prompt([
+    {
+      type: 'password',
+      name: 'accessToken',
+      message: '  access_token（无则留空）:',
+      default: '',
+    },
+  ]);
+  if (accessToken?.trim()) {
+    ctx.envVars.MILKY_ACCESS_TOKEN = accessToken.trim();
+    endpointConfig.access_token = '${MILKY_ACCESS_TOKEN}';
+  }
+
+  return { connection, endpoints: [endpointConfig] };
+}
+
+export async function configureSatoriBot(ctx: EndpointConfigureContext): Promise<Record<string, unknown>> {
+  console.log(chalk.gray('     文档: ' + adapterDocsUrl('satori')));
+
+  const { connection } = await inquirer.prompt([
+    {
+      type: 'select',
+      name: 'connection',
+      message: '  连接方式:',
+      choices: [
+        { name: '正向 WebSocket (ws) — 本 Bot 连 Satori SDK', value: 'ws' },
+        { name: 'Webhook (webhook) — SDK POST 事件到 path（由内置 HTTP Host 承接）', value: 'webhook' },
+      ],
+      default: 'ws',
+    },
+  ]);
+
+  const { endpointName, baseUrl } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'endpointName',
+      message: '  Endpoint 标识名称:',
+      default: 'satori-bot',
+      validate: (v: string) => (v.trim() ? true : '名称不能为空'),
+    },
+    {
+      type: 'input',
+      name: 'baseUrl',
+      message: '  Satori SDK baseUrl:',
+      default: 'http://127.0.0.1:5140',
+      validate: (v: string) => (v.trim() ? true : 'baseUrl 不能为空'),
+    },
+  ]);
+
+  // schema：connection 为顶层共享字段；name / baseUrl / token / path 为 endpoint 级
+  const endpointConfig: Record<string, unknown> = {
+    name: endpointName.trim(),
+    baseUrl: baseUrl.trim(),
+  };
+
+  if (connection === 'webhook') {
+    const { path: hookPath } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'path',
+        message: '  Webhook POST 路径:',
+        default: '/satori/webhook',
+        validate: (v: string) => (v.trim() ? true : '路径不能为空'),
+      },
+    ]);
+    endpointConfig.path = hookPath.trim();
+  }
+
+  const { token } = await inquirer.prompt([
+    {
+      type: 'password',
+      name: 'token',
+      message: '  Bearer Token（无则留空）:',
+      default: '',
+    },
+  ]);
+  if (token?.trim()) {
+    ctx.envVars.SATORI_TOKEN = token.trim();
+    endpointConfig.token = '${SATORI_TOKEN}';
+  }
+
+  return { connection, endpoints: [endpointConfig] };
+}
+
+/**
+ * 微信 iLink（个人微信 / ClawBot）配置：默认走扫码绑定 —— 终端展示二维码，
+ * 微信扫码确认后 bot_token 写入 .env（`WEIXIN_ILINK_TOKEN`），
+ * zhin.config.yml 只留 `${WEIXIN_ILINK_TOKEN}` 引用；扫码失败可降级手动输入 token。
+ */
+export async function configureWeixinIlinkBot(ctx: EndpointConfigureContext): Promise<Record<string, unknown>> {
+  console.log(chalk.gray('     文档: ' + adapterDocsUrl('weixin-ilink')));
+  console.log(chalk.gray('     需最新版微信 + ClawBot 灰度资格（仅私聊）'));
+
+  const { endpointName } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'endpointName',
+      message: '  Endpoint 标识名称:',
+      default: 'weixin-bot',
+      validate: (v: string) => (v.trim() ? true : '名称不能为空'),
+    },
+  ]);
+
+  const { method } = await inquirer.prompt([
+    {
+      type: 'select',
+      name: 'method',
+      message: '  登录方式:',
+      choices: [
+        { name: '扫码绑定（微信 ClawBot 入口扫码，自动获取 bot_token）', value: 'qr' },
+        { name: '手动输入 bot_token', value: 'manual' },
+      ],
+      default: 'qr',
+    },
+  ]);
+
+  if (method === 'qr') {
+    const scanned = await tryQrLogin(ctx);
+    if (scanned) {
+      return {
+        endpoints: [{ name: endpointName.trim(), botToken: '${WEIXIN_ILINK_TOKEN}' }],
+      };
+    }
+    console.log(chalk.yellow('     扫码未完成，降级为手动输入 bot_token'));
+  }
+
+  const { token } = await inquirer.prompt([
+    {
+      type: 'password',
+      name: 'token',
+      message: '  iLink Bot Token:',
+      validate: (v: string) => (v.trim() ? true : 'Token 不能为空'),
+    },
+  ]);
+  ctx.envVars.WEIXIN_ILINK_TOKEN = token.trim();
+  return {
+    endpoints: [{ name: endpointName.trim(), botToken: '${WEIXIN_ILINK_TOKEN}' }],
+  };
+}
+
+/** 扫码尝试：成功写入 envVars 并返回 true；用户放弃/过期/超时返回 false。 */
+async function tryQrLogin(ctx: EndpointConfigureContext): Promise<boolean> {
+  // 动态加载 qrcode：扫码路径才需要，失败则降级为纯链接展示
+  let renderQr: ((text: string) => Promise<string>) | undefined;
+  try {
+    const qrcode = await import('qrcode');
+    renderQr = (text) => qrcode.toString(text, { type: 'terminal', small: true });
+  } catch {
+    renderQr = undefined;
+  }
+
+  for (;;) {
+    try {
+      const creds = await loginWithIlinkQr({
+        onQrCode: async (url) => {
+          console.log('');
+          if (renderQr) {
+            console.log(await renderQr(url));
+          }
+          console.log(chalk.cyan('     请用微信扫描上方二维码（或打开链接完成绑定）:'));
+          console.log(chalk.cyan(`     ${url}`));
+          console.log('');
+        },
+        onStatus: (status) => {
+          if (status === 'scaned') {
+            console.log(chalk.green('     已扫码，请在微信中确认…'));
+          }
+        },
+      });
+      ctx.envVars.WEIXIN_ILINK_TOKEN = creds.botToken;
+      console.log(chalk.green('     绑定成功，bot_token 已写入 .env（WEIXIN_ILINK_TOKEN）'));
+      return true;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.log(chalk.yellow(`     扫码登录失败：${message}`));
+      const { retry } = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'retry',
+          message: '  重新获取二维码再试一次？（选否则手动输入 token）',
+          default: error instanceof IlinkQrLoginError && error.reason === 'expired',
+        },
+      ]);
+      if (!retry) return false;
+    }
+  }
 }