evolclaw 3.1.4 → 3.1.5

package/kits/rules/06-channel.md

@@ -6,45 +6,41 @@
 
 | 位置 | 内容 |
 |------|------|
-| `$KITS_DOCS/channels/` | 各渠道的使用手册（只读，按需加载） |
+| `$KITS_DOCS/channels/` | 各渠道的**知识文档**：配置、参数、特有机制（只读，按需加载） |
 | `$AGENT_DIR/channels/` | 各渠道的运行时数据（可写） |
 
-## 通信规则
-
-与其他主体通信时，**必须调用 CLI 命令**发消息，不要把输出当成发送给对方的内容。
+> 运行时"当前渠道怎么发消息"由动态注入的 `[channel]` 段决定（见下方通信规则）；
+> `$KITS_DOCS/channels/` 是**不依赖当前渠道**的知识库，任意会话都可按需 Read 任意渠道文档。
 
-当前渠道的发消息命令已在上下文中注入（见 `[aun]` 或对应渠道块）。
+## 通信规则
 
-### 仅在无法获取 self-aid 时才用 `ec ctl send`
+与其他主体通信**必须调用 CLI 命令**（首选 `ec msg send <self-aid> <peer-id> "<text>"`），
+不要把模型输出当成发送给对方的内容。当前渠道的发消息命令已在上下文中注入（见 `[aun]` 或对应渠道块）。
 
-```bash
-ec ctl send "<text>"
-ec ctl send --encrypt "<text>"
-```
+> proactive 模式尤其注意：你直接输出的普通文本会被投影成"思考过程"实时展示给用户，
+> 它可见、但不入消息历史、也不是发给对端的回复。只有显式调用 `ec msg send` 对端才真正收到。
+> 拿不到 self-aid 时才退回 `ec ctl send "<text>"`（自动继承当前会话的 AID 和对端）。
 
 ### 命令返回值
 
 - 成功：`ok` 或包含 `✓ 已发送 ...` 的输出（exit 0）
 - 失败：`✗ ...` 错误信息（exit 非零）
 
-发送成功后**继续后续处理**。一次任务可能发 0 到多条消息，不要因为看到"已发送"就反复发送同一条消息。
-
-## Agent 管理命令
+发送成功后**继续后续处理**。一次任务可能发 0 到多条消息不要因为看到"已发送"就反复发送同一条消息。
 
-`evolclaw agent` — agent 全生命周期管理。
+## 命令集
 
-触发词：创建/新建/初始化、列出/查看、启用/禁用/删除、热重载、修改配置。
+所有命令以 `ec` 为前缀，以自己的 AID 为发送者。详细用法按需 Read 对应文档。
 
-详细参考：Read `$KITS_DOCS/evolclaw/AGENT_CMD.md`
-
-## 消息命令
-
-`evolclaw msg` / `evolclaw group` — 通信 CLI。
-
-| 聊天类型 | 详细文档 |
-|----------|----------|
-| private | `$KITS_DOCS/evolclaw/MSG_PRIVATE.md` |
-| group | `$KITS_DOCS/evolclaw/MSG_GROUP.md` |
+| 命令集 | 用途 | 触发词 | 详细文档 |
+|--------|------|--------|----------|
+| `ec msg` | 私聊收发消息 | 回复/发消息/拉取/撤回 | `$KITS_DOCS/evolclaw/msg.md` |
+| `ec group` | 群聊收发与群管理 | 群发/建群/邀请/踢人 | `$KITS_DOCS/evolclaw/group.md` |
+| `ec agent` | EvolAgent 生命周期 | 创建/启用禁用/热重载/改配置 | `$KITS_DOCS/evolclaw/agent.md` |
+| `ec aid` | AID 身份管理 | 身份/证书/名片/探测对端 | `$KITS_DOCS/evolclaw/aid.md` |
+| `ec storage` | 文件存储 | 上传/下载/配额 | `$KITS_DOCS/evolclaw/storage.md` |
+| `ec ctl` | 会话运行时自管理 | 切模型/推理强度/压缩/重启 | `$KITS_DOCS/evolclaw/ctl.md` |
+| `ec rpc` | 底层 AUN RPC（逃生通道） | 直接调协议方法 | `$KITS_DOCS/evolclaw/rpc.md` |
 
 共同约定：
 - 以自己的 AID 为发送者
