evolcore 0.0.2 → 0.0.3

package/dist/cli/index.js

@@ -3,18 +3,82 @@
 process.env.AUN_LOG_INI_DISABLE = '1';
 import fs from 'fs';
 import path from 'path';
-import { resolvePaths, getPackageRoot } from '../paths.js';
+import { getPackageRoot } from '../paths.js';
 import { cmdInit } from './init.js';
 import { cmdInitWechat, cmdInitFeishu, cmdInitDingtalk, cmdInitQQBot, cmdInitWecom, cmdInitAun } from './init-channel.js';
-import { isHelpFlag, getArgValue } from './help.js';
+import { isHelpFlag, wantsHelp, getArgValue } from './help.js';
 import * as platform from '../utils/cross-platform.js';
 import { cmdRestartMonitor } from './restart-monitor.js';
 import { cmdAid, cmdRpc, cmdStorage, cmdMsg, cmdGroup } from './aun-commands.js';
 import { cmdAgent } from './agent-command.js';
 import { cmdCtl } from './ctl-command.js';
 import { cmdQueue } from './queue-command.js';
-import { cmdStart, cmdStop, cmdRestart, cmdStatus, cmdLogs, cmdWatchCommand, cmdDev, cmdMv, cmdDiagnose } from './daemon-commands.js';
+import { cmdStart, cmdStop, cmdRestart, cmdStatus, cmdLogs, cmdWatchCommand, cmdMv, cmdDiagnose } from './daemon-commands.js';
 import { logCliCommand } from './command-log.js';
