evolcore 0.0.2 → 0.0.4

package/dist/cli/init-channel.js

@@ -16,7 +16,9 @@ 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) {
     return new Promise(resolve => rl.question(question, resolve));
 }
@@ -198,26 +200,12 @@ async function pollBindStatusWithKeyboard(taskId, expiresAt) {
     let quit = false;
     let skip = false;
     const p = resolvePaths();
-    const setupKeyListener = () => {
-        if (!process.stdin.isTTY)
-            return () => { };
-        process.stdin.setRawMode(true);
-        process.stdin.resume();
-        process.stdin.setEncoding('utf8');
-        const handler = (key) => {
-            if (key === 'q' || key === '\u0003')
-                quit = true;
-            if (key === 's' || key === 'S')
-                skip = true;
-        };
-        process.stdin.on('data', handler);
-        return () => {
-            process.stdin.removeListener('data', handler);
-            process.stdin.setRawMode(false);
-            // Don't pause stdin - let the next readline/prompt handle it naturally
-        };
-    };
-    const cleanup = setupKeyListener();
+    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)
@@ -305,26 +293,12 @@ async function runQrRegistrationFlow() {
     console.log('请用飞书/Lark 扫描上方二维码...\n');
     console.log('按 q 退出 | 按 s 跳过扫码手动输入 appId/appSecret\n');
     let userAction = null;
-    const setupKeyListener = () => {
-        if (!process.stdin.isTTY)
-            return () => { };
-        process.stdin.setRawMode(true);
-        process.stdin.resume();
-        process.stdin.setEncoding('utf8');
-        const handler = (key) => {
-            if (key === 'q' || key === '\u0003')
-                userAction = QUIT;
-            if (key === 's')
-                userAction = SKIP;
-        };
-        process.stdin.on('data', handler);
-        return () => {
-            process.stdin.removeListener('data', handler);
-            process.stdin.setRawMode(false);
-            // Don't pause stdin - let the next readline/prompt handle it naturally
-        };
-    };
-    const cleanup = setupKeyListener();
+    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);
@@ -410,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)
@@ -420,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 {
@@ -470,10 +454,18 @@ 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', false));
+    console.log(generateInitSuccessMessage('feishu', contactBinding !== null));
 }
 // ==================== WeChat ====================
 const DEFAULT_BASE_URL = 'https://ilinkai.weixin.qq.com';
