evolcore 0.0.23 → 0.0.25

package/dist/cli/index.js

@@ -19,57 +19,57 @@ import { cmdStart, cmdStop, cmdRestart, cmdStatus, cmdLogs, cmdWatchCommand, cmd
 import { logCliCommand } from './command-log.js';
 import { isInitCancelledError, printInitCancelHint } from './init-cancel.js';
 import { assertManagedTopLevelCommandAllowed, ManagedCommandNotAllowedError } from './managed-command-guard.js';
-const MAIN_HELP = `用法: ec <command> [选项]
-
-服务:
-  init              初始化默认配置、owner、控制 AID 与 EC Web
-  start             启动服务
-  stop              停止服务
-  restart           重启服务并检查更新
-  status            查看运行状态
-  logs              持续查看 daemon 日志
-  watch             打开日志、AID、消息或 EC Web 监控
-
-Agent 与会话:
-  agent             管理 EvolAgent
-  ctl               当前托管会话的控制命令
-  queue             查询或操作 agent 消息队列
-  trigger           管理定时与事件触发器
-  handoff           查询和完成跨会话回流
-  model             查看或设置模型与推理强度
-  response          查看或设置响应模式
-
-AUN:
-  aid               管理 AID 身份与 agent.md
-  msg               私聊消息收发、撤回、在线状态与历史
-  group             群消息与群管理
-  fs                AUN 文件系统
-  storage           底层对象存储命令
-  rpc               调用底层 AUN RPC
-  menu-client       向远程 daemon 发送标准 Menu 请求
-  contact           联系人黑名单管理
-  net               AUN 网络链路诊断
-
-配置与诊断:
-  config            读取、修改和检查分层配置
-  stats             Token 用量与费用统计
-  diagnose          检查启动环境
-  version           显示组件版本
-  mv                迁移项目目录和会话路径
-
-维护命令:
-  data migrate      迁移 per-Agent 用户数据（显式维护窗口）
-  mode              切换开发源码与 npm 包运行模式
-  restart-monitor   运行 daemon 重启监控器
-  bench             AUN 消息性能基准测试
-  link-rules        连接 ECK rules 到项目目录
-
-运行 ec <command> --help 查看该命令的完整参数。
-
-环境变量:
-  EVOLCORE_HOME     数据目录（默认: ~/.evolcore）
-  LOG_LEVEL         日志级别（默认: INFO）
-  MESSAGE_LOG       消息日志（默认: true）
+const MAIN_HELP = `用法: ec <command> [选项]
+
+服务:
+  init              初始化默认配置、owner、控制 AID 与 EC Web
+  start             启动服务
+  stop              停止服务
+  restart           重启服务并检查更新
+  status            查看运行状态
+  logs              持续查看 daemon 日志
+  watch             打开日志、AID、消息或 EC Web 监控
+
+Agent 与会话:
+  agent             管理 EvolAgent
+  ctl               当前托管会话的控制命令
+  queue             查询或操作 agent 消息队列
+  trigger           管理定时与事件触发器
+  handoff           查询和完成跨会话回流
+  model             查看或设置模型与推理强度
+  response          查看或设置响应模式
+
+AUN:
+  aid               管理 AID 身份与 agent.md
+  msg               私聊消息收发、撤回、在线状态与历史
+  group             群消息与群管理
+  fs                AUN 文件系统
+  storage           底层对象存储命令
+  rpc               调用底层 AUN RPC
+  menu-client       向远程 daemon 发送标准 Menu 请求
+  contact           联系人黑名单管理
+  net               AUN 网络链路诊断
+
+配置与诊断:
+  config            读取、修改和检查分层配置
+  stats             Token 用量与费用统计
+  diagnose          检查启动环境
+  version           显示组件版本
+  mv                迁移项目目录和会话路径
+
+维护命令:
+  data migrate      迁移 per-Agent 用户数据（显式维护窗口）
+  mode              切换开发源码与 npm 包运行模式
+  restart-monitor   运行 daemon 重启监控器
+  bench             AUN 消息性能基准测试
+  link-rules        连接 ECK rules 到项目目录
+
+运行 ec <command> --help 查看该命令的完整参数。
+
+环境变量:
+  EVOLCORE_HOME     数据目录（默认: ~/.evolcore）
+  LOG_LEVEL         日志级别（默认: INFO）
+  MESSAGE_LOG       消息日志（默认: true）
   EVENT_LOG         事件日志（默认: true）`;
 function printLifecycleHelp(command) {
     const help = {
@@ -80,7 +80,7 @@ function printLifecycleHelp(command) {
         logs: `用法: ec logs [选项]\n\n  --level <error|warn|info|debug>  最低日志级别\n  --module <name>                  只显示指定模块\n  --raw                            原始输出\n  --no-color                       禁用颜色`,
         watch: `用法: ec watch [logs|log|aid|msg|web|session]\n\n  ec watch                 打开监控选择菜单\n  ec watch logs            选择日志类型后监控\n  ec watch log <类型...>   直接监控指定日志类型\n  ec watch aid             监控 AID 连接\n  ec watch msg             打开消息 TUI\n  ec watch web             安装/升级并启动 EC Web\n  ec watch session         ec watch web 的兼容别名`,
         'restart-monitor': '用法: ec restart-monitor\n\n运行内 daemon 重启与升级监控器。',
-        diagnose: '用法: ec diagnose\n\n检查配置、数据库、进程和编译产物。',
+        diagnose: '用法: ec diagnose [--codex-hook]\n\n检查配置、数据库、进程和编译产物。\n\n  --codex-hook 运行 Windows Codex managed hook 启动探针。',
         mv: '用法: ec mv <old-directory> <new-directory>\n\n迁移项目目录以及 Claude、Codex 和 EvolCore 会话路径。',
     };
     console.log(help[command]);
@@ -115,32 +115,32 @@ export async function main(args) {
         case 'init': {
             try {
                 if (wantsHelp(args.slice(1))) {
-                    console.log(`用法: ec init [渠道] [选项]
-
-仅初始化 defaults.json:
-  ec init                          交互式（写完 defaults.json 后嵌套 agent new）
-                                  选择 ecagent 时会继续询问 API Key 和 Base URL
-  ec init --non-interactive [选项]
-    --baseagent <claude|codex|gemini|ecagent>    默认: PATH 中第一个可用项；ecagent 需显式选择
-    --force                              已存在 defaults.json 时覆盖
-
-云部署非交互式初始化（结构化 JSON 输出）:
-  ec init --non-interactive --owner <aid> [--format json] [选项]
-    --owner <aid>                        必填。唯一 daemon owner AID
-    --baseagent <claude|codex|gemini|ecagent>    可选。默认从 PATH 检测，ecagent 需显式选择
-    --projectpath <abs-path>             可选。默认项目目录（必须绝对路径，自动创建）
-    --ecweb                              可选。安装 EC Web 并启用自启动
-    --auto-start                         Windows/macOS 上启用 EvolCore 登录自启动
-    --no-auto-start                      Windows/macOS 上禁用 EvolCore 登录自启动
-    --format json                        可选但推荐。stdout 输出 init.result JSON
-    --force                              已有不同 owner 时强制覆盖
-
-配置渠道（先 ec agent new 创建 agent）:
-  ec init aun           AUN owner 追加绑定（daemon 或指定 agent）
-  ec init feishu        飞书扫码登录
-  ec init wechat        微信扫码登录
-  ec init dingtalk      钉钉扫码登录
-  ec init qqbot         QQ 机器人扫码绑定
+                    console.log(`用法: ec init [渠道] [选项]
+
+仅初始化 defaults.json:
+  ec init                          交互式（写完 defaults.json 后嵌套 agent new）
+                                  选择 ecagent 时会继续询问 API Key 和 Base URL
+  ec init --non-interactive [选项]
+    --baseagent <claude|codex|gemini|ecagent>    默认: PATH 中第一个可用项；ecagent 需显式选择
+    --force                              已存在 defaults.json 时覆盖
+
+云部署非交互式初始化（结构化 JSON 输出）:
+  ec init --non-interactive --owner <aid> [--format json] [选项]
+    --owner <aid>                        必填。唯一 daemon owner AID
+    --baseagent <claude|codex|gemini|ecagent>    可选。默认从 PATH 检测，ecagent 需显式选择
+    --projectpath <abs-path>             可选。默认项目目录（必须绝对路径，自动创建）
+    --ecweb                              可选。安装 EC Web 并启用自启动
+    --auto-start                         Windows/macOS 上启用 EvolCore 登录自启动
+    --no-auto-start                      Windows/macOS 上禁用 EvolCore 登录自启动
+    --format json                        可选但推荐。stdout 输出 init.result JSON
+    --force                              已有不同 owner 时强制覆盖
+
+配置渠道（先 ec agent new 创建 agent）:
+  ec init aun           AUN owner 追加绑定（daemon 或指定 agent）
+  ec init feishu        飞书扫码登录
+  ec init wechat        微信扫码登录
+  ec init dingtalk      钉钉扫码登录
+  ec init qqbot         QQ 机器人扫码绑定
   ec init wecom         企业微信 AI Bot 扫码创建/手工配置`);
                 }
                 else {
@@ -309,7 +309,7 @@ export async function main(args) {
                 printLifecycleHelp('diagnose');
                 break;
             }
-            await cmdDiagnose();
+            await cmdDiagnose(args.slice(1));
             break;
         case 'data': {
             const { cmdData } = await import('./data-command.js');

package/dist/cli/link-rules.js

@@ -79,27 +79,27 @@ function cleanEmptyParents(dir) {
 }
 // ── 子命令 ──
 function showHelp() {
-    console.log(`Usage: ec link-rules <subcommand> [baseagent] [--dir <path>]
-
-Subcommands:
-  connect       Connect ECK rules to a project directory (default: cwd)
-  disconnect    Remove ECK rules connection for a baseagent
-  status        Show connection state for all baseagents
-
-Arguments:
-  baseagent     Target base agent: ${KNOWN_BASEAGENTS.join(', ')} (default: cc)
-  --dir <path>  Target directory (default: current working directory)
-
-Supported baseagents:
-  cc            Claude Code (.claude/rules/eck/)
-  codex         Codex (.codex/rules/eck/)
-  gemini        Gemini CLI (.gemini/rules/eck/)
-
-Examples:
-  ec link-rules connect              # connect cc in cwd
-  ec link-rules connect codex        # connect codex in cwd
-  ec link-rules connect cc --dir /x  # connect cc in specific dir
-  ec link-rules disconnect cc        # disconnect cc
+    console.log(`Usage: ec link-rules <subcommand> [baseagent] [--dir <path>]
+
+Subcommands:
+  connect       Connect ECK rules to a project directory (default: cwd)
+  disconnect    Remove ECK rules connection for a baseagent
+  status        Show connection state for all baseagents
+
+Arguments:
+  baseagent     Target base agent: ${KNOWN_BASEAGENTS.join(', ')} (default: cc)
+  --dir <path>  Target directory (default: current working directory)
+
+Supported baseagents:
+  cc            Claude Code (.claude/rules/eck/)
+  codex         Codex (.codex/rules/eck/)
+  gemini        Gemini CLI (.gemini/rules/eck/)
+
+Examples:
+  ec link-rules connect              # connect cc in cwd
+  ec link-rules connect codex        # connect codex in cwd
+  ec link-rules connect cc --dir /x  # connect cc in specific dir
+  ec link-rules disconnect cc        # disconnect cc
   ec link-rules status               # show all connections`);
 }
 function showStatus() {

package/dist/cli/managed-command-guard.js

@@ -12,6 +12,9 @@ const MANAGED_TASK_COMMANDS = new Set([
     'msg',
     'queue',
     'response',
+    // `stats` reads the usage database directly. It authorizes each managed call
+    // against the task's relation role in `resolveManagedStatsScope`.
+    'stats',
     'status',
     'storage',
     'trigger',

package/dist/cli/menu-client.js

@@ -56,17 +56,17 @@ function validateOptions(args) {
 }
 export async function cmdMenuClient(args) {
     if (wantsHelp(args)) {
-        console.log(`用法: ec menu-client request <from-aid> <daemon-aid> [选项]
-
-  --request-file <path>    从 JSON 文件读取一个 menu.* 请求
-  --request-json <json>    直接传入一个 menu.* JSON 请求
-  --timeout <时长>         默认 15s，最大 120s
-  --encrypt                使用 E2EE（默认）
-  --no-encrypt             已拒绝：ec-menu-client 必须使用 E2EE
-  --remote-token <token>   使用 daemon 远程访问 token 临时授权
-  --ecweb-token <token>    --remote-token 的兼容别名
-  --app <slot>             覆盖默认 evolcore-menu-client 消费槽位
-  --aun-path <path>        覆盖本地 AUN keystore 根目录
+        console.log(`用法: ec menu-client request <from-aid> <daemon-aid> [选项]
+
+  --request-file <path>    从 JSON 文件读取一个 menu.* 请求
+  --request-json <json>    直接传入一个 menu.* JSON 请求
+  --timeout <时长>         默认 15s，最大 120s
+  --encrypt                使用 E2EE（默认）
+  --no-encrypt             已拒绝：ec-menu-client 必须使用 E2EE
+  --remote-token <token>   使用 daemon 远程访问 token 临时授权
+  --ecweb-token <token>    --remote-token 的兼容别名
+  --app <slot>             覆盖默认 evolcore-menu-client 消费槽位
+  --aun-path <path>        覆盖本地 AUN keystore 根目录
   --format json            输出标准 menu.response JSON`);
         return;
     }

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) {