evolclaw 3.1.3 → 3.1.4

package/kits/eck_manifest.json

@@ -17,8 +17,8 @@
       "order": 20,
       "needsInjection": true,
       "when": {
-        "var": "scene",
-        "neq": "coding"
+        "var": "chatType",
+        "neq": null
       },
       "description": "身份层：我是谁"
     },
@@ -29,7 +29,7 @@
       "order": 30,
       "needsInjection": true,
       "when": {
-        "var": "scene",
+        "var": "chatType",
         "in": ["private", "group"]
       },
       "description": "关系层：跟我聊天的是谁"
@@ -56,7 +56,7 @@
         "var": "chatType",
         "neq": null
       },
-      "description": "环境层：我在什么场景下"
+      "description": "环境层：当前对话场景"
     },
     {
       "id": "channel-layer",
@@ -68,16 +68,16 @@
         "var": "channel",
         "neq": null
       },
-      "description": "渠道层：我通过什么通信"
+      "description": "渠道层：通信渠道及能力"
     },
     {
-      "id": "eckruntime",
+      "id": "session",
       "type": "file",
-      "file": "$PACKAGE_ROOT/kits/templates/system-fragments/eckruntime.md",
+      "file": "$PACKAGE_ROOT/kits/templates/system-fragments/session.md",
       "order": 60,
       "needsInjection": true,
       "when": "always",
-      "description": "运行时参数"
+      "description": "会话层：当前会话实例状态"
     },
     {
       "id": "baseagent",

package/kits/rules/05-venue.md

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

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

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

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

@@ -1,5 +1,8 @@
 [channel]
-channel: {{channel}}
+channel: {{channel}} # 渠道类型：aun|feishu|wechat|dingtalk|qqbot|wecom
+{{?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>']

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

@@ -1,11 +1,11 @@
 [identity]
 {{?selfAid}}
-self-name: {{selfName}}
-self-aid: {{selfAid}}
+selfName: {{selfName}}
+selfAid: {{selfAid}}
 {{/}}
 {{?hasPersona}}
-persona: loaded
+hasPersona: active
 {{/}}
 {{?hasWorkingMemory}}
-working-memory: loaded
+hasWorkingMemory: active
 {{/}}

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

@@ -1,11 +1,14 @@
 {{?peerKey}}
 [relation]
-peer-name: {{peerName}}
-peer-aid: {{peerId}}
-peer-role: {{peerRole}}
-peer-key: {{peerKey}}
+peerName: {{peerName}}
+peerId: {{peerId}} # 对端在当前渠道内的原生 ID
+peerRole: {{peerRole}} # owner|admin|guest|anonymous
+{{?peerType}}
+peerType: {{peerType}} # human 或 agent
+{{/}}
+peerKey: {{peerKey}} # 跨渠道唯一标识，格式 channel#urlEncode(peerId)
 {{/}}
 {{?groupId}}
 [relation]
-group-id: {{groupId}}
+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,4 +1,7 @@
 [venue]
+chatType: {{chatType}} # private|group
+EVOLCLAW_HOME: {{EVOLCLAW_HOME}} # 用户数据根目录（agents/sessions/logs）
+PACKAGE_ROOT: {{PACKAGE_ROOT}} # evolclaw 安装目录（kits/rules/docs）
 {{?venueUid}}
-venue-id: {{venueUid}}
+venueUid: {{venueUid}}
 {{/}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolclaw",
-  "version": "3.1.3",
+  "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"
   },