@@ -571,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)
@@ -581,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) {
@@ -607,10 +609,18 @@ 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', false));
+    console.log(generateInitSuccessMessage('wechat', contactBinding !== null));
 }
 // ==================== AUN ====================
 export async function cmdInitAun() {
@@ -752,26 +762,12 @@ async function runDingtalkQrFlow() {
     console.log('提示: 扫码页面标注 "OpenClaw" 是钉钉生态接入桥，可放心使用。\n');
     console.log('按 q 退出 | 按 s 跳过扫码手动输入\n');
     let userAction = null;
-    const setupKeyListener = () => {
-        if (!process.stdin.isTTY)
-            return () => { };
-        process.stdin.setRawMode(true);
-        process.stdin.resume();
-        process.stdin.setEncoding('utf8');
-        const handler = (key) => {
-            if (key === 'q' || key === '\u0003')
-                userAction = QUIT;
-            if (key === 's')
-                userAction = SKIP;
-        };
-        process.stdin.on('data', handler);
-        return () => {
-            process.stdin.removeListener('data', handler);
-            process.stdin.setRawMode(false);
-            // Don't pause stdin - let the next readline/prompt handle it naturally
-        };
-    };
-    const cleanup = setupKeyListener();
+    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();
@@ -828,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)
@@ -838,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 {
@@ -904,7 +910,7 @@ export async function cmdInitDingtalk() {
         console.log('  ⚠ 服务未运行或热重载失败，无法注册钉钉绑定码；请启动服务后重新执行 ec init dingtalk 并再次扫码绑定。');
     }
     const { generateInitSuccessMessage } = await import('../utils/welcome.js');
-    console.log(generateInitSuccessMessage('dingtalk', false));
+    console.log(generateInitSuccessMessage('dingtalk', contactBinding !== null));
 }
 // ==================== QQBot ====================
 const QQBOT_PORTAL_HOST = 'q.qq.com';
@@ -968,26 +974,12 @@ async function runQQBotBindFlow() {
     console.log('请用 QQ 扫描上方二维码绑定机器人...\n');
     console.log('按 q 退出 | 按 s 跳过扫码手动输入\n');
     let userAction = null;
-    const setupKeyListener = () => {
-        if (!process.stdin.isTTY)
-            return () => { };
-        process.stdin.setRawMode(true);
-        process.stdin.resume();
-        process.stdin.setEncoding('utf8');
-        const handler = (key) => {
-            if (key === 'q' || key === '\u0003')
-                userAction = QUIT;
-            if (key === 's')
-                userAction = SKIP;
-        };
-        process.stdin.on('data', handler);
-        return () => {
-            process.stdin.removeListener('data', handler);
-            process.stdin.setRawMode(false);
-            // Don't pause stdin - let the next readline/prompt handle it naturally
-        };
-    };
-    const cleanup = setupKeyListener();
+    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
@@ -1051,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)
@@ -1061,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 {
@@ -1120,9 +1122,17 @@ 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', false));
+    console.log(generateInitSuccessMessage('qqbot', contactBinding !== null));
 }
 // ==================== WeCom (企业微信) ====================
 export async function cmdInitWecom() {
@@ -1130,6 +1140,8 @@ export async function cmdInitWecom() {
     let aid = null;
     let agentConfig = null;
     let choice = null;
+    let contactBinding = null;
+    let operation = 'configure';
     let botId = '';
     let secret = '';
     try {
@@ -1142,25 +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;
-        console.log('\n企业微信 AI Bot 配置');
-        console.log('请在企业微信管理后台 → AI Bot 页面获取 Bot ID 和 Secret\n');
-        while (!botId) {
-            botId = (await ask(rl, '  Bot ID: ')).trim();
-            if (!botId)
-                console.log('  ⚠ 不能为空');
+        if (choice.action === 'overwrite') {
+            operation = await pickExistingChannelOperation(rl, '企微', choice.name);
+            if (operation === 'configure' && !await confirmOverwriteChannel(rl, '企微', choice.name))
+                return;
         }
-        while (!secret) {
-            secret = (await ask(rl, '  Secret: ')).trim();
-            if (!secret)
-                console.log('  ⚠ 不能为空');
+        contactBinding = await pickContactForChannelBinding(rl, agentConfig, 'wecom');
+        if (!contactBinding)
+            return;
+        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}`);
+                        },
+                    });
+                    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();
     }
+    if (operation === 'rebind-contact') {
+        await registerWecomContactBind(aid, contactBindChannelKey('wecom', aid, choice.name), contactBinding);
+        return;
+    }
     const channel = {
         type: 'wecom',
         name: choice.name,
@@ -1168,10 +1226,18 @@ export async function cmdInitWecom() {
         botId,
         secret,
     };
-    await commitChannel(aid, channel, choice.action);
+    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', false));
+    console.log(generateInitSuccessMessage('wecom', contactBinding !== null));
 }
 // ==================== Shared helpers for per-agent init <channel> ====================
 /**
@@ -1211,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} 尚未配置 owners/admins，无法为 ${channelType} 扫码账号建立身份映射。`);
-        console.log('   请先通过 AUN 绑定 agent owner，或在 agent config.json 中配置 owners/admins 后重试。');
-        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) {
@@ -1237,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) {
@@ -1255,7 +1351,7 @@ function ownerAdminContactCandidates(agentConfig) {
     };
     for (const owner of agentConfig.owners ?? [])
         add(owner, 'owner');
-    for (const admin of agentConfig.admins ?? [])
+    for (const admin of listStaticAgentAdmins(agentConfig.aid))
         add(admin, 'admin');
     return [...labels.entries()].map(([primaryId, roles]) => ({
         primaryId,
@@ -1273,7 +1369,7 @@ function bindQrActorToContact(aid, binding, channelType, actorId, channelKey) {
     try {
         const changed = bindContactAlias(aid, binding.primaryId, channelType, normalizedActor, channelKey);
         const action = changed ? '已写入' : '已存在';
-        console.log(`  ✓ 身份映射${action}: ${channelType}:${normalizedActor} -> ${binding.primaryId}`);
+        console.log(`  ✓ 身份映射${action}: ${channelKey}:${encodeURIComponent(normalizedActor)} -> ${binding.primaryId}`);
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
@@ -1281,23 +1377,40 @@ 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);
+}
+async function registerChannelContactBind(channelType, displayName, aid, channelName, binding) {
     if (!binding)
         return;
     const result = await ipcQuery(resolvePaths().socket, {
-        type: 'dingtalk.contact-bind.register',
+        type: `${channelType}.contact-bind.register`,
         selfAid: aid,
         channelName,
         primaryId: binding.primaryId,
     }, 3000);
     if (!result?.ok) {
-        console.log(`  ⚠ 钉钉绑定码注册失败: ${result?.error || 'daemon 不可用'}`);
-        console.log('    请重新执行 ec init dingtalk 并再次扫码绑定。');
+        console.log(`  ⚠ ${displayName}绑定码注册失败: ${result?.error || 'daemon 不可用'}`);
+        console.log(`    请重新执行 ec init ${channelType} 并再次绑定。`);
         return;
     }
     const expiresAt = new Date(Number(result.expiresAt)).toLocaleString();
-    console.log(`  ✓ 钉钉身份绑定码: ${result.code}`);
-    console.log(`    请在 10 分钟内私聊钉钉机器人，直接发送这 6 位数字绑定码。有效期至: ${expiresAt}`);
-    console.log('    非纯数字或位数不对只会提醒格式，不计入错误次数；6 位数字输错最多 5 次。');
+    console.log(`  ✓ ${displayName}身份绑定码: ${result.code}`);
+    console.log(`    请在 10 分钟内私聊${displayName}机器人，发送：/bind ${result.code}。有效期至: ${expiresAt}`);
 }
 function firstNonEmpty(...values) {
     for (const value of values) {