evolclaw 2.1.2 → 2.3.0

package/README.md

@@ -1,8 +1,8 @@
 # EvolClaw
 
-> 把 Claude Code 装进飞书和微信 —— 随时随地，接力开发
+> AI Agent 统一网关 —— 连接 IM、终端、Agent 网络
 
-EvolClaw 是一个轻量级 AI Agent 网关，基于 Claude Agent SDK 构建。它将终端中的 Claude Code 能力延伸到飞书、微信等即时通讯工具，让你在手机上也能review 代码、调试问题、管理项目，真正实现多终端无缝接力开发。
+EvolClaw 是一个轻量级 AI Agent 网关系统。它为 Claude Code / Codex 等 AI Agent 提供统一接入层，支持飞书、微信、AUN Mesh 网络和终端 TUI 四种通道。人类可以通过手机 IM 随时接力开发，其他 Agent 也可以通过 AUN 网络直接调用你的 Agent —— 不只是人机交互，也是 Agent 间协作的基础设施。
 
 ## 核心特性
 
@@ -11,9 +11,11 @@ EvolClaw 是一个轻量级 AI Agent 网关，基于 Claude Agent SDK 构建。
 - 🚀 **轻量化设计**：进程模式运行，CLI 命令行管理，无端口开放，无容器依赖，无 UI 界面
 - 📁 **多项目支持**：每个项目独立会话，支持动态切换
 - 👥 **双模式会话**：多用户私聊会话隔离，群聊会话共享，满足不同协作场景
-- 🌐 **多渠道接入**：Channel Adapter 模式，飞书 + 微信扫码一键接入
+- 🌐 **多渠道接入**：Channel Adapter 模式，飞书 + 微信 + AUN Mesh 网络，扫码一键接入
+- 🤖 **Agent 间互联**：通过 AUN 网络，你的 Agent 可被其他 Agent 发现和调用
+- 🖥️ **终端 TUI 客户端**：`evolclaw tui` 直接在终端与远程 Agent 对话，无需 IM
 - 🔐 **分层权限**：用户级/管理员级命令分离，多用户安全隔离
-- 📊 **统一消息处理**：消息处理与渠道解耦，新增渠道仅需 ~15 行代码
+- 📦 **项目搬家**：`evolclaw mv` 一键迁移项目目录，保留 Claude/Codex/EvolClaw 全部会话历史
 - 💾 **会话持久化**：会话数据与 CLI 工具共享，不额外存储，服务重启不丢失
 - ⚡ **执行中插入**：任务执行中可发送新消息，自动中断当前任务并处理新请求
 - 🔕 **消息智能发送**：前台任务动态聚合批量发送，后台任务静默完成后通知
@@ -23,7 +25,8 @@ EvolClaw 是一个轻量级 AI Agent 网关，基于 Claude Agent SDK 构建。
 
 - **通勤路上**：手机打开飞书，继续昨晚的代码 review，到公司无缝切回终端
 - **会议间隙**：微信快速问一句「这个接口的返回格式是什么」，Agent 直接查代码回复
-- **下班之后**：躺在沙发上用手机跟进 CI 报错，让 Agent 定位问题并修复
+- **终端直连**：`evolclaw tui` 在任意终端直接与远程 Agent 对话，无需打开 IM
+- **Agent 协作**：通过 AUN 网络，让你的 Agent 被其他 Agent 调用，组成分布式协作
 - **外出离开工位**：不带电脑也能通过 IM 给 Agent 下达任务，回来看结果
 - **团队协作**：拉个飞书群，成员共享同一个 Agent 会话，一起讨论和调试
 
@@ -35,12 +38,13 @@ EvolClaw 是一个轻量级 AI Agent 网关，基于 Claude Agent SDK 构建。
 
 ### 核心组件
 
-1. **消息渠道层** (`src/channels/`) - Feishu WebSocket + WeChat HTTP 长轮询
-2. **消息队列层** (`src/core/message-queue.ts`) - 会话级串行处理 + 中断支持
+1. **消息渠道层** (`src/channels/`) - Feishu WebSocket + WeChat HTTP 长轮询 + AUN Mesh 网络
+2. **消息队列层** (`src/core/message/message-queue.ts`) - 会话级串行处理 + 中断支持
 3. **命令处理层** (`src/core/command-handler.ts`) - 斜杠命令处理（CommandHandler 类）
