evolcore 0.0.2 → 0.0.4

package/dist/cli/index.js

@@ -3,18 +3,82 @@
 process.env.AUN_LOG_INI_DISABLE = '1';
 import fs from 'fs';
 import path from 'path';
-import { resolvePaths, getPackageRoot } from '../paths.js';
+import { getPackageRoot } from '../paths.js';
 import { cmdInit } from './init.js';
 import { cmdInitWechat, cmdInitFeishu, cmdInitDingtalk, cmdInitQQBot, cmdInitWecom, cmdInitAun } from './init-channel.js';
-import { isHelpFlag, getArgValue } from './help.js';
+import { isHelpFlag, wantsHelp, getArgValue } from './help.js';
 import * as platform from '../utils/cross-platform.js';
 import { cmdRestartMonitor } from './restart-monitor.js';
 import { cmdAid, cmdRpc, cmdStorage, cmdMsg, cmdGroup } from './aun-commands.js';
 import { cmdAgent } from './agent-command.js';
 import { cmdCtl } from './ctl-command.js';
 import { cmdQueue } from './queue-command.js';
-import { cmdStart, cmdStop, cmdRestart, cmdStatus, cmdLogs, cmdWatchCommand, cmdDev, cmdMv, cmdDiagnose } from './daemon-commands.js';
+import { cmdStart, cmdStop, cmdRestart, cmdStatus, cmdLogs, cmdWatchCommand, cmdMv, cmdDiagnose } from './daemon-commands.js';
 import { logCliCommand } from './command-log.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
