botmux 2.99.0 → 2.101.0

package/dist/cli.js

@@ -5,6 +5,7 @@
  * Usage:
  *   botmux setup          — interactive first-time configuration
  *   botmux setup --no-open-platform-auto — skip Feishu Open Platform automation
+ *   botmux setup list|add|edit|remove — scripted (non-TUI) bot management, see `botmux setup help`
  *   botmux start          — start daemon (pm2)
  *   botmux stop           — stop daemon
  *   botmux restart [--include-pm2] — restart daemon (optionally restart PM2 God too)
@@ -21,7 +22,7 @@
 import { execSync, execFileSync, spawnSync, spawn } from 'node:child_process';
 import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync, renameSync, readdirSync, readlinkSync, appendFileSync, statSync, unlinkSync } from 'node:fs';
 import { atomicWriteFileSync } from './utils/atomic-write.js';
-import { join, dirname, basename } from 'node:path';
+import { join, dirname, basename, resolve } from 'node:path';
 import { homedir } from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { createInterface } from 'node:readline';
@@ -35,10 +36,11 @@ import { tmuxEnv } from './setup/ensure-tmux.js';
 import { writeBotsJsonAtomic as writeBotsAtomic } from './setup/bots-store.js';
 import { applyBotConfigEdits, assertUniqueBotProcessNames, botProcessName, normalizeBotConfig, parseBotConfigsJson, parseBotSelection, removeBotConfig, resolveCliId, assertOwnerWhenChatGroups, findInvalidAllowedUserEntries, hasOwnerEntry, } from './setup/bot-config-editor.js';
 import { resolveCliSelection, selectionKeyForBot } from './setup/cli-selection.js';
-import { pickCliSelection } from './setup/interactive-select.js';
+import { buildBotFromAddFlags, editInputFromFlags, isScriptedSetupInvocation, maskAppSecret, parseSetupCommand, SETUP_CLI_USAGE, } from './setup/setup-args.js';
+import { interactiveSelect, pickChoice, pickCliSelection } from './setup/interactive-select.js';
 import { buildPreset, serializePreset, presetFilename } from './setup/agent-preset.js';
 import { logger } from './utils/logger.js';
-import { invalidWorkingDirs } from './utils/working-dir.js';
+import { expandHomePath, invalidWorkingDirs } from './utils/working-dir.js';
 import { firstPositional } from './cli/arg-utils.js';
 import { dispatchPrimaryMessage, findStdinAliasAttachment, sendFileAttachments } from './cli/send-dispatch.js';
 import { buildPm2SpawnCommand } from './cli/pm2-command.js';
@@ -240,6 +242,22 @@ function ensureBotWorkingDirsExist(bot, context = 'workingDir') {
     console.log('   请先创建目录，或重新填写一个已存在的工作目录。');
     return false;
 }
