evolcore 0.0.3 → 0.0.5

package/dist/channels/wecom.js

@@ -1,13 +1,17 @@
 import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
 import { logger } from '../utils/logger.js';
 import { requireOptional } from '../utils/npm-ops.js';
 import { middleOutputModePolicy, resolveShowActivities, showActivitiesPolicy } from '../core/channel-loader.js';
 import { formatItemsAsText } from '../core/message/items-formatter.js';
+import { createSendFileMarkerPattern } from '../core/message/file-markers.js';
 import { initWelcomeManager, sendWelcomeIfNeeded } from '../utils/welcome.js';
 import { bufferToInboundImage, sanitizeFileName, saveToUploads, validateUrl } from '../utils/media-cache.js';
-import { PersistentWecomCardStore, PersistentWecomDeduper, createWecomCardTaskId, wecomChannelDataPaths, } from './wecom-state.js';
-import { buildWecomInteractionCard, buildWecomTerminalCard, buildWecomUnknownCard, parseWecomCardResponse, } from './wecom-card.js';
-import { ContactBindCodeRegistry, } from './contact-bind-code.js';
+import { agentDataDir } from '../paths.js';
+import { atomicReadJson, atomicWriteJson } from '../utils/atomic-write.js';
+import { ContactBindCodeRegistry, handleExplicitContactBindCommand, } from '../config/contact-bind-code.js';
 function wecomErrorCode(error) {
     if (!error || typeof error !== 'object')
         return undefined;
@@ -93,14 +97,384 @@ export function registerPendingWecomContactBind(req) {
     return wecomContactBinds.register(req);
 }
 export function handlePendingWecomContactBindMessage(ctx) {
-    return wecomContactBinds.handle(ctx);
+    return handleExplicitContactBindCommand(wecomContactBinds, ctx);
 }
-export function getPendingWecomContactBind(selfAid, channelName) {
-    return wecomContactBinds.get(selfAid, channelName);
+export function getPendingWecomContactBind(selfAid, channelName, primaryId) {
+    return wecomContactBinds.get(selfAid, channelName, primaryId);
 }
 export function clearPendingWecomContactBinds() {
     wecomContactBinds.clear();
 }
+// ── Persistent channel state ──────────────────────────────────────────────────
+const STORE_VERSION = 1;
+const DEFAULT_DEDUP_TTL_MS = 24 * 60 * 60 * 1000;
+const DEFAULT_CARD_RETENTION_MS = 24 * 60 * 60 * 1000;
+function writePrivateJson(filePath, value) {
+    atomicWriteJson(filePath, value);
+    try {
+        fs.chmodSync(filePath, 0o600);
+    }
+    catch { /* best effort on non-POSIX filesystems */ }
+}
+export class PersistentWecomDeduper {
+    filePath;
+    channelKey;
+    entries = new Map();
+    ttlMs;
+    maxEntries;
+    constructor(filePath, channelKey, opts) {
+        this.filePath = filePath;
+        this.channelKey = channelKey;
+        this.ttlMs = opts?.ttlMs ?? DEFAULT_DEDUP_TTL_MS;
+        this.maxEntries = opts?.maxEntries ?? 20_000;
+        this.load();
+    }
+    checkAndMark(messageId, now = Date.now()) {
+        this.evict(now);
+        const seenAt = this.entries.get(messageId);
+        if (seenAt !== undefined && now - seenAt <= this.ttlMs)
+            return true;
+        this.entries.set(messageId, now);
+        this.trimToLimit();
+        this.flush();
+        return false;
+    }
+    get size() {
+        return this.entries.size;
+    }
+    load() {
+        if (!this.filePath)
+            return;
+        try {
+            const stored = atomicReadJson(this.filePath);
+            if (!stored || stored.version !== STORE_VERSION || stored.channelKey !== this.channelKey)
+                return;
+            for (const [id, timestamp] of Object.entries(stored.entries ?? {})) {
+                if (id && Number.isFinite(timestamp))
+                    this.entries.set(id, timestamp);
+            }
+            const before = this.entries.size;
+            this.evict(Date.now());
+            this.trimToLimit();
+            if (this.entries.size !== before)
+                this.flush();
+        }
+        catch (error) {
+            logger.warn(`[WeCom] Ignoring unreadable dedup store for ${this.channelKey}: ${String(error)}`);
+            this.entries.clear();
+        }
+    }
+    evict(now) {
+        for (const [id, timestamp] of this.entries) {
+            if (now - timestamp > this.ttlMs)
+                this.entries.delete(id);
+        }
+    }
+    trimToLimit() {
+        if (this.entries.size <= this.maxEntries)
+            return;
+        const oldest = [...this.entries.entries()].sort((a, b) => a[1] - b[1]);
+        for (let i = 0; i < oldest.length - this.maxEntries; i++) {
+            this.entries.delete(oldest[i][0]);
+        }
+    }
+    flush() {
+        writePrivateJson(this.filePath, {
+            version: STORE_VERSION,
+            channelKey: this.channelKey,
+            entries: Object.fromEntries(this.entries),
+        });
+    }
+}
+export class PersistentWecomCardStore {
+    filePath;
+    channelKey;
+    records = new Map();
+    constructor(filePath, channelKey) {
+        this.filePath = filePath;
+        this.channelKey = channelKey;
+        if (filePath)
+            this.load();
+    }
+    set(record) {
+        this.records.set(record.taskId, record);
+        this.cleanup();
+        this.flush();
+    }
+    get(taskId) {
+        this.cleanup();
+        return this.records.get(taskId);
+    }
+    findByInteractionId(interactionId) {
+        this.cleanup();
+        return [...this.records.values()].find(record => record.interaction.id === interactionId);
+    }
+    listPendingByChat(chatId) {
+        this.cleanup();
+        return [...this.records.values()].filter(record => (record.chatId === chatId
+            && record.status === 'pending'
+            && (!record.expiresAt || record.expiresAt >= Date.now())));
+    }
+    resolve(taskId, action) {
+        const record = this.records.get(taskId);
+        if (!record)
+            return undefined;
+        record.status = 'resolved';
+        record.resolution = action;
+        record.updatedAt = Date.now();
+        this.flush();
+        return record;
+    }
+    invalidateByInteractionId(interactionId, reason) {
+        const record = this.findByInteractionId(interactionId);
+        if (!record || record.status === 'resolved')
+            return record;
+        record.status = 'invalidated';
+        record.invalidationReason = reason;
+        record.updatedAt = Date.now();
+        this.flush();
+        return record;
+    }
+    load() {
+        if (!this.filePath)
+            return;
+        try {
+            const stored = atomicReadJson(this.filePath);
+            if (!stored || stored.version !== STORE_VERSION || stored.channelKey !== this.channelKey)
+                return;
+            for (const record of stored.records ?? []) {
+                if (record?.taskId && record?.interaction?.id)
+                    this.records.set(record.taskId, record);
+            }
+            this.cleanup(true);
+        }
+        catch (error) {
+            logger.warn(`[WeCom] Ignoring unreadable card store for ${this.channelKey}: ${String(error)}`);
+            this.records.clear();
+        }
+    }
+    cleanup(flushWhenChanged = false) {
+        const now = Date.now();
+        let changed = false;
+        for (const [taskId, record] of this.records) {
+            const terminalExpiry = record.updatedAt + DEFAULT_CARD_RETENTION_MS;
+            const pendingExpiry = (record.expiresAt ?? record.createdAt + 7 * DEFAULT_CARD_RETENTION_MS)
+                + DEFAULT_CARD_RETENTION_MS;
+            const expiresAt = record.status === 'pending' ? pendingExpiry : terminalExpiry;
+            if (now > expiresAt) {
+                this.records.delete(taskId);
+                changed = true;
+            }
+        }
+        if (changed && flushWhenChanged)
+            this.flush();
+    }
+    flush() {
+        if (!this.filePath)
+            return;
+        writePrivateJson(this.filePath, {
+            version: STORE_VERSION,
+            channelKey: this.channelKey,
+            records: [...this.records.values()],
+        });
+    }
+}
+export function wecomChannelDataPaths(agentAid, channelKey) {
+    const safeKey = encodeURIComponent(channelKey);
+    const dir = path.join(agentDataDir(agentAid), 'channels', safeKey);
+    return {
+        dedupFile: path.join(dir, 'wecom-message-dedup.json'),
+        cardFile: path.join(dir, 'wecom-cards.json'),
+    };
+}
+export function createWecomCardTaskId(channelKey, interactionId) {
+    const hash = crypto.createHash('sha256').update(`${channelKey}\0${interactionId}`).digest('hex').slice(0, 32);
+    return `ec_${hash}`;
+}
+// ── Template cards ────────────────────────────────────────────────────────────
+function truncate(value, max) {
+    if (!value)
+        return undefined;
+    const chars = [...value.trim()];
+    return chars.length <= max ? value.trim() : `${chars.slice(0, Math.max(1, max - 1)).join('')}...`;
+}
+function buttonStyle(style) {
+    if (style === 'primary')
+        return 2;
+    if (style === 'danger')
+        return 3;
+    return 1;
+}
+export function buildWecomInteractionCard(interaction, taskId) {
+    const bodyParts = [];
+    if (interaction.kind.body)
+        bodyParts.push(interaction.kind.body);
+    if (interaction.kind.kind === 'action' && interaction.kind.checkers?.length) {
+        bodyParts.push(interaction.kind.checkers.map((item, index) => `${index + 1}. ${item.label}`).join('\n'));
+    }
+    return {
+        card_type: 'button_interaction',
+        task_id: taskId,
+        main_title: {
+            title: truncate(interaction.kind.title, 26),
+            desc: truncate(bodyParts.join('\n\n'), 120),
+        },
+        button_list: interaction.kind.buttons
+            .map((button, index) => ({ button, index }))
+            .filter(({ button }) => !('disabled' in button) || !button.disabled)
+            .slice(0, 6)
+            .map(({ button, index }) => ({
+            text: truncate(button.label, 10) || `选项 ${index + 1}`,
+            style: buttonStyle(button.style),
+            key: interaction.kind.kind === 'command-card' ? `cmd_${index}` : `act_${index}`,
+        })),
+    };
+}
+export function parseWecomCardResponse(record, event, operatorId) {
+    const eventKey = String(event.event_key ?? '').trim();
+    const match = /^(cmd|act)_(\d+)$/.exec(eventKey);
+    if (!match)
+        return null;
+    const index = Number(match[2]);
+    if (record.interaction.kind.kind === 'command-card') {
+        const button = record.interaction.kind.buttons[index];
+        if (!button || button.disabled)
+            return null;
+        return { command: button.command };
+    }
+    const button = record.interaction.kind.buttons[index];
+    if (!button)
+        return null;
+    const values = {};
+    const selectedItems = event.selected_items?.selected_item;
+    if (Array.isArray(selectedItems)) {
+        for (const selected of selectedItems) {
+            const questionKey = String(selected?.question_key ?? '').trim();
+            const optionIds = selected?.option_ids?.option_id;
+            if (questionKey && Array.isArray(optionIds))
+                values[questionKey] = optionIds.filter(Boolean);
+        }
+    }
+    return {
+        response: {
+            type: 'interaction.response',
+            id: record.interaction.id,
+            action: button.key,
+            values: Object.keys(values).length > 0 ? values : undefined,
+            operatorId,
+        },
+    };
+}
+export function buildWecomTerminalCard(record, status, detail) {
+    const statusText = status === 'resolved'
+        ? `已处理${detail ? `：${detail}` : ''}`
+        : status === 'rejected'
+            ? '仅卡片发起者可操作'
+            : status === 'unavailable'
+                ? '处理服务暂不可用，请重新发起'
+                : `卡片已失效${detail ? `：${detail}` : ''}`;
+    return {
+        card_type: 'text_notice',
+        task_id: record.taskId,
+        main_title: {
+            title: truncate(record.interaction.kind.title, 26),
+            desc: truncate(statusText, 120),
+        },
+        sub_title_text: truncate(record.interaction.kind.body, 120),
+    };
+}
+export function buildWecomUnknownCard(taskId) {
+    return {
+        card_type: 'text_notice',
+        task_id: taskId,
+        main_title: {
+            title: '卡片已失效',
+            desc: '本地状态不存在，请重新发起操作',
+        },
+    };
+}
+// ── QR onboarding ─────────────────────────────────────────────────────────────
+const WECOM_QR_GENERATE_URL = 'https://work.weixin.qq.com/ai/qc/generate';
+const WECOM_QR_QUERY_URL = 'https://work.weixin.qq.com/ai/qc/query_result';
+const WECOM_QR_PAGE_URL = 'https://work.weixin.qq.com/ai/qc/gen';
+function platformCode() {
+    if (os.platform() === 'darwin')
+        return 1;
+    if (os.platform() === 'win32')
+        return 2;
+    if (os.platform() === 'linux')
+        return 3;
+    return 0;
+}
+async function fetchJson(url, fetchImpl, signal) {
+    const timeoutSignal = AbortSignal.timeout(15_000);
+    const response = await fetchImpl(url, {
+        headers: { Accept: 'application/json' },
+        signal: signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal,
+    });
+    if (!response.ok)
+        throw new Error(`企微扫码服务请求失败: HTTP ${response.status}`);
+    return response.json();
+}
+export async function createWecomQrSession(fetchImpl = fetch) {
+    const url = new URL(WECOM_QR_GENERATE_URL);
+    url.searchParams.set('source', 'wecom-cli');
+    url.searchParams.set('plat', String(platformCode()));
+    const payload = await fetchJson(url, fetchImpl);
+    const scode = String(payload?.data?.scode ?? '').trim();
+    const authUrl = String(payload?.data?.auth_url ?? '').trim();
+    if (!scode || !authUrl)
+        throw new Error('企微扫码服务未返回 scode 或授权地址');
+    const browserUrl = new URL(WECOM_QR_PAGE_URL);
+    browserUrl.searchParams.set('source', 'wecom-cli');
+    browserUrl.searchParams.set('scode', scode);
+    return { scode, authUrl, browserUrl: browserUrl.toString() };
+}
+export async function pollWecomQrCredentials(scode, opts) {
+    const fetchImpl = opts?.fetchImpl ?? fetch;
+    const timeoutMs = opts?.timeoutMs ?? 5 * 60 * 1000;
+    const intervalMs = opts?.intervalMs ?? 3_000;
+    const deadline = Date.now() + timeoutMs;
+    const url = new URL(WECOM_QR_QUERY_URL);
+    url.searchParams.set('scode', scode);
+    let previousStatus = '';
+    while (Date.now() < deadline) {
+        if (opts?.signal?.aborted)
+            throw new Error('企微扫码已取消');
+        const payload = await fetchJson(url, fetchImpl, opts?.signal);
+        const status = String(payload?.data?.status ?? 'waiting');
+        if (status !== previousStatus) {
+            opts?.onStatus?.(status);
+            previousStatus = status;
+        }
+        if (status === 'success') {
+            const botId = String(payload?.data?.bot_info?.botid ?? '').trim();
+            const secret = String(payload?.data?.bot_info?.secret ?? '').trim();
+            if (!botId || !secret)
+                throw new Error('扫码成功，但企微未返回 Bot ID 或 Secret');
+            return { botId, secret };
+        }
+        if (status === 'expired' || status === 'cancelled' || status === 'rejected') {
+            throw new Error(`企微扫码未完成: ${status}`);
+        }
+        await new Promise((resolve, reject) => {
+            const finish = () => {
+                opts?.signal?.removeEventListener('abort', onAbort);
+                resolve();
+            };
+            const timer = setTimeout(finish, intervalMs);
+            const onAbort = () => {
+                clearTimeout(timer);
+                opts?.signal?.removeEventListener('abort', onAbort);
+                reject(new Error('企微扫码已取消'));
+            };
+            opts?.signal?.addEventListener('abort', onAbort, { once: true });
+            if (opts?.signal?.aborted)
+                onAbort();
+        });
+    }
+    throw new Error('企微扫码超时，请重新生成二维码');
+}
 // ── WecomChannel ───────────────────────────────────────────────────────────────
 export class WecomChannel {
     agentAid;
@@ -1082,6 +1456,8 @@ export class WecomChannelPlugin {
                         await channel.finishStream(envelope.replyContext);
                         return;
                     case 'status.interrupted':
+                        await channel.finishStream(envelope.replyContext, payload.metadata?.reason === 'daemon_restart' ? '服务正在重启，将继续处理…' : '任务已中止');
+                        return;
                     case 'status.timeout':
                         await channel.finishStream(envelope.replyContext, '任务已中止');
                         return;
@@ -1136,7 +1512,7 @@ export class WecomChannelPlugin {
         return {
             channelType: 'wecom', adapter, channel,
             policy,
-            options: { fileMarkerPattern: /\[SEND_FILE:(?:(\w+):)?([^\]]+)\]/g, supportsImages: true, flushDelay: inst.flushDelay },
+            options: { fileMarkerPattern: createSendFileMarkerPattern(), supportsImages: true, flushDelay: inst.flushDelay },
             connect: () => channel.connect(),
             disconnect: () => channel.disconnect(),
             onProjectPathRequest: () => Promise.resolve(ctx.defaultProjectPath),

package/dist/cli/aun-commands.js

@@ -791,7 +791,7 @@ export async function cmdMsg(args) {
         console.log(`用法: ec msg <command> <from-aid> [args...] [options]
 
 Commands:
-  send <from> <to> <text>                              发送文本
+  send <from> <to> <text> --return <none|required>     发送文本（跨会话时 --return 必填）
   send <from> <to> --text-from-file <path>             从文件读取文本内容
   send <from> <to> --file <path> [--as <type>]         发送文件（image|video|voice|file）
   send <from> <to> --link <url> [--title T]            发送链接卡片
@@ -814,7 +814,7 @@ Options:
   --before <time>       只返回该时间之前的历史
   --after <time>        只返回该时间之后的历史
   --direction <value>   历史方向：in|out|all
-  --return <required|none> 跨会话回流策略（跨会话默认 required）
+  --return <none|required> 跨会话发送必填：none=仅补充目标上下文，required=回答回流来源
   --content-type <mime> 显式覆盖 MIME（仅 --file 模式）
   --as <type>           附件类型：image|video|voice|file（仅 --file 模式）
   --text <说明>          附件说明文字（仅 --file 模式）
@@ -825,12 +825,12 @@ Options:
                         （用于发送恰好等于某 flag 的文本，如 send a b -- --encrypt）
 
 示例:
-  ec msg send alice.agentid.pub bob.agentid.pub "hello"
-  ec msg send alice.agentid.pub bob.agentid.pub --text-from-file long-message.txt
-  ec msg send alice.agentid.pub bob.agentid.pub "讨论项目A" --thread "project-A"
-  ec msg send alice.agentid.pub bob.agentid.pub --file ./pic.png
-  ec msg send alice.agentid.pub bob.agentid.pub --file ./demo.mp4 --as video
-  ec msg send alice.agentid.pub bob.agentid.pub --link https://example.com --title "AUN"
+  ec msg send alice.agentid.pub bob.agentid.pub "hello" --return none
+  ec msg send alice.agentid.pub bob.agentid.pub --text-from-file long-message.txt --return none
+  ec msg send alice.agentid.pub bob.agentid.pub "讨论项目A" --thread "project-A" --return required
+  ec msg send alice.agentid.pub bob.agentid.pub --file ./pic.png --return none
+  ec msg send alice.agentid.pub bob.agentid.pub --file ./demo.mp4 --as video --return none
+  ec msg send alice.agentid.pub bob.agentid.pub --link https://example.com --title "AUN" --return none
   ec msg pull alice.agentid.pub --app my-bot
   ec msg ack alice.agentid.pub 42 --app my-bot
   ec msg recall alice.agentid.pub msg-uuid-1 msg-uuid-2
@@ -1234,7 +1234,7 @@ export async function cmdGroup(args) {
         console.log(`用法: ec group <command> <from-aid> [args...] [options]
 
 消息:
-  send <from> <group-id> <text>                        发送群文本
+  send <from> <group-id> <text> --return <none|required> 发送群文本（跨会话时 --return 必填）
   send <from> <group-id> --file <path> [--as <type>]   发送群文件
   send <from> <group-id> --payload <json>              发送自定义 payload
   pull <from> <group-id> [--after-seq N] [--limit N]   拉取群消息
@@ -1273,7 +1273,7 @@ Options:
   --encrypt             启用端到端加密（仅 send）
   --no-encrypt          强制明文发送（优先于 --encrypt；仅 send）
   --thread <id>         指定话题 ID（仅 send）
-  --return <required|none> 跨会话回流策略（仅 send）
+  --return <none|required> 跨会话发送必填（仅 send；Trigger 只能使用 none）
   --mention <aid>       发送时 @ 某个成员（可多次，或用逗号分隔多个 aid）
   --mention-all         发送时 @ 所有人
   --content-type <mime> 显式覆盖 MIME（仅 --file 模式）
@@ -1286,7 +1286,7 @@ Options:
 
 格式示例（.example.invalid 是保留的虚构域，以下 AID 均不是真实地址）:
   ec group create sender.example.invalid "Dev Team" --visibility private
-  ec group send sender.example.invalid 12345.example.invalid "hello team"
+  ec group send sender.example.invalid 12345.example.invalid "hello team" --return none
   ec group send sender.example.invalid 12345.example.invalid "@member 看下 PR" --mention member.example.invalid
   ec group send sender.example.invalid 12345.example.invalid --file ./arch.png
   ec group rules sender.example.invalid 12345.example.invalid set ./rules.md

package/dist/cli/daemon-commands.js

@@ -29,6 +29,22 @@ import { AGENT_DELEGATION_TOKEN_ENV } from '../core/auth/agent-delegation.js';
 import { WEB_CLI_BIN, WEB_PACKAGE_LATEST, WEB_PACKAGE_NAME } from '../product.js';
 import { rotateStdoutLog } from '../utils/log-writer.js';
 const execFileAsync = promisify(execFile);
+function printNoSelfAgentHints(options) {
+    const { daemonConfig, ecwebStarted, skipped } = options;
+    console.log('\nℹ 未配置任何 self-agent，Control Plane 已启动。');
+    console.log('  命令行：ec agent new <aid>.agentid.pub');
+    if (daemonConfig.aid && (daemonConfig.owners?.length ?? 0) > 0) {
+        console.log('  Evol App：可通过进程级菜单创建 agent');
+    }
+    if (ecwebStarted) {
+        console.log('  ECWeb：可通过控制台创建 agent');
+    }
+    if (skipped.length > 0) {
+        console.log('跳过的目录:');
+        for (const skippedAgent of skipped)
+            console.log(`  - ${skippedAgent.dirName}: ${skippedAgent.reason}`);
+    }
+}
 async function probeDaemon(socketPath, timeoutMs = 1000) {
     const response = await ipcQuery(socketPath, { type: 'ping' }, timeoutMs);
     if (response?.pong !== true || !Number.isInteger(response.pid) || response.pid <= 0)
@@ -196,8 +212,16 @@ export async function cmdStart(opts = {}) {
         }
         else {
             console.log('⚡ 未检测到初始化配置，自动启动初始化向导...\n');
-            await cmdInit();
-            return;
+            // cmdStart 直接调用 cmdInit，不会经过 CLI 的 `init` 分发分支；
+            // 这里需显式抑制 AUN SDK 的常规 keystore 日志。
+            const { suppressSdkLogs } = await import('../aun/aid/index.js');
+            suppressSdkLogs();
+            await cmdInit({ invokedByStart: true });
+            if (!loadDefaults()) {
+                console.log('⚠ 初始化未完成，未启动 EvolCore。');
+                return;
+            }
+            console.log('\n初始化完成，开始启动 EvolCore ....');
         }
     }
     // 控制 AID 门禁：缺 aid 且交互式 → 只补全控制 AID + owners（不重走 baseagent 向导）。
@@ -236,19 +260,12 @@ export async function cmdStart(opts = {}) {
     }
     // 检查至少有一个 self-agent
     const { agents, skipped } = loadAllAgents();
+    const isControlAidBootstrap = opts.bindBootstrap && !!daemonCfgStart.aid;
+    const shouldPrintNoSelfAgentHints = agents.length === 0 && !isControlAidBootstrap;
     if (agents.length === 0) {
-        if (opts.bindBootstrap && daemonCfgStart.aid) {
+        if (isControlAidBootstrap) {
             console.log('ℹ 未配置任何 self-agent，绑定 bootstrap 将仅启动控制 AID');
         }
-        else {
-            console.log('ℹ 未配置任何 self-agent，将仅启动 Control Plane。');
-            console.log('  可通过控制 AID 远程创建 agent，或稍后运行 ec agent new <aid>.agentid.pub');
-            if (skipped.length > 0) {
-                console.log(`跳过的目录:`);
-                for (const s of skipped)
-                    console.log(`  - ${s.dirName}: ${s.reason}`);
-            }
-        }
     }
     // 检查 instance 目录中的进程状态
     const status = scanInstances();
@@ -323,10 +340,22 @@ export async function cmdStart(opts = {}) {
             console.log(`  Logs: ${p.logs}/`);
             console.log(`⏱ ready in ${((Date.now() - cmdStartedAt) / 1000).toFixed(1)}s`);
             if (!ecwebStartedBeforeDaemon) {
-                startEcwebIfEnabled(p).catch((err) => {
+                startEcwebIfEnabled(p)
+                    .then((ecwebStarted) => {
+                    if (shouldPrintNoSelfAgentHints) {
+                        printNoSelfAgentHints({ daemonConfig: loadDaemonConfig(), ecwebStarted, skipped });
+                    }
+                })
+                    .catch((err) => {
                     console.error(`⚠ ECWeb 启动检查失败: ${err instanceof Error ? err.message : String(err)}`);
+                    if (shouldPrintNoSelfAgentHints) {
+                        printNoSelfAgentHints({ daemonConfig: loadDaemonConfig(), ecwebStarted: false, skipped });
+                    }
                 });
             }
+            else if (shouldPrintNoSelfAgentHints) {
+                printNoSelfAgentHints({ daemonConfig: loadDaemonConfig(), ecwebStarted: true, skipped });
+            }
         }, 500);
         let forwardingShutdown = false;
         const forwardSignal = (signal) => {
@@ -426,8 +455,10 @@ export async function cmdStart(opts = {}) {
             }
             console.log(`⏱ done in ${((Date.now() - cmdStartedAt) / 1000).toFixed(1)}s`);
             // ECWeb 自动后台启动
-            if (!ecwebStartedBeforeDaemon)
-                await startEcwebIfEnabled(p);
+            const ecwebStarted = ecwebStartedBeforeDaemon || await startEcwebIfEnabled(p);
+            if (shouldPrintNoSelfAgentHints) {
+                printNoSelfAgentHints({ daemonConfig: loadDaemonConfig(), ecwebStarted, skipped });
+            }
             return;
         }
         // 超时

package/dist/cli/handoff-command.js

@@ -246,11 +246,12 @@ Commands:
             console.log('没有匹配的 handoff');
             return;
         }
-        console.log('ID\tSTATE\tORIGIN\tTARGET\tUPDATED\tATTENTION');
+        console.log('ID\tSTATE\tRETURN_POLICY\tORIGIN\tTARGET\tUPDATED\tATTENTION');
         for (const item of result.handoffs) {
             console.log([
                 item.handoff_id,
                 item.state,
+                item.return_policy,
                 item.origin_session_id,
                 item.target_session_id,
                 formatTimestamp(item.updated_at),