-4. **消息处理层** (`src/core/message-processor.ts`) - 统一事件处理引擎
-5. **会话管理层** (`src/core/session-manager.ts`) - 多项目会话管理
-6. **会话存储层** - JSONL 文件（CLI 共用）+ SQLite 元数据
+4. **消息处理层** (`src/core/message/message-processor.ts`) - 统一事件处理引擎
+5. **会话管理层** (`src/core/session/session-manager.ts`) - 多项目会话管理
+6. **交互路由层** (`src/core/interaction-router.ts`) - 卡片交互回调注册与路由
+7. **会话存储层** - JSONL 文件（CLI 共用）+ SQLite 元数据
 
 ### 消息流转
 
@@ -106,6 +110,9 @@ evolclaw init feishu
 
 # 单独配置微信（扫码登录）
 evolclaw init wechat
+
+# 单独配置 AUN（Mesh 网络通道）
+evolclaw init aun
 ```
 
 交互式引导完成以下配置：
@@ -150,6 +157,9 @@ evolclaw stop       # 停止服务
 evolclaw restart    # 重启服务
 evolclaw status     # 查看状态
 evolclaw logs       # 查看日志（tail -f）
+evolclaw tui        # 启动 AUN TUI 终端客户端
+evolclaw mv <old> <new>  # 项目搬家（保留全部会话）
+evolclaw diagnose   # 诊断启动环境
 
 # 开发模式（热重载）
 npm run dev
@@ -163,23 +173,36 @@ npm test
 ```
 evolclaw/
 ├── src/
+│   ├── agents/
+│   │   ├── claude-runner.ts        # Claude Agent SDK 封装
+│   │   ├── codex-runner.ts         # Codex Agent 封装
+│   │   └── gemini-runner.ts        # Gemini CLI 封装
 │   ├── core/
-│   │   ├── command-handler.ts       # 斜杠命令处理
-│   │   ├── session-manager.ts       # 会话管理（多项目支持）
-│   │   ├── message-queue.ts         # 消息队列（串行+中断）
-│   │   ├── message-processor.ts     # 统一消息处理引擎
-│   │   ├── stream-flusher.ts        # 批量发送（3秒窗口）
-│   │   ├── agent-runner.ts          # Claude Agent SDK 封装
-│   │   └── message-cache.ts         # 消息缓存
+│   │   ├── message/
+│   │   │   ├── message-bridge.ts   # 渠道 ↔ 核心消息桥
+│   │   │   ├── message-processor.ts # 统一消息处理引擎
+│   │   │   ├── message-queue.ts    # 消息队列（串行+中断）
+│   │   │   ├── message-cache.ts    # 消息缓存
+│   │   │   └── stream-flusher.ts   # 批量发送（3秒窗口）
+│   │   ├── session/
+│   │   │   ├── adapters/           # 各后端会话文件适配器
+│   │   │   └── session-manager.ts  # 会话管理（多项目支持）
+│   │   ├── command-handler.ts      # 斜杠命令处理
+│   │   ├── interaction-router.ts   # 卡片交互回调路由
+│   │   └── permission.ts           # 权限网关
 │   ├── channels/
 │   │   ├── feishu.ts               # 飞书 WebSocket 渠道
-│   │   └── wechat.ts               # 微信 ClawBot 渠道
+│   │   ├── wechat.ts               # 微信 ClawBot 渠道
+│   │   └── aun.ts                  # AUN Mesh 网络渠道
 │   ├── utils/                      # 工具函数
 │   ├── types.ts                    # 类型定义
 │   ├── config.ts                   # 配置加载
 │   ├── paths.ts                    # 路径解析
-│   ├── cli.ts                      # CLI 命令（init/start/stop/...）
+│   ├── cli.ts                      # CLI 命令（init/start/stop/tui/mv/...）
 │   └── index.ts                    # 主入口