@@ -52,6 +48,13 @@ ec ctl send --encrypt "<text>"
 - `--format json` 所有命令通用
 - `--app <name>` 指定应用 slot
 
-## 各渠道文档
+## 各渠道知识文档（按需加载）
+
+`$KITS_DOCS/channels/` 下每个渠道一份知识文档，内容是该渠道的**配置、参数、特有机制**——
+属于知识性内容，**不依赖**当前注入的渠道类型。需要了解某渠道怎么配置、有哪些参数、
+有哪些特别机制时，按需 Read 对应文档（在 aun 会话里也可查飞书，反之亦然）。
 
-不同渠道的详细通信规则和命令工具使用方式：Read `$KITS_DOCS/channels/` 中的对应文档。
+| 渠道 | 文档 | 触发词 |
+|------|------|--------|
+| AUN | `$KITS_DOCS/channels/aun.md` | aun 怎么配置/网关/E2EE/群 ID 格式/证书链 |
+| 飞书 | `$KITS_DOCS/channels/feishu.md` | 飞书怎么配置/appId/合并转发/卡片/user_id |

package/kits/templates/system-fragments/session.md

@@ -2,11 +2,17 @@
 project: {{project}} # 项目目录名
 CURRENT_PROJECT: {{CURRENT_PROJECT}} # 项目完整路径
 sessionId: {{sessionId}} # evolclaw 会话 ID
+{{?sessionKey}}
+sessionKey: {{sessionKey}} # 会话路由键（channelType#urlEncode(channelId)#urlEncode(threadId)）
+{{/}}
 {{?sessionName}}
 sessionName: {{sessionName}}
 {{/}}
 sessionCreatedAt: {{sessionCreatedAt}}
 chatMode: {{chatMode}} # interactive=同步对话 / proactive=主动推送（输出静默）
+{{?permissionMode}}
+permissionMode: {{permissionMode}} # auto / bypass / request / edit / plan / noask / readonly
+{{/}}
 {{?threadId}}
 threadId: {{threadId}} # 同一会话内的子话题 ID（多话题路由时）
 {{/}}
@@ -14,7 +20,8 @@ threadId: {{threadId}} # 同一会话内的子话题 ID（多话题路由时）
 readonly: true — 禁止修改项目文件，如需生成文件请写入 .evolclaw/tmp/
 {{/}}
 {{?chatMode=proactive}}
-# proactive 模式：文本输出静默丢弃，必须用以下命令发消息
-proactive-send: evolclaw ctl send "<text>"
-proactive-file: evolclaw ctl file <path>
+# proactive 模式：你的普通文本会作为"思考过程"实时展示给用户（可见，但不入消息历史、不是回复）。
+# 要正式回复对端，必须显式调用发送命令（命令集见 06-channel）。
+proactive-send: ec msg send {{selfAid}} {{peerId}} "<text>"   # 拿不到 self-aid 时退回 ec ctl send "<text>"
+proactive-file: ec msg send {{selfAid}} {{peerId}} --file <path> --as <image|video|voice|file>
 {{/}}

package/kits/templates/system-fragments/venue.md

@@ -5,3 +5,12 @@ PACKAGE_ROOT: {{PACKAGE_ROOT}} # evolclaw 安装目录（kits/rules/docs）
 {{?venueUid}}
 venueUid: {{venueUid}}
 {{/}}