+/**
+ * 固定默认目录（defaultWorkingDir）写盘前的存在性校验。运行时 daemon 对无效
+ * defaultWorkingDir 只是 WARN 后回退弹仓库选择卡，用户很难察觉配置根本没生效，
+ * 所以 setup 侧必须在写盘前就挡下来。未配置视为通过。
+ */
+function ensureBotDefaultWorkingDirExists(bot) {
+    const raw = typeof bot.defaultWorkingDir === 'string' ? bot.defaultWorkingDir.trim() : '';
+    if (!raw)
+        return true;
+    const missing = missingDirResolved(raw);
+    if (!missing)
+        return true;
+    console.log(`\n❌ 固定默认目录不存在或不是目录: ${missing}`);
+    console.log('   请先创建目录，或改用仓库选择卡片模式。');
+    return false;
+}
 function ensureUniqueBotProcessNames(bots) {
     try {
         assertUniqueBotProcessNames(bots, PM2_NAME);
@@ -490,10 +508,78 @@ async function finishOpenPlatformSetup(appId, brand) {
     printRemainingSteps(appId, brand);
 }
 /**
- * 让用户选"扫码建应用"还是"手动粘 AppID/Secret".
+ * 「选择已有应用」路径：复用/扫码飞书 Web 登录态 → 拉当前账号可见的自建应用
+ * 列表 → 交互选择 → 自动读取该应用的 AppSecret。仅支持飞书 (feishu.cn) 租户
+ * （Web console 机制所限）。
  *
- * 默认走扫码: 调 SDK `registerApp` → 拿 client_id/client_secret. 失败 (用户拒绝/
- * 超时/网络/取消) 一律降级到手动, 不阻塞流程.
+ * 失败返回区分两类，调用方据此导航：
+ *   - back   — 用户主动退出（列表 Esc / 放弃手动粘 secret）→ 回「飞书应用来源」
+ *   - failed — 技术性失败（登录 / 列表 / console 访问）→ 提示后回「飞书应用来源」
+ */
+async function pickExistingAppCredentials(rl) {
+    const { prepareFeishuWebSession, createOpenPlatformApiClient, listOpenPlatformApps, fetchOpenPlatformAppSecret, } = await import('./setup/open-platform-automation.js');
+    console.log('\n获取飞书 Web 登录态（复用上次登录，过期则需重新扫码）…');
+    const prepared = await prepareFeishuWebSession({
+        onQrCode: (info) => {
+            process.stderr.write('\n请用飞书 App 扫码登录，以读取你创建过的应用列表：\n\n');
+            process.stderr.write(`${info.qrText}\n`);
+        },
+        onStatus: (message) => { process.stderr.write(`${message}\n`); },
+    });
+    if (!prepared.ok) {
+        console.log(`⚠️  飞书 Web 登录失败 (${prepared.reason}): ${prepared.message}`);
+        return { ok: false, reason: 'failed' };
+    }
+    const clientRes = await createOpenPlatformApiClient(prepared.cookies);
+    if (!clientRes.ok) {
+        console.log(`⚠️  开放平台访问失败 (${clientRes.reason}): ${clientRes.message}`);
+        return { ok: false, reason: 'failed' };
+    }
+    let apps;
+    try {
+        apps = await listOpenPlatformApps(clientRes.client);
+    }
+    catch (err) {
+        console.log(`⚠️  拉取应用列表失败: ${err?.message ?? String(err)}`);
+        return { ok: false, reason: 'failed' };
+    }
+    if (apps.length === 0) {
+        console.log('⚠️  当前账号名下没有可选的自建应用。');
+        return { ok: false, reason: 'failed' };
+    }
+    // 已在 bots.json 里的应用打标——可以重复选（比如换机器重配），但要让人知道。
+    const configured = new Set(loadBotsJson().map(b => b?.larkAppId));
+    const idx = await pickChoice(rl, {
+        title: '选择已有应用',
+        items: apps.map(a => ({
+            label: a.name,
+            hint: `${a.clientId}${configured.has(a.clientId) ? ' · 已在 bots.json' : ''}`,
+        })),
+        footer: 'Esc 返回上一步',
+    });
+    if (idx === null)
+        return { ok: false, reason: 'back' };
+    const app = apps[idx];
+    try {
+        const appSecret = await fetchOpenPlatformAppSecret(clientRes.client, app.clientId);
+        console.log(`✅ 已选择 ${app.name} (${app.clientId})，AppSecret 已自动获取`);
+        return { ok: true, appId: app.clientId, appSecret, brand: 'feishu' };
+    }
+    catch (err) {
+        console.log(`⚠️  自动读取 AppSecret 失败: ${err?.message ?? String(err)}`);
+        const manual = (await ask(rl, `请手动粘贴 ${app.clientId} 的 AppSecret（留空返回上一步）: `)).trim();
+        if (!manual)
+            return { ok: false, reason: 'back' };
+        return { ok: true, appId: app.clientId, appSecret: manual, brand: 'feishu' };
+    }
+}
+/**
+ * 拿应用凭证：扫码创建新应用 / 选择已有应用 / 手动输入，三选一。
+ *
+ * 导航语义（TTY）：子界面 Esc / 主动放弃一律**返回「飞书应用来源」菜单**，
+ * 只有在来源菜单本身 Esc（或扫码时 Ctrl-C）才取消整个 setup；技术性失败
+ * 提示后同样回到来源菜单，让用户改走其他方式。非 TTY 没有 Esc，保持
+ * 旧的「失败降级手动输入」直落语义，避免菜单循环在管道输入下打转。
  *
  * Codex review 边界:
  * - secret 不进 argv / 日志 / 错误链 (registerApp 内部 safeMsg 已做; 手动模式下
@@ -501,54 +587,90 @@ async function finishOpenPlatformSetup(appId, brand) {
  * - 任何失败都返回结构化对象, 不抛 (调用方根据 ok=false 回退)
  */
 async function obtainCredentials(rl) {
-    console.log('── 飞书应用建立 ──\n');
-    console.log('1) 扫码建应用（推荐，一步拿到 AppID/Secret，需要飞书 App 扫码）');
-    console.log('2) 手动粘 AppID/Secret（已经在开放平台创建好应用了）\n');
-    const choice = (await ask(rl, '选择 [1]: ')).trim();
-    if (choice !== '2') {
-        // 动态导入避免冷启动加载 SDK
-        const { tryRegisterApp } = await import('./setup/register-app.js');
-        const result = await tryRegisterApp();
-        if (result.ok) {
-            // brand 由扫码 device flow 的 tenant_brand 自动识别（registerApp 内部已
-            // 切到对应域名轮询）。feishu / lark 都直接落盘——daemon 链路全程从
-            // BotConfig.brand 派生 host（Client / WSClient domain、裸 fetch、深链）。
-            console.log(`\n✅ 应用创建成功`);
-            console.log(`   App ID: ${result.appId}`);
-            console.log(`   租户类型: ${result.brand === 'lark' ? 'Lark 国际版 (larksuite.com)' : '飞书 (feishu.cn)'}`);
-            if (result.userOpenId) {
-                console.log(`   扫码人 open_id: ${result.userOpenId}（将默认作为 allowedUsers）`);
+    const interactive = process.stdin.isTTY && process.stdout.isTTY;
+    console.log('── 飞书应用 ──\n');
+    for (;;) {
+        const method = await pickChoice(rl, {
+            title: '飞书应用来源',
+            items: [
+                { label: '扫码创建新应用（推荐）', hint: '飞书 App 扫码，自动创建并拿到 AppID/Secret' },
+                { label: '选择已有应用', hint: '飞书 Web 登录列出你创建过的应用，自动取 AppID/Secret（仅飞书租户）' },
+                { label: '手动输入 AppID/Secret', hint: '已在开放平台创建好应用' },
+            ],
+            defaultIndex: 0,
+            footer: 'Esc 取消 setup',
+        });
+        if (method === null)
+            return { ok: false, reason: 'cancelled' };
+        if (method === 0) {
+            // 动态导入避免冷启动加载 SDK
+            const { tryRegisterApp } = await import('./setup/register-app.js');
+            const result = await tryRegisterApp();
+            if (result.ok) {
+                // brand 由扫码 device flow 的 tenant_brand 自动识别（registerApp 内部已
+                // 切到对应域名轮询）。feishu / lark 都直接落盘——daemon 链路全程从
+                // BotConfig.brand 派生 host（Client / WSClient domain、裸 fetch、深链）。
+                console.log(`\n✅ 应用创建成功`);
+                console.log(`   App ID: ${result.appId}`);
+                console.log(`   租户类型: ${result.brand === 'lark' ? 'Lark 国际版 (larksuite.com)' : '飞书 (feishu.cn)'}`);
+                if (result.userOpenId) {
+                    console.log(`   扫码人 open_id: ${result.userOpenId}（将默认作为 allowedUsers）`);
+                }
+                return {
+                    ok: true,
+                    appId: result.appId,
+                    appSecret: result.appSecret,
+                    brand: result.brand,
+                    userOpenId: result.userOpenId,
+                };
             }
-            return {
-                ok: true,
-                appId: result.appId,
-                appSecret: result.appSecret,
-                brand: result.brand,
-                userOpenId: result.userOpenId,
-            };
-        }
-        console.log(`\n⚠️  扫码失败 (${result.error}): ${result.message}`);
-        if (result.error === 'aborted') {
-            // 用户主动取消整个 setup, 不再问手动 fallback
+            console.log(`\n⚠️  扫码失败 (${result.error}): ${result.message}`);
+            if (result.error === 'aborted') {
+                // 用户主动取消整个 setup, 不再问手动 fallback
+                return { ok: false, reason: 'cancelled' };
+            }
+            if (interactive) {
+                console.log('   已返回「飞书应用来源」，可重试或改走其他方式。\n');
+                continue;
+            }
+            console.log('   降级到手动输入 AppID/Secret。\n');
+        }
+        if (method === 1) {
+            const existing = await pickExistingAppCredentials(rl);
+            if (existing.ok)
+                return existing;
+            if (interactive) {
+                // back（Esc / 主动放弃）静默回菜单；failed 已打印过原因，补一句导航。
+                if (existing.reason === 'failed')
+                    console.log('   已返回「飞书应用来源」，可重试或改走其他方式。\n');
+                continue;
+            }
+            console.log('   降级到手动输入 AppID/Secret。\n');
+        }
+        // 手动输入（method 2；非 TTY 下也是 0/1 失败后的直落兜底）：扫码路径已用
+        // tenant_brand 自动识别；手动路径没有这个信号，兜底让用户手选租户类型
+        // （决定建应用 / 运行时的域名）。
+        const brandIdx = await pickChoice(rl, {
+            title: '租户类型',
+            items: [
+                { label: '飞书（中国版）', hint: 'open.feishu.cn' },
+                { label: 'Lark（国际版）', hint: 'open.larksuite.com' },
+            ],
+            defaultIndex: 0,
+            footer: 'Esc 返回上一步',
+        });
+        if (brandIdx === null && interactive)
+            continue; // Esc → 回「飞书应用来源」
+        const brand = brandIdx === 1 ? 'lark' : 'feishu';
+        console.log(`\n请在浏览器打开 ${larkHosts(brand).openApi}/app 创建应用，然后回来粘 ID/Secret。\n`);
+        const appId = (await ask(rl, 'AppID (cli_xxx): ')).trim();
+        const appSecret = (await ask(rl, 'AppSecret: ')).trim();
+        if (!appId || !appSecret) {
+            console.log('\n❌ AppID/AppSecret 不能为空，setup 中止。');
             return { ok: false, reason: 'cancelled' };
         }
-        console.log('   降级到手动输入 AppID/Secret。\n');
+        return { ok: true, appId, appSecret, brand };
     }
-    // 手动 fallback / 手动选项：扫码路径已用 tenant_brand 自动识别；手动路径
-    // 没有这个信号，兜底让用户手选租户类型（决定建应用 / 运行时的域名）。
-    console.log('\n租户类型：');
-    console.log('  1) 飞书（中国版，open.feishu.cn）');
-    console.log('  2) Lark（国际版，open.larksuite.com）');
-    const brandChoice = (await ask(rl, '选择 [1]: ')).trim();
-    const brand = brandChoice === '2' ? 'lark' : 'feishu';
-    console.log(`\n请在浏览器打开 ${larkHosts(brand).openApi}/app 创建应用，然后回来粘 ID/Secret。\n`);
-    const appId = (await ask(rl, 'AppID (cli_xxx): ')).trim();
-    const appSecret = (await ask(rl, 'AppSecret: ')).trim();
-    if (!appId || !appSecret) {
-        console.log('\n❌ AppID/AppSecret 不能为空，setup 中止。');
-        return { ok: false, reason: 'cancelled' };
-    }
-    return { ok: true, appId, appSecret, brand };
 }
 /**
  * 用新应用自身凭证验证扫码链路拿到的 open_id。
@@ -623,11 +745,17 @@ async function promptBotConfig(rl) {
     console.log('✅ 凭证有效（tenant_access_token 已成功获取）\n');
     // CLI 适配器：可搜索的级联选择器（选 Aiden 可进 × Claude / × Codex，aiden 网关）。
     // 非交互终端自动回退为序号 / ID 文本输入。
+    // Esc = 中止 setup（不写盘）。新建流程的必答题没有"上一步"可退，绝不静默
+    // 替用户选默认——扫码建出的应用可事后用「选择已有应用」找回，不会丢。
     const selKey = await pickCliSelection(rl, { title: '选择 CLI 适配器' });
+    if (selKey === null) {
+        console.log('\n已取消（Esc），setup 中止，不写任何配置。');
+        return null;
+    }
     let cliId;
     let wrapperCli;
     try {
-        const sel = resolveCliSelection(selKey ?? 'claude-code');
+        const sel = resolveCliSelection(selKey);
         cliId = sel.cliId;
         wrapperCli = sel.wrapperCli;
     }
@@ -636,16 +764,53 @@ async function promptBotConfig(rl) {
         console.log('   不写 bots.json。请重新运行 botmux setup。');
         return null;
     }
-    const workingDir = await ask(rl, '默认工作目录 [~]: ');
+    // 新话题工作目录：两种模式二选一。旧问法只问「默认工作目录」但写的是
+    // workingDir——那只是仓库选择卡片的扫描根，新话题照样弹卡，误导性强；
+    // 真正「直接进目录、不弹卡」的是 defaultWorkingDir，现在显式让用户选。
+    // 「固定默认目录」放首位当推荐默认：大量用户的真实诉求是"新话题直接进目录"，
+    // 弹卡模式作为多仓库场景的进阶选项。
+    const dirMode = await pickChoice(rl, {
+        title: '新话题工作目录',
+        items: [
+            { label: '固定默认目录（推荐）', hint: '新话题直接在指定目录启动、不弹卡片' },
+            { label: '仓库选择卡片', hint: '新话题先弹卡片，从扫描到的 git 仓库中选一个再启动' },
+        ],
+        defaultIndex: 0,
+        footer: 'Esc 取消 setup · 之后可用 /config 或 botmux setup edit 修改',
+    });
+    // Esc = 中止 setup，不静默套用推荐默认（非 TTY 留空走 defaultIndex，不受影响）。
+    if (dirMode === null) {
+        console.log('\n已取消（Esc），setup 中止，不写任何配置。');
+        return null;
+    }
+    let workingDir;
+    let defaultWorkingDir;
+    if (dirMode === 1) {
+        const raw = await ask(rl, '仓库扫描根目录（卡片会列出其下的 git 仓库，逗号分隔多个）[~]: ');
+        workingDir = raw.trim() || '~';
+    }
+    else {
+        // 存在性校验循环——运行时 daemon 对无效 defaultWorkingDir 只会静默回退
+        // 弹卡，setup 阶段必须挡住。留空默认 ~（一定存在，回车即通过）。
+        for (;;) {
+            const dir = (await ask(rl, '默认工作目录（新话题直接在此目录启动）[~]: ')).trim() || '~';
+            if (ensureBotDefaultWorkingDirExists({ defaultWorkingDir: dir })) {
+                defaultWorkingDir = dir;
+                break;
+            }
+        }
+    }
     const bot = {
         larkAppId: creds.appId,
         larkAppSecret: creds.appSecret,
         cliId,
         // aiden × claude/codex 等启动前缀；普通 CLI 不写此字段。
         ...(wrapperCli ? { wrapperCli } : {}),
-        // 总是写 workingDir, 留空用 '~'. 用户手动编辑 bots.json 时一眼能看到字段
-        // 在哪儿, 不用去 README 查字段名.
-        workingDir: workingDir.trim() || '~',
+        // 仓库选择模式总是写 workingDir（留空用 '~'），用户手动编辑 bots.json 时
+        // 一眼能看到字段在哪儿；固定默认目录模式只写 defaultWorkingDir，扫描根
+        // 回退默认 ~，bots.json 不留多余字段。
+        ...(workingDir ? { workingDir } : {}),
+        ...(defaultWorkingDir ? { defaultWorkingDir } : {}),
     };
     // brand 落盘：只在国际版 (lark) 时写字段，feishu 留空——保持旧 bots.json 干净，
     // 且 botBrand()/normalizeBrand() 读不到时 default 到 feishu，向后兼容。
@@ -673,7 +838,7 @@ async function promptBotConfig(rl) {
     else {
         bot.allowedUsers = await promptRequiredOwner(rl);
     }
-    if (!ensureBotWorkingDirsExist(bot, '默认工作目录'))
+    if (!ensureBotWorkingDirsExist(bot, '仓库扫描根目录'))
         return null;
     return normalizeBotConfig(bot);
 }
@@ -712,6 +877,29 @@ function formatBotConfigTable(bots) {
     const render = (cells) => '  ' + cells.map((cell, i) => padEndDisplay(cell, widths[i])).join('  ');
     return [render(headers), ...rows.map(render)].join('\n');
 }
+/**
+ * 从 bots 列表交互选择一个机器人，返回下标；取消 / 找不到返回 undefined。
+ * TTY 用可搜索选择器；非 TTY 保持旧文本语义（进程名 / AppID——见
+ * parseBotSelection 上的注释，刻意不接受裸序号，避免 off-by-one 歧义）。
+ */
+async function pickBotSelection(rl, bots, title) {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        const selected = await ask(rl, '选择机器人（进程名 或 AppID）: ');
+        return parseBotSelection(selected, bots);
+    }
+    const idx = await interactiveSelect({
+        title,
+        items: bots.map((b, i) => ({
+            label: botProcessName(b, i, PM2_NAME),
+            hint: `${b?.larkAppId ?? ''} · ${b?.cliId ?? 'claude-code'}`,
+        })),
+        footer: 'Esc 返回操作菜单',
+    });
+    if (idx === null)
+        return undefined;
+    console.log(` ✔ ${title}: ${botProcessName(bots[idx], idx, PM2_NAME)}`);
+    return idx;
+}
 async function promptEditBotConfig(rl, bot) {
     console.log('\n字段留空表示保留当前值；可选字段输入 - 表示清空。\n');
     const input = {};
@@ -768,11 +956,37 @@ async function promptEditBotConfig(rl, bot) {
         '留空保留当前值；输入 - 回到自动检测；接受 pty / tmux / herdr / zellij。',
     ]);
     input.backendType = await ask(rl, `会话后端 backendType [${formatOptionalValue(bot.backendType)}]: `);
-    printInputHelp('默认工作目录', [
-        '可选。新会话默认进入的目录，支持逗号分隔多个候选目录。',
-        '留空保留当前值；输入 - 清空并回到默认 ~。',
-    ]);
-    input.workingDir = await ask(rl, `默认工作目录 [${formatOptionalValue(bot.workingDir)}]: `);
+    // 新话题工作目录：模式二选一（与 promptBotConfig 的新建流程同款问法）。
+    const currentDirMode = bot.defaultWorkingDir
+        ? `固定默认目录: ${bot.defaultWorkingDir}`
+        : `仓库选择卡片，扫描根: ${bot.workingDir ?? '~'}`;
+    const dirMode = await pickChoice(rl, {
+        title: '新话题工作目录',
+        items: [
+            { label: '保留当前配置', hint: currentDirMode },
+            { label: '固定默认目录', hint: '新话题直接在指定目录启动、不弹卡片' },
+            { label: '仓库选择卡片', hint: '新话题先弹卡片选 git 仓库；下一问填卡片的扫描根目录' },
+        ],
+        defaultIndex: 0,
+    });
+    if (dirMode === 1) {
+        printInputHelp('固定默认目录', [
+            '新话题直接在此目录启动、不弹仓库选择卡片。',
+            '留空保留当前值；输入 - 清空并回到仓库选择卡片模式。',
+        ]);
+        input.defaultWorkingDir = await ask(rl, `固定默认目录 [${formatOptionalValue(bot.defaultWorkingDir)}]: `);
+    }
+    else if (dirMode === 2) {
+        printInputHelp('仓库扫描根目录', [
+            '仓库选择卡片会列出这些目录下的 git 仓库，支持逗号分隔多个。',
+            '留空保留当前值；输入 - 清空并回到默认 ~。',
+        ]);
+        input.workingDir = await ask(rl, `仓库扫描根目录 [${formatOptionalValue(bot.workingDir)}]: `);
+        if (bot.defaultWorkingDir) {
+            console.log('   已切回仓库选择卡片模式，原固定默认目录将被清空。');
+            input.defaultWorkingDir = '-';
+        }
+    }
     printInputHelp('允许的用户', [
         '可选。限制哪些飞书用户可以操作机器人，支持完整邮箱（如 alice@example.com）、union_id（on_xxx）或 open_id（ou_xxx），多个值用逗号分隔。',
         '注意：必须是完整邮箱，邮箱前缀（如 alice）无法解析、会被丢弃。',
@@ -852,6 +1066,247 @@ async function writeSingleBotConfig() {
     console.log(`  2. botmux autostart enable   注册开机自启（推荐：${process.platform === 'darwin' ? 'mac launchd' : process.platform === 'linux' ? 'linux user systemd' : process.platform === 'win32' ? 'Windows Task Scheduler' : '当前平台暂不支持'}，无需 sudo）`);
     return true;
 }
+// ─── Scripted (non-TUI) setup ────────────────────────────────────────────────
+/** 脚本化 setup 统一失败出口：--json 输出结构化错误到 stdout，退出码 1。 */
+function failSetupScripted(json, message) {
+    if (json)
+        console.log(JSON.stringify({ ok: false, error: message }));
+    else
+        console.error(`❌ ${message}`);
+    process.exitCode = 1;
+}
+/** 某个（可能带 ~ 前缀的）路径若不存在/不是目录，返回展开后的绝对路径；合法返回 null。 */
+function missingDirResolved(raw) {
+    const resolved = resolve(expandHomePath(raw));
+    try {
+        if (statSync(resolved).isDirectory())
+            return null;
+    }
+    catch { /* not a dir */ }
+    return resolved;
+}
+/** workingDir / workingDirs / defaultWorkingDir 里所有无效目录（脚本化模式一次性报全）。 */
+function invalidBotDirs(bot) {
+    const invalid = [...invalidWorkingDirs(bot)];
+    const raw = typeof bot.defaultWorkingDir === 'string' ? bot.defaultWorkingDir.trim() : '';
+    if (raw) {
+        const missing = missingDirResolved(raw);
+        if (missing)
+            invalid.push(missing);
+    }
+    return invalid;
+}
+/** list/add/edit 的 JSON 输出视图：bot 条目 + 进程名，secret 脱敏（stdout 可能被贴进聊天/日志）。 */
+function botJsonView(bot, index) {
+    return {
+        processName: botProcessName(bot, index, PM2_NAME),
+        ...bot,
+        larkAppSecret: maskAppSecret(bot?.larkAppSecret),
+    };
+}
+/**
+ * `botmux setup list|add|edit|remove` — 脚本化（非 TUI）bot 管理。
+ * 给 coding agent / 脚本一个字段级稳定接口，不依赖交互问答顺序（管道喂数字
+ * 的老姿势在问题序列变化时会静默错位）。校验口径与 TUI 一致：目录存在性、
+ * owner 必填、凭证变更时的 tenant_access_token 校验，任一失败不写盘。
+ */
+async function cmdSetupScripted(argv) {
+    const wantsJson = argv.includes('--json');
+    let cmd;
+    try {
+        cmd = parseSetupCommand(argv);
+    }
+    catch (err) {
+        failSetupScripted(wantsJson, err?.message ?? String(err));
+        return;
+    }
+    if (cmd.action === 'help') {
+        console.log(SETUP_CLI_USAGE);
+        return;
+    }
+    ensureConfigDir();
+    const bots = loadBotsJson();
+    if (cmd.action === 'list') {
+        if (cmd.json) {
+            console.log(JSON.stringify(bots.map((b, i) => botJsonView(b, i)), null, 2));
+        }
+        else if (bots.length === 0) {
+            console.log('尚未配置机器人。运行 botmux setup（交互式）或 botmux setup add 添加。');
+        }
+        else {
+            console.log(formatBotConfigTable(bots));
+            console.log('\n完整字段用 --json 查看（secret 脱敏；明文只在 ~/.botmux/bots.json）。');
+        }
+        return;
+    }
+    if (cmd.action === 'add') {
+        let bot;
+        try {
+            bot = buildBotFromAddFlags(cmd.flags);
+        }
+        catch (err) {
+            failSetupScripted(cmd.json, err?.message ?? String(err));
+            return;
+        }
+        // 单机器人 .env 老配置：与 TUI「添加新机器人」一致，先迁移进 bots.json 再追加。
+        let existing = bots;
+        let migratedEnv = false;
+        if (!existsSync(BOTS_JSON_FILE) && existsSync(ENV_FILE)) {
+            const legacy = parseDotEnvToBotConfig();
+            if (legacy.larkAppId && legacy.larkAppSecret) {
+                existing = [legacy];
+                migratedEnv = true;
+            }
+        }
+        if (existing.some(b => b?.larkAppId === bot.larkAppId)) {
+            failSetupScripted(cmd.json, `AppID ${bot.larkAppId} 已存在，修改请用 botmux setup edit ${bot.larkAppId}。`);
+            return;
+        }
+        const badDirs = invalidBotDirs(bot);
+        if (badDirs.length > 0) {
+            failSetupScripted(cmd.json, `目录不存在或不是目录: ${badDirs.join(', ')}。请先创建，未写入配置。`);
+            return;
+        }
+        // 凭证校验与 TUI 同口径：换不到 tenant_access_token 一律不写盘。
+        const { validateCredentials } = await import('./setup/verify-permissions.js');
+        const v = await validateCredentials(bot.larkAppId, bot.larkAppSecret, botBrand(bot));
+        if (!v.ok) {
+            failSetupScripted(cmd.json, `凭证校验失败 (${v.error}): ${v.message}`);
+            return;
+        }
+        writeBotsJsonAtomic([...existing, bot]);
+        if (migratedEnv)
+            renameSync(ENV_FILE, ENV_FILE + '.bak');
+        // 开放平台自动配置（权限导入/发版）需要扫码，脚本化模式默认跳过、显式 opt-in。
+        if (cmd.openPlatformAuto) {
+            await finishOpenPlatformSetup(bot.larkAppId, botBrand(bot));
+        }
+        const index = existing.length;
+        if (cmd.json) {
+            console.log(JSON.stringify({
+                ok: true,
+                action: 'add',
+                bot: botJsonView(bot, index),
+                botsFile: BOTS_JSON_FILE,
+                envMigrated: migratedEnv || undefined,
+                openPlatform: cmd.openPlatformAuto ? 'attempted' : 'skipped',
+                next: 'botmux restart',
+            }, null, 2));
+        }
+        else {
+            console.log(`✅ 已添加机器人 ${botProcessName(bot, index, PM2_NAME)} (${bot.larkAppId})，共 ${index + 1} 个`);
+            console.log(`   配置文件: ${BOTS_JSON_FILE}`);
+            if (migratedEnv)
+                console.log(`   旧 .env 已迁移并备份: ${ENV_FILE}.bak`);
+            if (!cmd.openPlatformAuto) {
+                console.log('   已跳过开放平台自动配置（权限导入/发版）。需要时加 --open-platform-auto（要扫码），或运行交互式 botmux setup。');
+            }
+            console.log('下一步: botmux restart');
+        }
+        return;
+    }
+    if (cmd.action === 'edit') {
+        const index = parseBotSelection(cmd.selector, bots);
+        if (index === undefined) {
+            failSetupScripted(cmd.json, `找不到机器人 "${cmd.selector}"（接受进程名 botmux-N 或 AppID，botmux setup list 可查）。`);
+            return;
+        }
+        const original = bots[index];
+        let edited;
+        let modelCleared = false;
+        try {
+            const input = editInputFromFlags(cmd.flags);
+            if (Object.keys(input).length === 0) {
+                throw new Error('edit 至少需要一个字段参数（如 --cli codex）。查看用法：botmux setup help');
+            }
+            // 切换 CLI 强制清空旧 model（与 TUI 同理：旧值属于上一个 CLI，套用会 spawn 报错）。
+            const nextCliId = input.cliChoice ? resolveCliId(input.cliChoice) : undefined;
+            if (nextCliId && nextCliId !== (original.cliId ?? 'claude-code') && original.model && input.model === undefined) {
+                input.model = null;
+                modelCleared = true;
+            }
+            edited = applyBotConfigEdits(original, input);
+            assertOwnerWhenChatGroups(edited);
+        }
+        catch (err) {
+            failSetupScripted(cmd.json, err?.message ?? String(err));
+            return;
+        }
+        const badDirs = invalidBotDirs(edited);
+        if (badDirs.length > 0) {
+            failSetupScripted(cmd.json, `目录不存在或不是目录: ${badDirs.join(', ')}。配置未修改。`);
+            return;
+        }
+        const appIdChanged = edited.larkAppId !== original.larkAppId;
+        if (appIdChanged && bots.some((b, i) => i !== index && b?.larkAppId === edited.larkAppId)) {
+            failSetupScripted(cmd.json, `AppID ${edited.larkAppId} 已被另一个机器人使用，配置未修改。`);
+            return;
+        }
+        if (appIdChanged || edited.larkAppSecret !== original.larkAppSecret) {
+            const { validateCredentials } = await import('./setup/verify-permissions.js');
+            const v = await validateCredentials(edited.larkAppId, edited.larkAppSecret, botBrand(edited));
+            if (!v.ok) {
+                failSetupScripted(cmd.json, `凭证校验失败 (${v.error}): ${v.message}。配置未修改。`);
+                return;
+            }
+        }
+        const nextBots = bots.slice();
+        nextBots[index] = edited;
+        copyFileSync(BOTS_JSON_FILE, BOTS_JSON_FILE + '.bak');
+        writeBotsJsonAtomic(nextBots);
+        const changed = [...new Set([...Object.keys(original), ...Object.keys(edited)])]
+            .filter(k => JSON.stringify(original[k]) !== JSON.stringify(edited[k]));
+        if (cmd.json) {
+            console.log(JSON.stringify({
+                ok: true,
+                action: 'edit',
+                bot: botJsonView(edited, index),
+                changed,
+                modelCleared: modelCleared || undefined,
+                backup: BOTS_JSON_FILE + '.bak',
+                next: 'botmux restart',
+            }, null, 2));
+        }
+        else {
+            console.log(`✅ 已更新机器人 ${botProcessName(edited, index, PM2_NAME)} (${edited.larkAppId})`);
+            console.log(`   变更字段: ${changed.join(', ') || '（无实际变化）'}`);
+            if (modelCleared)
+                console.log('   ⚠️ 已切换 CLI，原 model 字段已清空（需要时用 --model 或 /config 重设）。');
+            if (appIdChanged)
+                console.log('   ⚠️ LARK_APP_ID 已变更：历史会话/群聊状态不迁移，新应用可能需重新配置开放平台权限。');
+            console.log(`   旧配置已备份: ${BOTS_JSON_FILE}.bak`);
+            console.log('下一步: botmux restart');
+        }
+        return;
+    }
+    // remove
+    if (!cmd.yes) {
+        failSetupScripted(cmd.json, '非交互删除需要显式 --yes 确认。');
+        return;
+    }
+    const result = removeBotConfig(bots, cmd.selector);
+    if (!result) {
+        failSetupScripted(cmd.json, `找不到机器人 "${cmd.selector}"（接受进程名 botmux-N 或 AppID，botmux setup list 可查）。`);
+        return;
+    }
+    copyFileSync(BOTS_JSON_FILE, BOTS_JSON_FILE + '.bak');
+    writeBotsJsonAtomic(result.bots);
+    if (cmd.json) {
+        console.log(JSON.stringify({
+            ok: true,
+            action: 'remove',
+            removed: botJsonView(result.removed, result.index),
+            remaining: result.bots.length,
+            backup: BOTS_JSON_FILE + '.bak',
+            next: 'botmux restart',
+        }, null, 2));
+    }
+    else {
+        console.log(`✅ 已删除机器人 ${botProcessName(result.removed, result.index, PM2_NAME)} (${result.removed.larkAppId})，剩余 ${result.bots.length} 个`);
+        console.log(`   旧配置已备份: ${BOTS_JSON_FILE}.bak`);
+        console.log('下一步: botmux restart');
+    }
+}
 // ─── Commands ────────────────────────────────────────────────────────────────
 async function cmdSetup() {
     ensureConfigDir();
@@ -867,123 +1322,166 @@ async function cmdSetup() {
         console.log(formatBotConfigTable(bots));
         console.log('');
         const rl = createInterface({ input: process.stdin, output: process.stdout });
-        const action = await ask(rl, '操作: 1) 添加新机器人  2) 重新配置  3) 编辑现有机器人  4) 删除机器人  (1/2/3/4) [1]: ');
-        if (action === '2') {
-            console.log('\n── 重新配置 ──\n');
-            const newBot = await promptBotConfig(rl);
-            rl.close();
-            if (!newBot) {
-                console.log('\n⚠️  setup 中止，旧配置保留不动。');
-                return;
-            }
-            // Codex review #1: 先 copyFileSync 备份, 再原子写新文件. 之前先 rename
-            // 旧文件再 write, 一旦 write 失败 (磁盘/权限/进程被 kill) 用户就丢了
-            // bots.json. copy 之后写失败旧文件原地不动, .bak 是无害的同名副本.
-            copyFileSync(BOTS_JSON_FILE, BOTS_JSON_FILE + '.bak');
-            console.log(`旧配置已备份: ${BOTS_JSON_FILE}.bak`);
-            writeBotsJsonAtomic([newBot]);
-            console.log(`✅ 配置已写入: ${BOTS_JSON_FILE}`);
-            await finishOpenPlatformSetup(newBot.larkAppId, botBrand(newBot));
-            console.log(`下一步: botmux restart\n`);
-            return;
-        }
-        if (action === '3') {
-            console.log('\n── 编辑现有机器人 ──\n');
-            const selected = await ask(rl, '选择机器人（进程名 或 AppID）: ');
-            const index = parseBotSelection(selected, bots);
-            if (index === undefined) {
+        // 交互模式下子界面（选机器人）Esc = 返回本操作菜单；非 TTY 无 Esc，保持
+        // 「无效选择即报错退出」旧语义，避免管道输入在循环里打转。
+        const interactiveMenus = process.stdin.isTTY && process.stdout.isTTY;
+        for (;;) {
+            const action = await pickChoice(rl, {
+                title: '操作',
+                items: [
+                    { label: '添加新机器人' },
+                    { label: '编辑现有机器人' },
+                    { label: '删除机器人' },
+                    // 「重新配置」= 丢弃全部现有配置重建，低频且有破坏性，压轴放最后。
+                    { label: '重新配置', hint: '丢弃现有配置，重建为单机器人配置' },
+                ],
+                defaultIndex: 0,
+                footer: 'Esc 退出',
+            });
+            if (action === null) {
                 rl.close();
-                console.log('\n❌ 找不到指定机器人，配置未修改。');
+                console.log('\n已取消。');
                 return;
             }
-            const original = bots[index];
-            let edited;
-            try {
-                edited = await promptEditBotConfig(rl, original);
-            }
-            catch (err) {
+            if (action === 3) {
+                console.log('\n── 重新配置 ──\n');
+                const newBot = await promptBotConfig(rl);
                 rl.close();
-                console.log(`\n❌ 编辑失败: ${err?.message ?? String(err)}`);
+                if (!newBot) {
+                    console.log('\n⚠️  setup 中止，旧配置保留不动。');
+                    return;
+                }
+                // Codex review #1: 先 copyFileSync 备份, 再原子写新文件. 之前先 rename
+                // 旧文件再 write, 一旦 write 失败 (磁盘/权限/进程被 kill) 用户就丢了
+                // bots.json. copy 之后写失败旧文件原地不动, .bak 是无害的同名副本.
+                copyFileSync(BOTS_JSON_FILE, BOTS_JSON_FILE + '.bak');
+                console.log(`旧配置已备份: ${BOTS_JSON_FILE}.bak`);
+                writeBotsJsonAtomic([newBot]);
+                console.log(`✅ 配置已写入: ${BOTS_JSON_FILE}`);
+                await finishOpenPlatformSetup(newBot.larkAppId, botBrand(newBot));
+                console.log(`下一步: botmux restart\n`);
                 return;
             }
-            if (!ensureBotWorkingDirsExist(edited, '默认工作目录')) {
+            if (action === 1) {
+                console.log('\n── 编辑现有机器人 ──\n');
+                const index = await pickBotSelection(rl, bots, '选择要编辑的机器人');
+                if (index === undefined) {
+                    if (interactiveMenus) {
+                        console.log('   已返回操作菜单。\n');
+                        continue;
+                    }
+                    rl.close();
+                    console.log('\n❌ 未选择机器人，配置未修改。');
+                    return;
+                }
+                const original = bots[index];
+                let edited;
+                try {
+                    edited = await promptEditBotConfig(rl, original);
+                }
+                catch (err) {
+                    rl.close();
+                    console.log(`\n❌ 编辑失败: ${err?.message ?? String(err)}`);
+                    return;
+                }
+                if (!ensureBotWorkingDirsExist(edited, '仓库扫描根目录') || !ensureBotDefaultWorkingDirExists(edited)) {
+                    rl.close();
+                    console.log('   配置未修改。');
+                    return;
+                }
+                // 凭证字段有变化时, 像 promptBotConfig 一样跑一次 tenant_access_token
+                // 校验. 失败不写盘——避免编辑后 typo 一个字符, daemon 重启时才发现.
+                // (cmdRestart 不校验凭证, 只 cmdStart 校验, 所以编辑路径必须自己兜.)
+                const appIdChanged = edited.larkAppId !== original.larkAppId;
+                const appSecretChanged = edited.larkAppSecret !== original.larkAppSecret;
+                if (appIdChanged || appSecretChanged) {
+                    console.log('\n校验新凭证（取 tenant_access_token）…');
+                    const { validateCredentials } = await import('./setup/verify-permissions.js');
+                    const v = await validateCredentials(edited.larkAppId, edited.larkAppSecret, botBrand(edited));
+                    if (!v.ok) {
+                        rl.close();
+                        console.log(`\n❌ 凭证校验失败 (${v.error}): ${v.message}`);
+                        console.log('   配置未修改。请重新运行 botmux setup → 编辑现有机器人。');
+                        return;
+                    }
+                    console.log('✅ 凭证有效\n');
+                }
                 rl.close();
-                console.log('   配置未修改。');
+                const nextBots = bots.slice();
+                nextBots[index] = edited;
+                copyFileSync(BOTS_JSON_FILE, BOTS_JSON_FILE + '.bak');
+                console.log(`旧配置已备份: ${BOTS_JSON_FILE}.bak`);
+                writeBotsJsonAtomic(nextBots);
+                console.log(`✅ 已更新机器人 ${botProcessName(edited, index, PM2_NAME)} (${edited.larkAppId})`);
+                // appId 切换 = 换了一个飞书应用, 新 appId 大概率需要重新申请权限 + 配重定向 URL.
+                // 把 printRemainingSteps 的深链端给用户, 比 README 警告里那句"历史数据不迁移"更可操作.
+                if (appIdChanged) {
+                    await finishOpenPlatformSetup(edited.larkAppId, botBrand(edited));
+                }
+                console.log(`下一步: botmux restart\n`);
                 return;
             }
-            // 凭证字段有变化时, 像 promptBotConfig 一样跑一次 tenant_access_token
-            // 校验. 失败不写盘——避免编辑后 typo 一个字符, daemon 重启时才发现.
-            // (cmdRestart 不校验凭证, 只 cmdStart 校验, 所以编辑路径必须自己兜.)
-            const appIdChanged = edited.larkAppId !== original.larkAppId;
-            const appSecretChanged = edited.larkAppSecret !== original.larkAppSecret;
-            if (appIdChanged || appSecretChanged) {
-                console.log('\n校验新凭证（取 tenant_access_token）…');
-                const { validateCredentials } = await import('./setup/verify-permissions.js');
-                const v = await validateCredentials(edited.larkAppId, edited.larkAppSecret, botBrand(edited));
-                if (!v.ok) {
+            if (action === 2) {
+                console.log('\n── 删除机器人 ──\n');
+                const delIndex = await pickBotSelection(rl, bots, '选择要删除的机器人');
+                if (delIndex === undefined) {
+                    if (interactiveMenus) {
+                        console.log('   已返回操作菜单。\n');
+                        continue;
+                    }
                     rl.close();
-                    console.log(`\n❌ 凭证校验失败 (${v.error}): ${v.message}`);
-                    console.log('   配置未修改。请重新运行 botmux setup → 编辑现有机器人。');
+                    console.log('\n❌ 未选择机器人，配置未修改。');
                     return;
                 }
-                console.log('✅ 凭证有效\n');
-            }
-            rl.close();
-            const nextBots = bots.slice();
-            nextBots[index] = edited;
-            copyFileSync(BOTS_JSON_FILE, BOTS_JSON_FILE + '.bak');
-            console.log(`旧配置已备份: ${BOTS_JSON_FILE}.bak`);
-            writeBotsJsonAtomic(nextBots);
-            console.log(`✅ 已更新机器人 ${botProcessName(edited, index, PM2_NAME)} (${edited.larkAppId})`);
-            // appId 切换 = 换了一个飞书应用, 新 appId 大概率需要重新申请权限 + 配重定向 URL.
-            // 把 printRemainingSteps 的深链端给用户, 比 README 警告里那句"历史数据不迁移"更可操作.
-            if (appIdChanged) {
-                await finishOpenPlatformSetup(edited.larkAppId, botBrand(edited));
-            }
-            console.log(`下一步: botmux restart\n`);
-            return;
-        }
-        if (action === '4') {
-            console.log('\n── 删除机器人 ──\n');
-            const selected = await ask(rl, '选择机器人（进程名 或 AppID）: ');
-            const result = removeBotConfig(bots, selected);
-            if (!result) {
+                const nextBots = bots.slice();
+                const [removed] = nextBots.splice(delIndex, 1);
+                const confirm = (await ask(rl, `确认删除 ${botProcessName(removed, delIndex, PM2_NAME)} (${removed.larkAppId})? (y/N): `)).trim().toLowerCase();
                 rl.close();
-                console.log('\n❌ 找不到指定机器人，配置未修改。');
+                if (confirm !== 'y' && confirm !== 'yes') {
+                    console.log('\n已取消，配置未修改。');
+                    return;
+                }
+                copyFileSync(BOTS_JSON_FILE, BOTS_JSON_FILE + '.bak');
+                console.log(`旧配置已备份: ${BOTS_JSON_FILE}.bak`);
+                writeBotsJsonAtomic(nextBots);
+                console.log(`✅ 已删除机器人 ${botProcessName(removed, delIndex, PM2_NAME)} (${removed.larkAppId})`);
+                console.log(`下一步: botmux restart\n`);
                 return;
             }
-            const confirm = (await ask(rl, `确认删除 ${botProcessName(result.removed, result.index, PM2_NAME)} (${result.removed.larkAppId})? (y/N): `)).trim().toLowerCase();
+            console.log('\n── 添加新机器人 ──\n');
+            const newBot = await promptBotConfig(rl);
             rl.close();
-            if (confirm !== 'y' && confirm !== 'yes') {
-                console.log('\n已取消，配置未修改。');
+            if (!newBot) {
+                console.log('\n⚠️  setup 中止，bots.json 不动。');
                 return;
             }
-            copyFileSync(BOTS_JSON_FILE, BOTS_JSON_FILE + '.bak');
-            console.log(`旧配置已备份: ${BOTS_JSON_FILE}.bak`);
-            writeBotsJsonAtomic(result.bots);
-            console.log(`✅ 已删除机器人 ${botProcessName(result.removed, result.index, PM2_NAME)} (${result.removed.larkAppId})`);
+            writeBotsJsonAtomic([...bots, newBot]);
+            console.log(`\n✅ 已添加机器人 ${newBot.larkAppId}，共 ${bots.length + 1} 个`);
+            console.log(`   配置文件: ${BOTS_JSON_FILE}`);
+            await finishOpenPlatformSetup(newBot.larkAppId, botBrand(newBot));
             console.log(`下一步: botmux restart\n`);
             return;
         }
-        console.log('\n── 添加新机器人 ──\n');
-        const newBot = await promptBotConfig(rl);
-        rl.close();
-        if (!newBot) {
-            console.log('\n⚠️  setup 中止，bots.json 不动。');
-            return;
-        }
-        writeBotsJsonAtomic([...bots, newBot]);
-        console.log(`\n✅ 已添加机器人 ${newBot.larkAppId}，共 ${bots.length + 1} 个`);
-        console.log(`   配置文件: ${BOTS_JSON_FILE}`);
-        await finishOpenPlatformSetup(newBot.larkAppId, botBrand(newBot));
-        console.log(`下一步: botmux restart\n`);
     }
     else if (hasEnv) {
         // --- Single-bot mode (.env exists) ---
         console.log(`当前使用单机器人配置: ${ENV_FILE}`);
         const rl = createInterface({ input: process.stdin, output: process.stdout });
-        const action = await ask(rl, '操作: 1) 添加新机器人  2) 覆盖当前配置  (1/2): ');
-        if (action === '2') {
+        const action = await pickChoice(rl, {
+            title: '操作',
+            items: [
+                { label: '添加新机器人', hint: '迁移 .env 到 bots.json 多机器人配置' },
+                { label: '覆盖当前配置' },
+            ],
+            defaultIndex: 0,
+            footer: 'Esc 退出',
+        });
+        if (action === null) {
+            rl.close();
+            console.log('\n已取消。');
+            return;
+        }
+        if (action === 1) {
             rl.close();
             const ok = await writeSingleBotConfig();
             if (ok) {
@@ -5591,9 +6089,16 @@ switch (command) {
     case '-v':
         console.log(getVersion());
         break;
-    case 'setup':
-        await cmdSetup();
+    case 'setup': {
+        // 带子命令（list/add/edit/remove/help）走脚本化非 TUI 模式；空参数 / 纯
+        // flag（如 --no-open-platform-auto）保持原交互 TUI，向后兼容。
+        const setupArgs = process.argv.slice(3);
+        if (isScriptedSetupInvocation(setupArgs))
+            await cmdSetupScripted(setupArgs);
+        else
+            await cmdSetup();
         break;
+    }
     case 'start':
         await cmdStart();
         break;