evolclaw 3.1.2 → 3.1.4

package/kits/rules/02-navigation.md

@@ -18,6 +18,7 @@
 | `$KITS_RULES` | `$KITS/rules` | 自动载入部分（本目录） |
 | `$KITS_DOCS` | `$KITS/docs` | 按需载入文档 |
 | `$KITS_TEMPLATES` | `$KITS/templates` | prompt 模板 |
+| `$KITS_FRAGMENTS` | `$KITS_TEMPLATES/system-fragments` | ECK 动态注入 fragment 模板 |
 | `$ECK` | `$EVOLCLAW_HOME/eck` | 运行时配置 |
 | `$AGENTS_DIR` | `$EVOLCLAW_HOME/agents` | per-agent 数据根 |
 | `$AGENT_DIR` | `$AGENTS_DIR/<self-aid>` | 当前 agent 根 |

package/kits/rules/05-venue.md

@@ -1,6 +1,6 @@
-# 环境层：我在什么场景下
+# 环境层：当前对话场景
 
-环境层决定当前会话加载哪些信息。动态注入的 `scene` 标识当前场景类型，`venueKey`（`<channel>#<urlEncode(venueId)>`）是 venue 在所有渠道中的稳定标识。
+环境层决定当前会话加载哪些信息。动态注入的 `chatType` 标识当前聊天类型（private/group/null），`venueUid` 是场所唯一标识（预留）。
 
 ## 场景判定
 

package/kits/rules/06-channel.md

@@ -13,29 +13,15 @@
 
 与其他主体通信时，**必须调用 CLI 命令**发消息，不要把输出当成发送给对方的内容。
 
-### 必须使用 `ec msg send`（首选）
+当前渠道的发消息命令已在上下文中注入（见 `[aun]` 或对应渠道块）。
 
-```bash
-# 明文
-ec msg send <self-aid> <to-aid> "<text>"
-
-# 密文
-ec msg send <self-aid> <to-aid> "<text>" --encrypt
-```
-
-`<self-aid>` 是注入上下文里的 selfAid，`<to-aid>` 是 peerKey 解析出的对端 AID。
-
-### 仅在无法获取 selfAid 时才用 `ec ctl send`
+### 仅在无法获取 self-aid 时才用 `ec ctl send`
 
 ```bash
 ec ctl send "<text>"
 ec ctl send --encrypt "<text>"
 ```
 
-### 加密策略
-
-对端发来密文消息时回复必须加密；明文消息默认明文回复。
-
 ### 命令返回值
 
 - 成功：`ok` 或包含 `✓ 已发送 ...` 的输出（exit 0）
@@ -43,8 +29,6 @@ ec ctl send --encrypt "<text>"
 
 发送成功后**继续后续处理**。一次任务可能发 0 到多条消息，不要因为看到"已发送"就反复发送同一条消息。
 
-不同渠道有不同的命令行工具，使用方式参见各渠道文档。
-
 ## Agent 管理命令
 
 `evolclaw agent` — agent 全生命周期管理。

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

@@ -1,2 +1,8 @@
-[Base Agent]
-当前基座：{{baseAgentName}}（{{baseAgent}}）
+[baseagent]
+baseAgentName: {{baseAgentName}} # 底层推理引擎（Claude Code / Codex / Gemini CLI）
+{{?baseAgentModel}}
+baseAgentModel: {{baseAgentModel}}
+{{/}}
+{{?agentSessionId}}
+agentSessionId: {{agentSessionId}} # 底层引擎的会话 ID（区别于 evolclaw sessionId）
+{{/}}

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

@@ -1,10 +1,22 @@
-[渠道层]
-通信渠道：{{channel}}
-
-{{?canSendFile}}
-[文件发送] 当前渠道支持文件发送
-{{/}}
-
+[channel]
+channel: {{channel}} # 渠道类型：aun|feishu|wechat|dingtalk|qqbot|wecom
 {{?capabilities}}