+├── aun/
+│   ├── aun_cli.py                  # AUN TUI 客户端（Python）
+│   └── pyproject.toml              # AUN CLI 依赖声明
 └── data/
     └── evolclaw.sample.json        # 配置模板
 ```
@@ -191,7 +214,8 @@ evolclaw/
 **会话管理**：
 - `/new [名称]` - 创建新会话
 - `/slist` - 列出当前项目的所有会话
-- `/s <名称>` - 切换到指定会话
+- `/slist cli` - 列出未导入的 CLI 会话
+- `/s <名称|序号|uuid>` - 切换到指定会话
 - `/name <新名称>` - 重命名当前会话
 - `/del <名称>` - 删除指定会话（仅解绑，不删除文件）
 - `/status` - 显示会话状态
@@ -205,26 +229,27 @@ evolclaw/
 - `/p <name|path>` - 切换项目（保留会话历史）
 - `/bind <path>` - 绑定新项目目录
 
+**Agent 与模型**：
+- `/agent [name]` - 查看或切换 Agent 后端（claude / codex / gemini）
+- `/model [model]` - 查看或切换模型
+- `/effort [level]` - 查看或切换推理强度（low / medium / high / max / auto）
+- `/perm [mode]` - 查看或切换权限模式（auto / edit / default / readonly）
+
 **系统管理**：
 - `/clear` - 清空对话历史
 - `/compact` - 压缩会话上下文
 - `/stop` - 中断当前任务
+- `/send <文件路径>` - 发送文件给用户
+- `/check` - 系统健康检查面板
 - `/restart` - 重启服务（自愈机制）
 - `/repair` - 检查并修复会话
 - `/safe` - 进入安全模式
 
-**模型管理**：
-- `/model` - 显示当前模型和推理强度
-- `/model <model>` - 切换模型
-- `/model <effort>` - 切换推理强度（low / medium / high / max）
-- `/model <model> <effort>` - 同时切换模型和推理强度
-- `/model auto` - 恢复 SDK 默认推理强度
-
 ## 技术栈
 
 - **运行时**：Node.js >= 22 + TypeScript（ES modules）
-- **AI SDK**：@anthropic-ai/claude-agent-sdk >= 0.2.75
-- **消息渠道**：飞书（@larksuiteoapi/node-sdk）、微信（ClawBot ilink API）
+- **AI SDK**：@anthropic-ai/claude-agent-sdk >= 0.2.75、@openai/codex-sdk、Gemini CLI
+- **消息渠道**：飞书（@larksuiteoapi/node-sdk）、微信（ClawBot ilink API）、AUN Mesh 网络
 - **数据存储**：node:sqlite（内置模块）+ JSONL（CLI 共用）
 - **测试框架**：Vitest
 
@@ -232,8 +257,12 @@ evolclaw/
 
 - [x] Windows 系统 CLI 命令支持
 - [x] 微信插件支持图片/文件的收发
+- [x] AUN Mesh 网络通道接入
+- [x] TUI 终端客户端（`evolclaw tui`）
+- [x] 项目搬家工具（`evolclaw mv`）
 - [ ] 自动授权可配置（自动放行/自动拒绝）
-- [ ] 手动授权支持（飞书卡片/文本回复）
+- [x] 手动授权支持（文本回复）
+- [x] 手动授权支持（飞书卡片）
 - [ ] ACP 协议支持（接入 Codex / Gemini CLI）
 
 

package/data/evolclaw.sample.json

@@ -2,9 +2,20 @@
   "agents": {
     "anthropic": {
       "model": "sonnet"
-    }
+    },
+    "openai": {
+      "apiKey": "your-openai-api-key",
+      "baseUrl": "https://api.openai.com/v1",
+      "model": "gpt-5.2-codex",
+      "effort": "medium"
+    },
+    "google": {
+      "model": "gemini-2.5-flash"
+    },
+    "defaultAgent": "claude"
   },
   "channels": {
+    "defaultChannel": "feishu",
     "feishu": {
       "enabled": true,
       "appId": "",
@@ -16,9 +27,9 @@
       "token": ""
     },
     "aun": {
-      "enabled": true,
-      "domain": "your-aun-domain",
-      "agentName": "your-agent-name"
+      "enabled": false,
+      "aid": "your-agent.agentid.pub",
+      "gatewayPort": 443
     }
   },
   "projects": {