evolcore 0.0.21 → 0.0.22

package/dist/aun/outbox.js

@@ -215,6 +215,13 @@ export function findByDedupeKey(aid, dedupeKey, opts = {}, queue = 'default') {
         : load(aid, queue);
     return entries.find(entry => entry.dedupeKey === dedupeKey);
 }
+/** Find all durable entries belonging to an operation family. */
+export function findByDedupePrefix(aid, dedupePrefix, opts = {}, queue = 'default') {
+    const entries = opts.includeTerminal
+        ? readEntries(aid, queue).filter(entry => !isExpired(entry))
+        : load(aid, queue);
+    return entries.filter(entry => typeof entry.dedupeKey === 'string' && entry.dedupeKey.startsWith(dedupePrefix));
+}
 export function cleanup(aid, queue = 'default') {
     const all = readEntries(aid, queue);
     let expired = 0;

package/dist/channels/aun.js

@@ -34,7 +34,8 @@ import { deriveCausation, normalizeCausation } from '../core/causation/context.j
 import { recordCausationSpan } from '../core/causation/audit.js';
 import { refreshAgentDisplayName, resolveAgentDisplayName } from '../aun/aid/agentmd.js';
 import { readInstalledEvolcoreVersion } from '../utils/evolcore-version.js';
-import { bindPostBootstrapWelcomeOutboxSession, hasPendingPostBootstrapWelcomeOutbox, bootstrapInitialMessageOperationId, postBootstrapWelcomeOperationId, preparePostBootstrapWelcomeOutbox, } from '../core/bootstrap-messages.js';
+import { toolInputForDisplay } from '../utils/tool-summary.js';
+import { bindPostBootstrapWelcomeOutboxSession, hasPendingPostBootstrapWelcomeOutbox, bootstrapInitialMessageOperationPrefix, postBootstrapWelcomeOperationId, preparePostBootstrapWelcomeOutbox, } from '../core/bootstrap-messages.js';
 import { hasMentionAll, mentionEntryAids, mentionEntryTargets, } from '../core/message/mention-schema.js';
 import { normalizeAunMentionEntries, } from '../aun/msg/mention-schema.js';
 import { isDeliveryTarget, sameDeliveryTarget } from '../core/message/message-utils.js';
@@ -45,6 +46,9 @@ const AUN_INBOUND_DEDUP_TTL_MS = 7 * 24 * 60 * 60 * 1000;
 const IMAGE_MIME_TYPE = /^image\/[!#$%&'*+.^_`|~0-9A-Za-z-]+$/i;
 const AUN_ATTACHMENT_DOWNLOAD_ATTEMPTS = 3;
 const AUN_ATTACHMENT_RETRY_DELAYS_MS = [250, 750];
+const OBSERVER_GROUP_MEMBERS_TTL_MS = 60_000;
+const OBSERVER_GROUP_MEMBERS_PAGE_SIZE = 200;
+const OBSERVER_GROUP_MEMBERS_MAX_PAGES = 100;
 const AUN_SEND_LOG_TEXT_MAX_LENGTH = 60;
 export function formatAunSendLogText(text) {
     return text.replace(/\s+/gu, ' ').trim().slice(0, AUN_SEND_LOG_TEXT_MAX_LENGTH);
@@ -1062,6 +1066,18 @@ export class AUNChannel {
             .replace(/[ \t]+/g, ' ')
             .trim();
     }
+    /** Normalize a command after a client-rendered friendly mention label. */
+    normalizeSlashCommandText(text) {
+        const trimmed = text.trim();
+        const leadingLabels = trimmed.match(/^(?:@[^\s]+\s+)+(?=\/)/u);
+        const commandText = leadingLabels
+            ? trimmed.slice(leadingLabels[0].length).trimStart()
+            : trimmed;
+        // Keep the command contract consistent for mixed friendly/canonical @
+        // tokens: selector labels are removed above, then known AID-shaped tokens
+        // anywhere in the command are removed by the existing helper.
+        return this.stripAllMentions(commandText);
+    }
     parsePayloadMentionsOrReject(payload, context, messageId, seq) {
         const raw = payload && typeof payload === 'object' && !Array.isArray(payload)
             ? payload.mentions
@@ -1277,6 +1293,8 @@ export class AUNChannel {
     /** 撤权可能先于 outbox 卡片投递完成；迟到卡片注册后立即撤回。 */
     invalidatedInteractions = new Map();
     mentionModeResolver;
+    /** Agent-level policy controlling whether group slash commands require structured mentions. */
+    groupSlashRequireMentionsResolver;
     static PROACTIVE_ALLOW_TYPES = new Set([
         'text', 'quote', 'image', 'video', 'voice', 'file', 'json',
         'merge', 'link', 'location', 'personal_card',
@@ -1401,6 +1419,14 @@ export class AUNChannel {
         }
     }
     async _initClientInner() {
+        this.observerGroupMembers.clear();
+        for (const groupId of new Set([
+            ...this.observerGroupMembershipEpoch.keys(),
+            ...this.observerGroupMemberFetches.keys(),
+        ])) {
+            this.observerGroupMembershipEpoch.set(groupId, (this.observerGroupMembershipEpoch.get(groupId) ?? 0) + 1);
+        }
+        this.observerGroupMemberFetches.clear();
         // Clean up existing client if any
         if (this.client) {
             this.trace('OUT', 'client.close', { reason: 'initClient' });
@@ -1469,6 +1495,15 @@ export class AUNChannel {
                 logger.debug(`${this.logPrefix()}[DIAG] group.message_created: group_id=${gid} sender=${sender}`);
                 this.handleIncomingGroupMessage(data);
             });
+            client.on('group.changed', (data) => {
+                if (!isCurrentClient())
+                    return;
+                const record = data && typeof data === 'object' ? data : {};
+                const envelope = record.envelope && typeof record.envelope === 'object'
+                    ? record.envelope
+                    : {};
+                this.invalidateObserverGroupMembers(envelope.group_id ?? record.group_id);
+            });
         }
         const handleSdkState = (source) => (data) => {
             if (!isCurrentClient())
@@ -2034,7 +2069,7 @@ export class AUNChannel {
         // 显式排除 observer.inject：它是 owner 对本 agent 的控制消息，不应镜像给观察者
         // （即便日后 from-owner 排除规则调整，也不会泄漏）。
         if (inboundType !== AUNChannel.INJECT_REQUEST_TYPE) {
-            this.forwardInbound(msg);
+            void this.forwardInbound(msg);
         }
         // 回声过滤：自己发出的消息会被 gateway fanout 回来，
         // 只有 from_aid == self 且 chat_id 不匹配时才丢弃（说明是其它实例发的）
@@ -2205,7 +2240,7 @@ export class AUNChannel {
         }
         // Observer forward (inbound)：群聊消息在所有过滤之前转发原始明文 payload。
         // forwardInbound 内部排除 self-echo 与 from-owner。
-        this.forwardInbound(msg);
+        void this.forwardInbound(msg);
         logger.debug(`${this.logPrefix()}[DIAG-GRP] full_msg=${JSON.stringify(msg).substring(0, 500)}`);
         if (!groupId || !senderAid) {
             this.acknowledgeImmediately(messageId, seq);
@@ -2316,9 +2351,13 @@ export class AUNChannel {
         const firstLineGroup = text.split('\n')[0] || '';
         const hasEvolCoreTraceGroup = /\[EvolCore\.(receive|reply|agent)\]/.test(text);
         const isEchoMsg = /echo/i.test(firstLineGroup) && !hasEvolCoreTraceGroup;
+        const slashCommandText = this.normalizeSlashCommandText(text);
         // 命令判定：剥离所有 @ 后看是否 / 开头（多 @ 场景如 @a @b /status 也能正确识别）。
         // echo 消息走独立的 trace 流程，不参与命令语义判定。
-        const isCommandMsg = !isEchoMsg && this.stripAllMentions(text).startsWith('/');
+        const isCommandMsg = !isEchoMsg && slashCommandText.startsWith('/');
+        const groupSlashRequireMentions = this.groupSlashRequireMentionsResolver
+            ? await this.groupSlashRequireMentionsResolver().catch(() => undefined) ?? true
+            : true;
         if (isEchoMsg) {
             // 短 echo（≤10 字符）已在前面的快速通道命中并 return，这里只处理长 echo
             // >10 字符：追加 trace,存 pending echo,跳过 mention 过滤继续走 Agent 流程
@@ -2345,9 +2384,10 @@ export class AUNChannel {
         }
         else {
             // 非 echo 消息：mention 标记（不再过滤，交给响应模式决定）
-            // slash 命令在任何 mentionMode 下都强制走 mention-only 语义
-            // 即必须 @ 本 agent（或 @all）才处理，避免广播群里一条命令被全部 agent 各自执行。
-            const enforceMention = mentionMode === 'mention-only' || isCommandMsg;
+            // slash 命令默认要求结构化 @；Agent 可通过
+            // groupSlashRequireMentions=false 选择仅按正文命令格式处理。
+            const enforceMention = (mentionMode === 'mention-only' && !isCommandMsg)
+                || (isCommandMsg && groupSlashRequireMentions);
             const isMentioned = mentionedSelf || mentionedAll;
             // 过滤逻辑下移到响应层：这里只标记，不过滤
             // 但为了保持现有行为兼容（避免大量未 @ 消息涌入），暂时保留过滤
@@ -2355,14 +2395,14 @@ export class AUNChannel {
             if (enforceMention && !isMentioned && !isOwnHandoff) {
                 this.acknowledgeImmediately(messageId, seq);
                 this.appendInboundPayloadJsonl(groupId, senderAid, messageId, msgEncrypted, true, logDescriptor, threadId, receivedAt, seq);
-                logger.info(`${this.logPrefix()} Group dropped: unmentioned (group=${groupId} sender=${senderAid} mid=${messageId} mentionMode=${mentionMode} isCommand=${isCommandMsg} textPreview=${JSON.stringify(text.slice(0, 80))})`);
+                logger.info(`${this.logPrefix()} Group dropped: unmentioned (group=${groupId} sender=${senderAid} mid=${messageId} mentionMode=${mentionMode} slashRequireMentions=${groupSlashRequireMentions} isCommand=${isCommandMsg} textPreview=${JSON.stringify(text.slice(0, 80))})`);
                 return;
             }
         }
         // 命令消息：剥离所有 @（多 agent 被 @ 时各自拿到干净的 /status 各自执行）；
         // 普通消息：仅在唯一 @ 是自己时剥离，保留其他 @ 供 agent 感知。
         const strippedText = isCommandMsg
-            ? this.stripAllMentions(text)
+            ? slashCommandText
             : this.stripSelfMentionIfOnly(text, this._aid);
         // Detect attachments before the empty-text guard (顶层 + 嵌套)
         const rawAttachments = this.collectAllAttachments(payload);
@@ -2393,7 +2433,7 @@ export class AUNChannel {
                 : mentionedSelf
                     ? (structMentionSelf ? 'mention.self(struct)' : 'mention.self(text)')
                     : `${mentionMode}.no-mention`;
-        logger.info(`${this.logPrefix()} Group mention decision: mid=${messageId} group=${groupId} sender=${shortAid}(${displayName}) peerType=${peerIdentity.type} payloadType=${payloadType} mentionMode=${mentionMode} reason=${reason} structMentions=${JSON.stringify(payloadMentionEntries)} textMentionSelf=${textMentionSelf} textMentionAll=${textMentionAll} structMentionSelf=${structMentionSelf} structMentionAll=${structMentionAll} encrypt=${msgEncrypted} textPreview=${JSON.stringify(text.slice(0, 80))}`);
+        logger.info(`${this.logPrefix()} Group mention decision: mid=${messageId} group=${groupId} sender=${shortAid}(${displayName}) peerType=${peerIdentity.type} payloadType=${payloadType} mentionMode=${mentionMode} slashRequireMentions=${groupSlashRequireMentions} reason=${reason} structMentions=${JSON.stringify(payloadMentionEntries)} textMentionSelf=${textMentionSelf} textMentionAll=${textMentionAll} structMentionSelf=${structMentionSelf} structMentionAll=${structMentionAll} encrypt=${msgEncrypted} textPreview=${JSON.stringify(text.slice(0, 80))}`);
         // action_card_reply 已在 extractTextPayload 中消费，不分发给 agent
         if (payloadType === 'action_card_reply')
             return;
@@ -2564,6 +2604,9 @@ export class AUNChannel {
     // observable / owners 不在此处缓存——由 daemon 注入 resolver，从 EvolAgent 的
     // in-memory merged config（启动/重启/热重载时统一更新的唯一缓存）读取，避免重复缓存。
     observerConfigResolver;
+    observerGroupMembers = new Map();
+    observerGroupMemberFetches = new Map();
+    observerGroupMembershipEpoch = new Map();
     /** 注入观察者配置读取器（daemon 侧从 EvolAgent merged config 读）。 */
     setObserverConfigResolver(fn) {
         this.observerConfigResolver = fn;
@@ -2582,23 +2625,129 @@ export class AUNChannel {
      * data 为 SDK message.received / group.message_created 回调的整个对象，
      * 不拆解、不重组——SDK 信封结构变化不影响此处。
      */
+    async resolveObserverGroupMembers(groupId) {
+        if (!groupId || !this.client)
+            return undefined;
+        const cached = this.observerGroupMembers.get(groupId);
+        if (cached && cached.expiresAt > Date.now())
+            return cached.aids;
+        const pending = this.observerGroupMemberFetches.get(groupId);
+        if (pending)
+            return pending;
+        const epoch = this.observerGroupMembershipEpoch.get(groupId) ?? 0;
+        let request;
+        request = (async () => {
+            try {
+                const result = await this.callAndTrace('group.get_members', {
+                    group_id: groupId,
+                    page: 1,
+                    size: OBSERVER_GROUP_MEMBERS_PAGE_SIZE,
+                });
+                const rawMembers = Array.isArray(result?.members)
+                    ? result.members
+                    : Array.isArray(result?.items) ? result.items : undefined;
+                if (!rawMembers)
+                    return undefined;
+                const hasTotal = Number.isFinite(Number(result?.total));
+                const hasMore = result?.has_more === true || result?.hasMore === true;
+                if (!hasTotal && (hasMore || rawMembers.length >= OBSERVER_GROUP_MEMBERS_PAGE_SIZE))
+                    return undefined;
+                const allMembers = [...rawMembers];
+                const total = Number(result?.total);
+                const pageSize = Number(result?.size) > 0 ? Number(result.size) : OBSERVER_GROUP_MEMBERS_PAGE_SIZE;
+                const pageCount = Number.isFinite(total) && total > allMembers.length
+                    ? Math.ceil(total / pageSize)
+                    : 1;
+                if (pageCount > OBSERVER_GROUP_MEMBERS_MAX_PAGES)
+                    return undefined;
+                for (let page = 2; page <= pageCount; page++) {
+                    const next = await this.callAndTrace('group.get_members', {
+                        group_id: groupId,
+                        page,
+                        size: OBSERVER_GROUP_MEMBERS_PAGE_SIZE,
+                    });
+                    const nextMembers = Array.isArray(next?.members)
+                        ? next.members
+                        : Array.isArray(next?.items) ? next.items : undefined;
+                    if (!nextMembers)
+                        return undefined;
+                    allMembers.push(...nextMembers);
+                }
+                if (hasTotal && total > allMembers.length)
+                    return undefined;
+                const aids = new Set();
+                for (const member of allMembers) {
+                    const aid = typeof member === 'string'
+                        ? member.trim()
+                        : typeof member?.aid === 'string' ? member.aid.trim()
+                            : typeof member?.member_aid === 'string' ? member.member_aid.trim() : '';
+                    if (aid)
+                        aids.add(aid);
+                }
+                if ((this.observerGroupMembershipEpoch.get(groupId) ?? 0) === epoch) {
+                    this.observerGroupMembers.set(groupId, { aids, expiresAt: Date.now() + OBSERVER_GROUP_MEMBERS_TTL_MS });
+                }
+                return aids;
+            }
+            catch (error) {
+                logger.debug(`${this.logPrefix()} observer group membership lookup failed group=${groupId}: ${error}`);
+                return undefined;
+            }
+            finally {
+                if (this.observerGroupMemberFetches.get(groupId) === request) {
+                    this.observerGroupMemberFetches.delete(groupId);
+                }
+            }
+        })();
+        this.observerGroupMemberFetches.set(groupId, request);
+        return request;
+    }
+    invalidateObserverGroupMembers(groupId) {
+        if (typeof groupId !== 'string' || !groupId.trim())
+            return;
+        const key = groupId.trim();
+        this.observerGroupMembers.delete(key);
+        this.observerGroupMembershipEpoch.set(key, (this.observerGroupMembershipEpoch.get(key) ?? 0) + 1);
+    }
+    async observerRecipients(owners, envelope) {
+        if (owners.length === 0)
+            return owners;
+        const groupId = typeof envelope.group_id === 'string' ? envelope.group_id.trim() : '';
+        const members = groupId ? await this.resolveObserverGroupMembers(groupId) : undefined;
+        // Unknown membership is fail-open for observation: only an explicit member
+        // response may suppress the redundant owner DM.
+        return owners.filter(owner => !(members?.has(owner)));
+    }
     forwardInbound(data) {
         if (!this.connected || !this.client)
-            return;
+            return Promise.resolve();
         if (payloadTypeForObserver(data)?.startsWith('menu.'))
-            return;
+            return Promise.resolve();
         const { observable, owners } = this.getObserverConfig();
         if (!observable || owners.length === 0)
-            return;
-        const env = (data?.envelope && typeof data.envelope === 'object') ? data.envelope : {};
+            return Promise.resolve();
+        const env = (data?.envelope && typeof data.envelope === 'object')
+            ? { ...data.envelope }
+            : {};
+        if (!env.group_id && typeof data.group_id === 'string')
+            env.group_id = data.group_id;
         const from = env.from ?? '';
         if (this._aid && from === this._aid)
-            return; // self-echo：已在出站转过
+            return Promise.resolve(); // self-echo：已在出站转过
         // 排除来源 owner（不把"owner A 发来的"再转回 A），但仍转给其他 owner。
-        const recipientOwners = owners.filter(o => o !== from);
-        if (recipientOwners.length === 0)
-            return;
-        this.emitForward('inbound', data, recipientOwners);
+        const candidateOwners = owners.filter(o => o !== from);
+        if (candidateOwners.length === 0)
+            return Promise.resolve();
+        if (typeof env.group_id !== 'string' || !env.group_id.trim()) {
+            this.emitForward('inbound', data, candidateOwners);
+            return Promise.resolve();
+        }
+        return this.observerRecipients(candidateOwners, env)
+            .then(recipientOwners => {
+            if (recipientOwners.length > 0)
+                this.emitForward('inbound', data, recipientOwners);
+        })
+            .catch(error => logger.debug(`${this.logPrefix()} observer inbound recipient lookup failed: ${error}`));
     }
     /**
      * 出站转发：Agent 经 AUN 真实发出的消息原样转发给 owner。
@@ -2607,20 +2756,33 @@ export class AUNChannel {
      */
     forwardOutbound(result) {
         if (!this.connected || !this.client)
-            return;
+            return Promise.resolve();
         if (payloadTypeForObserver(result)?.startsWith('menu.'))
-            return;
+            return Promise.resolve();
         const { observable, owners } = this.getObserverConfig();
         if (!observable || owners.length === 0)
-            return;
-        const env = (result?.envelope && typeof result.envelope === 'object') ? result.envelope : {};
+            return Promise.resolve();
+        const env = (result?.envelope && typeof result.envelope === 'object')
+            ? { ...result.envelope }
+            : {};
+        if (!env.group_id && typeof result.group_id === 'string')
+            env.group_id = result.group_id;
         const to = env.to ?? env.group_id ?? '';
         // 过滤：若对端本身是 owner，不转发给该 owner（避免"回复你"转给你自己）；
         // 但仍转发给其他 owner。
-        const recipientOwners = owners.filter(o => o !== to);
-        if (recipientOwners.length === 0)
-            return;
-        this.emitForward('outbound', result, recipientOwners);
+        const candidateOwners = owners.filter(o => o !== to);
+        if (candidateOwners.length === 0)
+            return Promise.resolve();
+        if (typeof env.group_id !== 'string' || !env.group_id.trim()) {
+            this.emitForward('outbound', result, candidateOwners);
+            return Promise.resolve();
+        }
+        return this.observerRecipients(candidateOwners, env)
+            .then(recipientOwners => {
+            if (recipientOwners.length > 0)
+                this.emitForward('outbound', result, recipientOwners);
+        })
+            .catch(error => logger.debug(`${this.logPrefix()} observer outbound recipient lookup failed: ${error}`));
     }
     /**
      * 实际投递 observer.forward 给每个 owner，使用 daemon 的全局 AUN 默认加密设置。
@@ -3104,6 +3266,9 @@ export class AUNChannel {
     setMentionModeResolver(resolver) {
         this.mentionModeResolver = resolver;
     }
+    setGroupSlashRequireMentionsResolver(resolver) {
+        this.groupSlashRequireMentionsResolver = resolver;
+    }
     onRecall(handler) {
         this.recallHandler = handler;
     }
@@ -3711,9 +3876,15 @@ export class AUNChannel {
         return truncated;
     }
     buildActivityPayload(envelope, context, item) {
-        const activityItem = item && typeof item === 'object' && !Array.isArray(item)
+        const rawItem = item && typeof item === 'object' && !Array.isArray(item)
             ? { ...item }
             : { kind: 'unknown', text: String(item ?? '') };
+        const displayArguments = rawItem.kind === 'tool_call'
+            ? toolInputForDisplay(rawItem.name, rawItem.arguments)
+            : undefined;
+        const activityItem = rawItem.kind === 'tool_call' && displayArguments !== rawItem.arguments
+            ? { ...rawItem, arguments: displayArguments }
+            : rawItem;
         return {
             ...this.buildTaskPayloadBase(envelope, context),
             type: 'activity',
@@ -5119,13 +5290,11 @@ export class AUNChannel {
         const owner = getFirstStaticAgentOwner(aid);
         if (!owner)
             return;
-        const operationIds = new Set([
-            bootstrapInitialMessageOperationId(aid),
-            postBootstrapWelcomeOperationId(aid),
-        ]);
-        const entries = [...operationIds]
-            .map(operationId => outbox.findByDedupeKey(aid, operationId, { includeTerminal: true }))
-            .filter((entry) => !!entry?.channelId);
+        const completionEntry = outbox.findByDedupeKey(aid, postBootstrapWelcomeOperationId(aid), { includeTerminal: true });
+        const entries = [
+            ...outbox.findByDedupePrefix(aid, bootstrapInitialMessageOperationPrefix(aid), { includeTerminal: true }),
+            ...(completionEntry ? [completionEntry] : []),
+        ].filter((entry) => !!entry?.channelId);
         for (const entry of entries) {
             const delivery = { chatType: 'private' };
             const nestedDelivery = entry.context?.delivery;
@@ -5915,6 +6084,11 @@ export class AUNChannelPlugin {
                         }, { cache: true }).mentionMode;
                     });
                 }
+                if (typeof channel.setGroupSlashRequireMentionsResolver === 'function') {
+                    channel.setGroupSlashRequireMentionsResolver(async () => {
+                        return resolveEffective({ self: aid }, { cache: true }).groupSlashRequireMentions ?? true;
+                    });
+                }
             },
         };
     }

package/dist/cli/daemon-commands.js

@@ -174,14 +174,35 @@ function sourceBuildNeedsRefresh() {
     const sourceMtime = Math.max(latestSourceMtime(path.join(packageRoot, 'src')), latestSourceMtime(path.join(packageRoot, 'ecagent', 'src')));
     return sourceMtime > fs.statSync(daemonEntry).mtimeMs;
 }
-function requireFreshSourceBuild() {
+function runSourceBuild() {
+    return new Promise(resolve => {
+        console.log('🔧 源码比 daemon 编译产物更新，自动重新构建...');
+        const child = spawn(platform.isWindows ? 'npm.cmd' : 'npm', ['run', 'build'], {
+            cwd: getPackageRoot(),
+            stdio: 'inherit',
+            shell: platform.isWindows,
+        });
+        child.on('error', err => {
+            console.error(`❌ 无法启动构建进程: ${err.message}`);
+            resolve(false);
+        });
+        child.on('exit', code => {
+            if (code === 0) {
+                console.log('✅ 构建完成');
+                resolve(true);
+            }
+            else {
+                console.error(`❌ 自动构建失败 (exit ${code})，服务未启动。`);
+                console.error('  请手动执行: npm run build 排查错误');
+                resolve(false);
+            }
+        });
+    });
+}
+async function requireFreshSourceBuild() {
     if (!sourceBuildNeedsRefresh())
         return true;
-    console.error('❌ 源码比 daemon 编译产物更新，服务未启动。');
-    console.error('  请先执行: ec stop && npm run build');
-    console.error('  然后执行: ec start');
-    process.exitCode = 2;
-    return false;
+    return await runSourceBuild();
 }
 function requireCompletedDataMigration(root) {
     const requirement = inspectDataMigrationRequirement(root);
@@ -306,7 +327,7 @@ export async function cmdStart(opts = {}) {
         return;
     }
     ensureDataDirs();
-    if (!requireFreshSourceBuild())
+    if (!await requireFreshSourceBuild())
         return;
     // 旧配置自动迁移（daemon.json → 新结构）
     const { autoMigrateIfNeeded } = await import('../config-store.js');
@@ -681,7 +702,7 @@ export async function cmdRestart(opts = {}) {
         if (initialRuntimeOrphans.length === 0 && rejectPidIsolatedLifecycle('restart', initialStatus, ping))
             return;
     }
-    if (!requireFreshSourceBuild())
+    if (!await requireFreshSourceBuild())
         return;
     // 版本检查与自动升级
     console.log('📦 Checking for updates...');

package/dist/cli/task-context.js

@@ -6,6 +6,7 @@ import os from 'node:os';
 import path from 'node:path';
 export const TASK_RUNTIME_CONTEXT_ENV = 'EVOLCORE_TASK_RUNTIME_CONTEXT';
 export const SESSION_RUNTIME_DIR_ENV = 'EVOLCORE_SESSION_RUNTIME_DIR';
+export const DAEMON_RUNTIME_EPOCH_ENV = 'EVOLCORE_DAEMON_RUNTIME_EPOCH';
 export { RUNTIME_LOCK_DIR_ENV };
 const generatedProcessManagedTempDirs = new Set();
 let processTempCleanupRegistered = false;
@@ -32,11 +33,13 @@ function normalizeTaskRuntimeContext(value) {
         peerName: optionalString(value.peerName),
         peerType: optionalString(value.peerType),
         peerRole: optionalString(value.peerRole),
+        permissionMode: optionalString(value.permissionMode),
         processRole: optionalProcessRole(value.processRole),
         dataScope: optionalDataScope(value.dataScope),
         authorizedBy: optionalString(value.authorizedBy),
         executionSource: value.executionSource === 'fullaccess-command' || value.executionSource === 'trigger'
             ? value.executionSource : undefined,
+        daemonRuntimeEpoch: optionalString(value.daemonRuntimeEpoch),
         threadId: optionalString(value.threadId),
         sessionRuntimeDir: optionalAbsolutePath(value.sessionRuntimeDir),
         runtimeLockDir: optionalAbsolutePath(value.runtimeLockDir),
@@ -336,6 +339,7 @@ export function buildTaskRuntimeEnv(ctx) {
     const clean = normalizeTaskRuntimeContext(ctx);
     return {
         EVOLCORE_SESSION_ID: ctx.sessionId ?? '',
+        ...(ctx.daemonRuntimeEpoch ? { [DAEMON_RUNTIME_EPOCH_ENV]: ctx.daemonRuntimeEpoch } : {}),
         [TASK_RUNTIME_CONTEXT_ENV]: JSON.stringify(clean),
         // Every managed child receives the session directory as TMPDIR. This keeps
         // ordinary temporary files and runtime-only fallbacks out of shared agent

package/dist/cli/trigger-command.js

@@ -32,7 +32,7 @@ export async function cmdTrigger(args) {
         return;
     }
     if (process.env.EVOLCORE_SESSION_ID
-        && (hasOption(rest, '--file') || hasOption(rest, '--prompt-file') || hasOption(rest, '--script-path'))) {
+        && (hasOption(rest, '--file') || hasOption(rest, '--prompt-file') || hasOption(rest, '--script-path') || hasOption(rest, '--script-file'))) {
         throw new Error('Managed tasks cannot read trigger definitions, prompts, or scripts from local files; use inline prompt content');
     }
     try {
@@ -123,7 +123,7 @@ Create 参数模式支持:
 
 Update 仅支持常用字段:
   --once | --delay | --at | --cron | --every | --event [--tz]
-  --prompt <文本> | --prompt-file <路径>  --name <名称>
+  --prompt <文本> | --prompt-file <路径>  --script-file <路径>  --name <名称>
   --model <模型>  --effort <强度>  --permission <权限模式|inherit>（inherit 清除覆盖）
   --max-runs <次数>  --max-duration <时长>
   --concurrency <forbid|replace|allow>  --missed-policy <skip|run-once|run-all>
@@ -399,19 +399,28 @@ function shellQuoteArg(value) {
 }
 async function updateTrigger(args, json) {
     const agentAid = resolveAgentAid(args);
-    const triggerId = positional(args, 0, ['--agent', '--format', '--if-revision', '--prompt-file']);
+    const triggerId = positional(args, 0, ['--agent', '--format', '--if-revision', '--prompt-file', '--script-file']);
     const usesPromptFile = hasOption(args, '--prompt-file');
+    const usesScriptFile = hasOption(args, '--script-file');
+    const scriptFilePath = usesScriptFile ? requireFlag(args, '--script-file') : undefined;
     const { parseTriggerUpdateArgv } = await import('../trigger/parser.js');
     const parsed = parseTriggerUpdateArgv(triggerId, withPromptFromFile(triggerUpdateArgs(args)), { allowLongPrompt: usesPromptFile });
     if (!parsed.ok)
         throw new Error(parsed.error);
+    const scriptFileRequested = parsed.value.scriptFile !== undefined;
+    const { scriptFile: _scriptFile, ...patchFields } = parsed.value;
+    const patch = scriptFileRequested ? { ...patchFields, scriptFile: true } : patchFields;
     const expectedRevision = flagValue(args, '--if-revision');
+    const scriptFileBase64 = scriptFilePath
+        ? fs.readFileSync(scriptFilePath).toString('base64')
+        : undefined;
     const res = await request({
         type: 'trigger.update',
         agentAid,
         triggerId,
-        patch: parsed.value,
+        patch,
         ...(usesPromptFile ? { promptFile: true } : {}),
+        ...(scriptFileBase64 !== undefined ? { scriptFileBase64 } : {}),
         ...(expectedRevision ? { expectedRevision } : {}),
     }, 30_000);
     if (json)

package/dist/config/config-field-policy.js

@@ -2,6 +2,7 @@ const BEHAVIOR_TOP_FIELDS = new Set([
     'active_baseagent',
     'chatmode',
     'mentionMode',
+    'groupSlashRequireMentions',
     'responseMode',
     'responseModeParams',
     'flush_delay',
@@ -110,6 +111,8 @@ export function resolveConfigFieldRule(fieldPath) {
         return scalar(field, 'nonnegative-number');
     if (field === 'mentionMode')
         return scalar(field, 'mention-mode');
+    if (field === 'groupSlashRequireMentions')
+        return scalar(field, 'boolean');
     if (field === 'show_activities')
         return scalar(field, 'show-activities');
     if (field === 'enable_rich_content')

package/dist/config/config-manager.js

@@ -933,7 +933,10 @@ function acquireConfigMutationLock(file) {
                 return () => releaseConfigMutationLock(lockDir, ownerFile, token);
             }
             catch (error) {
-                if (error?.code !== 'EEXIST' && error?.code !== 'ENOTEMPTY')
+                const lockMayAlreadyExist = error?.code === 'EEXIST'
+                    || error?.code === 'ENOTEMPTY'
+                    || (process.platform === 'win32' && error?.code === 'EPERM' && fs.existsSync(lockDir));
+                if (!lockMayAlreadyExist)
                     throw error;
                 if (reclaimStaleConfigMutationLock(lockDir, ownerFile))
                     continue;
@@ -957,10 +960,10 @@ function reclaimStaleConfigMutationLock(lockDir, ownerFile) {
         pid = Number(JSON.parse(raw).pid);
     }
     catch {
-        return false;
+        return reclaimCorruptConfigMutationLock(lockDir);
     }
     if (!Number.isInteger(pid) || pid <= 0)
-        return false;
+        return reclaimCorruptConfigMutationLock(lockDir);
     try {
         process.kill(pid, 0);
         return false;
@@ -979,6 +982,24 @@ function reclaimStaleConfigMutationLock(lockDir, ownerFile) {
         }
     }
 }
+function reclaimCorruptConfigMutationLock(lockDir) {
+    try {
+        const stat = fs.statSync(lockDir);
+        if (Date.now() - stat.mtimeMs < CONFIG_MUTATION_LOCK_WAIT_MS)
+            return false;
+        const reclaimed = `${lockDir}.reclaimed-corrupt-${crypto.randomBytes(8).toString('hex')}`;
+        fs.renameSync(lockDir, reclaimed);
+        fs.rmSync(reclaimed, { recursive: true, force: true });
+        return true;
+    }
+    catch (error) {
+        if (error?.code === 'ENOENT')
+            return true;
+        if (error?.code === 'EEXIST' || error?.code === 'ENOTEMPTY' || error?.code === 'EPERM')
+            return false;
+        throw error;
+    }
+}
 function releaseConfigMutationLock(lockDir, ownerFile, token) {
     try {
         const owner = JSON.parse(fs.readFileSync(ownerFile, 'utf8'));
@@ -1289,9 +1310,13 @@ function stripStaticOwnerField(config) {
         return config;
     if (!Object.prototype.hasOwnProperty.call(config, 'owners')
         && !Object.prototype.hasOwnProperty.call(config, 'admins')
-        && !Object.prototype.hasOwnProperty.call(config, 'access'))
+        && !Object.prototype.hasOwnProperty.call(config, 'access')
+        && !Object.prototype.hasOwnProperty.call(config, 'groupSlashRequireMentions'))
         return config;
-    const { owners: _owners, admins: _admins, access: _access, ...rest } = config;
+    // groupSlashRequireMentions is intentionally Agent-only. Relation/defaults
+    // files allow forward-compatible unknown properties, so strip it before the
+    // generic merge chain can treat a manually written value as an override.
+    const { owners: _owners, admins: _admins, access: _access, groupSlashRequireMentions: _groupSlashRequireMentions, ...rest } = config;
     return rest;
 }
 function stripRelationRoleData(config) {
@@ -1330,6 +1355,7 @@ export function resolveEffective(sel, opts = {}) {
         baseagents: config.baseagents,
         chatmode: config.chatmode,
         mentionMode: config.mentionMode,
+        groupSlashRequireMentions: config.groupSlashRequireMentions ?? true,
         model: config.model,
         responseMode: config.responseMode,
         responseModeParams: config.responseModeParams,
@@ -1361,6 +1387,7 @@ const EFFECTIVE_BEHAVIOR_FIELDS = [
     'baseagents',
     'chatmode',
     'mentionMode',
+    'groupSlashRequireMentions',
     'flush_delay',
     'debounce',
     'show_activities',