+  contact           联系人黑名单管理
+  net               AUN 网络链路诊断
+
+配置与诊断:
+  config            读取、修改和检查分层配置
+  stats             Token 用量与费用统计
+  diagnose          检查启动环境
+  version           显示组件版本
+  mv                迁移项目目录和会话路径
+
+维护命令:
+  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 = {
+        start: `用法: ec start [--foreground] [--diagnose|-d]\n\n  --foreground   前台运行，适合 systemd 或容器直接管理\n  --diagnose, -d 以诊断模式启动 daemon`,
+        stop: '用法: ec stop\n\n停止当前 EVOLCORE_HOME 下运行的 EvolCore 服务。',
+        restart: `用法: ec restart [--clear] [--diagnose|-d]\n\n  --clear        同时清理跨 HOME 残留的 EvolCore 主进程\n  --diagnose, -d 以诊断模式启动新 daemon`,
+        status: '用法: ec status\n\n查看 daemon、agent、渠道与会话运行状态。',
+        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检查配置、数据库、进程和编译产物。',
+        mv: '用法: ec mv <old-directory> <new-directory>\n\n迁移项目目录以及 Claude、Codex 和 EvolCore 会话路径。',
+    };
+    console.log(help[command]);
+}
 // Suppress Node.js ExperimentalWarning (e.g. SQLite) from cluttering CLI output
 process.removeAllListeners('warning');
 process.on('warning', (w) => { if (w.name === 'ExperimentalWarning')
@@ -27,9 +91,13 @@ export async function main(args) {
         console.log(pkg.version);
         return;
     }
+    if (isHelpFlag(cmd)) {
+        console.log(MAIN_HELP);
+        return;
+    }
     switch (cmd) {
         case 'init':
-            if (isHelpFlag(args[1])) {
+            if (wantsHelp(args.slice(1))) {
                 console.log(`用法: ec init [渠道] [选项]
 
 仅初始化 defaults.json:
@@ -43,7 +111,7 @@ export async function main(args) {
     --owner <aid>                        必填。唯一 daemon owner AID
     --baseagent <claude|codex|gemini>    可选。默认从 PATH 检测
     --projectpath <abs-path>             可选。默认项目目录（必须绝对路径，自动创建）
-    --ecweb                              可选。启用 ECWeb 自启动
+    --ecweb                              可选。安装 EC Web 并启用自启动
     --format json                        可选但推荐。stdout 输出 init.result JSON
     --force                              已有不同 owner 时强制覆盖
 
@@ -53,7 +121,7 @@ export async function main(args) {
   ec init wechat        微信扫码登录
   ec init dingtalk      钉钉扫码登录
   ec init qqbot         QQ 机器人扫码绑定
-  ec init wecom         企业微信 AI Bot 配置（手动输入）`);
+  ec init wecom         企业微信 AI Bot 扫码创建/手工配置`);
             }
             else if (args[1] === 'aun') {
                 const { suppressSdkLogs } = await import('../aun/aid/index.js');
@@ -105,36 +173,84 @@ export async function main(args) {
             }
             break;
         case 'start':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('start');
+                break;
+            }
             await cmdStart({
                 diagnose: args.includes('--diagnose') || args.includes('-d'),
                 foreground: args.includes('--foreground'),
             });
             break;
         case 'stop':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('stop');
+                break;
+            }
             await cmdStop();
             break;
         case 'restart':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('restart');
+                break;
+            }
             await cmdRestart({ clear: args.includes('--clear'), diagnose: args.includes('--diagnose') || args.includes('-d') });
             break;
         case 'status':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('status');
+                break;
+            }
             await cmdStatus();
             break;
         case 'logs':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('logs');
+                break;
+            }
             cmdLogs(args.slice(1));
             break;
         case 'watch':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('watch');
+                break;
+            }
             await cmdWatchCommand(args.slice(1));
             break;
         case 'restart-monitor':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('restart-monitor');
+                break;
+            }
             await cmdRestartMonitor();
             break;
-        case 'dev':
-            await cmdDev(args.slice(1));
+        case 'mode':
+            try {
+                // 开发源码仓可提供 mode.js；正式 npm 包可以不携带该内部命令。
+                const { cmdMode } = await import('./mode.js');
+                await cmdMode(args.slice(1));
+            }
+            catch (error) {
+                if (error?.code === 'ERR_MODULE_NOT_FOUND' && /(?:^|[\\/])mode\.js(?:$|')/.test(String(error?.message ?? ''))) {
+                    console.error('❌ 无效指令: mode');
+                    process.exitCode = 1;
+                    break;
+                }
+                throw error;
+            }
             break;
         case 'mv':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('mv');
+                break;
+            }
             await cmdMv(args[1], args[2]);
             break;
         case 'diagnose':
+            if (wantsHelp(args.slice(1))) {
+                printLifecycleHelp('diagnose');
+                break;
+            }
             await cmdDiagnose();
             break;
         case 'net': {
@@ -217,6 +333,11 @@ export async function main(args) {
             await cmdConfig(args.slice(1));
             break;
         }
+        case 'contact': {
+            const { cmdContact } = await import('./contact.js');
+            await cmdContact(args.slice(1));
+            break;
+        }
         case 'stats': {
             const { handleStats } = await import('./stats.js');
             await handleStats(args.slice(1));
@@ -242,114 +363,9 @@ export async function main(args) {
             break;
         }
         default:
-            console.log(`Usage: ec {init|start|stop|restart|status|logs|watch|ctl|queue|trigger|handoff|diagnose|net|mv}
-
-Commands:
-  init          初始化 evolcore home (${resolvePaths().defaultsConfig})
-  init feishu   飞书扫码登录并写入配置
-  init wechat   微信扫码登录并写入配置
-  init dingtalk 钉钉扫码登录并写入配置
-  init qqbot    QQ 机器人扫码绑定并写入配置
-  init wecom    企业微信 AI Bot 配置（手动输入 Bot ID + Secret）
-  start         启动服务 (默认)
-                  --foreground  前台运行，适合 systemd/Docker 直接管理进程
-  stop          停止服务
-  restart       重启服务
-                  --clear  顺带 SIGKILL 跨 HOME 残留的 evolcore 主进程
-  status        查看状态
-  logs          查看日志 (tail -f, 着色渲染)
-                  --level error|warn   只显示指定级别及以上
-                  --module <name>      只显示指定模块（如 feishu、AgentRunner）
-                  --raw                原始输出，不着色
-  watch         监控面板选择菜单（↑↓ 选择 log/aid/msg）
-  watch logs    勾选日志类型后实时监控（记忆上次选择，存入 daemon.json）
-  watch log <类型...>  直接监控指定类型（如 evolcore aun），不读写偏好
-  watch aid     AID 连接状态实时监控（显示各 AID 在线/离线/重连状态）
-  watch msg     消息监控（三面板交互式 TUI：AID 列表 / 对端统计 / 消息流）
-  ctl           当前会话工具（发送消息/文件、名称、队列、路径、状态）
-                  ec ctl help 查看完整命令列表
-  trigger       daemon 级触发器管理（list/show/history/create/update/run）
-  handoff       跨会话任务回流
-                  handoff return [id] [content]  确认当前 handoff；required 策略需提供内容
-                  handoff list/trace             查询实例和审计事件
-  queue          消息队列查询与操作
-                  queue --agent <aid>          查看 agent 的所有队列
-                  queue --agent <aid> --clear  清空待处理消息
-                  queue --agent <aid> --interrupt --sessionkey <key>  打断处理中任务
-  agent         管理 EvolAgent
-                  agent              列出所有 agent
-                  agent <name>       查看指定 agent 详情
-                  agent new <name>   创建新 agent（交互式）
-                  agent new <name> --non-interactive ...  非交互创建（自动化）
-                    必填: --project <absolute path>
-                    可选: --baseagent <claude|codex|gemini>  (默认: PATH 中第一个可用)
-                          --owner <aid>
-                          --name <display-name>
-                          --description <text>
-                          --force                            (覆盖已有 config.json)
-                  agent reload       全量 resync（扫磁盘，新增上线、删除下线、修改热更新）
-                  agent reload <n>   热重载指定 agent 配置
-  model         模型管理（agent/关系可写，支持角色策略预览）
-                  model list         列出可用模型并显示当前生效模型
-                  model current      显示实际生效的模型、强度和来源
-                  model info <id>    查看模型详情
-                  model use <id>     设置模型（写操作需要 --self）
-                  model effort <lv>  设置推理强度
-                  model reset        清除当前作用域的模型和强度设置
-                  model check        诊断网关与模型可用性
-  response      响应模式管理（查看/切换/配置，作用域：全局/agent/关系）
-                  response list      列出所有响应模式
-                  response current   显示当前作用域生效的默认模式
-                  response info <id> 查看单个模式详情（场景/配置参数）
-                  response set <id>  设置默认模式（--scene private/group）
-                  response config    查看/修改模式配置参数
-                  response reset     清除指定作用域设置
-                  response help      查看完整用法
-  aid           AID 身份管理
-                  aid list           列出本地所有 AID
-                  aid show <aid>     查看本地 AID 详情（证书有效期、私钥状态）
-                  aid new <aid>      创建新 AID 身份
-                  aid lookup <aid>   远程探测 AID（是否存在 + 网关 + agent.md）
-                  aid agentmd put <aid>  签名并上传 agent.md
-                  aid agentmd get <aid>  下载并验签 agent.md
-                  aid delete <aid>             删除指定 AID
-                  aid delete --orphan          清理无私钥的外部 AID 缓存
-                  aid delete --unrecoverable   清理云端公钥已变更、不可恢复的 AID
-                                                 默认 dry-run，加 --yes 执行
-  fs            AUN 文件系统统一入口
-                  fs ls|stat|cat|find <AID>:/path
-                  fs cp <src> <dst>      上传/下载/远程复制
-                  fs mv <src> <dst>      移动/改名（同后端）
-                  fs rm [-r] <AID>:/path
-                  fs mkdir [-p] <AID>:/path
-                  fs ln -s <target> <AID>:/path
-                  fs chmod +r|o-r <AID>:/path
-                  fs setfacl|getfacl <AID>:/path
-                  fs token issue|revoke|ls <AID>:/path
-                  fs df <AID>:
-                  fs mount <target> --volume <id>|--source <src>
-  net           网络链路诊断
-                  net check [<aid>]  10 步链路检测（DNS→Discovery→TCP→TLS→WSS→Auth→Ping→Echo）
-                  net help           查看详细帮助
-  rpc           AUN RPC 调用
-                  rpc --as <aid> --params <json|jsonl|file>
-  storage       文件存储
-                  storage upload <aid> <file> <path> [--public]
-                  storage download <aid> <url> [local-path]
-                  storage ls <aid> [prefix]
-                  storage rm <aid> <path>
-                  storage quota <aid>
-  diagnose      诊断启动环境（配置、数据库、进程）
-  mv <old> <new>  迁移项目目录（保留 Claude/Codex/EvolCore 会话）
-  bench         AUN 消息性能基准测试
-                  bench --aids 5 --rounds 10 --concurrency 5
-
-Environment:
-  EVOLCORE_HOME   数据目录 (默认: ~/.evolcore)
-  LOG_LEVEL       日志级别 (默认: INFO)
-  MESSAGE_LOG     消息日志 (默认: true)
-  EVENT_LOG       事件日志 (默认: true)`);
-            process.exit(1);
+            console.error(`未知命令: ${cmd}`);
+            console.log(MAIN_HELP);
+            process.exitCode = 1;
     }
 }
 // 直接运行时自动执行（node dist/cli/index.js ...）