evolcore 0.0.28 → 0.0.29

package/dist/channels/daemon.js

@@ -222,7 +222,24 @@ export class DaemonChannel {
         const threadId = mode.thread === 'by_run'
             ? `trigger:${trigger.id}:${runId}`
             : `trigger:${trigger.id}`;
-        return await this.sessionManager.getOrCreateSession(this.channelName, channelId, projectPath, threadId, { channelKey: this.channelKey, peerId: `trigger:${trigger.id}`, peerName: trigger.name }, trigger.name, undefined, 'private', baseagent, trigger.agentAid, this.channelName, 'system');
+        // 记忆整理会话：把会话原型与整理模式写进 metadata，供渲染层选 manifest / 手册，
+        // 供 ipc 侧校验写命令的 --scope。
+        const { memoryMode, memoryScope, consolidationBatchDir, consolidationChatDir, consolidationMemoryDir } = trigger.execution;
+        // 反馈目标与触发方式（launch-consolidation 在 normalize 后补挂的字段）：
+        // 收尾时据此投递反馈，并判断是否该反馈（定时触发不反馈）。
+        const { feedbackOrigin, consolidationTriggeredBy } = trigger.execution;
+        return await this.sessionManager.getOrCreateSession(this.channelName, channelId, projectPath, threadId, {
+            channelKey: this.channelKey,
+            peerId: `trigger:${trigger.id}`,
+            peerName: trigger.name,
+            ...(memoryMode ? { sessionType: 'memory', memoryMode } : {}),
+            ...(memoryScope ? { memoryScope } : {}),
+            ...(consolidationBatchDir ? { consolidationBatchDir } : {}),
+            ...(consolidationChatDir ? { consolidationChatDir } : {}),
+            ...(consolidationMemoryDir ? { consolidationMemoryDir } : {}),
+            ...(feedbackOrigin ? { feedbackOrigin } : {}),
+            ...(consolidationTriggeredBy ? { consolidationTriggeredBy } : {}),
+        }, trigger.name, undefined, 'private', baseagent, trigger.agentAid, this.channelName, 'system');
     }
     executionDeadlineAt(startedAt = Date.now()) {
         return this.totalExecutionMs === undefined

package/dist/channels/feishu.js

@@ -1734,8 +1734,7 @@ export class FeishuChannelPlugin {
                     case 'system.error':
                     case 'result.error': {
                         const sendCtx = { ...(replyCtx ?? {}) };
-                        if (payload.kind === 'result.text' && payload.isFinal)
-                            sendCtx.title = '✅ 最终回复:';
+                        // isFinal is now carried via payload.ext by response-engine; no title injection here.
                         if (replyCtx?.metadata?.onThreadCreated)
                             sendCtx.onThreadCreated = replyCtx.metadata.onThreadCreated;
                         const ids = await channel.sendMessage(channelId, payload.text, sendCtx);

package/dist/cli/agent-command.js

@@ -4,6 +4,9 @@ import { getArgValue, isHelpFlag, wantsHelp } from './help.js';
 import { isHostChinese } from '../utils/locale.js';
 import { readTaskRuntimeContextFromEnv } from './task-context.js';
 import { parseAgentWelcomeArgs } from './agent-create.js';
+import { assertEcSingleLine } from './cli-argv.js';
+import { canonicalizeEvolcoreCommandArgv } from '../core/permission/ec-command-parser.js';
+import { parseAgentAvatarArgs } from './agent-create.js';
 function printBootstrapDeliveries(result) {
     for (const delivery of result?.deliveries ?? []) {
         if (delivery.status === 'sent')
@@ -40,7 +43,13 @@ function formatBytes(bytes) {
 }
 // ==================== Agent ====================
 export async function cmdAgent(args) {
+    args = canonicalizeEvolcoreCommandArgv(['ec', 'agent', ...args]).slice(2);
     const sub = args[0];
+    if (sub === 'new') {
+        const nameIndex = args.indexOf('--name');
+        if (nameIndex >= 0)
+            assertEcSingleLine(args[nameIndex + 1], '--name');
+    }
     const formatJson = getArgValue(args, '--format') === 'json';
     const commands = new Set(['list', 'show', 'new', 'initialize', 'enable', 'disable', 'get', 'set', 'persona', 'welcome', 'rename', 'ready', 'reload', 'delete']);
     if (sub === 'create') {
@@ -95,7 +104,7 @@ Options:
     }
     if ((sub === 'new' && args.includes('--initialize')) || sub === 'initialize') {
         if (wantsHelp(args)) {
-            console.log('ec agent new <aid> --initialize --name <name> --description <text> --tags <json> [--owner <aid> | --owners <json>] [--persona-file <path> | --persona-text <text>] [--wait 0..300] [--dry-run] [--format json]\nec agent initialize <aid> --resume [--wait 0..300] [--format json]\n--initialize implies --non-interactive; waits for activation (default 60 seconds).');
+            console.log('ec agent new <aid> --initialize ... [--avatar-file <path> | --avatar-url <https-url>] [--wait 0..300] [--format json]\nec agent initialize <aid> --resume [--wait 0..300] [--format json]\n--initialize implies --non-interactive; waits for activation (default 60 seconds).');
             return;
         }
         try {
@@ -270,6 +279,8 @@ Options:
   --owner <aid>                       默认: daemon.json 第一个 owner
   --owners <json-array>               多个 Owner；与 --owner 互斥
   --handoff <context>                 当前任务的 Bootstrap 上下文
+  --avatar-file <path>                  头像图片文件（沿用 ec aid avatar）
+  --avatar-url <https-url>              头像 HTTPS 地址（沿用 ec aid avatar）
   --name <display-name>               默认: package.json name，否则目录名
   --description <text>                默认: package.json description，否则使用 EvolCore 默认描述
   --type <type>                       主体类型: human|agent|group|service|device|org|host（默认 agent）
@@ -306,8 +317,10 @@ Options:
                 return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
             };
             let ownerOptions;
+            let avatarOptions;
             try {
                 ownerOptions = parseAgentOwnerArgs(args);
+                avatarOptions = parseAgentAvatarArgs(args);
             }
             catch (error) {
                 const result = { ok: false, error: error instanceof Error ? error.message : String(error) };
@@ -336,6 +349,7 @@ Options:
                 project: getArg('--project'),
                 baseagent: getArg('--baseagent'),
                 ...ownerOptions,
+                ...avatarOptions,
                 handoff: getArg('--handoff'),
                 name: getArg('--name'),
                 description: getArg('--description'),
@@ -381,6 +395,8 @@ Options:
                 type: plan.type,
                 tags: plan.tags,
                 force: args.includes('--force'),
+                avatarFile: plan.avatarFile,
+                avatarUrl: plan.avatarUrl,
             });
             if (!result.ok) {
                 if (formatJson) {
@@ -498,11 +514,14 @@ Options:
 热重载 agent 配置。
   无参数      全量 resync（扫磁盘，新增上线、删除下线、修改热更新）
   <aid>       仅热重载指定 agent
-  --force     中断目标 Agent 的运行中任务并清空排队任务后重载（仅与 <aid> 同用）`);
+  --force     中断目标 Agent 的运行中任务并清空排队任务后重载（仅与 <aid> 同用）
+  重载时自动读取当前终端的 ANTHROPIC_* 环境变量`);
             return;
         }
         const target = args[1] && !args[1].startsWith('--') ? args[1] : undefined;
-        const result = await agentReload(target, { force: args.includes('--force') });
+        const result = await agentReload(target, {
+            force: args.includes('--force'),
+        });
         if (!result.ok) {
             if (formatJson) {
                 console.log(JSON.stringify(result));
@@ -906,6 +925,7 @@ Options:
             console.error('用法: ec agent rename <aid> <name>');
             process.exit(1);
         }
+        assertEcSingleLine(name, '<name>');
         const result = await agentRename(aid, name);
         if (!result.ok) {
             if (formatJson) {

package/dist/cli/agent-create.js

@@ -19,6 +19,7 @@ import { AGENT_DESCRIPTION_MAX_LENGTH, AGENT_TAG_MAX_COUNT, AGENT_TAG_MIN_COUNT,
 import { atomicWriteJson } from '../utils/atomic-write.js';
 import { isHClassPath, isLClassPath, isSameOrDescendant } from '../core/permission/protected-paths.js';
 import { MAIN_CLI_BIN } from '../product.js';
+import { uploadAvatarFile, uploadAvatarUrl } from '../utils/avatar-upload.js';
 /** Parse the current Agent's Bootstrap welcome subcommand. */
 export function parseAgentWelcomeArgs(args) {
     const tail = args.at(-2) === '--format' && args.at(-1) === 'json' ? args.slice(0, -2) : args;
@@ -29,6 +30,25 @@ export function parseAgentWelcomeArgs(args) {
     }
     throw new Error(`用法: ${MAIN_CLI_BIN} agent welcome show | --text <text> [--format json]`);
 }
+export function parseAgentAvatarArgs(argv) {
+    const hasFile = argv.includes('--avatar-file');
+    const hasUrl = argv.includes('--avatar-url');
+    if (argv.filter(arg => arg === '--avatar-file').length > 1 || argv.filter(arg => arg === '--avatar-url').length > 1) {
+        throw new Error('--avatar-file and --avatar-url may each be supplied once');
+    }
+    if (hasFile && hasUrl)
+        throw new Error('--avatar-file and --avatar-url are mutually exclusive');
+    const flag = hasFile ? '--avatar-file' : hasUrl ? '--avatar-url' : undefined;
+    if (!flag)
+        return {};
+    const value = argv[argv.indexOf(flag) + 1];
+    if (!value || value.startsWith('--'))
+        throw new Error(`${flag} requires a value`);
+    if (value.startsWith('attachment:') && !process.env.EVOLCORE_SESSION_ID) {
+        throw new Error('attachment:<id> avatar sources require a managed Agent task');
+    }
+    return hasFile ? { avatarFile: value } : { avatarUrl: value };
+}
 export function parseAgentTags(raw) {
     if (raw === undefined)
         return undefined;
@@ -203,7 +223,8 @@ export function resolveAgentCreatePlan(options) {
     const type = requestedType ? (normalizeAgentType(requestedType) ?? requestedType) : DEFAULT_AGENT_TYPE;
     const configExists = isValidAid(aid) && fs.existsSync(path.join(resolvePaths().agentsDir, aid, 'config.json'));
     return {
-        aid, project, baseagent, owner, owners, handoff: options.handoff, name, description, type, tags: options.tags,
+        aid, project, baseagent, owner, owners, handoff: options.handoff, avatarFile: options.avatarFile, avatarUrl: options.avatarUrl,
+        name, description, type, tags: options.tags,
         force: options.force === true, configExists, baseagentSource, ownerSource,
         nameSource: options.name?.trim() ? 'argument' : metadata.name ? 'package' : 'directory',
         descriptionSource: explicitDescription ? 'argument' : packageDescription ? 'package' : 'default',
@@ -216,6 +237,8 @@ export function validateAgentCreatePlan(plan) {
         return ownerError;
     if (!isValidAid(plan.aid))
         return `Invalid AID "${plan.aid}": must be a valid multi-level domain (e.g. mybot.agentid.pub)`;
+    if (plan.avatarFile !== undefined && plan.avatarUrl !== undefined)
+        return '--avatar-file and --avatar-url are mutually exclusive';
     if (plan.configExists && !plan.force)
         return `Agent "${plan.aid}" already exists (use --force to overwrite)`;
     if (plan.tags !== undefined) {
@@ -655,6 +678,26 @@ export async function agentCreateNonInteractive(opts, runtime = {}) {
         agentmdError = `generation failed: ${e?.message || e}`;
         opts.onPhase?.('uploading_agentmd', 'warn', agentmdError);
     }
+    let avatarUploaded = false;
+    if (opts.avatarFile || opts.avatarUrl) {
+        opts.onPhase?.('uploading_avatar', 'begin');
+        try {
+            if (!agentmdUploaded)
+                throw new Error('头像上传前 agent.md 尚未成功发布');
+            const avatar = opts.avatarFile
+                ? await uploadAvatarFile(opts.aid, opts.avatarFile)
+                : await uploadAvatarUrl(opts.aid, opts.avatarUrl);
+            if (!avatar.ok)
+                throw new Error(avatar.error || '头像上传失败');
+            avatarUploaded = true;
+            opts.onPhase?.('uploading_avatar', 'done', `${avatar.width}x${avatar.height} ${avatar.mime}`);
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            opts.onPhase?.('uploading_avatar', 'failed', detail);
+            return { ok: false, code: 'AVATAR_UPLOAD_FAILED', error: `头像上传失败：${detail}` };
+        }
+    }
     let hotLoaded = false;
     let hotLoadError;
     opts.onPhase?.('hot_loading', 'begin');
@@ -692,6 +735,7 @@ export async function agentCreateNonInteractive(opts, runtime = {}) {
         agentmdError,
         hotLoaded,
         hotLoadError,
+        ...(opts.avatarFile || opts.avatarUrl ? { avatarUploaded } : {}),
         ...ownerContactSync,
     };
 }
@@ -712,6 +756,7 @@ export function initializationFingerprint(plan) {
     return createHash('sha256').update(JSON.stringify([
         plan.aid, plan.project, plan.baseagent, plan.owners, plan.name,
         plan.description, plan.type, plan.tags, plan.persona ?? null,
+        plan.avatarFile ?? null, plan.avatarUrl ?? null,
     ])).digest('hex');
 }
 export function readInitialization(aid) {
@@ -749,6 +794,7 @@ export function initializationSummary(aid) {
             nextStep: r.status === 'failed' ? `ec agent initialize ${aid} --resume` : undefined,
             agentmd: { published: r.published === true, verified: r.verified === true },
             persona: { provided: r.plan.persona !== undefined },
+            avatar: { requested: r.plan.avatarFile !== undefined || r.plan.avatarUrl !== undefined, uploaded: r.avatarUploaded === true },
             welcome: r.welcome, startedAt: r.startedAt, updatedAt: r.updatedAt,
         };
     }
@@ -782,6 +828,8 @@ export function validateInitializationPlan(plan) {
     }
     if (plan.type !== 'agent')
         failure('INVALID_ARGS', 'Initialized targets must have type=agent');
+    if (plan.avatarFile !== undefined && plan.avatarUrl !== undefined)
+        failure('INVALID_ARGS', 'avatar-file and avatar-url are mutually exclusive');
     const error = validateAgentCreatePlan({
         ...plan, force: false, configExists: false, baseagentSource: 'argument', ownerSource: 'argument',
         nameSource: 'argument', descriptionSource: 'argument', typeSource: 'argument',
@@ -958,6 +1006,7 @@ export class AgentInitializationService {
                 failure('INITIALIZE_PLAN_CONFLICT');
             fs.writeFileSync(file, p.persona, { encoding: 'utf8', mode: 0o600 });
         }
+        const resolvedAvatarFile = p.avatarFile;
         await syncOwnerContactsAfterCreate(p.aid, p.owners);
         this.phase(r, 'uploading_agentmd');
         let remote;
@@ -1013,6 +1062,15 @@ export class AgentInitializationService {
         if (!fs.existsSync(agentMdPath(p.aid)) || !matchesCard(fs.readFileSync(agentMdPath(p.aid), 'utf8'), p)) {
             failure('INITIALIZE_AGENTMD_VERIFY_FAILED');
         }
+        if ((resolvedAvatarFile || p.avatarUrl) && !r.avatarUploaded) {
+            const avatar = resolvedAvatarFile
+                ? await uploadAvatarFile(p.aid, resolvedAvatarFile)
+                : await uploadAvatarUrl(p.aid, p.avatarUrl);
+            if (!avatar.ok)
+                failure('INITIALIZE_AVATAR_FAILED', avatar.error || 'avatar upload failed');
+            r.avatarUploaded = true;
+            saveInitialization(r);
+        }
         r.published = true;
         r.verified = true;
         this.phase(r, 'hot_loading');
@@ -1074,7 +1132,7 @@ export function parseInitializationArgs(args) {
         throw new Error('Invalid initialization command or AID');
     const booleans = new Set(resume ? ['--resume'] : ['--initialize', '--non-interactive', '--dry-run']);
     const strings = new Set(resume ? ['--wait', '--format'] : [
-        '--project', '--baseagent', '--owner', '--owners', '--name', '--description', '--tags', '--type',
+        '--project', '--baseagent', '--owner', '--owners', '--name', '--description', '--tags', '--type', '--avatar-file', '--avatar-url',
         '--persona-file', '--persona-text', '--wait', '--format',
     ]);
     const seen = new Set();
@@ -1114,16 +1172,24 @@ export function resolveInitializationPlan(args) {
     if (parsed.resume)
         throw new Error('A resume request cannot supply a new plan');
     const v = parsed.values;
+    if (v['--avatar-file'] !== undefined && v['--avatar-url'] !== undefined)
+        throw new Error('--avatar-file and --avatar-url are mutually exclusive');
+    if (v['--avatar-file']?.startsWith('attachment:') && !process.env.EVOLCORE_SESSION_ID) {
+        throw new Error('attachment:<id> avatar sources require a managed Agent task');
+    }
     if (v['--persona-file'] !== undefined)
         throw new Error('CLI must submit persona file contents as text');
     const p = resolveAgentCreatePlan({
         aid: parsed.aid, project: v['--project'], baseagent: v['--baseagent'], ...parseAgentOwnerArgs(args),
+        avatarFile: v['--avatar-file'], avatarUrl: v['--avatar-url'],
         name: v['--name'], description: v['--description'], tags: parseAgentTags(v['--tags']), type: v['--type'],
     });
     return {
         aid: p.aid, project: p.project, baseagent: p.baseagent ?? '', owners: p.owners ?? (p.owner ? [p.owner] : []),
         name: p.name, description: p.description, tags: p.tags, type: p.type,
         ...(v['--persona-text'] !== undefined ? { persona: v['--persona-text'] } : {}),
+        ...(v['--avatar-file'] !== undefined ? { avatarFile: v['--avatar-file'] } : {}),
+        ...(v['--avatar-url'] !== undefined ? { avatarUrl: v['--avatar-url'] } : {}),
     };
 }
 export function readInitializationPersona(file, managed) {

package/dist/cli/agent.js

@@ -19,6 +19,7 @@ import { findPostBootstrapWelcomeOutbox } from '../core/bootstrap-messages.js';
 import { resolveAgentLifecycle } from '../config/lifecycle.js';
 import { initializationSummary } from './agent-create.js';
 import { parseAgentWelcomeMetadata, readAgentWelcomeTemplate, renderPostBootstrapWelcomeMessage, saveAgentWelcomeTemplate, validateWelcomeTemplate } from '../utils/welcome.js';
+import { RUNTIME_ENVIRONMENT_NAMES } from '../config/runtime-env.js';
 export { agentCreateInteractive, agentCreateNonInteractive, parseAgentOwnerArgs, resolveAgentCreatePlan, validateAgentCreatePlan, validateAgentOwnerOptions, } from './agent-create.js';
 /** Route agent lifecycle commands from a managed task through daemon IPC. */
 export async function runManagedAgentOperation(argv) {
@@ -306,13 +307,17 @@ const AGENT_RELOAD_TIMEOUT_MS = 45_000;
 const AGENT_RESYNC_TIMEOUT_MS = 5 * 60_000;
 export async function agentReload(aid, options = {}) {
     const p = resolvePaths();
+    const runtimeEnv = Object.fromEntries(RUNTIME_ENVIRONMENT_NAMES.map(name => [name, process.env[name] || null]));
     if (!aid) {
         if (options.force) {
             return { ok: false, code: 'INVALID_ARGS', error: '--force requires a target Agent AID' };
         }
         // Full resync
         try {
-            const result = await ipcQuery(p.socket, { type: 'evolagent.resync' }, AGENT_RESYNC_TIMEOUT_MS, { throwOnError: true });
+            const result = await ipcQuery(p.socket, {
+                type: 'evolagent.resync',
+                runtimeEnv,
+            }, AGENT_RESYNC_TIMEOUT_MS, { throwOnError: true });
             if (result === null) {
                 return { ok: false, code: 'IPC_INVALID_RESPONSE', error: 'daemon IPC 未返回有效响应，请检查 ec status' };
             }
@@ -327,7 +332,12 @@ export async function agentReload(aid, options = {}) {
     }
     // Single agent reload
     try {
-        const result = await ipcQuery(p.socket, { type: 'evolagent.reload', name: aid, force: options.force === true }, AGENT_RELOAD_TIMEOUT_MS, { throwOnError: true });
+        const result = await ipcQuery(p.socket, {
+            type: 'evolagent.reload',
+            name: aid,
+            force: options.force === true,
+            runtimeEnv,
+        }, AGENT_RELOAD_TIMEOUT_MS, { throwOnError: true });
         if (result === null) {
             return { ok: false, code: 'IPC_INVALID_RESPONSE', error: 'daemon IPC 未返回有效响应，请检查 ec status' };
         }

package/dist/cli/aun-commands.js

@@ -7,6 +7,9 @@ import { ipcQuery } from '../ipc.js';
 import { AGENT_DELEGATION_TOKEN_ENV, readDelegationCredential } from '../core/auth/agent-delegation.js';
 import { isManagementRole } from '../config/builtin-roles.js';
 import { readBestTaskRuntimeContext } from './task-context.js';
+import { assertEcSingleLine } from './cli-argv.js';
+import { canonicalizeEvolcoreCommandArgv } from '../core/permission/ec-command-parser.js';
+import { ManagedGroupOperationError } from '../aun/msg/managed-operation.js';
 // ==================== AID ====================
 function resolveAunPath(args) {
     const idx = args.indexOf('--aun-path');
@@ -318,14 +321,17 @@ function renderManagedGroupResult(args, result, formatJson) {
                 if (message.content_truncated)
                     console.log('正文尚未读完');
                 if (message.content_truncated && message.msgId) {
-                    console.log('--all --message ' + message.msgId + ' --offset ' + message.next_offset);
+                    console.log('--message ' + message.msgId + ' --offset ' + message.next_offset);
                 }
             }
         }
         if (result.next_offset != null)
             console.log('next_offset=' + result.next_offset);
-        if (result.has_more)
-            console.log('还有更多历史');
+        if (result.has_more) {
+            const cursor = result.next_before ?? result.next_after;
+            const direction = result.next_before ? 'before' : 'after';
+            console.log(`还有更多历史，请使用 --${direction} ${cursor.ts} --${direction}-id ${cursor.id}`);
+        }
         return;
     }
     if (sub === 'list') {
@@ -389,6 +395,31 @@ function renderManagedGroupResult(args, result, formatJson) {
         console.log(typeof result.message === 'string' ? result.message : `✓ group ${sub} 完成`);
         return;
     }
+    if (sub === 'mention') {
+        const renderMode = (value) => {
+            if (value === 'mention-only')
+                return '@提及时响应';
+            if (value === 'disabled')
+                return '所有消息响应';
+            if (value === 'auto')
+                return 'auto（本地自动判断）';
+            return String(value);
+        };
+        const sourceLabel = result.source === 'relation' ? '本群覆盖'
+            : result.source === 'agent' ? 'Agent 全局'
+                : result.source === 'aun' ? 'AUN 服务端'
+                    : result.source === 'defaults' ? '默认配置' : '内置默认';
+        if (result.override === null) {
+            console.log(`@ 处理模式: ${renderMode(result.mode)}（跟随上级设置，当前生效来源：${sourceLabel}）`);
+            return;
+        }
+        if (result.override === undefined) {
+            console.log(`@ 处理模式: ${renderMode(result.mode)}（${sourceLabel}）`);
+            return;
+        }
+        console.log(`@ 处理模式: ${renderMode(result.override)}（本群覆盖${result.mode !== undefined ? `，实际生效 ${renderMode(result.mode)}` : ''}）`);
+        return;
+    }
     console.log(`✓ group ${sub} 完成`);
 }
 export async function cmdAid(args) {
@@ -1204,6 +1235,7 @@ Options:
 }
 // ==================== Msg ====================
 export async function cmdMsg(args) {
+    args = canonicalizeEvolcoreCommandArgv(['ec', 'msg', ...args]).slice(2);
     const sub = args[0];
     const aunPath = resolveAunPath(args);
     const formatJson = getArgValue(args, '--format') === 'json';
@@ -1487,6 +1519,7 @@ Options:
             body = { mode: 'text', text };
         }
         else if (linkVal) {
+            assertEcSingleLine(getArgValue(args, '--title'), '--title');
             body = {
                 mode: 'link',
                 url: linkVal,
@@ -1695,25 +1728,28 @@ function printGroupSendAidHint() {
     console.error('查询真实群 AID: ec group list <发送方AID>');
 }
 export async function cmdGroup(args) {
+    args = canonicalizeEvolcoreCommandArgv(['ec', 'group', ...args]).slice(2);
     const sub = args[0];
+    if (sub === 'create')
+        assertEcSingleLine(args[2], '<name>');
+    if (sub === 'update')
+        assertEcSingleLine(getArgValue(args, '--name'), '--name');
     const aunPath = resolveAunPath(args);
     const formatJson = getArgValue(args, '--format') === 'json';
     const appSlot = getArgValue(args, '--app');
     if (sub === 'history' && wantsHelp(args)) {
-        console.log(`用法: ec group history <self-aid> <group-aid> --unread|--all [options]
+        console.log(`用法: ec group history <self-aid> <group-aid> [options]
 本地 messages.jsonl 查询，不访问 Gateway，不推进 group pull/ack 游标。
---unread               返回最早未读的未提及背景，并自动记录本页已读
---all                  浏览群会话历史（返回最近 N 条），不改变已读状态
+查询始终只读，不维护本地已读游标
 --limit <N>            默认 50，范围 1–500；另有 24 KiB 单页消息预算
 --thread <main|all|id>  当前群任务缺省继承当前话题；其他调用缺省 all
 --direction <in|out|all> 按方向筛选，默认 all
 --before/--after <time> 按接收时间筛选，开区间；epoch 毫秒或 ISO 时间
+--before-id/--after-id <id> 同一时间戳分页用的 64 位游标（需配合对应时间）
 --format <text|json>    默认 text
---message <msg-id>     配合 --all 查看指定长消息正文
+--message <msg-id>     查看指定长消息正文
 --offset <bytes>       配合 --message 从 next_offset 继续读取，默认 0
---unread 返回的消息会记为已读；--all（包括 --all --message）始终只读，之后仍可回看。
-visitor 不开放历史；群权限仍由托管会话校验。
-旧日志通过 --all 查询，只有带本地未提及标记的新记录参与 --unread。`);
+visitor 不开放历史；群权限仍由托管会话校验。`);
         return;
     }
     const rulesActionHelp = sub === 'rules' && isHelpFlag(args[3]);
@@ -1726,7 +1762,7 @@ visitor 不开放历史；群权限仍由托管会话校验。
   send <from> <group-id> --payload <json>              发送自定义 payload
   pull <from> <group-id> [--after-seq N] [--limit N] --app <name>   拉取群消息（必须使用独立 slot）
   ack <from> <group-id> <seq> [--app <name>]           确认已读
-  history <from> <group-id> [--unread|--all]           查询本地群消息历史
+  history <from> <group-id> [options]                 查询本地群消息历史（只读）
 
 群管理:
   create <from> <name> [--visibility public|private] [--description D]
@@ -1741,6 +1777,8 @@ visitor 不开放历史；群权限仍由托管会话校验。
   rules <from> <group-id> set <file>                   上传并发布群规则文件
   rules <from> <group-id> publish                      发布当前群空间 /rules.md
   rules <from> <group-id> [--mode M] [--question Q] [--max-pending N]  查看/更新入群规则
+  mention <from> <group-id> [<mention-only|disabled|auto>] [--clear]
+                       查看/设置本群 @ 提及模式（不带 mode 为查看；--clear 清除本群覆盖跟随上级）
 
 成员:
   join <from> <group-id> [--message M] [--answer A]    申请加入
@@ -2599,7 +2637,43 @@ g- 是名称的一部分，会完整保留；默认命名格式为 g-10000 至 g
         });
         return;
     }
-    console.error(`未知子命令: ${sub}\n用法: ec group [send|pull|ack|history|create|list|info|update|dissolve|suspend|resume|rules|join|leave|invite|invites|accept-invite|reject-invite|revoke-invite|kick|members|online|role|owner|ban|unban|block|unblock|blocklist|report-status|member-statuses]`);
+    if (sub === 'mention') {
+        const groupId = requireGroupId();
+        if (args[3])
+            assertEcSingleLine(args[3], '<mode>');
+        const values = collectPositional(args, 3);
+        if (values.length > 1) {
+            console.error('用法: ec group mention <from> <group-id> [<mention-only|disabled|auto>] [--clear]');
+            process.exit(1);
+        }
+        const mode = values[0];
+        const clear = args.includes('--clear');
+        if (mode !== undefined && clear) {
+            console.error('❌ <mode> 与 --clear 互斥');
+            process.exit(1);
+        }
+        if (mode !== undefined && !['mention-only', 'disabled', 'auto'].includes(mode)) {
+            console.error(`❌ 无效提及模式: ${mode}（可选 mention-only|disabled|auto）`);
+            process.exit(1);
+        }
+        const operationArgs = ['mention', from, groupId, ...(mode ? [mode] : []), ...(clear ? ['--clear'] : [])];
+        const { resolveManagedGroupOperation, executeManagedGroupOperation } = await import('../aun/msg/managed-operation.js');
+        const parsed = resolveManagedGroupOperation(operationArgs);
+        if (!parsed.ok)
+            failManagedGroup(formatJson, parsed.code, parsed.reason);
+        try {
+            const result = await executeManagedGroupOperation(parsed.command);
+            renderManagedGroupResult(operationArgs, result, formatJson);
+        }
+        catch (error) {
+            if (error instanceof ManagedGroupOperationError) {
+                failManagedGroup(formatJson, error.code, error.message);
+            }
+            throw error;
+        }
+        return;
+    }
+    console.error(`未知子命令: ${sub}\n用法: ec group [send|pull|ack|history|create|list|info|update|dissolve|suspend|resume|rules|mention|join|leave|invite|invites|accept-invite|reject-invite|revoke-invite|kick|members|online|role|owner|ban|unban|block|unblock|blocklist|report-status|member-statuses]`);
     process.exit(1);
 }
 // ==================== Main ====================
@@ -2625,7 +2699,7 @@ const VALUE_FLAGS = new Set([
     '--aun-path', '--thread', '--return', '--handoff-context',
 ]);
 const BOOLEAN_FLAGS = new Set([
-    '--encrypt', '--no-encrypt', '--mention-all',
+    '--encrypt', '--no-encrypt', '--mention-all', '--clear',
 ]);
 function collectPositional(args, startIdx, extraValueFlags) {
     const out = [];

package/dist/cli/cli-argv.js

@@ -1,8 +1,34 @@
+import { decodeEvolcoreInlineText } from '../core/permission/ec-command-parser.js';
 export function normalizeCliArgv(argv) {
     if (argv[0] === 'ec' && argv[1])
         return argv.slice(1);
     return argv;
 }
+export function decodeEcInlineText(value) {
+    return decodeEvolcoreInlineText(value);
+}
+export function decodeEcInlineOptions(args, flags) {
+    const decoded = [...args];
+    for (let index = 0; index < decoded.length; index++) {
+        const flag = decoded[index];
+        if (flag === '--')
+            break;
+        if (flags.has(flag) && decoded[index + 1] !== undefined) {
+            decoded[++index] = decodeEcInlineText(decoded[index]);
+            continue;
+        }
+        const separator = flag.indexOf('=');
+        if (separator > 0 && flags.has(flag.slice(0, separator))) {
+            decoded[index] = flag.slice(0, separator + 1) + decodeEcInlineText(flag.slice(separator + 1));
+        }
+    }
+    return decoded;
+}
+export function assertEcSingleLine(value, field) {
+    if (value !== undefined && /[\x00-\x1f\x7f]/.test(value)) {
+        throw new Error(`${field} 不允许换行或控制字符`);
+    }
+}
 export function splitConfigBatchGetArgv(inputArgv) {
     const argv = normalizeCliArgv(inputArgv);
     if (argv[0] !== 'config' || argv[1] !== 'get')

package/dist/cli/daemon-commands.js

@@ -291,18 +291,14 @@ async function launchPackageLifecycle(source, log, options = {}) {
         platform.cleanupMonitorStage(launch.stageDir);
     return { ok: result.ok, ...(!result.ok ? { reason: result.reason } : {}) };
 }
-function requireCompletedDataMigration(root, action = 'start') {
+function requireCompletedDataMigration(root) {
     const requirement = inspectDataMigrationRequirement(root);
     if (!requirement.required)
         return true;
-    console.error(action === 'restart'
-        ? `❌ 检测到 ${requirement.operationCount} 项待确认的用户数据迁移，本次不停止当前服务。`
-        : `❌ 检测到 ${requirement.operationCount} 项待确认的用户数据迁移，服务未启动。`);
+    console.error(`❌ 检测到 ${requirement.operationCount} 项待确认的用户数据迁移，服务未启动。`);
     console.error('  先执行: ec data migrate --dry-run');
     console.error('  确认后: ec data migrate --apply');
-    console.error('  迁移成功并校验后，再执行 ec start 或 ec restart。');
-    if (action === 'restart')
-        console.error('  本次 ec restart 仅完成只读检查，未停止当前服务。');
+    console.error('  迁移成功并校验后，再执行 ec start。');
     process.exitCode = 2;
     return false;
 }
@@ -925,9 +921,8 @@ export async function cmdRestart(opts = {}) {
     }
     // The shared launchPackageLifecycle path delegates to launchMonitorAndConfirm;
     // the monitor retains shutdown, orphan checks, build and rollback ownership.
-    // Network preflight must finish before a confirmed monitor stops the daemon.
-    if (!requireCompletedDataMigration(resolveRoot(), 'restart'))
-        return;
+    // restart-monitor performs the read-only preflight before stopping the
+    // current daemon, then applies the migration during the stopped window.
     const launched = await launchPackageLifecycle('restart', console.log, { clear: opts.clear });
     if (!launched.ok) {
         console.error(`❌ 重启中止：restart-monitor 未能启动（${launched.reason}）；当前服务未主动停止`);
@@ -1809,6 +1804,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: 'diag', label: 'diag', desc: 'message lifecycle diagnostics (AUN→queue→task)' },
         { key: 'web', label: 'web', desc: 'browser dashboard (aid/msg/session)' },
     ];
     let index = 0;
@@ -1873,6 +1869,10 @@ async function cmdWatchMenu() {
                     const { cmdWatchMsg } = await import('./watch-msg.js');
                     await cmdWatchMsg();
                 }
+                else if (chosen === 'diag') {
+                    const { cmdWatchMsgDiag } = await import('./watch-msg-diag.js');
+                    await cmdWatchMsgDiag([]);
+                }
                 else if (chosen === 'web') {
                     await cmdWatchWeb();
                 }
@@ -3295,6 +3295,36 @@ export async function cmdWatchCommand(args) {
         const { cmdWatchMsg } = await import('./watch-msg.js');
         await cmdWatchMsg();
     }
+    else if (args[0] === 'diag' || args[0] === 'msg-diag') {
+        if (isHelpFlag(args[1])) {
+            console.log(`用法: ec watch diag
+
+实时诊断消息生命周期，从 AUN SDK 入站到 daemon 处理全过程。
+
+显示内容:
+  ✓ AUN入站      消息到达 AUN SDK
+  → 队列入队     消息进入 daemon 队列
+  ⚡ 任务创建     daemon 创建处理任务
+  ✓ 任务完成     任务处理完成
+  ← AUN出站      回复消息发送
+
+每条消息显示:
+  - 时间戳（精确到毫秒）
+  - 阶段标识
+  - AID（前12字符）
+  - 消息ID
+  - 内容预览（前50字符）
+
+用途:
+  排查消息丢失、处理延迟、队列阻塞等问题
+
+操作:
+  Ctrl+C         退出`);
+            return;
+        }
+        const { cmdWatchMsgDiag } = await import('./watch-msg-diag.js');
+        await cmdWatchMsgDiag(args.slice(1));
+    }
     else if (args[0] === 'log' || args[0] === 'logs') {
         const requested = args.slice(1);
         if (requested.length > 0) {