evolclaw 3.1.4 → 3.1.6

package/dist/cli/index.js

@@ -11,7 +11,7 @@ import { migrateProject } from '../config-store.js';
 import { cmdInit } from './init.js';
 import { ipcQuery } from '../ipc.js';
 import { cmdInitWechat, cmdInitFeishu, cmdInitDingtalk, cmdInitQQBot, cmdInitWecom } from './init-channel.js';
-import { isHelpFlag, wantsHelp } from './help.js';
+import { isHelpFlag, wantsHelp, getArgValue } from './help.js';
 import * as platform from '../utils/cross-platform.js';
 import { EventBus } from '../core/event-bus.js';
 import { tryUpgrade, tryUpgradeAunSdk } from '../utils/npm-ops.js';
@@ -292,6 +292,13 @@ async function cmdStart() {
     // 旧配置自动迁移（evolclaw.json → 新结构）
     const { autoMigrateIfNeeded } = await import('../config-store.js');
     autoMigrateIfNeeded();
+    // 未初始化时自动引导
+    const defaults = loadDefaults();
+    if (!defaults || !defaults.baseagents || Object.keys(defaults.baseagents).length === 0) {
+        console.log('⚡ 未检测到初始化配置，自动启动初始化向导...\n');
+        await cmdInit();
+        return;
+    }
     // 检查至少有一个 self-agent
     const { agents, skipped } = loadAllAgents();
     if (agents.length === 0) {
@@ -313,7 +320,7 @@ async function cmdStart() {
     const aliveMains = status.mains.filter(m => m.alive);
     if (aliveMains.length > 0) {
         const first = aliveMains[0];
-        console.log(`❌ EvolClaw is already running (PID: ${aliveMains.map(m => m.record.pid).join(', ')})`);
+        console.log(`  EvolClaw is already running (PID: ${aliveMains.map(m => m.record.pid).join(', ')})`);
         console.log(`  启动于: ${new Date(first.record.startedAtIso).toLocaleString()}`);
         console.log(`  启动方式: ${first.record.launchedBy}`);
         // 报告 AID 状态
@@ -371,14 +378,7 @@ async function cmdStart() {
     const checkReady = () => {
         // ready signal 出现（优先检查，避免 Windows 上误判进程状态）
         if (fs.existsSync(p.readySignal)) {
-            const pkg = JSON.parse(fs.readFileSync(path.join(getPackageRoot(), 'package.json'), 'utf-8'));
-            let aunVer = 'unknown';
-            try {
-                const aunPkg = JSON.parse(fs.readFileSync(path.join(getPackageRoot(), 'node_modules', '@agentunion', 'fastaun', 'package.json'), 'utf-8'));
-                aunVer = aunPkg.version;
-            }
-            catch { /* ignore */ }
-            console.log(`✓ EvolClaw v${pkg.version} started successfully (PID: ${childPid})  fastaun v${aunVer}`);
+            console.log(`✓ EvolClaw started successfully (PID: ${childPid})`);
             console.log(`  EVOLCLAW_HOME: ${resolveRoot()}`);
             console.log(`  Logs: ${p.logs}/`);
             // 从主日志提取渠道连接摘要
@@ -495,7 +495,6 @@ async function cmdStop() {
 }
 async function cmdRestart(opts = {}) {
     const cmdStartedAt = Date.now();
-    printStartupInfo();
     console.log('🔄 Restarting EvolClaw...');
     // 版本检查与自动升级
     console.log('📦 Checking for updates...');
@@ -884,8 +883,8 @@ async function cmdStatus() {
                     const configChannelNames = new Set();
                     for (const cfg of agents) {
                         for (const inst of cfg.channels) {
-                            // effective key: <type>#<urlEncode(selfPeerId)>#<name>
-                            configChannelNames.add(`${inst.type}#${encodeURIComponent(cfg.aid)}#${inst.name}`);
+                            // effective key: <type>#<selfAID>#<name>
+                            configChannelNames.add(`${inst.type}#${cfg.aid}#${inst.name}`);
                         }
                     }
                     for (const s of allSessions) {
@@ -1014,7 +1013,7 @@ async function cmdStatus() {
     }
 }
 /**
- * 把 channel fingerprint 列表（`<type>#<selfPeerId>#<name>`）折叠成展示用摘要。
+ * 把 channel fingerprint 列表（`<type>#<selfAID>#<name>`）折叠成展示用摘要。
  *
  * 聚合规则：
  *   - 按 type 分组
@@ -1414,6 +1413,7 @@ async function cmdWatchMenu() {
         { key: 'log', label: 'log', desc: 'real-time log tail' },
         { key: 'aid', label: 'aid', desc: 'AID connection stats' },
         { key: 'msg', label: 'msg', desc: 'message inspector' },
+        { key: 'web', label: 'web', desc: 'browser dashboard (aid/msg/session)' },
     ];
     let index = 0;
     const useColor = !!process.stdout.isTTY;
@@ -1477,6 +1477,9 @@ async function cmdWatchMenu() {
                     const { cmdWatchMsg } = await import('./watch-msg.js');
                     await cmdWatchMsg();
                 }
+                else if (chosen === 'web') {
+                    await cmdWatchWeb();
+                }
                 resolve();
             }
         };
@@ -2098,6 +2101,24 @@ async function cmdWatchAid() {
     }
     platform.onShutdown(cleanup);
 }
+async function cmdWatchWeb() {
+    // ecweb 是独立插件包（可执行命令），按需安装。
+    // 复用 npm-ops.npmInstallGlobal（含 EACCES→sudo 回退、Windows npm.cmd、超时）。
+    const { execFileSync } = await import('child_process');
+    const home = resolvePaths().root;
+    if (!platform.commandExists('ecweb')) {
+        process.stdout.write('📦 ecweb 未安装，正在从 npm 安装...\n');
+        const { npmInstallGlobal } = await import('../utils/npm-ops.js');
+        try {
+            await npmInstallGlobal('ecweb');
+        }
+        catch (e) {
+            process.stderr.write(`❌ 安装 ecweb 失败: ${e?.stderr || e?.message || e}\n   可手动安装: npm install -g ecweb\n`);
+            process.exit(1);
+        }
+    }
+    execFileSync('ecweb', ['--home', home], { stdio: 'inherit' });
+}
 async function cmdRestartMonitor() {
     const p = resolvePaths();
     const restartLog = path.join(p.logs, 'restart.log');
@@ -2472,14 +2493,13 @@ function archiveSelfHealLog(p, log) {
  * Searches across all channel types (feishu, wechat, aun) for a matching instance.
  */
 function resolveInstanceConfig(instanceName) {
-    // 新结构：channel key 是 <type>#<selfPeerId>#<name>，解析后从对应 agent 的 channels[] 找
+    // 新结构：channel key 是 <type>#<selfAID>#<name>，解析后从对应 agent 的 channels[] 找
     const parts = instanceName.split('#');
     if (parts.length === 3) {
-        const [type, encodedSelfPeerId, name] = parts;
-        const selfPeerId = decodeURIComponent(encodedSelfPeerId);
+        const [type, selfAID, name] = parts;
         const { agents } = loadAllAgents();
-        // AUN channel 的 selfPeerId 就是 agent.aid
-        const agent = agents.find(a => a.aid === selfPeerId);
+        // AUN channel 的 selfAID 就是 agent.aid
+        const agent = agents.find(a => a.aid === selfAID);
         if (!agent)
             return null;
         const inst = agent.channels.find((c) => c.type === type && c.name === name);
@@ -2625,8 +2645,6 @@ async function cmdMv(oldDir, newDir) {
             console.log('✓ 项目目录已移动');
         if (r.evolclawDbUpdated > 0)
             console.log(`✓ EvolClaw 会话存储已更新 (${r.evolclawDbUpdated} 条记录)`);
-        if (r.evolclawConfigUpdated)
-            console.log('✓ agent config projects.list 已更新');
         console.log('\n迁移完成！');
     }
     catch (e) {
@@ -2800,7 +2818,7 @@ Agent:
 // ==================== Agent ====================
 async function cmdAgent(args) {
     const sub = args[0];
-    const formatJson = args.includes('--format') && args[args.indexOf('--format') + 1] === 'json';
+    const formatJson = getArgValue(args, '--format') === 'json';
     if (!sub || isHelpFlag(sub)) {
         console.log(`用法: evolclaw agent <command>
 
@@ -3375,7 +3393,7 @@ function resolveAunPath(args) {
 }
 async function cmdAid(args) {
     const sub = args[0];
-    const formatJson = args.includes('--format') && args[args.indexOf('--format') + 1] === 'json';
+    const formatJson = getArgValue(args, '--format') === 'json';
     const aunPath = resolveAunPath(args);
     if (!sub || isHelpFlag(sub)) {
         console.log(`用法: evolclaw aid <command>
@@ -3467,7 +3485,7 @@ Options:
             console.log('无匹配 AID');
             return;
         }
-        console.log(`本地 AID${noVerify ? '（静态扫描，未实测）' : ''}:`);
+        console.log(`本地 AID${noVerify ? '（静态扫描，未实测）' : ''}（${aunPath ?? resolveRoot()}）:`);
         for (const a of aids) {
             const keyIcon = a.hasPrivateKey ? '🔑' : '  ';
             let signIcon = '  ';
@@ -3533,40 +3551,63 @@ Options:
     }
     if (sub === 'new') {
         if (wantsHelp(args)) {
-            console.log(`用法: evolclaw aid new <完整AID>
+            console.log(`用法: evolclaw aid new <完整AID> [--force]
 
 创建新 AID 身份：生成 ECDSA 密钥对、向 Issuer 申请证书、构建并上传初始 agent.md。
 
-例: evolclaw aid new reviewer.agentid.pub`);
+选项:
+  --force    强制重新注册，覆盖已存在的身份（即使签名验证失败）
+
+例: evolclaw aid new reviewer.agentid.pub
+    evolclaw aid new reviewer.agentid.pub --force`);
             return;
         }
         const aid = args[1];
+        const force = args.includes('--force');
         if (!aid) {
-            console.error('用法: evolclaw aid new <完整AID>\n例: evolclaw aid new reviewer.agentid.pub');
+            console.error('用法: evolclaw aid new <完整AID> [--force]\n例: evolclaw aid new reviewer.agentid.pub');
             process.exit(1);
         }
         if (!isValidAid(aid)) {
             console.error(`❌ 无效 AID 格式: ${aid}`);
             process.exit(1);
         }
-        const result = await aidCreate(aid, { aunPath });
-        if (!result.alreadyExisted) {
-            const content = buildInitialAgentMd({ aid });
+        try {
+            const result = await aidCreate(aid, { aunPath, force });
+            if (!result.alreadyExisted) {
+                const content = buildInitialAgentMd({ aid });
+                try {
+                    await agentmdPut(content, { aid, aunPath });
+                    console.log('✓ agent.md 已发布');
+                }
+                catch (e) {
+                    console.warn(`⚠ agent.md 发布失败（首次连接将自动重试）: ${String(e.message || e).slice(0, 100)}`);
+                }
+            }
             try {
-                await agentmdPut(content, { aid, client: result.client, aunPath });
-                console.log('✓ agent.md 已发布');
+                await result.client.close();
             }
-            catch (e) {
-                console.warn(`⚠ agent.md 发布失败（首次连接将自动重试）: ${String(e.message || e).slice(0, 100)}`);
+            catch { }
+            try {
+                result.store?.close();
             }
+            catch { }
+            const verb = result.alreadyExisted ? '已存在且有效' : (force ? '已重新创建' : '已创建');
+            console.log(`✓ ${aid} ${verb}`);
+            console.log('  如需上线 AUN 通道，运行 evolclaw agent new ' + aid);
         }
-        try {
-            await result.client.close();
+        catch (e) {
+            if (e.code === 'AID_INVALID') {
+                console.error(`❌ ${e.message}`);
+                process.exit(1);
+            }
+            if (e.code === -32052 || e.constructor?.name === 'IdentityConflictError') {
+                console.error(`❌ AID ${aid} 已在服务端注册，但本地密钥无法匹配。\n` +
+                    `该 AID 可能由其他设备创建，无法在本地恢复。请选择其他名称。`);
+                process.exit(1);
+            }
+            throw e;
         }
-        catch { }
-        const verb = result.alreadyExisted ? '已存在' : '已创建';
-        console.log(`✓ ${aid} ${verb}`);
-        console.log('  如需上线 AUN 通道，运行 evolclaw agent new ' + aid);
         return;
     }
     if (sub === 'delete') {
@@ -3853,6 +3894,10 @@ async function cmdRpc(args) {
 
 每行 JSON 格式: {"method":"<namespace.method>","params":{...}}
 
+Options:
+  --app <name>   指定应用 slot（独立消费通道）。仅对 message.pull / group.pull
+                 等消费类方法有意义——隔离 seq 游标与消息过滤；默认与 daemon 共享通道。
+
 示例:
   evolclaw rpc --as alice.agentid.pub --params '{"method":"message.send","params":{"to":"bob.agentid.pub","payload":{"type":"text","text":"hello"}}}'
   evolclaw rpc --as alice.agentid.pub --params calls.jsonl`);
@@ -3861,6 +3906,7 @@ async function cmdRpc(args) {
     const asIdx = args.indexOf('--as');
     const paramsIdx = args.indexOf('--params');
     const aunPath = resolveAunPath(args);
+    const appSlot = getArgValue(args, '--app');
     if (asIdx === -1 || asIdx + 1 >= args.length) {
         console.error('❌ 缺少 --as <aid>');
         process.exit(1);
@@ -3905,11 +3951,11 @@ async function cmdRpc(args) {
     }
     const { rpcCall, rpcBatch } = await import('../aun/rpc/index.js');
     if (calls.length === 1) {
-        const result = await rpcCall(aid, calls[0].method, calls[0].params, { aunPath });
+        const result = await rpcCall(aid, calls[0].method, calls[0].params, { aunPath, slotId: appSlot });
         console.log(JSON.stringify(result));
     }
     else {
-        const results = await rpcBatch(aid, calls, { aunPath });
+        const results = await rpcBatch(aid, calls, { aunPath, slotId: appSlot });
         for (const r of results) {
             console.log(JSON.stringify(r));
         }
@@ -3919,7 +3965,7 @@ async function cmdRpc(args) {
 async function cmdStorage(args) {
     const sub = args[0];
     const aunPath = resolveAunPath(args);
-    const formatJson = args.includes('--format') && args[args.indexOf('--format') + 1] === 'json';
+    const formatJson = getArgValue(args, '--format') === 'json';
     if (!sub || isHelpFlag(sub)) {
         console.log(`用法: evolclaw storage <command> <aid> [options]
 
@@ -4066,10 +4112,9 @@ Commands:
 async function cmdMsg(args) {
     const sub = args[0];
     const aunPath = resolveAunPath(args);
-    const formatJson = args.includes('--format') && args[args.indexOf('--format') + 1] === 'json';
+    const formatJson = getArgValue(args, '--format') === 'json';
     const appIdx = args.indexOf('--app');
     const appSlot = appIdx >= 0 ? args[appIdx + 1] : undefined;
-    const asDaemon = args.includes('--as-daemon');
     if (!sub || isHelpFlag(sub)) {
         console.log(`用法: evolclaw msg <command> <from-aid> [args...] [options]
 
@@ -4079,19 +4124,20 @@ Commands:
   send <from> <to> --link <url> [--title T]            发送链接卡片
   send <from> <to> --payload <json>                    发送自定义 payload
   pull <from> [--after-seq N] [--limit N]              拉取收件箱
-  ack <from> <seq> --app <name>                        确认已读（必须传 --app）
+  ack <from> <seq> [--app <name>]                      确认已读
   recall <from> <message-id> [<message-id>...]         撤回消息
   online <from> <target-aid> [<target-aid>...]         查询在线状态
 
 Options:
-  --app <name>          指定应用 slot（隔离 ack 游标）
-  --as-daemon           ack 时显式以 daemon 身份（高危，会污染 daemon 游标）
+  --app <name>          指定应用 slot（独立消费通道，不影响 daemon）
   --format json         输出 JSON 格式
   --encrypt             启用端到端加密
   --thread <id>         指定话题 ID（用于多话题路由）
   --content-type <mime> 显式覆盖 MIME（仅 --file 模式）
   --text <说明>          附件说明文字（仅 --file 模式）
   --transcript <text>   语音转写（仅 --as voice）
+  --                    end-of-options：其后所有参数按正文处理
+                        （用于发送恰好等于某 flag 的文本，如 send a b -- --encrypt）
 
 示例:
   evolclaw msg send alice.agentid.pub bob.agentid.pub "hello"
@@ -4211,7 +4257,7 @@ Options:
     }
     if (sub === 'pull') {
         if (!appSlot) {
-            console.error('⚠ 警告: 未传 --app，将使用 daemon 共享 slot（可能与 daemon 看到同一批消息）');
+            console.warn('⚠ 警告: 未传 --app，当前与 daemon 共享 evolclaw 消费通道。pull 会看到/影响 daemon 的消息消费；如需独立消费请用 --app <name>');
         }
         const afterSeqStr = getArgValue(args, '--after-seq');
         const limitStr = getArgValue(args, '--limit');
@@ -4253,7 +4299,7 @@ Options:
     if (sub === 'ack') {
         const seqStr = args[2];
         if (!seqStr) {
-            console.error('用法: evolclaw msg ack <from> <seq> --app <name>');
+            console.error('用法: evolclaw msg ack <from> <seq> [--app <name>]');
             process.exit(1);
         }
         const seq = Number(seqStr);
@@ -4261,10 +4307,8 @@ Options:
             console.error(`❌ seq 必须是数字: ${seqStr}`);
             process.exit(1);
         }
-        if (!appSlot && !asDaemon) {
-            console.error('❌ ack 必须传 --app <name>（或 --as-daemon 显式以 daemon 身份，高危）');
-            console.error('   理由: 不传 --app 会推进 daemon 共享的 ack 游标，导致 daemon 丢消息');
-            process.exit(1);
+        if (!appSlot) {
+            console.warn('⚠ 警告: 未传 --app，ack 将推进与 daemon 共享的 evolclaw 消费游标，可能影响 daemon 收消息；如需独立请用 --app <name>');
         }
         const result = await msgAck({ from, seq, ...commonOpts });
         if (!result.ok) {
@@ -4352,10 +4396,9 @@ Options:
 async function cmdGroup(args) {
     const sub = args[0];
     const aunPath = resolveAunPath(args);
-    const formatJson = args.includes('--format') && args[args.indexOf('--format') + 1] === 'json';
+    const formatJson = getArgValue(args, '--format') === 'json';
     const appIdx = args.indexOf('--app');
     const appSlot = appIdx >= 0 ? args[appIdx + 1] : undefined;
-    const asDaemon = args.includes('--as-daemon');
     if (!sub || isHelpFlag(sub)) {
         console.log(`用法: evolclaw group <command> <from-aid> [args...] [options]
 
@@ -4364,7 +4407,7 @@ async function cmdGroup(args) {
   send <from> <group-id> --file <path> [--as <type>]   发送群文件
   send <from> <group-id> --payload <json>              发送自定义 payload
   pull <from> <group-id> [--after-seq N] [--limit N]   拉取群消息
-  ack <from> <group-id> <seq> --app <name>             确认已读（必须传 --app）
+  ack <from> <group-id> <seq> [--app <name>]           确认已读
 
 群管理:
   create <from> <name> [--visibility public|private] [--description D] [--join-mode M]  创建群
@@ -4382,11 +4425,13 @@ async function cmdGroup(args) {
   online <from> <group-id>                             查看在线成员
 
 Options:
-  --app <name>          指定应用 slot（隔离 ack 游标）
-  --as-daemon           ack 时显式以 daemon 身份（高危）
+  --app <name>          指定应用 slot（独立消费通道，不影响 daemon）
   --format json         输出 JSON 格式
-  --mention <aid>       发送时 @ 某个成员（可多次）
+  --encrypt             启用端到端加密（仅 send）
+  --mention <aid>       发送时 @ 某个成员（可多次，或用逗号分隔多个 aid）
   --mention-all         发送时 @ 所有人
+  --                    end-of-options：其后所有参数按正文处理
+                        （用于发送恰好等于某 flag 的文本，如 send a g -- --encrypt）
 
 示例:
   evolclaw group create alice.agentid.pub "Dev Team" --visibility private
@@ -4418,12 +4463,23 @@ Options:
         }
         return gid;
     };
-    // 收集 --mention（可多次）
+    // 收集 --mention（可多次；每次的值支持逗号分隔多个 aid）
     const collectMentions = () => {
         const mentions = [];
-        for (let i = 0; i < args.length - 1; i++) {
-            if (args[i] === '--mention') {
-                mentions.push({ aid: args[i + 1] });
+        for (let i = 0; i < args.length; i++) {
+            if (args[i] !== '--mention')
+                continue;
+            const val = args[i + 1];
+            if (val === undefined || val.startsWith('--')) {
+                console.error(`❌ --mention 后面缺少 <aid>`);
+                process.exit(1);
+            }
+            for (const aid of val.split(',').map(s => s.trim()).filter(Boolean)) {
+                if (!isValidAid(aid)) {
+                    console.error(`❌ --mention 的 aid 无效: ${aid}`);
+                    process.exit(1);
+                }
+                mentions.push({ aid });
             }
         }
         if (args.includes('--mention-all')) {
@@ -4496,7 +4552,7 @@ Options:
     if (sub === 'pull') {
         const groupId = requireGroupId();
         if (!appSlot) {
-            console.error('⚠ 警告: 未传 --app，将使用 daemon 共享 slot');
+            console.warn('⚠ 警告: 未传 --app，当前与 daemon 共享 evolclaw 消费通道。pull 会看到/影响 daemon 的消息消费；如需独立消费请用 --app <name>');
         }
         const afterSeqStr = getArgValue(args, '--after-seq');
         const limitStr = getArgValue(args, '--limit');
@@ -4517,7 +4573,7 @@ Options:
         const groupId = requireGroupId();
         const seqStr = args[3];
         if (!seqStr) {
-            console.error('用法: evolclaw group ack <from> <group-id> <seq> --app <name>');
+            console.error('用法: evolclaw group ack <from> <group-id> <seq> [--app <name>]');
             process.exit(1);
         }
         const seq = Number(seqStr);
@@ -4525,9 +4581,8 @@ Options:
             console.error(`❌ seq 必须是数字: ${seqStr}`);
             process.exit(1);
         }
-        if (!appSlot && !asDaemon) {
-            console.error('❌ group ack 必须传 --app <name>（或 --as-daemon 显式以 daemon 身份，高危）');
-            process.exit(1);
+        if (!appSlot) {
+            console.warn('⚠ 警告: 未传 --app，ack 将推进与 daemon 共享的 evolclaw 消费游标，可能影响 daemon 收消息；如需独立请用 --app <name>');
         }
         const result = await groupAck({ from, groupId, seq, ...commonOpts });
         outputResult(result, () => {
@@ -4718,32 +4773,50 @@ Options:
     process.exit(1);
 }
 // ==================== Main ====================
-function getArgValue(args, flag) {
-    const idx = args.indexOf(flag);
-    return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
-}
 /**
- * 收集位置参数（从 startIdx 开始），跳过 flag 及其值。
- * 已知"取值"的 flag 会消耗下一个 arg；已知"开关"的 flag 只占自身。
+ * 收集位置参数（从 startIdx 开始）。
+ *
+ * flag 判定采用**精确匹配已知 flag 集合**，而非 `startsWith('--')`——
+ * 这样"正文恰好以 -- 开头"（如消息文本 `--file 坏了`）不会被误当 flag 吞掉。
+ * 仅当 token 精确等于某个已知 flag 时才按 flag 处理：
+ *   - VALUE_FLAGS：消耗自身 + 下一个 arg（flag 的值）
+ *   - BOOLEAN_FLAGS：仅消耗自身
+ * 其余以 -- 开头但不在集合中的 token，一律视为正文。
+ *
+ * 另支持 POSIX `--` end-of-options 分隔符：遇到单独的 `--` 后，
+ * 其后所有 token 无条件按正文处理（用于发送精确等于某 flag 的文本，如 `-- --encrypt`）。
  */
+const VALUE_FLAGS = new Set([
+    '--format', '--app', '--after-seq', '--limit', '--file', '--link',
+    '--payload', '--title', '--description', '--text', '--transcript',
+    '--as', '--content-type', '--mention', '--visibility', '--join-mode',
+    '--group-id', '--name', '--message', '--answer', '--page', '--size',
+    '--aun-path', '--thread',
+]);
+const BOOLEAN_FLAGS = new Set([
+    '--encrypt', '--mention-all',
+]);
 function collectPositional(args, startIdx) {
-    const VALUE_FLAGS = new Set([
-        '--format', '--app', '--after-seq', '--limit', '--file', '--link',
-        '--payload', '--title', '--description', '--text', '--transcript',
-        '--as', '--content-type', '--mention', '--visibility', '--join-mode',
-        '--group-id', '--name', '--message', '--answer', '--page', '--size',
-        '--aun-path',
-    ]);
     const out = [];
+    let endOfFlags = false;
     for (let i = startIdx; i < args.length; i++) {
         const a = args[i];
-        if (a.startsWith('--')) {
-            if (VALUE_FLAGS.has(a))
-                i++; // 跳过 flag 的值
-            // else: 开关 flag，自身已被跳过
+        if (endOfFlags) {
+            out.push(a);
             continue;
         }
-        out.push(a);
+        if (a === '--') {
+            endOfFlags = true;
+            continue;
+        }
+        if (VALUE_FLAGS.has(a)) {
+            i++;
+            continue;
+        } // 精确匹配取值 flag：跳过其值
+        if (BOOLEAN_FLAGS.has(a)) {
+            continue;
+        } // 精确匹配开关 flag：仅跳过自身
+        out.push(a); // 其余（含以 -- 开头的未知 token）= 正文
     }
     return out;
 }
@@ -4857,6 +4930,9 @@ export async function main(args) {
             else if (args[1] === 'log') {
                 cmdWatch();
             }
+            else if (args[1] === 'web' || args[1] === 'session') {
+                await cmdWatchWeb();
+            }
             else if (!args[1]) {
                 await cmdWatchMenu();
             }
@@ -4920,6 +4996,11 @@ export async function main(args) {
             await cmdGroup(args.slice(1));
             break;
         }
+        case 'model': {
+            const { cmdModel } = await import('./model.js');
+            await cmdModel(args.slice(1));
+            break;
+        }
         case 'bench': {
             const { suppressSdkLogs } = await import('../aun/aid/index.js');
             suppressSdkLogs();
@@ -4970,6 +5051,14 @@ Commands:
                           --force                            (覆盖已有 config.json)
                   agent reload       全量 resync（扫磁盘，新增上线、删除下线、修改热更新）
                   agent reload <n>   热重载指定 agent 配置
+  model         模型管理（查看/切换，作用域：全局/agent/关系/会话）
+                  model list         列出可用模型，标注各作用域命中
+                  model current      显示实际生效的模型 + 来源
+                  model info <id>    查看单个模型详情（价格/上下文/模态等）
+                  model use <id>     切换模型（--self/--peer/--session 决定作用域）
+                  model effort <lv>  设置推理强度
+                  model reset        清除指定作用域设置，回落上一级
+                  model help         查看完整用法
   aid           AID 身份管理
                   aid list           列出本地所有 AID
                   aid show <aid>     查看本地 AID 详情（证书有效期、私钥状态）

package/dist/cli/init-channel.js

@@ -463,7 +463,7 @@ export async function setupAunAid(rl, _config) {
             const agentType = typeInput === 'human' ? 'human' : 'ai';
             const content = buildInitialAgentMd({ aid, type: agentType });
             try {
-                await agentmdPut(content, { aid, client: result.client });
+                await agentmdPut(content, { aid });
                 console.log('  ✓ agent.md 已发布并写入本地');
             }
             catch (e) {
@@ -484,6 +484,10 @@ export async function setupAunAid(rl, _config) {
                 await result.client.close();
             }
             catch { /* ignore */ }
+            try {
+                result.store?.close();
+            }
+            catch { /* ignore */ }
         }
         catch (e) {
             const msg = e.message || String(e);