evolcore 0.0.25 → 0.0.26

package/dist/cli/net-check.js

@@ -635,28 +635,28 @@ export async function cmdNet(args) {
     const formatJson = args.includes('--format') && args.includes('json');
     const kickTest = args.includes('--kick-test');
     if (isHelpFlag(sub) || wantsHelp(args)) {
-        console.log(`用法: ec net check [<aid>] [--format json] [--kick-test]
-
-检查 AUN 网络链路连通性（11 步逐层诊断）。
-
-步骤:
-  1.  DNS (AID)      AID 域名解析
-  2.  Discovery      .well-known/aun-gateway 获取网关地址
-  3.  DNS (Gateway)  网关域名解析
-  4.  TCP            网关端口连接
-  5.  TLS            TLS 握手 + 证书验证
-  6.  WSS            WebSocket 升级握手
-  7.  Auth           AID 认证（login1 + login2 → token）
-  8.  Session        会话建立
-  9.  Ping           meta.ping RPC
-  10. Echo           self-to-self 消息收发
-  11. KickTest       踢人测试 / extra_info 验证（可选）
-
-参数:
-  <aid>    要检查的 AID（可选，默认取前 3 个本地 AID）
-
-选项:
-  --format json    JSON 格式输出
+        console.log(`用法: ec net check [<aid>] [--format json] [--kick-test]
+
+检查 AUN 网络链路连通性（11 步逐层诊断）。
+
+步骤:
+  1.  DNS (AID)      AID 域名解析
+  2.  Discovery      .well-known/aun-gateway 获取网关地址
+  3.  DNS (Gateway)  网关域名解析
+  4.  TCP            网关端口连接
+  5.  TLS            TLS 握手 + 证书验证
+  6.  WSS            WebSocket 升级握手
+  7.  Auth           AID 认证（login1 + login2 → token）
+  8.  Session        会话建立
+  9.  Ping           meta.ping RPC
+  10. Echo           self-to-self 消息收发
+  11. KickTest       踢人测试 / extra_info 验证（可选）
+
+参数:
+  <aid>    要检查的 AID（可选，默认取前 3 个本地 AID）
+
+选项:
+  --format json    JSON 格式输出
   --kick-test      启用踢人测试（会断开 daemon 长连接，daemon 会自动重连）`);
         return;
     }

package/dist/cli/queue-command.js

@@ -4,35 +4,35 @@ import { AGENT_DELEGATION_TOKEN_ENV } from '../core/auth/agent-delegation.js';
 import { getArgValue, isHelpFlag, wantsHelp } from './help.js';
 export async function cmdQueue(args) {
     if (args.length === 0 || isHelpFlag(args[0]) || wantsHelp(args)) {
-        console.log(`用法: ec queue --agent <aid> [选项]
-
-查询与操作 EvolAgent 的消息队列。
-
-查询:
-  --agent <aid>           必填，目标 agent（如 mybot.agentid.pub）
-  --after <time>          只显示 adapter 接收时间晚于该值的消息（epoch ms 或 ISO）
-  --before <time>         只显示 adapter 接收时间早于该值的消息（epoch ms 或 ISO）
-  --showid                显示 messageId
-  --full                  显示完整消息内容（不截断）
-  --format json           以 JSON 格式输出
-
-JSON 时间字段:
-  receivedAt              adapter 收到消息时间（epoch ms）
-  enqueuedAt              实际进入队列时间（epoch ms）
-  queueWaitMs             排队等待时长（ms）
-  processingStartedAt     开始处理时间（epoch ms，active）
-
-操作:
-  --clear                 清空该 agent 的所有待处理消息
-  --cancel <messageId>    取消指定消息
-  --interrupt --sessionkey <key>  打断指定 session 的处理中任务
-
-示例:
-  ec queue --agent mybot.agentid.pub
-  ec queue --agent mybot.agentid.pub --after 2026-08-19T12:00:00+08:00
-  ec queue --agent mybot.agentid.pub --showid
-  ec queue --agent mybot.agentid.pub --clear
-  ec queue --agent mybot.agentid.pub --cancel msg_d4e5f6
+        console.log(`用法: ec queue --agent <aid> [选项]
+
+查询与操作 EvolAgent 的消息队列。
+
+查询:
+  --agent <aid>           必填，目标 agent（如 mybot.agentid.pub）
+  --after <time>          只显示 adapter 接收时间晚于该值的消息（epoch ms 或 ISO）
+  --before <time>         只显示 adapter 接收时间早于该值的消息（epoch ms 或 ISO）
+  --showid                显示 messageId
+  --full                  显示完整消息内容（不截断）
+  --format json           以 JSON 格式输出
+
+JSON 时间字段:
+  receivedAt              adapter 收到消息时间（epoch ms）
+  enqueuedAt              实际进入队列时间（epoch ms）
+  queueWaitMs             排队等待时长（ms）
+  processingStartedAt     开始处理时间（epoch ms，active）
+
+操作:
+  --clear                 清空该 agent 的所有待处理消息
+  --cancel <messageId>    取消指定消息
+  --interrupt --sessionkey <key>  打断指定 session 的处理中任务
+
+示例:
+  ec queue --agent mybot.agentid.pub
+  ec queue --agent mybot.agentid.pub --after 2026-08-19T12:00:00+08:00
+  ec queue --agent mybot.agentid.pub --showid
+  ec queue --agent mybot.agentid.pub --clear
+  ec queue --agent mybot.agentid.pub --cancel msg_d4e5f6
   ec queue --agent mybot.agentid.pub --interrupt --sessionkey feishu#oc_abc123#main`);
         return;
     }

package/dist/cli/response.js

@@ -191,36 +191,36 @@ function sourceLabel(target) {
         default: return String(target);
     }
 }
-const HELP = `用法: ec response <command> [options]
-
-Commands:
-  list                列出所有响应模式（内置 + 元数据）
-  current             显示当前作用域生效的模式 + 参数
-  info <mode-id>      查看单个模式详情（场景/配置参数）
-  set <mode-id>       设置响应模式
-  reset               清除指定作用域的 responseMode 设置
-  config <mode-id>    查看指定模式的配置参数
-  config set <k> <v>  修改模式配置参数（--mode 指定模式）
-
-作用域（由参数决定，越具体越优先：关系 > agent）:
-  --self <aid>                   agent级   → config.json
-  --self <aid> --peer <X>        关系级    → relations/<peerKey>/config.json
-
-Options:
-  --self <aid>        本端 AID
-  --peer <X>          对端：channelType#channelId 或裸 aid（裸 aid 视为 aun#<aid>）
-  --mode <id>         模式 id（config set 专用）
-  --format json       输出 JSON
-  --help, -h          各子命令均支持
-
-示例:
-  ec response list
-  ec response current --self bot.agentid.pub
-  ec response info single-session
-  ec response set single-session --self bot.agentid.pub
-  ec response set single-session --self bot.agentid.pub --peer aun#team.group.com
-  ec response config single-session --self bot.agentid.pub
-  ec response config set tool_use_reminder false --mode single-session --self bot.agentid.pub
+const HELP = `用法: ec response <command> [options]
+
+Commands:
+  list                列出所有响应模式（内置 + 元数据）
+  current             显示当前作用域生效的模式 + 参数
+  info <mode-id>      查看单个模式详情（场景/配置参数）
+  set <mode-id>       设置响应模式
+  reset               清除指定作用域的 responseMode 设置
+  config <mode-id>    查看指定模式的配置参数
+  config set <k> <v>  修改模式配置参数（--mode 指定模式）
+
+作用域（由参数决定，越具体越优先：关系 > agent）:
+  --self <aid>                   agent级   → config.json
+  --self <aid> --peer <X>        关系级    → relations/<peerKey>/config.json
+
+Options:
+  --self <aid>        本端 AID
+  --peer <X>          对端：channelType#channelId 或裸 aid（裸 aid 视为 aun#<aid>）
+  --mode <id>         模式 id（config set 专用）
+  --format json       输出 JSON
+  --help, -h          各子命令均支持
+
+示例:
+  ec response list
+  ec response current --self bot.agentid.pub
+  ec response info single-session
+  ec response set single-session --self bot.agentid.pub
+  ec response set single-session --self bot.agentid.pub --peer aun#team.group.com
+  ec response config single-session --self bot.agentid.pub
+  ec response config set tool_use_reminder false --mode single-session --self bot.agentid.pub
   ec response reset --self bot.agentid.pub --peer alice.agentid.pub`;
 // ── list ────────────────────────────────────────────────────────────────
 function cmdList(args, formatJson) {

package/dist/cli/restart-monitor.js

@@ -15,6 +15,7 @@ import { shouldSuppressRealRestart } from '../utils/restart-safety.js';
 import { rotateStdoutLog } from '../utils/log-writer.js';
 import { inspectDataMigrationRequirement } from '../core/data-migration.js';
 import { DAEMON_SHUTDOWN_TIMEOUT_MS, requestDaemonShutdown } from './daemon-commands.js';
+import { getProcessStartTime, startTimeMatches } from '../utils/process-introspect.js';
 const execFileAsync = promisify(execFile);
 /**
  * The package this monitor operates on, which is not always the one it runs
@@ -43,6 +44,15 @@ function cleanEnv() {
         delete process.env[key];
     }
 }
+function isPidReused(pid, expectedStartedAt) {
+    if (expectedStartedAt === undefined)
+        return false;
+    const actualStartedAt = getProcessStartTime(pid);
+    return actualStartedAt !== null && !startTimeMatches(expectedStartedAt, actualStartedAt);
+}
+function reportPidReused(pid, log) {
+    log(`Process ${pid} no longer refers to the recorded daemon; treating the original process as exited`);
+}
 export async function cmdRestartMonitor() {
     // Defense in depth: a unit test that accidentally executes the real restart
     // path must not detach a persistent daemon from the test worker.
@@ -117,9 +127,11 @@ export async function cmdRestartMonitor() {
     }
     // Test daemons live in one temporary HOME per test, so the current HOME's
     // instance registry cannot see them. Their strict environment markers make
-    // them safe to reap globally on every real restart.
+    // them safe to reap globally on every real restart. Keep one process-table
+    // snapshot for both orphan categories; each Windows CIM scan is expensive.
+    const orphanSnapshot = findOrphanProcesses();
     {
-        const leakedTestDaemons = findOrphanProcesses().filter(o => o.confirmedTestDaemon);
+        const leakedTestDaemons = orphanSnapshot.filter(o => o.confirmedTestDaemon);
         if (leakedTestDaemons.length > 0) {
             const killed = killOrphans(leakedTestDaemons);
             log(`Cleaned ${killed.length} leaked test daemon(s): ${killed.join(', ')}`);
@@ -130,7 +142,7 @@ export async function cmdRestartMonitor() {
     // still alive. Refuse to create a second daemon when an unregistered process
     // from this package is found; a duplicate would connect AUN and kick the
     // existing session before failing on IPC/port ownership.
-    const runtimeOrphans = findOrphanProcesses().filter(o => {
+    const runtimeOrphans = orphanSnapshot.filter(o => {
         if (o.confirmedTestDaemon)
             return false;
         const homeMatches = o.evolcoreHome && normalizePath(o.evolcoreHome) === normalizePath(p.root);
@@ -165,6 +177,7 @@ export async function cmdRestartMonitor() {
     const aliveMains = oldStatus.mains.filter(m => m.alive);
     if (aliveMains.length > 0) {
         const oldPids = aliveMains.map(m => m.record.pid);
+        const expectedStarts = new Map(aliveMains.map(m => [m.record.pid, m.record.startedAt]));
         log(`Monitoring ${oldPids.length} main process(es): ${oldPids.join(', ')}`);
         const gracefulPid = await requestDaemonShutdown(p.socket, DAEMON_SHUTDOWN_TIMEOUT_MS, 'restart-monitor', new Set(oldPids));
         // 没有收到 IPC shutdown 确认的进程才走信号兜底
@@ -177,15 +190,39 @@ export async function cmdRestartMonitor() {
             }
         }
         const exited = await Promise.all(oldPids.map(async (oldPid) => {
+            const expectedStartedAt = expectedStarts.get(oldPid);
+            if (isPidReused(oldPid, expectedStartedAt)) {
+                reportPidReused(oldPid, log);
+                return true;
+            }
             if (await platform.waitForProcessExit(oldPid, 30_000)) {
+                if (isPidReused(oldPid, expectedStartedAt)) {
+                    reportPidReused(oldPid, log);
+                    return true;
+                }
                 log(`Process ${oldPid} has exited`);
                 return true;
             }
-            log(`ERROR: Process ${oldPid} still running after 30s, force killing`);
+            if (isPidReused(oldPid, expectedStartedAt)) {
+                reportPidReused(oldPid, log);
+                return true;
+            }
+            const state = platform.getProcessState(oldPid);
+            log(`ERROR: Process ${oldPid} still running after 30s${state ? ` (state=${state})` : ''}, force killing`);
+            if (isPidReused(oldPid, expectedStartedAt)) {
+                reportPidReused(oldPid, log);
+                return true;
+            }
             platform.killProcess(oldPid, true);
             const forced = await platform.waitForProcessExit(oldPid, 5_000);
-            if (!forced)
-                log(`ERROR: Process ${oldPid} survived forced termination`);
+            if (isPidReused(oldPid, expectedStartedAt)) {
+                reportPidReused(oldPid, log);
+                return true;
+            }
+            if (!forced) {
+                const finalState = platform.getProcessState(oldPid);
+                log(`ERROR: Process ${oldPid} survived forced termination${finalState ? ` (state=${finalState})` : ''}`);
+            }
             return forced;
         }));
         if (exited.some(result => !result)) {
@@ -194,7 +231,9 @@ export async function cmdRestartMonitor() {
             cleanupPendingFile(pendingFile, log);
             process.exit(1);
         }
-        await sleep(3000);
+        // waitForProcessExit above already observed the old daemon exit. A fixed
+        // three-second delay only serialized the restart path and was not needed
+        // for instance-file cleanup.
         cleanupInstances();
     }
     // 版本检查与自动升级
@@ -202,7 +241,10 @@ export async function cmdRestartMonitor() {
     // 升级会原地替换整包，先留一个可回退的产物副本。备份放 EVOLCORE_HOME 而非包目录：
     // Linux/macOS 的全局目录常常不可写，而 HOME 一定可写。
     const upgradeBackup = await backupDistForUpgrade(p, log);
-    const upgrade = await tryUpgrade();
+    const [upgrade, ecwebUpgrade] = await Promise.all([
+        tryUpgrade(),
+        tryUpgradeGlobalPkg(() => resolveGlobalPkg(WEB_PACKAGE_NAME), WEB_PACKAGE_NAME),
+    ]);
     let upgradeRolledBack;
     switch (upgrade.status) {
         case 'upgraded':
@@ -243,8 +285,8 @@ export async function cmdRestartMonitor() {
             await notifyDaemonOwners(p, `⚠️ evolcore 升级失败，使用当前版本继续\n${upgrade.error ?? ''}`.trim(), log);
             break;
     }
-    // EC Web 是独立全局包，已安装时单独检查升级。
-    const ecwebUpgrade = await tryUpgradeGlobalPkg(() => resolveGlobalPkg(WEB_PACKAGE_NAME), WEB_PACKAGE_NAME);
+    // EC Web 是独立全局包，已安装时单独检查升级；与 EvolCore registry
+    // 查询并行执行，npm 安装阶段由 npm-ops 的全局锁串行化。
     switch (ecwebUpgrade.status) {
         case 'upgraded':
             log(`✅ ${WEB_PACKAGE_NAME} upgraded: ${ecwebUpgrade.from} → ${ecwebUpgrade.to}`);
@@ -710,6 +752,11 @@ async function revertToPreviousBuild(log) {
  * back up or the copy failed — the caller then knows rollback is unavailable.
  */
 async function backupDistForUpgrade(p, log) {
+    // Linked/source checkouts cannot be upgraded by npm. Copying dist/ here was
+    // pure restart overhead and made every source restart rewrite the artifact
+    // tree even when no build was needed.
+    if (fs.existsSync(path.join(targetPackageRoot(), 'src')))
+        return null;
     const distDir = path.join(targetPackageRoot(), 'dist');
     if (!distArtifactIsUsable(distDir))
         return null;
@@ -851,36 +898,36 @@ async function invokeClaude(claudePath, p, attempt, maxAttempts, timeout, log) {
     const selfHealLog = p.selfHealLog;
     const stdoutLog = path.join(p.logs, 'stdout.log');
     const selfHealExists = fs.existsSync(selfHealLog) ? '存在，请先阅读之前的修复记录' : '不存在（首次修复）';
-    const prompt = `EvolCore 服务启动失败，需要你诊断并修复。这是第 ${attempt}/${maxAttempts} 次自动修复尝试。
-
-关键信息：
-- 项目目录：${projectDir}
-- EVOLCORE_HOME：${p.root}
-- 错误日志：${stdoutLog}
-- 主日志：${p.logs}/daemon-*.log（按小时切片，读最新的那个，包含 config 校验失败等关键错误）
-- 修复记录：${selfHealLog}（${selfHealExists}）
-
-⚠️ 重要诊断技巧：
-- stdout.log 可能是空的（进程秒退时 logger 输出不会到 stdout），一定要同时读 daemon-*.log 最新文件
-- 必须实际运行进程来复现错误：\`EVOLCORE_HOME=${p.root} node dist/index.js 2>&1\`，观察输出和退出码
-- 检查是否有旧进程仍在运行：\`ps aux | grep 'node.*dist/index.js' | grep -v grep\`，旧进程可能占用端口或锁文件
-- 可以运行 \`EVOLCORE_HOME=${p.root} node dist/cli/index.js diagnose\` 快速检查配置和数据库
-- 如果进程无任何输出就 exit(1)，说明是 process.exit(1) 被显式调用，搜索源码中所有 process.exit(1) 位置
-- 配置文件使用双 rename 原子写（foo.json → foo.json_ → foo.json__），崩溃时可从 foo.json_ 恢复
-
-请执行以下步骤：
-1. 读取 ${stdoutLog} 和 ${p.logs}/daemon-*.log（最新文件）的最后 50 行
-2. 运行 \`EVOLCORE_HOME=${p.root} node dist/index.js 2>&1\` 复现错误（设置 10 秒超时）
-3. 如果 ${selfHealLog} 存在，先阅读之前的修复记录，避免重复尝试已失败的方案
-4. 根据实际复现的错误修复代码
-5. 执行 npm run build 确认编译通过
-6. 验证修复：启动服务确认 ready.signal 已写入，然后执行 \`EVOLCORE_HOME=${p.root} node dist/cli/index.js stop\` 优雅停止（restart-monitor 会负责最终启动）
-7. 将本次修复内容追加到 ${selfHealLog}，格式：
-   ## 第 ${attempt} 次修复 - {时间}
-   - 错误原因：...
-   - 修复方案：...
-   - 修改文件：...
-
+    const prompt = `EvolCore 服务启动失败，需要你诊断并修复。这是第 ${attempt}/${maxAttempts} 次自动修复尝试。
+
+关键信息：
+- 项目目录：${projectDir}
+- EVOLCORE_HOME：${p.root}
+- 错误日志：${stdoutLog}
+- 主日志：${p.logs}/daemon-*.log（按小时切片，读最新的那个，包含 config 校验失败等关键错误）
+- 修复记录：${selfHealLog}（${selfHealExists}）
+
+⚠️ 重要诊断技巧：
+- stdout.log 可能是空的（进程秒退时 logger 输出不会到 stdout），一定要同时读 daemon-*.log 最新文件
+- 必须实际运行进程来复现错误：\`EVOLCORE_HOME=${p.root} node dist/index.js 2>&1\`，观察输出和退出码
+- 检查是否有旧进程仍在运行：\`ps aux | grep 'node.*dist/index.js' | grep -v grep\`，旧进程可能占用端口或锁文件
+- 可以运行 \`EVOLCORE_HOME=${p.root} node dist/cli/index.js diagnose\` 快速检查配置和数据库
+- 如果进程无任何输出就 exit(1)，说明是 process.exit(1) 被显式调用，搜索源码中所有 process.exit(1) 位置
+- 配置文件使用双 rename 原子写（foo.json → foo.json_ → foo.json__），崩溃时可从 foo.json_ 恢复
+
+请执行以下步骤：
+1. 读取 ${stdoutLog} 和 ${p.logs}/daemon-*.log（最新文件）的最后 50 行
+2. 运行 \`EVOLCORE_HOME=${p.root} node dist/index.js 2>&1\` 复现错误（设置 10 秒超时）
+3. 如果 ${selfHealLog} 存在，先阅读之前的修复记录，避免重复尝试已失败的方案
+4. 根据实际复现的错误修复代码
+5. 执行 npm run build 确认编译通过
+6. 验证修复：启动服务确认 ready.signal 已写入，然后执行 \`EVOLCORE_HOME=${p.root} node dist/cli/index.js stop\` 优雅停止（restart-monitor 会负责最终启动）
+7. 将本次修复内容追加到 ${selfHealLog}，格式：
+   ## 第 ${attempt} 次修复 - {时间}
+   - 错误原因：...
+   - 修复方案：...
+   - 修改文件：...
+
 注意：只修复导致启动失败的问题，不要做额外的重构或优化。`;
     try {
         log(`Invoking claude CLI (attempt ${attempt}, timeout ${timeout / 60000}min)...`);

package/dist/cli/stats.js

@@ -6,52 +6,52 @@ import { wantsHelp } from './help.js';
 import { readBestTaskRuntimeContext } from './task-context.js';
 import { queryAggregated, querySessionTurns, queryContextBreakdown, queryTopPeers, queryTopModels, queryMessageAggregated, queryPeerList, querySummary, queryPeerDaily, queryTaskModelCalls, querySessionModelCalls } from '../stats/query.js';
 import { getBudgetStatus } from '../stats/budget.js';
-const HELP = `ec stats — Token 用量与费用统计
-
-Usage: ec stats [options]
-
-时间范围:
-  (无参数)                今日概览
-  --today                 同上
-  --hour                  最近 24 小时，按小时分组
-  --week                  本周
-  --month                 本月
-  --from <date> --to <date>   任意区间（YYYY-MM-DD）
-
-维度过滤（可组合）:
-  --agent <aid>           指定 agent
-  --peer <X>             对端（裸 AID 自动前缀 aun#，或 channel#id 格式）
-  --model <model-id>      指定模型
-  --session <id>          指定会话
-
-聚合粒度:
-  --by hour|day|week|month|model|peer|agent
-
-快捷视图:
-  --session <id>          单个会话明细
-  --session <id> --last   会话最后一轮用量 + 累计（等价 status.completed）
-  --context <id>          会话 context breakdown 细目
-  --budget                预算状态
-  --top-peers [--limit N] 对端排行
-  --top-models [--limit N] 模型排行
-  --traffic               消息收发条数与字节数
-  --sql "<query>"         直接执行只读 SQL
-  --rebuild               全量重建日聚合表 usage_daily（运维兜底/排查）
-  --peers [--limit N]     私聊对端列表（带累计 token/calls/活跃日）
-  --groups [--limit N]    群聊列表（同上）
-  --summary               指定时间范围总消耗汇总（token/USD/CNY）
-  --peer-detail <id>      指定对端 AID 或 peer_key，按天返回消耗明细
-  --task-calls <taskId>   一个 task 的逐次大模型调用明细
-  --session-calls <id>    一个会话的逐次大模型调用明细
-
-输出格式:
-  --format json           JSON 输出
-  --help, -h              显示此帮助
-
-示例:
-  ec stats
-  ec stats --month --agent bot.agentid.pub
-  ec stats --peer alice.aid.pub
+const HELP = `ec stats — Token 用量与费用统计
+
+Usage: ec stats [options]
+
+时间范围:
+  (无参数)                今日概览
+  --today                 同上
+  --hour                  最近 24 小时，按小时分组
+  --week                  本周
+  --month                 本月
+  --from <date> --to <date>   任意区间（YYYY-MM-DD）
+
+维度过滤（可组合）:
+  --agent <aid>           指定 agent
+  --peer <X>             对端（裸 AID 自动前缀 aun#，或 channel#id 格式）
+  --model <model-id>      指定模型
+  --session <id>          指定会话
+
+聚合粒度:
+  --by hour|day|week|month|model|peer|agent
+
+快捷视图:
+  --session <id>          单个会话明细
+  --session <id> --last   会话最后一轮用量 + 累计（等价 status.completed）
+  --context <id>          会话 context breakdown 细目
+  --budget                预算状态
+  --top-peers [--limit N] 对端排行
+  --top-models [--limit N] 模型排行
+  --traffic               消息收发条数与字节数
+  --sql "<query>"         直接执行只读 SQL
+  --rebuild               全量重建日聚合表 usage_daily（运维兜底/排查）
+  --peers [--limit N]     私聊对端列表（带累计 token/calls/活跃日）
+  --groups [--limit N]    群聊列表（同上）
+  --summary               指定时间范围总消耗汇总（token/USD/CNY）
+  --peer-detail <id>      指定对端 AID 或 peer_key，按天返回消耗明细
+  --task-calls <taskId>   一个 task 的逐次大模型调用明细
+  --session-calls <id>    一个会话的逐次大模型调用明细
+
+输出格式:
+  --format json           JSON 输出
+  --help, -h              显示此帮助
+
+示例:
+  ec stats
+  ec stats --month --agent bot.agentid.pub
+  ec stats --peer alice.aid.pub
   ec stats --session abc123 --format json`;
 const RESET = '\x1b[0m';
 const BOLD = '\x1b[1m';
@@ -246,11 +246,11 @@ export async function handleStats(args) {
             const batch = allEvents.slice(i, i + batchSize);
             for (const event of batch) {
                 const prices = resolvePrices(home, event); // 不传 gatewayPricing，全走本地 JSONL
-                db.prepare(`
-          UPDATE usage_events
-          SET cost_official_usd = ?, cost_official_cny = ?,
-              cost_gateway_usd = ?, cost_gateway_cny = ?
-          WHERE id = ?
+                db.prepare(`
+          UPDATE usage_events
+          SET cost_official_usd = ?, cost_official_cny = ?,
+              cost_gateway_usd = ?, cost_gateway_cny = ?
+          WHERE id = ?
         `).run(prices.official?.usd ?? null, prices.official?.cny ?? null, prices.gateway?.usd ?? null, prices.gateway?.cny ?? null, event.id);
                 updated++;
             }

package/dist/cli/trigger-command.js

@@ -81,62 +81,62 @@ export async function cmdTrigger(args) {
     }
 }
 function printHelp() {
-    console.log(`用法: ec trigger <subcommand>
-
-命令:
-  list [--agent <aid>] [--all] [--json]
-  show [--agent <aid>] <triggerId> [--json]
-  history [--agent <aid>] [triggerId] [--limit <n>] [--json]
-  create --exec <script|trigger-session|target-session> --file <trigger.json|trigger-dir> [--enable] [--json]
-    OR
-  create [--agent <aid>] --exec <script|trigger-session|target-session> --cron <expr>|--event <pattern> (--prompt <text>|--prompt-file <path>) [--enable] [其他flag]
-  set ...  (create 的兼容别名)
-  update [--agent <aid>] <triggerId> <参数...> [--if-revision <sha256:...>] [--json]
-  enable [--agent <aid>] <triggerId>
-  disable [--agent <aid>] <triggerId>
-  cancel [--agent <aid>] <triggerId>  (disable 的兼容别名)
-  delete|remove|rm [--agent <aid>] <triggerId>
-  run [--agent <aid>] <triggerId> [--dry-run] [--json]
-  template list|show <name> [--json]
-
-Create 参数模式支持:
-  --once | --delay <时长> | --at <ISO时间> | --cron <表达式> | --every <时长> | --event <事件模式>
-  --exec <script|trigger-session|target-session>  (必填)
-  --prompt <文本> | --prompt-file <路径>
-    Shell 双引号内的双引号、反引号和变量形式的美元符号都需在前面加反斜杠；trigger 保存的是还原后的原文
-  --script-path <路径> --script-runtime <node|python|bash>
-  --script-args <JSON> --script-timeout <时长>
-  --feedback <target>  (origin/silent 仅可通过 --file 导入)
-  --baseagent <name>  (仅 --exec trigger-session)
-  --model <模型>  --effort <low|medium|high|xhigh|max>
-  --max-runs <次数>  --max-duration <时长: 30s|15m|2h|1d>
-  --permission <readonly|auto|request|bypass|fullaccess>（省略则继承当前身份配置；fullaccess 仅 daemon-owner 且 feature flag 开启时可用）
-  --tz <时区> (仅 cron)
-  --target-channel <channelKey> --target-channel-id <ID>  (AUN 可简写为 aun)
-  --target-chat-type <private|group>  (AUN 目标必填；channelId 同时作为群聊 ID)
-  --target-session <main|thread> [--target-thread-id <threadId>]
-  --trigger-thread <by-run|by-trigger>  (兼容旧值 per-run)
-  --name <名称>
-
-通用输出参数:
-  --json | --format json
-
-Update 参数:
-  --once | --delay | --at | --cron | --every | --event [--tz]
-  --prompt <文本> | --prompt-file <路径>  --script-file <路径>  --name <名称>
-  --description <文本>  (空字符串删除)
-  --model <模型>  --effort <强度>  --permission <权限模式|inherit>（inherit 清除覆盖）
-  --max-runs <次数>  --max-duration <时长>
-  --concurrency <forbid|replace|allow>  --missed-policy <skip|run-once|run-all>
-  --feedback <origin|target|silent>
-  --target-channel <channelKey> --target-channel-id <ID>  (必须同时指定)
-  --target-chat-type <private|group>  --target-session <main|thread> [--target-thread-id <threadId>]
-  --trigger-thread <by-run|by-trigger>  --baseagent <name>  (仅 trigger_session 之间)
-  --on-error <fail|retry>  --noop-sentinel <文本>
-  --retry-attempts <次数>  --retry-backoff <毫秒>
-  --script-runtime <node|python|bash>  --script-args <JSON>  --script-timeout <时长>
-
-省略 --agent 时使用当前 agent AID；无会话上下文或跨身份操作时需要显式指定。
+    console.log(`用法: ec trigger <subcommand>
+
+命令:
+  list [--agent <aid>] [--all] [--json]
+  show [--agent <aid>] <triggerId> [--json]
+  history [--agent <aid>] [triggerId] [--limit <n>] [--json]
+  create --exec <script|trigger-session|target-session> --file <trigger.json|trigger-dir> [--enable] [--json]
+    OR
+  create [--agent <aid>] --exec <script|trigger-session|target-session> --cron <expr>|--event <pattern> (--prompt <text>|--prompt-file <path>) [--enable] [其他flag]
+  set ...  (create 的兼容别名)
+  update [--agent <aid>] <triggerId> <参数...> [--if-revision <sha256:...>] [--json]
+  enable [--agent <aid>] <triggerId>
+  disable [--agent <aid>] <triggerId>
+  cancel [--agent <aid>] <triggerId>  (disable 的兼容别名)
+  delete|remove|rm [--agent <aid>] <triggerId>
+  run [--agent <aid>] <triggerId> [--dry-run] [--json]
+  template list|show <name> [--json]
+
+Create 参数模式支持:
+  --once | --delay <时长> | --at <ISO时间> | --cron <表达式> | --every <时长> | --event <事件模式>
+  --exec <script|trigger-session|target-session>  (必填)
+  --prompt <文本> | --prompt-file <路径>
+    Shell 双引号内的双引号、反引号和变量形式的美元符号都需在前面加反斜杠；trigger 保存的是还原后的原文
+  --script-path <路径> --script-runtime <node|python|bash>
+  --script-args <JSON> --script-timeout <时长>
+  --feedback <target>  (origin/silent 仅可通过 --file 导入)
+  --baseagent <name>  (仅 --exec trigger-session)
+  --model <模型>  --effort <low|medium|high|xhigh|max>
+  --max-runs <次数>  --max-duration <时长: 30s|15m|2h|1d>
+  --permission <readonly|auto|request|bypass|fullaccess>（省略则继承当前身份配置；fullaccess 仅 daemon-owner 且 feature flag 开启时可用）
+  --tz <时区> (仅 cron)
+  --target-channel <channelKey> --target-channel-id <ID>  (AUN 可简写为 aun)
+  --target-chat-type <private|group>  (AUN 目标必填；channelId 同时作为群聊 ID)
+  --target-session <main|thread> [--target-thread-id <threadId>]
+  --trigger-thread <by-run|by-trigger>  (兼容旧值 per-run)
+  --name <名称>
+
+通用输出参数:
+  --json | --format json
+
+Update 参数:
+  --once | --delay | --at | --cron | --every | --event [--tz]
+  --prompt <文本> | --prompt-file <路径>  --script-file <路径>  --name <名称>
+  --description <文本>  (空字符串删除)
+  --model <模型>  --effort <强度>  --permission <权限模式|inherit>（inherit 清除覆盖）
+  --max-runs <次数>  --max-duration <时长>
+  --concurrency <forbid|replace|allow>  --missed-policy <skip|run-once|run-all>
+  --feedback <origin|target|silent>
+  --target-channel <channelKey> --target-channel-id <ID>  (必须同时指定)
+  --target-chat-type <private|group>  --target-session <main|thread> [--target-thread-id <threadId>]
+  --trigger-thread <by-run|by-trigger>  --baseagent <name>  (仅 trigger_session 之间)
+  --on-error <fail|retry>  --noop-sentinel <文本>
+  --retry-attempts <次数>  --retry-backoff <毫秒>
+  --script-runtime <node|python|bash>  --script-args <JSON>  --script-timeout <时长>
+
+省略 --agent 时使用当前 agent AID；无会话上下文或跨身份操作时需要显式指定。
 任务会话中的跨身份操作仅允许目标 Agent 上具备 owner/admin 权限的调用者执行 list/show/history；创建、修改、启停、删除和运行仍只允许当前 Agent。`);
 }
 async function listTriggers(args, json) {

package/dist/config/builtin-roles.js

@@ -34,6 +34,7 @@ export function getManagementCommandPermissions(role) {
         'contact.read': { allow: true, scopes: ['agent'] },
         'contact.add': { allow: true, scopes: ['relation'], constraints: { ownPeerOnly: true, privateOnly: true } },
         'contact.block': { allow: true, scopes: ['agent'], constraints: { requireAgentAdmin: true } },
+        'contact.review': { allow: true, scopes: ['agent'], constraints: { requireAgentAdmin: true } },
         'connect.write': { allow: true, scopes: ['agent'], constraints: { requireAgentAdmin: true } },
         'connect.access.write': { allow: true, scopes: ['agent'], constraints: { requireAgentOwner: true } },
         'role.assign': { allow: true, scopes: ['agent'] },