-[渠道能力] {{capabilities}}
+capabilities: {{capabilities}} # 当前渠道支持的能力
+{{/}}
+{{?peerId}}
+{{?channel=aun}}
+ec msg send {{selfAid}} {{peerId}} "<text>" [--encrypt] [--file <path> --as image|video|voice|file] [--link <url> --title "<title>"] [--payload '<json>']
+encrypt: 跟随对端消息加密状态（密文回密文，明文回明文）；本端主动发时依据会话 encrypt 配置（待实现）
+{{/}}
+{{?channel!=aun}}
+非 aun 渠道：回复由 evolclaw 自动完成，无需调用 CLI
+{{/}}
+{{/}}
+{{?groupId}}
+{{?channel=aun}}
+ec group send {{selfAid}} {{groupId}} "<text>" [--file <path> --as image|video|voice|file] [--mention <aid>]
+{{/}}
+{{?channel!=aun}}
+非 aun 渠道：回复由 evolclaw 自动完成，无需调用 CLI
+{{/}}
 {{/}}

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

@@ -1,12 +1,11 @@
-[身份层]
+[identity]
 {{?selfAid}}
-我是 {{selfName}} ({{selfAid}})
+selfName: {{selfName}}
+selfAid: {{selfAid}}
 {{/}}
-
 {{?hasPersona}}
-[人格] 已加载 persona.md 行为规范
+hasPersona: active
 {{/}}
-
 {{?hasWorkingMemory}}
-[当前关注] 已加载 working memory
+hasWorkingMemory: active
 {{/}}

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

@@ -1,9 +1,14 @@
 {{?peerKey}}
-[关系层]
-对话者：{{peerName}} ({{peerId}})，权限：{{peerRole}}
-对端标识：{{peerKey}}
+[relation]
+peerName: {{peerName}}
+peerId: {{peerId}} # 对端在当前渠道内的原生 ID
+peerRole: {{peerRole}} # owner|admin|guest|anonymous
+{{?peerType}}
+peerType: {{peerType}} # human 或 agent
+{{/}}
+peerKey: {{peerKey}} # 跨渠道唯一标识，格式 channel#urlEncode(peerId)
 {{/}}
 {{?groupId}}
-[关系层]
-群组：{{groupId}}
+[relation]
+groupId: {{groupId}}
 {{/}}

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

@@ -0,0 +1,20 @@
+[session]
+project: {{project}} # 项目目录名
+CURRENT_PROJECT: {{CURRENT_PROJECT}} # 项目完整路径
+sessionId: {{sessionId}} # evolclaw 会话 ID
+{{?sessionName}}
+sessionName: {{sessionName}}
+{{/}}
+sessionCreatedAt: {{sessionCreatedAt}}
+chatMode: {{chatMode}} # interactive=同步对话 / proactive=主动推送（输出静默）
+{{?threadId}}
+threadId: {{threadId}} # 同一会话内的子话题 ID（多话题路由时）
+{{/}}
+{{?readonly}}
+readonly: true — 禁止修改项目文件，如需生成文件请写入 .evolclaw/tmp/
+{{/}}
+{{?chatMode=proactive}}
+# proactive 模式：文本输出静默丢弃，必须用以下命令发消息
+proactive-send: evolclaw ctl send "<text>"
+proactive-file: evolclaw ctl file <path>
+{{/}}

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

@@ -1,5 +1,7 @@
-[环境层]
-聊天类型：{{chatType}}
+[venue]
+chatType: {{chatType}} # private|group
+EVOLCLAW_HOME: {{EVOLCLAW_HOME}} # 用户数据根目录（agents/sessions/logs）
+PACKAGE_ROOT: {{PACKAGE_ROOT}} # evolclaw 安装目录（kits/rules/docs）
 {{?venueUid}}
-环境标识：{{venueUid}}
+venueUid: {{venueUid}}
 {{/}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolclaw",
-  "version": "3.1.2",
+  "version": "3.1.4",
   "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",
@@ -11,6 +11,7 @@
   "files": [
     "dist/",
     "bin/",
+    "assets/",
     "!dist/experimental/",
     "kits/",
     "!kits/.kits-version",
@@ -29,9 +30,10 @@
     "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
-    "@agentunion/fastaun": "^0.3.2",
+    "@agentunion/fastaun": "^0.3.3",
     "@anthropic-ai/claude-agent-sdk": "^0.2.100",
     "cron-parser": "^5.5.0",
+    "dotenv": "^17.4.2",
     "image-type": "^6.0.0",
     "qrcode-terminal": "^0.12.0"
   },