evolcore 0.0.1 → 0.0.3

package/dist/cli/init-channel.js

@@ -0,0 +1,1372 @@
+/**
+ * Channel-specific init flows: Feishu, WeChat, AUN
+ *
+ * Each channel provides:
+ *   - cmdInit<Channel>()  — standalone `ec init <channel>` entry
+ *   - run<Channel>QrFlow() or setupAun*() — reusable primitives for the main init wizard
+ */
+import readline from 'readline';
+import crypto from 'crypto';
+import { selectInstance } from './init.js';
+import { loadAllAgents, loadAgent, saveAgent, loadDaemonConfig, saveDaemonConfig } from '../config-store.js';
+import { agentChannelUpsert } from './agent.js';
+import { isValidAid } from '../aun/aid/index.js';
+import { resolvePaths } from '../paths.js';
+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 { listStaticAgentAdmins } from '../config/peer-role-resolver.js';
+import { setupRawKeyListener } from './raw-key-input.js';
+function ask(rl, question) {
+    return new Promise(resolve => rl.question(question, resolve));
+}
+export async function runDaemonOwnerQrBindFlow(ownerMode = 'append') {
+    const p = resolvePaths();
+    const daemonConfig = loadDaemonConfig();
+    if (!daemonConfig.aid) {
+        console.log('❌ 未找到控制 AID，请先运行 ec init');
+        return null;
+    }
+    let status = await ipcQuery(p.socket, { type: 'status' }, 1000);
+    let startedBootstrapDaemon = false;
+    if (!status) {
+        await cmdStart({ bindBootstrap: true });
+        startedBootstrapDaemon = loadAllAgents().agents.length === 0;
+        status = await waitForIpcStatus(30_000);
+    }
+    try {
+        if (!status) {
+            console.log('❌ daemon 未就绪，无法创建绑定任务');
+            return null;
+        }
+        if (!status.controlAid?.connected) {
+            console.log('⚠ daemon 已启动，但 AUN 控制通道尚未连接；仍将生成二维码，daemon 会后台重连');
+        }
+        const begin = await ipcQuery(p.socket, {
+            type: 'bind.begin',
+            bindType: 'daemon',
+            ownerMode,
+        }, 3000);
+        if (!begin?.ok) {
+            console.log(`❌ 创建绑定任务失败: ${begin?.error || 'unknown error'}`);
+            return null;
+        }
+        await printQr(begin.qrData);
+        console.log('\n请用 evol app 扫描上方二维码完成绑定');
+        console.log('按 q 取消 | 10 分钟内有效\n');
+        const result = await pollBindStatusWithKeyboard(begin.taskId, begin.expiresAt);
+        if (result === 'quit') {
+            await ipcQuery(p.socket, { type: 'bind.cancel', taskId: begin.taskId }, 1000);
+            console.log('已取消');
+            return null;
+        }
+        if (result === 'skip') {
+            await ipcQuery(p.socket, { type: 'bind.cancel', taskId: begin.taskId }, 1000);
+            console.log('已跳过扫码');
+            return null;
+        }
+        if (!result) {
+            console.log('绑定超时，请重新生成二维码');
+            return null;
+        }
+        return { boundAid: result.boundAid, boundName: result.boundName };
+    }
+    finally {
+        if (startedBootstrapDaemon) {
+            await stopStartedBootstrapDaemon();
+        }
+    }
+}
+export async function runAgentOwnerQrBindFlow(targetAid, agentName, ownerMode = 'append') {
+    const p = resolvePaths();
+    const daemonConfig = loadDaemonConfig();
+    if (!daemonConfig.aid) {
+        console.log('❌ 未找到控制 AID，请先运行 ec init');
+        return null;
+    }
+    let status = await ipcQuery(p.socket, { type: 'status' }, 1000);
+    if (!status) {
+        await cmdStart();
+        status = await waitForIpcStatus(30_000);
+    }
+    if (!status) {
+        console.log('❌ daemon 未就绪，无法创建 agent 绑定任务');
+        return null;
+    }
+    if (!status.controlAid?.connected) {
+        console.log('⚠ daemon 已启动，但 AUN 控制通道尚未连接；仍将生成二维码，daemon 会后台重连');
+    }
+    const begin = await ipcQuery(p.socket, {
+        type: 'bind.begin',
+        bindType: 'agent',
+        targetAid,
+        agentName,
+        ownerMode,
+    }, 3000);
+    if (!begin?.ok) {
+        console.log(`❌ 创建 agent 绑定任务失败: ${begin?.error || 'unknown error'}`);
+        return null;
+    }
+    await printQr(begin.qrData);
+    console.log('\n请用 evol app 扫描上方二维码，10 分钟内有效');
+    console.log('按 q 退出 | 按 s 跳过扫码手动输入 agent owner AID\n');
+    const result = await pollBindStatusWithKeyboard(begin.taskId, begin.expiresAt);
+    if (result === 'quit') {
+        await ipcQuery(p.socket, { type: 'bind.cancel', taskId: begin.taskId }, 1000);
+        console.log('已取消');
+        return null;
+    }
+    if (result === 'skip') {
+        await ipcQuery(p.socket, { type: 'bind.cancel', taskId: begin.taskId }, 1000);
+        console.log('已跳过扫码');
+        return null;
+    }
+    if (!result) {
+        console.log('绑定超时');
+        return null;
+    }
+    await reloadAgentAfterBind(targetAid);
+    return { boundAid: result.boundAid, boundName: result.boundName };
+}
+async function waitForIpcStatus(timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    const p = resolvePaths();
+    while (Date.now() < deadline) {
+        const status = await ipcQuery(p.socket, { type: 'status' }, 1000);
+        if (status?.pid)
+            return status;
+        await new Promise(r => setTimeout(r, 500));
+    }
+    return null;
+}
+async function stopStartedBootstrapDaemon() {
+    const status = await ipcQuery(resolvePaths().socket, { type: 'status' }, 1000);
+    const pid = typeof status?.pid === 'number' ? status.pid : null;
+    if (!pid)
+        return;
+    platform.killProcess(pid);
+    if (!await waitForProcessExit(pid, 5_000)) {
+        platform.killProcess(pid, true);
+        await waitForProcessExit(pid, 3_000);
+    }
+    cleanupInstances();
+    const stale = await ipcQuery(resolvePaths().socket, { type: 'status' }, 500);
+    if (stale?.pid === pid) {
+        console.log(`⚠ bootstrap daemon PID ${pid} 仍在响应 IPC，后续 start 可能需要先执行 ec stop`);
+    }
+}
+async function waitForProcessExit(pid, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (!platform.isProcessRunning(pid)) {
+            return true;
+        }
+        await new Promise(r => setTimeout(r, 250));
+    }
+    return !platform.isProcessRunning(pid);
+}
+async function reloadAgentAfterBind(aid) {
+    try {
+        const result = await ipcQuery(resolvePaths().socket, { type: 'evolagent.reload', name: aid }, 30_000);
+        if (result?.ok) {
+            console.log('  ✓ agent owner 已热重载');
+        }
+        else if (result?.error) {
+            console.log(`  ⚠ agent owner 已写入配置，热重载失败：${result.error}`);
+        }
+    }
+    catch {
+        console.log('  ⚠ agent owner 已写入配置，daemon 未响应热重载；下次启动生效');
+    }
+}
+async function printQr(qrData) {
+    const qrText = JSON.stringify(qrData);
+    try {
+        const qrterm = await import('qrcode-terminal');
+        await new Promise(resolve => {
+            qrterm.default.generate(qrText, { small: true }, (qr) => {
+                console.log(qr);
+                resolve();
+            });
+        });
+    }
+    catch {
+        console.log(qrText);
+    }
+}
+async function pollBindStatusWithKeyboard(taskId, expiresAt) {
+    let quit = false;
+    let skip = false;
+    const p = resolvePaths();
+    const cleanup = setupRawKeyListener((key) => {
+        if (key === 'q' || key === '\u0003')
+            quit = true;
+        if (key === 's' || key === 'S')
+            skip = true;
+    });
+    try {
+        while (Date.now() < expiresAt) {
+            if (quit)
+                return 'quit';
+            if (skip)
+                return 'skip';
+            const status = await ipcQuery(p.socket, { type: 'bind.status', taskId }, 1500);
+            if (status?.ok && status.status === 'bound') {
+                return { boundAid: status.boundAid, boundName: status.boundName };
+            }
+            if (status?.ok && (status.status === 'expired' || status.status === 'cancelled')) {
+                return null;
+            }
+            await new Promise(r => setTimeout(r, 1000));
+        }
+        return null;
+    }
+    finally {
+        cleanup();
+    }
+}
+// ==================== Feishu ====================
+const FEISHU_PROD_URL = 'https://accounts.feishu.cn';
+const LARK_PROD_URL = 'https://accounts.larksuite.com';
+const SKIP = Symbol('SKIP');
+const QUIT = Symbol('QUIT');
+class FeishuQrRegistrationClient {
+    baseUrl;
+    constructor(isLark = false) {
+        this.baseUrl = isLark ? LARK_PROD_URL : FEISHU_PROD_URL;
+    }
+    setDomain(isLark) {
+        this.baseUrl = isLark ? LARK_PROD_URL : FEISHU_PROD_URL;
+    }
+    async init() {
+        return this.postRegistration('init', {});
+    }
+    async begin() {
+        return this.postRegistration('begin', {
+            archetype: 'PersonalAgent',
+            auth_method: 'client_secret',
+            request_user_info: 'open_id',
+        });
+    }
+    async poll(deviceCode) {
+        return this.postRegistration('poll', { device_code: deviceCode });
+    }
+    async postRegistration(action, extraParams) {
+        const body = new URLSearchParams({ action, ...extraParams }).toString();
+        const res = await fetch(`${this.baseUrl}/oauth/v1/app/registration`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/x-www-form-urlencoded' },
+            body,
+        });
+        const text = await res.text();
+        if (!text)
+            return {};
+        return JSON.parse(text);
+    }
+}
+async function runQrRegistrationFlow() {
+    const client = new FeishuQrRegistrationClient();
+    const initResult = await client.init();
+    const authMethods = Array.isArray(initResult.supported_auth_methods) ? initResult.supported_auth_methods : [];
+    if (!authMethods.includes('client_secret')) {
+        throw new Error('当前环境不支持 client_secret 注册');
+    }
+    const beginResult = await client.begin();
+    if (!beginResult.verification_uri_complete || !beginResult.device_code) {
+        throw new Error('服务端未返回扫码链接或 device_code');
+    }
+    // 显示二维码
+    try {
+        const qrterm = await import('qrcode-terminal');
+        await new Promise(resolve => {
+            qrterm.default.generate(beginResult.verification_uri_complete, { small: true }, (qr) => {
+                console.log(qr);
+                resolve();
+            });
+        });
+    }
+    catch {
+        console.log(`请在浏览器中打开此链接扫码: ${beginResult.verification_uri_complete}\n`);
+    }
+    console.log('请用飞书/Lark 扫描上方二维码...\n');
+    console.log('按 q 退出 | 按 s 跳过扫码手动输入 appId/appSecret\n');
+    let userAction = null;
+    const cleanup = setupRawKeyListener((key) => {
+        if (key === 'q' || key === '\u0003')
+            userAction = QUIT;
+        if (key === 's')
+            userAction = SKIP;
+    });
+    const startedAt = Date.now();
+    let pollIntervalSeconds = Number(beginResult.interval ?? 5);
+    const expireInSeconds = Number(beginResult.expires_in ?? beginResult.expire_in ?? 600);
+    let domainResolved = false;
+    let currentDomain = 'feishu';
+    try {
+        while (Date.now() - startedAt < expireInSeconds * 1000) {
+            if (userAction === QUIT)
+                return QUIT;
+            if (userAction === SKIP)
+                return SKIP;
+            const pollResult = await client.poll(beginResult.device_code);
+            if (pollResult.user_info?.tenant_brand === 'lark' && !domainResolved) {
+                client.setDomain(true);
+                currentDomain = 'lark';
+                domainResolved = true;
+            }
+            if (pollResult.client_id && pollResult.client_secret) {
+                return {
+                    appId: pollResult.client_id,
+                    appSecret: pollResult.client_secret,
+                    domain: currentDomain,
+                    openId: pollResult.user_info?.open_id ?? '',
+                };
+            }
+            if (pollResult.error === 'authorization_pending') {
+                await new Promise(r => setTimeout(r, pollIntervalSeconds * 1000));
+                continue;
+            }
+            if (pollResult.error === 'slow_down') {
+                pollIntervalSeconds += 5;
+                await new Promise(r => setTimeout(r, pollIntervalSeconds * 1000));
+                continue;
+            }
+            if (pollResult.error === 'access_denied') {
+                throw new Error('用户拒绝了扫码授权');
+            }
+            if (pollResult.error === 'expired_token') {
+                throw new Error('扫码会话已过期');
+            }
+            if (pollResult.error) {
+                throw new Error(`扫码注册失败: ${pollResult.error}${pollResult.error_description ? ` - ${pollResult.error_description}` : ''}`);
+            }
+            await new Promise(r => setTimeout(r, pollIntervalSeconds * 1000));
+        }
+        throw new Error('等待扫码结果超时');
+    }
+    finally {
+        cleanup();
+    }
+}
+async function manualInput(rl) {
+    console.log('\n手动输入模式：\n');
+    let appId = '';
+    while (!appId) {
+        appId = (await ask(rl, '  飞书 App ID: ')).trim();
+        if (!appId)
+            console.log('  ⚠ 不能为空');
+    }
+    let appSecret = '';
+    while (!appSecret) {
+        appSecret = (await ask(rl, '  飞书 App Secret: ')).trim();
+        if (!appSecret)
+            console.log('  ⚠ 不能为空');
+    }
+    return { appId, appSecret, domain: 'unknown', openId: '' };
+}
+export async function runFeishuQrFlow() {
+    try {
+        const result = await runQrRegistrationFlow();
+        if (result === QUIT || result === SKIP)
+            return null;
+        return result;
+    }
+    catch (error) {
+        console.error(`\n登录失败: ${error instanceof Error ? error.message : error}`);
+        return null;
+    }
+}
+export async function cmdInitFeishu() {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    let aid = null;
+    let agentConfig = null;
+    let choice = null;
+    let contactBinding = null;
+    try {
+        aid = await pickAgentForChannel(rl);
+        if (!aid)
+            return;
+        agentConfig = loadAgent(aid);
+        if (!agentConfig) {
+            console.error(`❌ 无法加载 agent ${aid} 的配置`);
+            return;
+        }
+        const existing = (agentConfig.channels || []).filter(c => c.type === 'feishu');
+        choice = await pickInstanceWithinAgent(rl, 'feishu', existing);
+        if (choice === null)
+            return;
+        contactBinding = await pickOwnerAdminForChannelBinding(rl, agentConfig, 'feishu');
+        if (!contactBinding)
+            return;
+    }
+    finally {
+        rl.close();
+    }
+    console.log('\n正在获取飞书登录二维码...\n');
+    let result;
+    try {
+        const flowResult = await runQrRegistrationFlow();
+        if (flowResult === QUIT) {
+            console.log('已退出');
+            return;
+        }
+        if (flowResult === SKIP) {
+            const rl2 = readline.createInterface({ input: process.stdin, output: process.stdout });
+            try {
+                result = await manualInput(rl2);
+            }
+            finally {
+                rl2.close();
+            }
+        }
+        else {
+            result = flowResult;
+        }
+    }
+    catch (error) {
+        console.error(`\n登录失败: ${error instanceof Error ? error.message : error}`);
+        process.exit(1);
+    }
+    const channel = {
+        type: 'feishu',
+        name: choice.name,
+        enabled: true,
+        appId: result.appId,
+        appSecret: result.appSecret,
+    };
+    const commitResult = await commitChannel(aid, channel, choice.action);
+    if (!commitResult)
+        return;
+    console.log(`  App ID: ${result.appId}`);
+    if (result.openId)
+        console.log(`  Login Open ID: ${result.openId}`);
+    if (result.domain !== 'unknown')
+        console.log(`  Domain: ${result.domain}`);
+    bindQrActorToContact(aid, contactBinding, 'feishu', result.openId, commitResult.channelKey);
+    // Show unified init success message
+    const { generateInitSuccessMessage } = await import('../utils/welcome.js');
+    console.log(generateInitSuccessMessage('feishu', contactBinding !== null));
+}
+// ==================== WeChat ====================
+const DEFAULT_BASE_URL = 'https://ilinkai.weixin.qq.com';
+const BOT_TYPE = '3';
+const QR_POLL_TIMEOUT_MS = 35_000;
+const LOGIN_TIMEOUT_MS = 480_000;
+async function fetchQRCode(baseUrl) {
+    const base = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;
+    const url = `${base}ilink/bot/get_bot_qrcode?bot_type=${BOT_TYPE}`;
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`QR fetch failed: ${res.status}`);
+    return (await res.json());
+}
+async function pollQRStatus(baseUrl, qrcode) {
+    const base = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;
+    const url = `${base}ilink/bot/get_qrcode_status?qrcode=${encodeURIComponent(qrcode)}`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), QR_POLL_TIMEOUT_MS);
+    try {
+        const res = await fetch(url, {
+            headers: { 'iLink-App-ClientVersion': '1' },
+            signal: controller.signal,
+        });
+        clearTimeout(timer);
+        if (!res.ok)
+            throw new Error(`QR status failed: ${res.status}`);
+        return (await res.json());
+    }
+    catch (err) {
+        clearTimeout(timer);
+        if (err instanceof Error && err.name === 'AbortError') {
+            return { status: 'wait' };
+        }
+        throw err;
+    }
+}
+export async function runWechatQrFlow() {
+    const qrResp = await fetchQRCode(DEFAULT_BASE_URL);
+    try {
+        const qrterm = await import('qrcode-terminal');
+        await new Promise(resolve => {
+            qrterm.default.generate(qrResp.qrcode_img_content, { small: true }, (qr) => {
+                console.log(qr);
+                resolve();
+            });
+        });
+    }
+    catch {
+        console.log(`请在浏览器中打开此链接扫码: ${qrResp.qrcode_img_content}\n`);
+    }
+    console.log('请用微信扫描上方二维码...\n');
+    const deadline = Date.now() + LOGIN_TIMEOUT_MS;
+    let scannedPrinted = false;
+    let currentPollUrl = DEFAULT_BASE_URL;
+    while (Date.now() < deadline) {
+        const status = await pollQRStatus(currentPollUrl, qrResp.qrcode);
+        switch (status.status) {
+            case 'wait':
+                process.stdout.write('.');
+                break;
+            case 'scaned':
+                if (!scannedPrinted) {
+                    console.log('\n👀 已扫码，请在微信中确认...');
+                    scannedPrinted = true;
+                }
+                break;
+            case 'scaned_but_redirect':
+                if (status.redirect_host) {
+                    currentPollUrl = `https://${status.redirect_host}`;
+                }
+                break;
+            case 'expired':
+                console.error('\n二维码已过期');
+                return null;
+            case 'confirmed':
+                if (!status.ilink_bot_id || !status.bot_token) {
+                    console.error('\n登录失败：服务器未返回完整信息');
+                    return null;
+                }
+                return {
+                    baseUrl: status.baseurl || DEFAULT_BASE_URL,
+                    token: status.bot_token,
+                    userId: status.ilink_user_id,
+                };
+        }
+        await new Promise(r => setTimeout(r, 1000));
+    }
+    console.log('\n登录超时');
+    return null;
+}
+export async function cmdInitWechat() {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    let aid = null;
+    let agentConfig = null;
+    let choice = null;
+    let contactBinding = null;
+    try {
+        aid = await pickAgentForChannel(rl);
+        if (!aid)
+            return;
+        agentConfig = loadAgent(aid);
+        if (!agentConfig) {
+            console.error(`❌ 无法加载 agent ${aid} 的配置`);
+            return;
+        }
+        const existing = (agentConfig.channels || []).filter(c => c.type === 'wechat');
+        choice = await pickInstanceWithinAgent(rl, 'wechat', existing);
+        if (choice === null)
+            return;
+        contactBinding = await pickOwnerAdminForChannelBinding(rl, agentConfig, 'wechat');
+        if (!contactBinding)
+            return;
+    }
+    finally {
+        rl.close();
+    }
+    console.log('\n正在获取微信登录二维码...\n');
+    const result = await runWechatQrFlow();
+    if (!result) {
+        console.log('已取消');
+        return;
+    }
+    const channel = {
+        type: 'wechat',
+        name: choice.name,
+        enabled: true,
+        baseUrl: result.baseUrl,
+        token: result.token,
+    };
+    const commitResult = await commitChannel(aid, channel, choice.action);
+    if (!commitResult)
+        return;
+    bindQrActorToContact(aid, contactBinding, 'wechat', result.userId, commitResult.channelKey);
+    // Show unified init success message
+    const { generateInitSuccessMessage } = await import('../utils/welcome.js');
+    console.log(generateInitSuccessMessage('wechat', contactBinding !== null));
+}
+// ==================== AUN ====================
+export async function cmdInitAun() {
+    const daemonConfig = loadDaemonConfig();
+    if (!daemonConfig.aid) {
+        console.log('❌ 未找到控制 AID，请先运行 ec init');
+        return;
+    }
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const target = await pickAunOwnerBindTarget(rl, daemonConfig.aid);
+        if (!target)
+            return;
+        if (target.kind === 'daemon') {
+            console.log(`\n📡 EvolCore daemon owner 绑定 — ${daemonConfig.aid}\n`);
+            const result = await runDaemonOwnerQrBindFlow('append');
+            if (result?.boundAid) {
+                console.log(`\n✅ daemon owner 已绑定: ${result.boundAid}`);
+                return;
+            }
+            await promptDaemonOwnerManually(rl);
+            return;
+        }
+        const agentConfig = loadAgent(target.aid);
+        console.log(`\n📡 Agent owner 绑定 — ${target.aid}\n`);
+        const result = await runAgentOwnerQrBindFlow(target.aid, agentConfig?.aid ?? target.aid, 'append');
+        if (result?.boundAid) {
+            console.log(`\n✅ agent owner 已绑定: ${result.boundAid}`);
+            return;
+        }
+        await promptAgentOwnerForAunManually(rl, target.aid);
+    }
+    finally {
+        rl.close();
+    }
+}
+async function pickAunOwnerBindTarget(rl, daemonAid) {
+    const { agents } = loadAllAgents();
+    console.log('\n请选择 AUN owner 绑定目标：');
+    console.log(`  d. daemon owner (${daemonAid})`);
+    const letters = 'abcdefghijklmnopqrstuvwxyz';
+    for (let i = 0; i < agents.length; i++) {
+        console.log(`  ${letters[i]}. agent owner (${agents[i].aid})`);
+    }
+    console.log('  q. 取消');
+    const validAgentLetters = letters.slice(0, agents.length).split('');
+    while (true) {
+        const input = (await ask(rl, '请选择 [d]: ')).trim().toLowerCase() || 'd';
+        if (input === 'q')
+            return null;
+        if (input === 'd')
+            return { kind: 'daemon' };
+        if (validAgentLetters.includes(input)) {
+            return { kind: 'agent', aid: agents[letters.indexOf(input)].aid };
+        }
+        console.log(`无效选择，请输入 d${validAgentLetters.length ? `/${validAgentLetters.join('/')}` : ''}/q`);
+    }
+}
+async function promptDaemonOwnerManually(rl) {
+    const fallback = (await ask(rl, '\n扫码未完成。手动输入 daemon owner AID（留空跳过）: ')).trim();
+    if (!fallback)
+        return;
+    if (!isValidAid(fallback)) {
+        console.log('  ⚠ Owner AID 格式无效（需合法多级域名，如 alice.agentid.pub）');
+        return;
+    }
+    const owners = [fallback, ...(loadDaemonConfig().owners || []).filter(o => o !== fallback)];
+    saveDaemonConfig({ ...loadDaemonConfig(), owners });
+    console.log(`✅ daemon owner 已设置: ${fallback}`);
+}
+async function promptAgentOwnerForAunManually(rl, aid) {
+    const fallback = (await ask(rl, '\n扫码未完成。手动输入 agent owner AID（留空跳过）: ')).trim();
+    if (!fallback)
+        return;
+    if (!isValidAid(fallback)) {
+        console.log('  ⚠ Owner AID 格式无效（需合法多级域名，如 alice.agentid.pub）');
+        return;
+    }
+    const agent = loadAgent(aid);
+    if (!agent) {
+        console.log(`  ⚠ 无法加载 agent 配置: ${aid}`);
+        return;
+    }
+    const owners = [fallback, ...(agent.owners ?? []).filter(owner => owner !== fallback)];
+    saveAgent({ ...agent, owners });
+    try {
+        const result = await ipcQuery(resolvePaths().socket, { type: 'evolagent.reload', name: aid }, 30_000);
+        if (result?.ok)
+            console.log('  ✓ agent owner 已热重载');
+    }
+    catch { /* daemon not running */ }
+    console.log(`✅ agent owner 已设置: ${fallback}`);
+}
+// ==================== DingTalk ====================
+const DINGTALK_BASE_URL = 'https://oapi.dingtalk.com';
+const DINGTALK_SOURCE = 'openClaw';
+async function dingtalkApiPost(path, payload) {
+    const res = await fetch(`${DINGTALK_BASE_URL}${path}`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+    });
+    if (!res.ok)
+        throw new Error(`DingTalk API ${path} failed: ${res.status}`);
+    const data = await res.json();
+    if (data.errcode && data.errcode !== 0) {
+        throw new Error(`DingTalk API ${path}: ${data.errmsg || 'unknown error'} (errcode=${data.errcode})`);
+    }
+    return data;
+}
+async function runDingtalkQrFlow() {
+    // Step 1: init → nonce
+    const initData = await dingtalkApiPost('/app/registration/init', { source: DINGTALK_SOURCE });
+    const nonce = initData.nonce?.trim();
+    if (!nonce)
+        throw new Error('DingTalk init: 未返回 nonce');
+    // Step 2: begin → device_code + verification_uri_complete
+    const beginData = await dingtalkApiPost('/app/registration/begin', { nonce });
+    const deviceCode = beginData.device_code?.trim();
+    const verificationUri = beginData.verification_uri_complete?.trim();
+    if (!deviceCode)
+        throw new Error('DingTalk begin: 未返回 device_code');
+    if (!verificationUri)
+        throw new Error('DingTalk begin: 未返回 verification_uri_complete');
+    // Display QR code
+    try {
+        const qrterm = await import('qrcode-terminal');
+        await new Promise(resolve => {
+            qrterm.default.generate(verificationUri, { small: true }, (qr) => {
+                console.log(qr);
+                resolve();
+            });
+        });
+    }
+    catch {
+        console.log(`请在浏览器中打开此链接扫码: ${verificationUri}\n`);
+    }
+    console.log('请用钉钉扫描上方二维码...\n');
+    console.log('提示: 扫码页面标注 "OpenClaw" 是钉钉生态接入桥，可放心使用。\n');
+    console.log('按 q 退出 | 按 s 跳过扫码手动输入\n');
+    let userAction = null;
+    const cleanup = setupRawKeyListener((key) => {
+        if (key === 'q' || key === '\u0003')
+            userAction = QUIT;
+        if (key === 's')
+            userAction = SKIP;
+    });
+    const pollInterval = Math.max(Number(beginData.interval ?? 3), 2);
+    const expiresIn = Number(beginData.expires_in ?? 7200);
+    const startedAt = Date.now();
+    try {
+        while (Date.now() - startedAt < expiresIn * 1000) {
+            if (userAction === QUIT)
+                return QUIT;
+            if (userAction === SKIP)
+                return SKIP;
+            await new Promise(r => setTimeout(r, pollInterval * 1000));
+            const pollData = await dingtalkApiPost('/app/registration/poll', { device_code: deviceCode });
+            const status = (pollData.status || '').trim().toUpperCase();
+            if (status === 'SUCCESS') {
+                if (!pollData.client_id || !pollData.client_secret) {
+                    throw new Error('授权成功但未返回凭据');
+                }
+                return {
+                    clientId: pollData.client_id.trim(),
+                    clientSecret: pollData.client_secret.trim(),
+                };
+            }
+            if (status === 'WAITING') {
+                continue;
+            }
+            if (status === 'EXPIRED') {
+                throw new Error('扫码会话已过期');
+            }
+            if (status === 'FAIL') {
+                throw new Error(`授权失败: ${pollData.fail_reason || '未知原因'}`);
+            }
+            // Unknown status — keep polling
+        }
+        throw new Error('等待扫码结果超时');
+    }
+    finally {
+        cleanup();
+    }
+}
+export async function runDingtalkQrFlowSimple() {
+    try {
+        const result = await runDingtalkQrFlow();
+        if (result === QUIT || result === SKIP)
+            return null;
+        return result;
+    }
+    catch (error) {
+        console.error(`\n登录失败: ${error instanceof Error ? error.message : error}`);
+        return null;
+    }
+}
+export async function cmdInitDingtalk() {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    let aid = null;
+    let agentConfig = null;
+    let choice = null;
+    let contactBinding = null;
+    try {
+        aid = await pickAgentForChannel(rl);
+        if (!aid)
+            return;
+        agentConfig = loadAgent(aid);
+        if (!agentConfig) {
+            console.error(`❌ 无法加载 agent ${aid} 的配置`);
+            return;
+        }
+        const existing = (agentConfig.channels || []).filter(c => c.type === 'dingtalk');
+        choice = await pickInstanceWithinAgent(rl, 'dingtalk', existing);
+        if (choice === null)
+            return;
+        contactBinding = await pickOwnerAdminForChannelBinding(rl, agentConfig, 'dingtalk');
+        if (!contactBinding)
+            return;
+    }
+    finally {
+        rl.close();
+    }
+    console.log('\n正在获取钉钉登录二维码...\n');
+    let result;
+    try {
+        const flowResult = await runDingtalkQrFlow();
+        if (flowResult === QUIT) {
+            console.log('已退出');
+            return;
+        }
+        if (flowResult === SKIP) {
+            const rl2 = readline.createInterface({ input: process.stdin, output: process.stdout });
+            try {
+                console.log('\n手动输入模式：\n');
+                let clientId = '';
+                while (!clientId) {
+                    clientId = (await ask(rl2, '  钉钉 Client ID (AppKey): ')).trim();
+                    if (!clientId)
+                        console.log('  ⚠ 不能为空');
+                }
+                let clientSecret = '';
+                while (!clientSecret) {
+                    clientSecret = (await ask(rl2, '  钉钉 Client Secret (AppSecret): ')).trim();
+                    if (!clientSecret)
+                        console.log('  ⚠ 不能为空');
+                }
+                result = { clientId, clientSecret };
+            }
+            finally {
+                rl2.close();
+            }
+        }
+        else {
+            result = flowResult;
+        }
+    }
+    catch (error) {
+        console.error(`\n登录失败: ${error instanceof Error ? error.message : error}`);
+        process.exit(1);
+    }
+    const channel = {
+        type: 'dingtalk',
+        name: choice.name,
+        enabled: true,
+        clientId: result.clientId,
+        clientSecret: result.clientSecret,
+    };
+    const commitResult = await commitChannel(aid, channel, choice.action);
+    if (!commitResult)
+        return;
+    console.log(`  Client ID: ${result.clientId}`);
+    if (commitResult.reloaded) {
+        await registerDingtalkContactBind(aid, commitResult.channelKey, contactBinding);
+    }
+    else {
+        console.log('  ⚠ 服务未运行或热重载失败，无法注册钉钉绑定码；请启动服务后重新执行 ec init dingtalk 并再次扫码绑定。');
+    }
+    const { generateInitSuccessMessage } = await import('../utils/welcome.js');
+    console.log(generateInitSuccessMessage('dingtalk', contactBinding !== null));
+}
+// ==================== QQBot ====================
+const QQBOT_PORTAL_HOST = 'q.qq.com';
+const QQBOT_CREATE_PATH = '/lite/create_bind_task';
+const QQBOT_POLL_PATH = '/lite/poll_bind_result';
+const QQBOT_QR_TEMPLATE = 'https://q.qq.com/qqbot/openclaw/connect.html?task_id={task_id}&_wv=2&source=hermes';
+const QQBOT_POLL_INTERVAL_MS = 2000;
+const QQBOT_POLL_TIMEOUT_MS = 600_000; // 10 minutes
+function qqbotApiHeaders() {
+    return {
+        'Content-Type': 'application/json',
+        'Accept': 'application/json', // Required — without it, q.qq.com returns anti-bot HTML
+        'User-Agent': 'EvolCore/QQBotInit',
+    };
+}
+function generateBindKey() {
+    const keyBuffer = crypto.randomBytes(32);
+    return { keyBase64: keyBuffer.toString('base64'), keyBuffer };
+}
+function decryptSecret(encryptedBase64, keyBuffer) {
+    const raw = Buffer.from(encryptedBase64, 'base64');
+    const iv = raw.subarray(0, 12);
+    const authTag = raw.subarray(raw.length - 16);
+    const ciphertext = raw.subarray(12, raw.length - 16);
+    const decipher = crypto.createDecipheriv('aes-256-gcm', keyBuffer, iv);
+    decipher.setAuthTag(authTag);
+    const decrypted = Buffer.concat([decipher.update(ciphertext), decipher.final()]);
+    return decrypted.toString('utf-8');
+}
+async function runQQBotBindFlow() {
+    // Step 1: Generate AES key and create bind task
+    const { keyBase64, keyBuffer } = generateBindKey();
+    const createRes = await fetch(`https://${QQBOT_PORTAL_HOST}${QQBOT_CREATE_PATH}`, {
+        method: 'POST',
+        headers: qqbotApiHeaders(),
+        body: JSON.stringify({ key: keyBase64 }),
+    });
+    if (!createRes.ok)
+        throw new Error(`create_bind_task failed: ${createRes.status}`);
+    const createData = await createRes.json();
+    if (createData.retcode !== 0) {
+        throw new Error(`create_bind_task: ${createData.msg || 'unknown error'}`);
+    }
+    const taskId = createData.data?.task_id;
+    if (!taskId)
+        throw new Error('create_bind_task: 未返回 task_id');
+    // Step 2: Build QR URL and display
+    const qrUrl = QQBOT_QR_TEMPLATE.replace('{task_id}', encodeURIComponent(taskId));
+    try {
+        const qrterm = await import('qrcode-terminal');
+        await new Promise(resolve => {
+            qrterm.default.generate(qrUrl, { small: true }, (qr) => {
+                console.log(qr);
+                resolve();
+            });
+        });
+    }
+    catch {
+        console.log(`请在浏览器中打开此链接扫码: ${qrUrl}\n`);
+    }
+    console.log('请用 QQ 扫描上方二维码绑定机器人...\n');
+    console.log('按 q 退出 | 按 s 跳过扫码手动输入\n');
+    let userAction = null;
+    const cleanup = setupRawKeyListener((key) => {
+        if (key === 'q' || key === '\u0003')
+            userAction = QUIT;
+        if (key === 's')
+            userAction = SKIP;
+    });
+    const startedAt = Date.now();
+    try {
+        // Step 3: Poll for bind result
+        while (Date.now() - startedAt < QQBOT_POLL_TIMEOUT_MS) {
+            if (userAction === QUIT)
+                return QUIT;
+            if (userAction === SKIP)
+                return SKIP;
+            await new Promise(r => setTimeout(r, QQBOT_POLL_INTERVAL_MS));
+            const pollRes = await fetch(`https://${QQBOT_PORTAL_HOST}${QQBOT_POLL_PATH}`, {
+                method: 'POST',
+                headers: qqbotApiHeaders(),
+                body: JSON.stringify({ task_id: taskId }),
+            });
+            if (!pollRes.ok)
+                continue; // transient error, keep polling
+            const pollData = await pollRes.json();
+            if (pollData.retcode !== 0)
+                continue;
+            const status = pollData.data?.status ?? 0 /* QQBotBindStatus.NONE */;
+            if (status === 2 /* QQBotBindStatus.COMPLETED */) {
+                const botAppId = pollData.data?.bot_appid;
+                const encryptedSecret = pollData.data?.bot_encrypt_secret;
+                if (!botAppId || !encryptedSecret) {
+                    throw new Error('绑定成功但未返回完整凭据');
+                }
+                // Step 4: Decrypt the secret
+                const clientSecret = decryptSecret(encryptedSecret, keyBuffer);
+                return {
+                    appId: botAppId,
+                    clientSecret,
+                    userOpenId: pollData.data?.user_openid,
+                };
+            }
+            if (status === 3 /* QQBotBindStatus.EXPIRED */) {
+                throw new Error('二维码已过期');
+            }
+            // NONE or PENDING — keep polling
+        }
+        throw new Error('等待扫码结果超时');
+    }
+    finally {
+        cleanup();
+    }
+}
+export async function runQQBotBindFlowSimple() {
+    try {
+        const result = await runQQBotBindFlow();
+        if (result === QUIT || result === SKIP)
+            return null;
+        return result;
+    }
+    catch (error) {
+        console.error(`\n绑定失败: ${error instanceof Error ? error.message : error}`);
+        return null;
+    }
+}
+export async function cmdInitQQBot() {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    let aid = null;
+    let agentConfig = null;
+    let choice = null;
+    let contactBinding = null;
+    try {
+        aid = await pickAgentForChannel(rl);
+        if (!aid)
+            return;
+        agentConfig = loadAgent(aid);
+        if (!agentConfig) {
+            console.error(`❌ 无法加载 agent ${aid} 的配置`);
+            return;
+        }
+        const existing = (agentConfig.channels || []).filter(c => c.type === 'qqbot');
+        choice = await pickInstanceWithinAgent(rl, 'qqbot', existing);
+        if (choice === null)
+            return;
+        contactBinding = await pickOwnerAdminForChannelBinding(rl, agentConfig, 'qqbot');
+        if (!contactBinding)
+            return;
+    }
+    finally {
+        rl.close();
+    }
+    console.log('\n正在创建 QQ 机器人绑定任务...\n');
+    let result;
+    try {
+        const flowResult = await runQQBotBindFlow();
+        if (flowResult === QUIT) {
+            console.log('已退出');
+            return;
+        }
+        if (flowResult === SKIP) {
+            const rl2 = readline.createInterface({ input: process.stdin, output: process.stdout });
+            try {
+                console.log('\n手动输入模式：\n');
+                let appId = '';
+                while (!appId) {
+                    appId = (await ask(rl2, '  QQ 机器人 App ID: ')).trim();
+                    if (!appId)
+                        console.log('  ⚠ 不能为空');
+                }
+                let clientSecret = '';
+                while (!clientSecret) {
+                    clientSecret = (await ask(rl2, '  QQ 机器人 Client Secret: ')).trim();
+                    if (!clientSecret)
+                        console.log('  ⚠ 不能为空');
+                }
+                result = { appId, clientSecret };
+            }
+            finally {
+                rl2.close();
+            }
+        }
+        else {
+            result = flowResult;
+        }
+    }
+    catch (error) {
+        console.error(`\n绑定失败: ${error instanceof Error ? error.message : error}`);
+        process.exit(1);
+    }
+    const channel = {
+        type: 'qqbot',
+        name: choice.name,
+        enabled: true,
+        appId: result.appId,
+        clientSecret: result.clientSecret,
+    };
+    const commitResult = await commitChannel(aid, channel, choice.action);
+    if (!commitResult)
+        return;
+    console.log(`  App ID: ${result.appId}`);
+    bindQrActorToContact(aid, contactBinding, 'qqbot', result.userOpenId, commitResult.channelKey);
+    const { generateInitSuccessMessage } = await import('../utils/welcome.js');
+    console.log(generateInitSuccessMessage('qqbot', contactBinding !== null));
+}
+// ==================== WeCom (企业微信) ====================
+export async function cmdInitWecom() {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    let aid = null;
+    let agentConfig = null;
+    let choice = null;
+    let contactBinding = null;
+    let botId = '';
+    let secret = '';
+    try {
+        aid = await pickAgentForChannel(rl);
+        if (!aid)
+            return;
+        agentConfig = loadAgent(aid);
+        if (!agentConfig) {
+            console.error(`❌ 无法加载 agent ${aid} 的配置`);
+            return;
+        }
+        const existing = (agentConfig.channels || []).filter(c => c.type === 'wecom');
+        choice = await pickInstanceWithinAgent(rl, 'wecom', existing);
+        if (choice === null)
+            return;
+        contactBinding = await pickOwnerAdminForChannelBinding(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();
+                    });
+                });
+                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');
+            }
+            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('  ⚠ 不能为空');
+        }
+    }
+    finally {
+        rl.close();
+    }
+    const channel = {
+        type: 'wecom',
+        name: choice.name,
+        enabled: true,
+        botId,
+        secret,
+    };
+    const commitResult = await commitChannel(aid, channel, choice.action);
+    if (!commitResult)
+        return;
+    console.log(`  Bot ID: ${botId}`);
+    if (commitResult.reloaded) {
+        await registerWecomContactBind(aid, commitResult.channelKey, contactBinding);
+    }
+    else {
+        console.log('  ⚠ 服务未运行或热重载失败，无法注册企微绑定码；请启动服务后重新执行 ec init wecom。');
+    }
+    const { generateInitSuccessMessage } = await import('../utils/welcome.js');
+    console.log(generateInitSuccessMessage('wecom', contactBinding !== null));
+}
+// ==================== Shared helpers for per-agent init <channel> ====================
+/**
+ * Pick the target agent for an `ec init <channel>` flow.
+ *
+ * - 0 agents → print guidance and return null
+ * - ≥1 → letter menu; with 1 agent the prompt accepts Enter (defaults to 'a')
+ */
+async function pickAgentForChannel(rl) {
+    const { agents } = loadAllAgents();
+    if (agents.length === 0) {
+        console.log('❌ 暂无 agent，请先创建：');
+        console.log('     ec agent new <aid>.agentid.pub');
+        return null;
+    }
+    const letters = 'abcdefghijklmnopqrstuvwxyz';
+    console.log(`共 ${agents.length} 个 agent：`);
+    for (let i = 0; i < agents.length; i++) {
+        console.log(`  ${letters[i]}. ${agents[i].aid}`);
+    }
+    const valid = letters.slice(0, agents.length).split('');
+    const promptSuffix = agents.length === 1 ? ' [a]' : '';
+    let choice = '';
+    while (!valid.includes(choice)) {
+        choice = (await ask(rl, `请选择${promptSuffix}: `)).trim().toLowerCase();
+        if (agents.length === 1 && choice === '')
+            choice = 'a';
+        if (!valid.includes(choice)) {
+            console.log(`无效选择，请输入 ${valid.join('/')}`);
+        }
+    }
+    return agents[letters.indexOf(choice)].aid;
+}
+/**
+ * Pick "add new instance" or "overwrite existing instance" within a single agent
+ * for the given channel type. Returns null if user cancels.
+ *
+ * If existing.length === 0 → returns { action:'add', name:'main' } directly.
+ */
+async function pickInstanceWithinAgent(rl, channelType, existing) {
+    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);
+}
+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;
+    }
+    console.log(`\n请选择 ${channelType} 扫码账号要绑定到的 owner/admin AID：`);
+    candidates.forEach((candidate, index) => {
+        console.log(`  ${index + 1}. ${candidate.primaryId} (${candidate.label})`);
+    });
+    const defaultIndex = candidates.length === 1 ? 1 : null;
+    const prompt = defaultIndex ? `请选择 [${defaultIndex}]: ` : '请选择: ';
+    while (true) {
+        const raw = (await ask(rl, prompt)).trim();
+        const selected = raw === '' && defaultIndex ? defaultIndex : Number(raw);
+        if (Number.isInteger(selected) && selected >= 1 && selected <= candidates.length) {
+            return candidates[selected - 1];
+        }
+        console.log(`无效选择，请输入 1-${candidates.length}`);
+    }
+}
+function ownerAdminContactCandidates(agentConfig) {
+    const labels = new Map();
+    const add = (value, label) => {
+        const aid = String(value || '').trim();
+        if (!isValidAid(aid))
+            return;
+        let set = labels.get(aid);
+        if (!set) {
+            set = new Set();
+            labels.set(aid, set);
+        }
+        set.add(label);
+    };
+    for (const owner of agentConfig.owners ?? [])
+        add(owner, 'owner');
+    for (const admin of listStaticAgentAdmins(agentConfig.aid))
+        add(admin, 'admin');
+    return [...labels.entries()].map(([primaryId, roles]) => ({
+        primaryId,
+        label: [...roles].join('/'),
+    }));
+}
+function bindQrActorToContact(aid, binding, channelType, actorId, channelKey) {
+    if (!binding)
+        return;
+    const normalizedActor = firstNonEmpty(actorId);
+    if (!normalizedActor) {
+        console.log(`  ⚠ ${channelType} 扫码流程未返回可绑定的用户 ID，未写入 contact.json`);
+        return;
+    }
+    try {
+        const changed = bindContactAlias(aid, binding.primaryId, channelType, normalizedActor, channelKey);
+        const action = changed ? '已写入' : '已存在';
+        console.log(`  ✓ 身份映射${action}: ${channelKey}:${encodeURIComponent(normalizedActor)} -> ${binding.primaryId}`);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.log(`  ⚠ 身份映射写入失败: ${message}`);
+    }
+}
+async function registerDingtalkContactBind(aid, channelName, binding) {
+    await registerChannelContactBind('dingtalk', '钉钉', aid, channelName, binding);
+}
+async function registerWecomContactBind(aid, channelName, binding) {
+    await registerChannelContactBind('wecom', '企微', aid, channelName, binding);
+}
+async function registerChannelContactBind(channelType, displayName, aid, channelName, binding) {
+    if (!binding)
+        return;
+    const result = await ipcQuery(resolvePaths().socket, {
+        type: `${channelType}.contact-bind.register`,
+        selfAid: aid,
+        channelName,
+        primaryId: binding.primaryId,
+    }, 3000);
+    if (!result?.ok) {
+        console.log(`  ⚠ ${displayName}绑定码注册失败: ${result?.error || 'daemon 不可用'}`);
+        console.log(`    请重新执行 ec init ${channelType} 并再次绑定。`);
+        return;
+    }
+    const expiresAt = new Date(Number(result.expiresAt)).toLocaleString();
+    console.log(`  ✓ ${displayName}身份绑定码: ${result.code}`);
+    console.log(`    请在 10 分钟内私聊${displayName}机器人，直接发送这 6 位数字绑定码。有效期至: ${expiresAt}`);
+}
+function firstNonEmpty(...values) {
+    for (const value of values) {
+        const text = String(value ?? '').trim();
+        if (text)
+            return text;
+    }
+    return undefined;
+}
+/**
+ * Persist the new/overwritten channel and trigger hot-reload.
+ */
+async function commitChannel(aid, channel, mode) {
+    const result = await agentChannelUpsert({ aid, channel, mode });
+    if (result.ok !== true) {
+        console.error(`❌ ${result.error || 'channel upsert failed'}`);
+        return null;
+    }
+    console.log(`\n✓ 已写入 agents/${aid}/config.json`);
+    console.log(result.reloaded
+        ? '  ✓ 已热重载'
+        : '  ⚠ 服务未运行（或热重载失败），下次 ec start 时生效');
+    return result;
+}
+export function getChannelCredentialCollector(type) {
+    switch (type) {
+        case 'feishu':
+            return async () => {
+                const result = await runFeishuQrFlow();
+                if (!result)
+                    return null;
+                return { appId: result.appId, appSecret: result.appSecret, enabled: true };
+            };
+        case 'wechat':
+            return async () => {
+                const result = await runWechatQrFlow();
+                if (!result)
+                    return null;
+                return { baseUrl: result.baseUrl, token: result.token, enabled: true };
+            };
+        case 'dingtalk':
+            return async () => {
+                const result = await runDingtalkQrFlowSimple();
+                if (!result)
+                    return null;
+                return { clientId: result.clientId, clientSecret: result.clientSecret, enabled: true };
+            };
+        case 'qqbot':
+            return async () => {
+                const result = await runQQBotBindFlowSimple();
+                if (!result)
+                    return null;
+                return { appId: result.appId, clientSecret: result.clientSecret, enabled: true };
+            };
+        case 'wecom':
+            return async () => {
+                const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+                const ask = (q) => new Promise(r => rl.question(q, r));
+                try {
+                    console.log('企业微信 AI Bot 配置\n');
+                    console.log('请在企业微信管理后台 → AI Bot 页面获取 Bot ID 和 Secret\n');
+                    const botId = (await ask('  Bot ID: ')).trim();
+                    if (!botId)
+                        return null;
+                    const secret = (await ask('  Secret: ')).trim();
+                    if (!secret)
+                        return null;
+                    return { botId, secret, enabled: true };
+                }
+                finally {
+                    rl.close();
+                }
+            };
+        default:
+            return null;
+    }
+}