+{{?dispatch}}
+dispatch: {{dispatch}} # 群分发模式：mention(被@才响应) / broadcast(所有消息都响应)
+{{/}}
+{{?clientType}}
+clientType: {{clientType}} # 客户端类型：desktop / web / mobile
+{{/}}
+{{?groupId}}
+groupId: {{groupId}}
+{{/}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolclaw",
-  "version": "3.1.4",
+  "version": "3.1.5",
   "description": "Lightweight AI Agent gateway connecting Claude Agent SDK to messaging channels (Feishu, ACP) with multi-project session management",
   "type": "module",
   "main": "dist/index.js",
@@ -22,20 +22,24 @@
   ],
   "scripts": {
     "dev": "tsx watch src/index.ts",
-    "build": "tsc && node -e \"const f='dist/cli/index.js',c=require('fs').readFileSync(f,'utf8');if(!c.startsWith('#!'))require('fs').writeFileSync(f,'#!/usr/bin/env node\\n'+c)\" && node -e \"try{require('child_process').execFileSync('chmod',['+x','dist/cli/index.js'])}catch{}\" && node -e \"require('fs').mkdirSync('dist/data',{recursive:true});require('fs').copyFileSync('src/data/error-dict.json','dist/data/error-dict.json')\"",
+    "build": "tsc && node -e \"const f='dist/cli/index.js',c=require('fs').readFileSync(f,'utf8');if(!c.startsWith('#!'))require('fs').writeFileSync(f,'#!/usr/bin/env node\\n'+c)\" && node -e \"try{require('child_process').execFileSync('chmod',['+x','dist/cli/index.js'])}catch{}\" && node -e \"require('fs').mkdirSync('dist/data',{recursive:true});require('fs').copyFileSync('src/data/error-dict.json','dist/data/error-dict.json')\" && node -e \"require('fs').cpSync('src/cli/watch-web/static','dist/cli/watch-web/static',{recursive:true})\"",
     "start": "node dist/index.js",
-    "test": "flock --nonblock /tmp/evolclaw-test.lock vitest run || { echo '\\n[ERROR] Another vitest instance is already running. Wait or kill it first.' >&2; exit 1; }",
+    "test": "vitest run",
     "test:watch": "vitest",
     "test:hooks": "tsx test-sdk-hooks.ts",
     "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
-    "@agentunion/fastaun": "^0.3.3",
-    "@anthropic-ai/claude-agent-sdk": "^0.2.100",
+    "@agentunion/fastaun": "^0.4.7",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.156",
+    "@anthropic-ai/sdk": "^0.100.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "cron-parser": "^5.5.0",
     "dotenv": "^17.4.2",
     "image-type": "^6.0.0",
-    "qrcode-terminal": "^0.12.0"
+    "qrcode-terminal": "^0.12.0",
+    "ws": "^8.21.0",
+    "zod": "^4.0.0"
   },
   "optionalDependencies": {
     "@larksuiteoapi/node-sdk": "^1.59.0",
@@ -49,6 +53,7 @@
     "@types/form-data": "^2.2.1",
     "@types/node": "^25.5.0",
     "@types/qrcode-terminal": "^0.12.2",
+    "@types/ws": "^8.18.1",
     "@vitest/coverage-v8": "^4.1.0",
     "tsx": "^4.19.0",
     "typescript": "^5.6.0",

package/dist/aun/aid/lifecycle-log.js

@@ -1,33 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import { resolvePaths } from '../../paths.js';
-function ensureDir(dir) {
-    fs.mkdirSync(dir, { recursive: true });
-}
-function logPath(aid) {
-    const aidName = aid.startsWith('@') ? aid.slice(1) : aid;
-    return path.join(resolvePaths().aidLogsDir, `${aidName}.jsonl`);
-}
-export function appendAidLifecycle(event) {
-    const filePath = logPath(event.aid);
-    ensureDir(path.dirname(filePath));
-    fs.appendFileSync(filePath, JSON.stringify(event) + '\n');
-}
-export function readAidLifecycle(aid, lastN = 50) {
-    const filePath = logPath(aid);
-    try {
-        const content = fs.readFileSync(filePath, 'utf-8');
-        const lines = content.trim().split('\n').filter(Boolean);
-        const events = [];
-        for (const line of lines.slice(-lastN)) {
-            try {
-                events.push(JSON.parse(line));
-            }
-            catch { }
-        }
-        return events;
-    }
-    catch {
-        return [];
-    }
-}

package/dist/utils/aid-lifecycle-log.js

@@ -1,33 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import { resolvePaths } from '../paths.js';
-function ensureDir(dir) {
-    fs.mkdirSync(dir, { recursive: true });
-}
-function logPath(aid) {
-    const aidName = aid.startsWith('@') ? aid.slice(1) : aid;
-    return path.join(resolvePaths().aidLogsDir, `${aidName}.jsonl`);
-}
-export function appendAidLifecycle(event) {
-    const filePath = logPath(event.aid);
-    ensureDir(path.dirname(filePath));
-    fs.appendFileSync(filePath, JSON.stringify(event) + '\n');
-}
-export function readAidLifecycle(aid, lastN = 50) {
-    const filePath = logPath(aid);
-    try {
-        const content = fs.readFileSync(filePath, 'utf-8');
-        const lines = content.trim().split('\n').filter(Boolean);
-        const events = [];
-        for (const line of lines.slice(-lastN)) {
-            try {
-                events.push(JSON.parse(line));
-            }
-            catch { }
-        }
-        return events;
-    }
-    catch {
-        return [];
-    }
-}

package/kits/docs/evolclaw/AGENT_CMD.md

@@ -1,31 +0,0 @@
-# EvolClaw 可用命令
-
-通过 `evolclaw ctl <command> [args]` 管理运行时配置。仅在 evolclaw 托管环境中可用。
-
-## 查询类（所有用户）
-- `evolclaw ctl help` — 显示帮助
-- `evolclaw ctl status` — 显示会话状态
-- `evolclaw ctl check` — 检查渠道健康状态
-
-## 配置类（管理员）
-- `evolclaw ctl model` — 查看当前模型和可选列表
-- `evolclaw ctl model <model-id>` — 切换模型（如 `opus`, `sonnet`, `haiku`）
-- `evolclaw ctl effort` — 查看当前推理强度
-- `evolclaw ctl effort <low|medium|high|max>` — 切换推理强度
-- `evolclaw ctl compact` — 压缩当前会话上下文
-
-## 权限类
-- `evolclaw ctl perm` — 查看当前权限模式（管理员）
-- `evolclaw ctl perm <mode>` — 切换权限模式（仅 owner）
-
-## 运维类（仅 owner）
-- `evolclaw ctl activity <all|dm|owner|none>` — 查看/控制中间输出显示模式
-- `evolclaw ctl send [channel] <message>` — 发送消息
-- `evolclaw ctl file <path>` — 发送文件
-- `evolclaw ctl restart` — 重启服务
-- `evolclaw ctl restart <channel>` — 重连指定渠道
-- `evolclaw ctl agentmd` — 查看当前 agent.md
-- `evolclaw ctl agentmd put` — 发布本地 agent.md
-- `evolclaw ctl agentmd set <内容>` — 直接设置 agent.md 内容
-- `evolclaw ctl aid` — 列出所有 AUN 实例及连接状态
-- `evolclaw ctl aid new <aid>` — 创建新 AID 并热加载

package/kits/docs/evolclaw/MSG_GROUP.md

@@ -1,30 +0,0 @@
-# 群聊消息命令
-
-<!-- TODO: 填充群聊消息命令详细参考 -->
-
-## 发送群消息
-
-```bash
-evolclaw group send <from-aid> <group-id> "<message>"
-```
-
-## 拉取群消息
-
-```bash
-evolclaw group pull <self-aid> <group-id> --app <app-name>
-```
-
-## 群管理
-
-```bash
-evolclaw group create <owner-aid> --name "<group-name>"
-evolclaw group list <self-aid>
-evolclaw group info <self-aid> <group-id>
-evolclaw group invite <self-aid> <group-id> <target-aid>
-evolclaw group kick <self-aid> <group-id> <target-aid>
-evolclaw group members <self-aid> <group-id>
-```
-
-## 自主回复策略
-
-群聊中被 @ 才默认响应，可通过 venue policy 配置其他触发条件。

package/kits/docs/evolclaw/MSG_PRIVATE.md

@@ -1,72 +0,0 @@
-# 私聊消息命令
-
-## 发送消息
-
-### 以指定 AID 发送（首选）
-
-```bash
-# 明文
-ec msg send <from-aid> <to-aid> "<message>"
-
-# 密文（E2EE）
-ec msg send <from-aid> <to-aid> "<message>" --encrypt
-```
-
-### 发送文件
-
-```bash
-ec msg send <from-aid> <to-aid> --file <path>
-ec msg send <from-aid> <to-aid> --file <path> --as image
-ec msg send <from-aid> <to-aid> --file <path> --encrypt
-```
-
-`--as` 可选值：`image` | `video` | `voice` | `file`（默认按扩展名推断）
-
-## 拉取消息
-
-```bash
-ec msg pull <self-aid> --app <app-name>
-ec msg pull <self-aid> --app <app-name> --after-seq <N> --limit <N>
-```
-
-## 确认消息已读
-
-```bash
-ec msg ack <self-aid> <seq> --app <app-name>
-```
-
-`--app` 必须传，否则会污染 daemon 游标。
-
-## 撤回消息
-
-```bash
-ec msg recall <self-aid> <message-id>
-```
-
-## 查询在线状态
-
-```bash
-ec msg online <self-aid> <target-aid>
-```
-
-## 自主回复策略
-
-收到消息 ≠ 必须回复。是否回复、怎么回复、何时回复由 agent 自主决定。
-
-加密策略：
-- 对端发来密文消息时，回复也应使用 `--encrypt`（保持对话加密一致性）
-- 对端发来明文消息时，默认明文回复
-
-## 在当前会话中快速回复（备选）
-
-仅当无法使用 `ec msg send` 时（如不知道自己的 AID），可用 `ec ctl send`：
-
-```bash
-# 明文
-ec ctl send "<text>"
-
-# 密文
-ec ctl send --encrypt "<text>"
-```
-
-`ec ctl send` 自动继承当前会话的 AID 和对端，无需指定。

package/kits/docs/evolclaw/tools.md

@@ -1,25 +0,0 @@
-# EvolClaw 可用工具
-
-evolclaw 托管环境下，baseagent 可通过 Bash 工具调用以下命令：
-
-## 消息发送
-- `evolclaw ctl send "<消息>"` — 发送文本消息给当前对话方
-- `evolclaw ctl file <路径>` — 发送项目内文件
-
-## 运行时查询
-- `evolclaw ctl status` — 当前会话状态
-- `evolclaw ctl model` — 当前模型信息
-- `evolclaw ctl effort` — 当前推理强度
-- `evolclaw ctl check` — 渠道健康检查
-- `evolclaw ctl aid` — AUN 连接状态
-
-## 运行时配置
-- `evolclaw ctl model <id>` — 切换模型
-- `evolclaw ctl effort <level>` — 切换推理强度
-- `evolclaw ctl compact` — 压缩上下文
-- `evolclaw ctl perm <mode>` — 切换权限模式
-
-## agent.md 管理
-- `evolclaw ctl agentmd` — 查看当前 agent.md
-- `evolclaw ctl agentmd put` — 发布到 AUN 网络
-- `evolclaw ctl agentmd set <内容>` — 直接设置内容