+const MAIN_HELP = `用法: ec <command> [选项]
+
+服务:
+  init              初始化默认配置、owner、控制 AID 与 EC Web
+  start             启动服务
+  stop              停止服务
+  restart           重启服务并检查更新
+  status            查看运行状态
+  logs              持续查看 daemon 日志
+  watch             打开日志、AID、消息或 EC Web 监控
+
+Agent 与会话:
+  agent             管理 EvolAgent
+  ctl               当前托管会话的控制命令
+  queue             查询或操作 agent 消息队列
+  trigger           管理定时与事件触发器
+  handoff           查询和完成跨会话回流
+  model             查看或设置模型与推理强度
+  response          查看或设置响应模式
+
+AUN:
+  aid               管理 AID 身份与 agent.md
+  msg               私聊消息收发、撤回、在线状态与历史
+  group             群消息与群管理
+  fs                AUN 文件系统
+  storage           底层对象存储命令
+  rpc               调用底层 AUN RPC
+  contact           联系人黑名单管理
+  net               AUN 网络链路诊断
+
+配置与诊断:
+  config            读取、修改和检查分层配置
+  stats             Token 用量与费用统计
+  diagnose          检查启动环境
+  version           显示组件版本
+  mv                迁移项目目录和会话路径
+
+维护命令:
+  mode              切换开发源码与 npm 包运行模式
+  restart-monitor   运行 daemon 重启监控器
+  bench             AUN 消息性能基准测试
+  link-rules        连接 ECK rules 到项目目录
+
+运行 ec <command> --help 查看该命令的完整参数。
+
+环境变量:
+  EVOLCORE_HOME     数据目录（默认: ~/.evolcore）
+  LOG_LEVEL         日志级别（默认: INFO）
+  MESSAGE_LOG       消息日志（默认: true）
+  EVENT_LOG         事件日志（默认: true）`;
+function printLifecycleHelp(command) {
+    const help = {
+        start: `用法: ec start [--foreground] [--diagnose|-d]\n\n  --foreground   前台运行，适合 systemd 或容器直接管理\n  --diagnose, -d 以诊断模式启动 daemon`,
+        stop: '用法: ec stop\n\n停止当前 EVOLCORE_HOME 下运行的 EvolCore 服务。',
+        restart: `用法: ec restart [--clear] [--diagnose|-d]\n\n  --clear        同时清理跨 HOME 残留的 EvolCore 主进程\n  --diagnose, -d 以诊断模式启动新 daemon`,
+        status: '用法: ec status\n\n查看 daemon、agent、渠道与会话运行状态。',
+        logs: `用法: ec logs [选项]\n\n  --level <error|warn|info|debug>  最低日志级别\n  --module <name>                  只显示指定模块\n  --raw                            原始输出\n  --no-color                       禁用颜色`,
+        watch: `用法: ec watch [logs|log|aid|msg|web|session]\n\n  ec watch                 打开监控选择菜单\n  ec watch logs            选择日志类型后监控\n  ec watch log <类型...>   直接监控指定日志类型\n  ec watch aid             监控 AID 连接\n  ec watch msg             打开消息 TUI\n  ec watch web             安装/升级并启动 EC Web\n  ec watch session         ec watch web 的兼容别名`,
+        'restart-monitor': '用法: ec restart-monitor\n\n运行内 daemon 重启与升级监控器。',
+        diagnose: '用法: ec diagnose\n\n检查配置、数据库、进程和编译产物。',
+        mv: '用法: ec mv <old-directory> <new-directory>\n\n迁移项目目录以及 Claude、Codex 和 EvolCore 会话路径。',
+    };
+    console.log(help[command]);
+}
 // Suppress Node.js ExperimentalWarning (e.g. SQLite) from cluttering CLI output
 process.removeAllListeners('warning');
 process.on('warning', (w) => { if (w.name === 'ExperimentalWarning')
@@ -27,9 +91,13 @@ export async function main(args) {
         console.log(pkg.version);
         return;
     }
+    if (isHelpFlag(cmd)) {
+        console.log(MAIN_HELP);
+        return;
+    }
     switch (cmd) {
         case 'init':
-            if (isHelpFlag(args[1])) {
+            if (wantsHelp(args.slice(1))) {
                 console.log(`用法: ec init [渠道] [选项]
 
 仅初始化 defaults.json:
@@ -43,7 +111,7 @@ export async function main(args) {
     --owner <aid>                        必填。唯一 daemon owner AID
     --baseagent <claude|codex|gemini>    可选。默认从 PATH 检测
     --projectpath <abs-path>             可选。默认项目目录（必须绝对路径，自动创建）
-    --ecweb                              可选。启用 ECWeb 自启动
+    --ecweb                              可选。安装 EC Web 并启用自启动
     --format json                        可选但推荐。stdout 输出 init.result JSON
     --force                              已有不同 owner 时强制覆盖
 
@@ -53,7 +121,7 @@ export async function main(args) {
   ec init wechat        微信扫码登录
   ec init dingtalk      钉钉扫码登录
   ec init qqbot         QQ 机器人扫码绑定
-  ec init wecom         企业微信 AI Bot 配置（手动输入）`);
+  ec init wecom         企业微信 AI Bot 扫码创建/手工配置`);
             }
             else if (args[1] === 'aun') {
                 const { suppressSdkLogs } = await import('../aun/aid/index.js');
@@ -105,36 +173,84 @@ export async function main(args) {
             }
             break;
         case 'start':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('start');
+                break;
+            }
             await cmdStart({
                 diagnose: args.includes('--diagnose') || args.includes('-d'),
                 foreground: args.includes('--foreground'),
             });
             break;
         case 'stop':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('stop');
+                break;
+            }
             await cmdStop();
             break;
         case 'restart':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('restart');
+                break;
+            }
             await cmdRestart({ clear: args.includes('--clear'), diagnose: args.includes('--diagnose') || args.includes('-d') });
             break;
         case 'status':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('status');
+                break;
+            }
             await cmdStatus();
             break;
         case 'logs':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('logs');
+                break;
+            }
             cmdLogs(args.slice(1));
             break;
         case 'watch':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('watch');
+                break;
+            }
             await cmdWatchCommand(args.slice(1));
             break;
         case 'restart-monitor':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('restart-monitor');
+                break;
+            }
             await cmdRestartMonitor();
             break;
-        case 'dev':
-            await cmdDev(args.slice(1));
+        case 'mode':
+            try {
+                // 开发源码仓可提供 mode.js；正式 npm 包可以不携带该内部命令。
+                const { cmdMode } = await import('./mode.js');
+                await cmdMode(args.slice(1));
+            }
+            catch (error) {
+                if (error?.code === 'ERR_MODULE_NOT_FOUND' && /(?:^|[\\/])mode\.js(?:$|')/.test(String(error?.message ?? ''))) {
+                    console.error('❌ 无效指令: mode');
+                    process.exitCode = 1;
+                    break;
+                }
+                throw error;
+            }
             break;
         case 'mv':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('mv');
+                break;
+            }
             await cmdMv(args[1], args[2]);
             break;
         case 'diagnose':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('diagnose');
+                break;
+            }
             await cmdDiagnose();
             break;
         case 'net': {
@@ -217,6 +333,11 @@ export async function main(args) {
             await cmdConfig(args.slice(1));
             break;
         }
+        case 'contact': {
+            const { cmdContact } = await import('./contact.js');
+            await cmdContact(args.slice(1));
+            break;
+        }
         case 'stats': {
             const { handleStats } = await import('./stats.js');
             await handleStats(args.slice(1));
@@ -242,114 +363,9 @@ export async function main(args) {
             break;
         }
         default:
-            console.log(`Usage: ec {init|start|stop|restart|status|logs|watch|ctl|queue|trigger|handoff|diagnose|net|mv}
-
-Commands:
-  init          初始化 evolcore home (${resolvePaths().defaultsConfig})
-  init feishu   飞书扫码登录并写入配置
-  init wechat   微信扫码登录并写入配置
-  init dingtalk 钉钉扫码登录并写入配置
-  init qqbot    QQ 机器人扫码绑定并写入配置
-  init wecom    企业微信 AI Bot 配置（手动输入 Bot ID + Secret）
-  start         启动服务 (默认)
-                  --foreground  前台运行，适合 systemd/Docker 直接管理进程
-  stop          停止服务
-  restart       重启服务
-                  --clear  顺带 SIGKILL 跨 HOME 残留的 evolcore 主进程
-  status        查看状态
-  logs          查看日志 (tail -f, 着色渲染)
-                  --level error|warn   只显示指定级别及以上
-                  --module <name>      只显示指定模块（如 feishu、AgentRunner）
-                  --raw                原始输出，不着色
-  watch         监控面板选择菜单（↑↓ 选择 log/aid/msg）
-  watch logs    勾选日志类型后实时监控（记忆上次选择，存入 daemon.json）
-  watch log <类型...>  直接监控指定类型（如 evolcore aun），不读写偏好
-  watch aid     AID 连接状态实时监控（显示各 AID 在线/离线/重连状态）
-  watch msg     消息监控（三面板交互式 TUI：AID 列表 / 对端统计 / 消息流）
-  ctl           当前会话工具（发送消息/文件、名称、队列、路径、状态）
-                  ec ctl help 查看完整命令列表
-  trigger       daemon 级触发器管理（list/show/history/create/update/run）
-  handoff       跨会话任务回流
-                  handoff return [id] [content]  确认当前 handoff；required 策略需提供内容
-                  handoff list/trace             查询实例和审计事件
-  queue          消息队列查询与操作
-                  queue --agent <aid>          查看 agent 的所有队列
-                  queue --agent <aid> --clear  清空待处理消息
-                  queue --agent <aid> --interrupt --sessionkey <key>  打断处理中任务
-  agent         管理 EvolAgent
-                  agent              列出所有 agent
-                  agent <name>       查看指定 agent 详情
-                  agent new <name>   创建新 agent（交互式）
-                  agent new <name> --non-interactive ...  非交互创建（自动化）
-                    必填: --project <absolute path>
-                    可选: --baseagent <claude|codex|gemini>  (默认: PATH 中第一个可用)
-                          --owner <aid>
-                          --name <display-name>
-                          --description <text>
-                          --force                            (覆盖已有 config.json)
-                  agent reload       全量 resync（扫磁盘，新增上线、删除下线、修改热更新）
-                  agent reload <n>   热重载指定 agent 配置
-  model         模型管理（agent/关系可写，支持角色策略预览）
-                  model list         列出可用模型并显示当前生效模型
-                  model current      显示实际生效的模型、强度和来源
-                  model info <id>    查看模型详情
-                  model use <id>     设置模型（写操作需要 --self）
-                  model effort <lv>  设置推理强度
-                  model reset        清除当前作用域的模型和强度设置
-                  model check        诊断网关与模型可用性
-  response      响应模式管理（查看/切换/配置，作用域：全局/agent/关系）
-                  response list      列出所有响应模式
-                  response current   显示当前作用域生效的默认模式
-                  response info <id> 查看单个模式详情（场景/配置参数）
-                  response set <id>  设置默认模式（--scene private/group）
-                  response config    查看/修改模式配置参数
-                  response reset     清除指定作用域设置
-                  response help      查看完整用法
-  aid           AID 身份管理
-                  aid list           列出本地所有 AID
-                  aid show <aid>     查看本地 AID 详情（证书有效期、私钥状态）
-                  aid new <aid>      创建新 AID 身份
-                  aid lookup <aid>   远程探测 AID（是否存在 + 网关 + agent.md）
-                  aid agentmd put <aid>  签名并上传 agent.md
-                  aid agentmd get <aid>  下载并验签 agent.md
-                  aid delete <aid>             删除指定 AID
-                  aid delete --orphan          清理无私钥的外部 AID 缓存
-                  aid delete --unrecoverable   清理云端公钥已变更、不可恢复的 AID
-                                                 默认 dry-run，加 --yes 执行
-  fs            AUN 文件系统统一入口
-                  fs ls|stat|cat|find <AID>:/path
-                  fs cp <src> <dst>      上传/下载/远程复制
-                  fs mv <src> <dst>      移动/改名（同后端）
-                  fs rm [-r] <AID>:/path
-                  fs mkdir [-p] <AID>:/path
-                  fs ln -s <target> <AID>:/path
-                  fs chmod +r|o-r <AID>:/path
-                  fs setfacl|getfacl <AID>:/path
-                  fs token issue|revoke|ls <AID>:/path
-                  fs df <AID>:
-                  fs mount <target> --volume <id>|--source <src>
-  net           网络链路诊断
-                  net check [<aid>]  10 步链路检测（DNS→Discovery→TCP→TLS→WSS→Auth→Ping→Echo）
-                  net help           查看详细帮助
-  rpc           AUN RPC 调用
-                  rpc --as <aid> --params <json|jsonl|file>
-  storage       文件存储
-                  storage upload <aid> <file> <path> [--public]
-                  storage download <aid> <url> [local-path]
-                  storage ls <aid> [prefix]
-                  storage rm <aid> <path>
-                  storage quota <aid>
-  diagnose      诊断启动环境（配置、数据库、进程）
-  mv <old> <new>  迁移项目目录（保留 Claude/Codex/EvolCore 会话）
-  bench         AUN 消息性能基准测试
-                  bench --aids 5 --rounds 10 --concurrency 5
-
-Environment:
-  EVOLCORE_HOME   数据目录 (默认: ~/.evolcore)
-  LOG_LEVEL       日志级别 (默认: INFO)
-  MESSAGE_LOG     消息日志 (默认: true)
-  EVENT_LOG       事件日志 (默认: true)`);
-            process.exit(1);
+            console.error(`未知命令: ${cmd}`);
+            console.log(MAIN_HELP);
+            process.exitCode = 1;
     }
 }
 // 直接运行时自动执行（node dist/cli/index.js ...）

package/dist/cli/init-channel.js

@@ -17,6 +17,8 @@ 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));
 }
@@ -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);
@@ -473,7 +447,7 @@ export async function cmdInitFeishu() {
     bindQrActorToContact(aid, contactBinding, 'feishu', result.openId, commitResult.channelKey);
     // 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';
@@ -610,7 +584,7 @@ export async function cmdInitWechat() {
     bindQrActorToContact(aid, contactBinding, 'wechat', result.userId, commitResult.channelKey);
     // 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 +726,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();
@@ -904,7 +864,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 +928,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
@@ -1122,7 +1068,7 @@ export async function cmdInitQQBot() {
     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', false));
+    console.log(generateInitSuccessMessage('qqbot', contactBinding !== null));
 }
 // ==================== WeCom (企业微信) ====================
 export async function cmdInitWecom() {
@@ -1130,6 +1076,7 @@ export async function cmdInitWecom() {
     let aid = null;
     let agentConfig = null;
     let choice = null;
+    let contactBinding = null;
     let botId = '';
     let secret = '';
     try {
@@ -1145,8 +1092,43 @@ export async function cmdInitWecom() {
         choice = await pickInstanceWithinAgent(rl, 'wecom', existing);
         if (choice === null)
             return;
+        contactBinding = await pickOwnerAdminForChannelBinding(rl, agentConfig, 'wecom');
+        if (!contactBinding)
+            return;
         console.log('\n企业微信 AI Bot 配置');
-        console.log('请在企业微信管理后台 → AI Bot 页面获取 Bot ID 和 Secret\n');
+        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)
@@ -1168,10 +1150,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> ====================
 /**
@@ -1221,8 +1211,8 @@ async function pickInstanceWithinAgent(rl, channelType, existing) {
 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 后重试。');
+        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：`);
@@ -1255,7 +1245,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 +1263,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 +1271,28 @@ function bindQrActorToContact(aid, binding, channelType, actorId, channelKey) {
     }
 }
 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: '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}机器人，直接发送这 6 位数字绑定码。有效期至: ${expiresAt}`);
 }
 function firstNonEmpty(...values) {
     for (const value of values) {