evolcore 0.0.3 → 0.0.5

package/dist/cli/init-channel.js

@@ -16,7 +16,7 @@ import { ipcQuery } from '../ipc.js';
 import { cmdStart } from './daemon-commands.js';
 import * as platform from '../utils/cross-platform.js';
 import { cleanupInstances } from '../utils/instance-registry.js';
-import { bindContactAlias } from '../config/contact-book.js';
+import { bindContactAlias, getContactSnapshot } from '../config/contact-book.js';
 import { listStaticAgentAdmins } from '../config/peer-role-resolver.js';
 import { setupRawKeyListener } from './raw-key-input.js';
 function ask(rl, question) {
@@ -384,6 +384,7 @@ export async function cmdInitFeishu() {
     let agentConfig = null;
     let choice = null;
     let contactBinding = null;
+    let operation = 'configure';
     try {
         aid = await pickAgentForChannel(rl);
         if (!aid)
@@ -394,16 +395,25 @@ export async function cmdInitFeishu() {
             return;
         }
         const existing = (agentConfig.channels || []).filter(c => c.type === 'feishu');
-        choice = await pickInstanceWithinAgent(rl, 'feishu', existing);
+        choice = await pickInstanceWithinAgent(rl, 'feishu', existing, { confirmOverwrite: false });
         if (choice === null)
             return;
-        contactBinding = await pickOwnerAdminForChannelBinding(rl, agentConfig, 'feishu');
+        if (choice.action === 'overwrite') {
+            operation = await pickExistingChannelOperation(rl, '飞书', choice.name);
+            if (operation === 'configure' && !await confirmOverwriteChannel(rl, '飞书', choice.name))
+                return;
+        }
+        contactBinding = await pickContactForChannelBinding(rl, agentConfig, 'feishu');
         if (!contactBinding)
             return;
     }
     finally {
         rl.close();
     }
+    if (operation === 'rebind-contact') {
+        await registerFeishuContactBind(aid, contactBindChannelKey('feishu', aid, choice.name), contactBinding);
+        return;
+    }
     console.log('\n正在获取飞书登录二维码...\n');
     let result;
     try {
@@ -444,7 +454,15 @@ export async function cmdInitFeishu() {
         console.log(`  Login Open ID: ${result.openId}`);
     if (result.domain !== 'unknown')
         console.log(`  Domain: ${result.domain}`);
-    bindQrActorToContact(aid, contactBinding, 'feishu', result.openId, commitResult.channelKey);
+    if (result.openId) {
+        bindQrActorToContact(aid, contactBinding, 'feishu', result.openId, commitResult.channelKey);
+    }
+    else if (commitResult.reloaded) {
+        await registerFeishuContactBind(aid, commitResult.channelKey, contactBinding);
+    }
+    else {
+        console.log('  ⚠ 服务未运行或热重载失败，无法注册飞书绑定码；请启动服务后重新执行 ec init feishu。');
+    }
     // Show unified init success message
     const { generateInitSuccessMessage } = await import('../utils/welcome.js');
     console.log(generateInitSuccessMessage('feishu', contactBinding !== null));
@@ -545,6 +563,7 @@ export async function cmdInitWechat() {
     let agentConfig = null;
     let choice = null;
     let contactBinding = null;
+    let operation = 'configure';
     try {
         aid = await pickAgentForChannel(rl);
         if (!aid)
@@ -555,16 +574,25 @@ export async function cmdInitWechat() {
             return;
         }
         const existing = (agentConfig.channels || []).filter(c => c.type === 'wechat');
-        choice = await pickInstanceWithinAgent(rl, 'wechat', existing);
+        choice = await pickInstanceWithinAgent(rl, 'wechat', existing, { confirmOverwrite: false });
         if (choice === null)
             return;
-        contactBinding = await pickOwnerAdminForChannelBinding(rl, agentConfig, 'wechat');
+        if (choice.action === 'overwrite') {
+            operation = await pickExistingChannelOperation(rl, '微信', choice.name);
+            if (operation === 'configure' && !await confirmOverwriteChannel(rl, '微信', choice.name))
+                return;
+        }
+        contactBinding = await pickContactForChannelBinding(rl, agentConfig, 'wechat');
         if (!contactBinding)
             return;
     }
     finally {
         rl.close();
     }
+    if (operation === 'rebind-contact') {
+        await registerWechatContactBind(aid, contactBindChannelKey('wechat', aid, choice.name), contactBinding);
+        return;
+    }
     console.log('\n正在获取微信登录二维码...\n');
     const result = await runWechatQrFlow();
     if (!result) {
@@ -581,7 +609,15 @@ export async function cmdInitWechat() {
     const commitResult = await commitChannel(aid, channel, choice.action);
     if (!commitResult)
         return;
-    bindQrActorToContact(aid, contactBinding, 'wechat', result.userId, commitResult.channelKey);
+    if (firstNonEmpty(result.userId)) {
+        bindQrActorToContact(aid, contactBinding, 'wechat', result.userId, commitResult.channelKey);
+    }
+    else if (commitResult.reloaded) {
+        await registerWechatContactBind(aid, commitResult.channelKey, contactBinding);
+    }
+    else {
+        console.log('  ⚠ 服务未运行或热重载失败，无法注册微信绑定码；请启动服务后重新执行 ec init wechat。');
+    }
     // Show unified init success message
     const { generateInitSuccessMessage } = await import('../utils/welcome.js');
     console.log(generateInitSuccessMessage('wechat', contactBinding !== null));
@@ -788,6 +824,7 @@ export async function cmdInitDingtalk() {
     let agentConfig = null;
     let choice = null;
     let contactBinding = null;
+    let operation = 'configure';
     try {
         aid = await pickAgentForChannel(rl);
         if (!aid)
@@ -798,16 +835,25 @@ export async function cmdInitDingtalk() {
             return;
         }
         const existing = (agentConfig.channels || []).filter(c => c.type === 'dingtalk');
-        choice = await pickInstanceWithinAgent(rl, 'dingtalk', existing);
+        choice = await pickInstanceWithinAgent(rl, 'dingtalk', existing, { confirmOverwrite: false });
         if (choice === null)
             return;
-        contactBinding = await pickOwnerAdminForChannelBinding(rl, agentConfig, 'dingtalk');
+        if (choice.action === 'overwrite') {
+            operation = await pickExistingChannelOperation(rl, '钉钉', choice.name);
+            if (operation === 'configure' && !await confirmOverwriteChannel(rl, '钉钉', choice.name))
+                return;
+        }
+        contactBinding = await pickContactForChannelBinding(rl, agentConfig, 'dingtalk');
         if (!contactBinding)
             return;
     }
     finally {
         rl.close();
     }
+    if (operation === 'rebind-contact') {
+        await registerDingtalkContactBind(aid, contactBindChannelKey('dingtalk', aid, choice.name), contactBinding);
+        return;
+    }
     console.log('\n正在获取钉钉登录二维码...\n');
     let result;
     try {
@@ -997,6 +1043,7 @@ export async function cmdInitQQBot() {
     let agentConfig = null;
     let choice = null;
     let contactBinding = null;
+    let operation = 'configure';
     try {
         aid = await pickAgentForChannel(rl);
         if (!aid)
@@ -1007,16 +1054,25 @@ export async function cmdInitQQBot() {
             return;
         }
         const existing = (agentConfig.channels || []).filter(c => c.type === 'qqbot');
-        choice = await pickInstanceWithinAgent(rl, 'qqbot', existing);
+        choice = await pickInstanceWithinAgent(rl, 'qqbot', existing, { confirmOverwrite: false });
         if (choice === null)
             return;
-        contactBinding = await pickOwnerAdminForChannelBinding(rl, agentConfig, 'qqbot');
+        if (choice.action === 'overwrite') {
+            operation = await pickExistingChannelOperation(rl, 'QQ', choice.name);
+            if (operation === 'configure' && !await confirmOverwriteChannel(rl, 'QQ', choice.name))
+                return;
+        }
+        contactBinding = await pickContactForChannelBinding(rl, agentConfig, 'qqbot');
         if (!contactBinding)
             return;
     }
     finally {
         rl.close();
     }
+    if (operation === 'rebind-contact') {
+        await registerQQBotContactBind(aid, contactBindChannelKey('qqbot', aid, choice.name), contactBinding);
+        return;
+    }
     console.log('\n正在创建 QQ 机器人绑定任务...\n');
     let result;
     try {
@@ -1066,7 +1122,15 @@ export async function cmdInitQQBot() {
     if (!commitResult)
         return;
     console.log(`  App ID: ${result.appId}`);
-    bindQrActorToContact(aid, contactBinding, 'qqbot', result.userOpenId, commitResult.channelKey);
+    if (firstNonEmpty(result.userOpenId)) {
+        bindQrActorToContact(aid, contactBinding, 'qqbot', result.userOpenId, commitResult.channelKey);
+    }
+    else if (commitResult.reloaded) {
+        await registerQQBotContactBind(aid, commitResult.channelKey, contactBinding);
+    }
+    else {
+        console.log('  ⚠ 服务未运行或热重载失败，无法注册 QQ 绑定码；请启动服务后重新执行 ec init qqbot。');
+    }
     const { generateInitSuccessMessage } = await import('../utils/welcome.js');
     console.log(generateInitSuccessMessage('qqbot', contactBinding !== null));
 }
@@ -1077,6 +1141,7 @@ export async function cmdInitWecom() {
     let agentConfig = null;
     let choice = null;
     let contactBinding = null;
+    let operation = 'configure';
     let botId = '';
     let secret = '';
     try {
@@ -1089,60 +1154,71 @@ export async function cmdInitWecom() {
             return;
         }
         const existing = (agentConfig.channels || []).filter(c => c.type === 'wecom');
-        choice = await pickInstanceWithinAgent(rl, 'wecom', existing);
+        choice = await pickInstanceWithinAgent(rl, 'wecom', existing, { confirmOverwrite: false });
         if (choice === null)
             return;
-        contactBinding = await pickOwnerAdminForChannelBinding(rl, agentConfig, 'wecom');
+        if (choice.action === 'overwrite') {
+            operation = await pickExistingChannelOperation(rl, '企微', choice.name);
+            if (operation === 'configure' && !await confirmOverwriteChannel(rl, '企微', choice.name))
+                return;
+        }
+        contactBinding = await pickContactForChannelBinding(rl, agentConfig, 'wecom');
         if (!contactBinding)
             return;
-        console.log('\n企业微信 AI Bot 配置');
-        const method = (await ask(rl, '  接入方式：1. 扫码创建（推荐）  2. 手工输入 [1]: ')).trim() || '1';
-        if (method === '1') {
-            try {
-                const { createWecomQrSession, pollWecomQrCredentials } = await import('../channels/wecom-onboarding.js');
-                const session = await createWecomQrSession();
-                const qrterm = await import('qrcode-terminal');
-                console.log('\n请使用企业微信扫描以下二维码：\n');
-                await new Promise(resolve => {
-                    qrterm.default.generate(session.authUrl, { small: true }, (qr) => {
-                        console.log(qr);
-                        resolve();
+        if (operation !== 'rebind-contact') {
+            console.log('\n企业微信 AI Bot 配置');
+            const method = (await ask(rl, '  接入方式：1. 扫码创建（推荐）  2. 手工输入 [1]: ')).trim() || '1';
+            if (method === '1') {
+                try {
+                    const { createWecomQrSession, pollWecomQrCredentials } = await import('../channels/wecom.js');
+                    const session = await createWecomQrSession();
+                    const qrterm = await import('qrcode-terminal');
+                    console.log('\n请使用企业微信扫描以下二维码：\n');
+                    await new Promise(resolve => {
+                        qrterm.default.generate(session.authUrl, { small: true }, (qr) => {
+                            console.log(qr);
+                            resolve();
+                        });
+                    });
+                    console.log(`也可在浏览器打开：${session.browserUrl}`);
+                    console.log('等待扫码确认，二维码 5 分钟内有效...\n');
+                    const credentials = await pollWecomQrCredentials(session.scode, {
+                        onStatus: status => {
+                            if (status !== 'waiting')
+                                console.log(`  扫码状态: ${status}`);
+                        },
                     });
-                });
-                console.log(`也可在浏览器打开：${session.browserUrl}`);
-                console.log('等待扫码确认，二维码 5 分钟内有效...\n');
-                const credentials = await pollWecomQrCredentials(session.scode, {
-                    onStatus: status => {
-                        if (status !== 'waiting')
-                            console.log(`  扫码状态: ${status}`);
-                    },
-                });
-                botId = credentials.botId;
-                secret = credentials.secret;
-                console.log('  ✓ 已取得 Bot ID 和 Secret');
+                    botId = credentials.botId;
+                    secret = credentials.secret;
+                    console.log('  ✓ 已取得 Bot ID 和 Secret');
+                }
+                catch (error) {
+                    console.log(`  ⚠ 扫码接入失败: ${error instanceof Error ? error.message : String(error)}`);
+                    console.log('  将切换到手工输入模式。\n');
+                }
             }
-            catch (error) {
-                console.log(`  ⚠ 扫码接入失败: ${error instanceof Error ? error.message : String(error)}`);
-                console.log('  将切换到手工输入模式。\n');
+            if (!botId || !secret) {
+                console.log('请在企业微信管理后台 → AI Bot 页面获取 Bot ID 和 Secret\n');
+            }
+            while (!botId) {
+                botId = (await ask(rl, '  Bot ID: ')).trim();
+                if (!botId)
+                    console.log('  ⚠ 不能为空');
+            }
+            while (!secret) {
+                secret = (await ask(rl, '  Secret: ')).trim();
+                if (!secret)
+                    console.log('  ⚠ 不能为空');
             }
-        }
-        if (!botId || !secret) {
-            console.log('请在企业微信管理后台 → AI Bot 页面获取 Bot ID 和 Secret\n');
-        }
-        while (!botId) {
-            botId = (await ask(rl, '  Bot ID: ')).trim();
-            if (!botId)
-                console.log('  ⚠ 不能为空');
-        }
-        while (!secret) {
-            secret = (await ask(rl, '  Secret: ')).trim();
-            if (!secret)
-                console.log('  ⚠ 不能为空');
         }
     }
     finally {
         rl.close();
     }
+    if (operation === 'rebind-contact') {
+        await registerWecomContactBind(aid, contactBindChannelKey('wecom', aid, choice.name), contactBinding);
+        return;
+    }
     const channel = {
         type: 'wecom',
         name: choice.name,
@@ -1201,24 +1277,42 @@ async function pickAgentForChannel(rl) {
  *
  * If existing.length === 0 → returns { action:'add', name:'main' } directly.
  */
-async function pickInstanceWithinAgent(rl, channelType, existing) {
+async function pickInstanceWithinAgent(rl, channelType, existing, options) {
     if (existing.length === 0) {
         return { action: 'add', name: 'main' };
     }
     const view = existing.map((c, i) => ({ ...c, name: c.name, originalIndex: i }));
-    return await selectInstance(rl, channelType, view);
+    return await selectInstance(rl, channelType, view, options);
 }
-async function pickOwnerAdminForChannelBinding(rl, agentConfig, channelType) {
-    const candidates = ownerAdminContactCandidates(agentConfig);
-    if (candidates.length === 0) {
-        console.log(`\n❌ agent ${agentConfig.aid} 尚未配置 owner/admin，无法为 ${channelType} 扫码账号建立身份映射。`);
-        console.log('   请先通过 AUN 绑定 agent owner，或由 owner 在 AUN 私聊 relation 中分配 admin 后重试。');
-        return null;
+async function pickExistingChannelOperation(rl, displayName, channelName) {
+    console.log(`\n请选择对${displayName}实例 ${channelName} 的操作：`);
+    console.log('  a. 覆盖机器人配置（重新扫码或输入 App ID / App Secret）');
+    console.log('  b. 重新绑定联系人（保留机器人配置，生成一次性 /bind 验证码）');
+    while (true) {
+        const choice = (await ask(rl, '请选择 [a/b]: ')).trim().toLowerCase();
+        if (choice === 'a')
+            return 'configure';
+        if (choice === 'b')
+            return 'rebind-contact';
+        console.log('无效选择，请输入 a 或 b');
     }
-    console.log(`\n请选择 ${channelType} 扫码账号要绑定到的 owner/admin AID：`);
+}
+async function confirmOverwriteChannel(rl, displayName, channelName) {
+    const confirm = (await ask(rl, `⚠️ 即将覆盖${displayName}实例 ${channelName} 的机器人配置，确认？(y/N) `)).trim().toLowerCase();
+    if (confirm === 'y' || confirm === 'yes')
+        return true;
+    console.log('已取消');
+    return false;
+}
+async function pickContactForChannelBinding(rl, agentConfig, channelType) {
+    const candidates = preferredContactBindingCandidates(agentConfig);
+    const contacts = getContactSnapshot(agentConfig.aid).contacts;
+    console.log(`\n请选择 ${channelType} 账号要绑定到的联系人 AID：`);
     candidates.forEach((candidate, index) => {
         console.log(`  ${index + 1}. ${candidate.primaryId} (${candidate.label})`);
     });
+    const manualChoice = candidates.length + 1;
+    console.log(`  ${manualChoice}. 手工输入已有联系人 AID`);
     const defaultIndex = candidates.length === 1 ? 1 : null;
     const prompt = defaultIndex ? `请选择 [${defaultIndex}]: ` : '请选择: ';
     while (true) {
@@ -1227,14 +1321,26 @@ async function pickOwnerAdminForChannelBinding(rl, agentConfig, channelType) {
         if (Number.isInteger(selected) && selected >= 1 && selected <= candidates.length) {
             return candidates[selected - 1];
         }
-        console.log(`无效选择，请输入 1-${candidates.length}`);
+        if (selected === manualChoice) {
+            const primaryId = (await ask(rl, '请输入要绑定的联系人 AID: ')).trim();
+            if (isValidAid(primaryId) && contacts.has(primaryId))
+                return { primaryId, label: 'contact' };
+            if (isValidAid(primaryId)) {
+                console.log('该 AID 不是当前 Agent 的联系人，请先添加联系人或将其设为 Owner。');
+                continue;
+            }
+            console.log('AID 格式无效，请重新输入。');
+            continue;
+        }
+        console.log(`无效选择，请输入 1-${manualChoice}`);
     }
 }
-function ownerAdminContactCandidates(agentConfig) {
+function preferredContactBindingCandidates(agentConfig) {
+    const contacts = getContactSnapshot(agentConfig.aid).contacts;
     const labels = new Map();
     const add = (value, label) => {
         const aid = String(value || '').trim();
-        if (!isValidAid(aid))
+        if (!isValidAid(aid) || !contacts.has(aid))
             return;
         let set = labels.get(aid);
         if (!set) {
@@ -1273,6 +1379,18 @@ function bindQrActorToContact(aid, binding, channelType, actorId, channelKey) {
 async function registerDingtalkContactBind(aid, channelName, binding) {
     await registerChannelContactBind('dingtalk', '钉钉', aid, channelName, binding);
 }
+function contactBindChannelKey(channelType, aid, channelName) {
+    return `${channelType}#${aid}#${channelName}`;
+}
+async function registerFeishuContactBind(aid, channelName, binding) {
+    await registerChannelContactBind('feishu', '飞书', aid, channelName, binding);
+}
+async function registerWechatContactBind(aid, channelName, binding) {
+    await registerChannelContactBind('wechat', '微信', aid, channelName, binding);
+}
+async function registerQQBotContactBind(aid, channelName, binding) {
+    await registerChannelContactBind('qqbot', 'QQ', aid, channelName, binding);
+}
 async function registerWecomContactBind(aid, channelName, binding) {
     await registerChannelContactBind('wecom', '企微', aid, channelName, binding);
 }
@@ -1292,7 +1410,7 @@ async function registerChannelContactBind(channelType, displayName, aid, channel
     }
     const expiresAt = new Date(Number(result.expiresAt)).toLocaleString();
     console.log(`  ✓ ${displayName}身份绑定码: ${result.code}`);
-    console.log(`    请在 10 分钟内私聊${displayName}机器人，直接发送这 6 位数字绑定码。有效期至: ${expiresAt}`);
+    console.log(`    请在 10 分钟内私聊${displayName}机器人，发送：/bind ${result.code}。有效期至: ${expiresAt}`);
 }
 function firstNonEmpty(...values) {
     for (const value of values) {

package/dist/cli/init.js

@@ -1,4 +1,5 @@
 import fs from 'fs';
+import os from 'os';
 import path from 'path';
 import readline from 'readline';
 import { resolvePaths, ensureDataDirs } from '../paths.js';
@@ -13,6 +14,15 @@ import { WEB_CLI_BIN, WEB_PACKAGE_LATEST } from '../product.js';
 function ask(rl, question) {
     return new Promise(resolve => rl.question(question, resolve));
 }
+/** 展开用户在交互式输入中使用的 home 目录简写（shell 不会替 readline 自动做这件事）。 */
+export function expandLeadingTildePath(value, homeDir = os.homedir()) {
+    if (value === '~')
+        return homeDir;
+    if (value.startsWith('~/') || value.startsWith('~\\')) {
+        return path.join(homeDir, value.slice(2));
+    }
+    return value;
+}
 const BASEAGENT_CANDIDATES = ['claude', 'codex', 'gemini'];
 function isBaseagentAvailable(baseagent) {
     if (baseagent === 'codex')
@@ -167,7 +177,7 @@ export async function cmdInit(options) {
         await runInteractive();
     }
     // ── 共享 tail（单一出口）：提示创建 agent + 生成控制 AID ──
-    await initTail();
+    await initTail({ invokedByStart: options?.invokedByStart });
     // ── 内部函数 ──
     async function runInteractive() {
         const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
@@ -194,29 +204,36 @@ export async function cmdInit(options) {
         }
         async function askProjectsDefaultPath() {
             const defaultDir = path.join(defaultProjectsRoot(p.root), 'default');
-            const input = (await ask(rl, `项目默认目录 [${defaultDir}]: `)).trim();
-            const resolved = input || defaultDir;
-            if (!path.isAbsolute(resolved)) {
-                console.log('  ⚠ 需要绝对路径，已跳过');
-                return undefined;
-            }
-            if (!fs.existsSync(resolved)) {
-                const create = (await ask(rl, `  目录不存在，是否创建？[Y/n]: `)).trim().toLowerCase();
-                if (create === '' || create === 'y' || create === 'yes') {
-                    try {
-                        fs.mkdirSync(resolved, { recursive: true });
+            while (true) {
+                const input = (await ask(rl, `项目默认目录 [${defaultDir}]（输入 skip 跳过）: `)).trim();
+                if (input.toLowerCase() === 'skip') {
+                    console.log('  已跳过项目默认目录配置');
+                    return undefined;
+                }
+                const resolved = expandLeadingTildePath(input || defaultDir);
+                if (!path.isAbsolute(resolved)) {
+                    console.log('  ⚠ 请输入绝对路径或回车使用默认值；输入 skip 可跳过');
+                    continue;
+                }
+                if (!fs.existsSync(resolved)) {
+                    const create = (await ask(rl, `  目录不存在，是否创建？[Y/n]: `)).trim().toLowerCase();
+                    if (create === '' || create === 'y' || create === 'yes') {
+                        try {
+                            fs.mkdirSync(resolved, { recursive: true });
+                        }
+                        catch (e) {
+                            console.log(`  ⚠ 创建目录失败: ${e?.message || e}`);
+                            continue;
+                        }
+                        console.log(`  ✓ 已创建 ${resolved}`);
                     }
-                    catch (e) {
-                        console.log(`  ⚠ 创建目录失败: ${e?.message || e}`);
-                        return undefined;
+                    else {
+                        console.log('  未创建目录，请重新输入路径；输入 skip 可跳过');
+                        continue;
                     }
-                    console.log(`  ✓ 已创建 ${resolved}`);
-                }
-                else {
-                    return undefined;
                 }
+                return resolved;
             }
-            return resolved;
         }
         try {
             if (defaultsExisted) {
@@ -249,10 +266,10 @@ export async function cmdInit(options) {
     }
 }
 /** 补全控制 AID + owners（可单独调用，不走 baseagent 向导）。 */
-export async function initTail() {
+export async function initTail(options = {}) {
     // 提示创建 agent（两分支汇合后执行一次）
     const { agents } = loadAllAgents();
-    if (agents.length === 0) {
+    if (agents.length === 0 && !options.invokedByStart) {
         console.log('\n提示：尚无 agent，运行以下命令创建：');
         console.log('  ec agent new <aid>.agentid.pub');
     }
@@ -368,6 +385,9 @@ export async function initTail() {
             }
         }
     }
+    // ec start 会接着启动 daemon，并在其 ready 后给出可用的 Agent 创建入口。
+    if (options.invokedByStart)
+        return;
     // 初始化完成总结
     console.log('\n✓ EvolCore 初始化完成');
     const finalCfg = loadDaemonConfig();
@@ -390,7 +410,7 @@ export async function initTail() {
  * Present instance selection menu when existing instances are found.
  * Returns the user's choice, or null if cancelled.
  */
-export async function selectInstance(rl, channelType, instances) {
+export async function selectInstance(rl, channelType, instances, options = {}) {
     const typeLabel = channelType === 'feishu' ? '飞书' : channelType === 'wechat' ? '微信' : channelType === 'dingtalk' ? '钉钉' : channelType === 'qqbot' ? 'QQ机器人' : channelType === 'wecom' ? '企业微信' : channelType.toUpperCase();
     console.log(`\n发现已有 ${typeLabel} 配置：`);
     const letters = 'abcdefghijklmnopqrstuvwxyz';
@@ -427,10 +447,12 @@ export async function selectInstance(rl, channelType, instances) {
     }
     const target = instances[choiceIndex];
     console.log(`\n已选择：${target.name}`);
-    const confirm = (await new Promise(r => rl.question(`⚠️ 即将覆盖该配置，确认？(y/N) `, r))).trim().toLowerCase();
-    if (confirm !== 'y' && confirm !== 'yes') {
-        console.log('已取消');
-        return null;
+    if (options.confirmOverwrite !== false) {
+        const confirm = (await new Promise(r => rl.question(`⚠️ 即将覆盖该配置，确认？(y/N) `, r))).trim().toLowerCase();
+        if (confirm !== 'y' && confirm !== 'yes') {
+            console.log('已取消');
+            return null;
+        }
     }
     return { action: 'overwrite', index: choiceIndex, name: target.name };
 }