evolclaw 3.0.0 → 3.1.1

package/dist/utils/stats.js

@@ -1,3 +1,5 @@
+import fs from 'fs';
+import path from 'path';
 export class StatsCollector {
     events = [];
     startTime;
@@ -100,6 +102,71 @@ export class StatsCollector {
 export class AidStatsCollector {
     entries = new Map();
     queueStatsProvider;
+    /** sessionId → 当前正在跑该 session 的 agent，task:started 写入，task:completed/error 清除 */
+    sessionToAgent = new Map();
+    constructor(eventBus) {
+        if (!eventBus)
+            return;
+        eventBus.subscribe('task:started', (event) => {
+            const e = event;
+            if (e.agentName)
+                this.onTaskStart(e.agentName, e.encrypt, e.chatmode);
+            if (e.agentName && e.sessionId)
+                this.sessionToAgent.set(e.sessionId, e.agentName);
+        });
+        eventBus.subscribe('task:completed', (event) => {
+            const e = event;
+            if (e.agentName)
+                this.onTaskEnd(e.agentName, 'completed', undefined, e.finalText, e.numTurns);
+            if (e.sessionId)
+                this.sessionToAgent.delete(e.sessionId);
+        });
+        eventBus.subscribe('task:error', (event) => {
+            const e = event;
+            if (e.agentName)
+                this.onTaskEnd(e.agentName, 'error', e.errorType);
+            if (e.sessionId)
+                this.sessionToAgent.delete(e.sessionId);
+        });
+        // thought.put 次数 + 最后一次 thought 文本
+        // 注意：thought.put 是 fire-and-forget async，可能在 task:completed 之后才到达，
+        // 所以同时累加到 currentTask（task 进行中）或 lastTaskEnd（task 已结束但 thought 属于它）
+        eventBus.subscribe('message:thought-put', (event) => {
+            const e = event;
+            if (!e.agentName)
+                return;
+            const entry = this.entries.get(e.agentName);
+            if (!entry)
+                return;
+            if (entry.currentTaskStartAt != null) {
+                // task 进行中
+                entry.currentTaskThoughtPutCount++;
+                if (e.text)
+                    entry.currentTaskLastThoughtText = e.text;
+            }
+            else if (entry.lastTaskEnd) {
+                // task 已结束，回填到最近一次 task
+                entry.lastTaskEnd.thoughtPutCount++;
+                entry.lastTaskEnd.thoughtDuringTask = true;
+                if (e.text) {
+                    const t = e.text.length > 100 ? e.text.slice(0, 100) + '…' : e.text;
+                    entry.lastTaskEnd.lastThoughtText = t;
+                }
+            }
+        });
+        // 工具调用次数（tool:use 事件）
+        eventBus.subscribe('tool:use', (event) => {
+            const e = event;
+            if (!e.sessionId)
+                return;
+            const agent = this.sessionToAgent.get(e.sessionId);
+            if (!agent)
+                return;
+            const entry = this.entries.get(agent);
+            if (entry && entry.currentTaskStartAt != null)
+                entry.currentTaskToolUseCount++;
+        });
+    }
     setQueueStatsProvider(provider) {
         this.queueStatsProvider = provider;
     }
@@ -119,19 +186,145 @@ export class AidStatsCollector {
                 lastSentAt: null,
                 lastReceivedText: null,
                 lastReceivedFrom: null,
+                lastReceivedEncrypt: null,
+                lastReceivedChatmode: null,
                 lastSentText: null,
                 lastSentTo: null,
+                lastSentEncrypt: null,
+                lastSentChatmode: null,
                 uniquePeers: new Set(),
+                currentTaskStartAt: null,
+                currentTaskReplyCount: 0,
+                currentTaskThoughtPutCount: 0,
+                currentTaskToolUseCount: 0,
+                currentTaskNumTurns: 0,
+                currentTaskLastThoughtText: null,
+                currentTaskSessionId: null,
+                currentTaskChatmode: null,
+                currentTaskEncrypt: null,
+                lastTaskEnd: undefined,
             };
             this.entries.set(aid, entry);
         }
         return entry;
     }
+    sessionsDir;
+    setSessionsDir(dir) {
+        this.sessionsDir = dir;
+    }
+    onTaskStart(aid, encrypt, chatmode) {
+        const entry = this.getOrCreate(aid);
+        entry.currentTaskStartAt = Date.now();
+        entry.currentTaskReplyCount = 0;
+        entry.currentTaskThoughtPutCount = 0;
+        entry.currentTaskToolUseCount = 0;
+        entry.currentTaskNumTurns = 0;
+        entry.currentTaskLastThoughtText = null;
+        entry.currentTaskChatmode = chatmode ?? null;
+        entry.currentTaskEncrypt = encrypt ?? null;
+    }
+    onTaskEnd(aid, status, errorType, finalText, numTurns) {
+        const entry = this.getOrCreate(aid);
+        const startedAt = entry.currentTaskStartAt;
+        const taskEndTs = Date.now();
+        // 先用内存计数写入初始值（立即可用）
+        const buildTaskEnd = (msgCount, thoughtCount, lastThought) => ({
+            ts: taskEndTs,
+            status,
+            errorType,
+            sentDuringTask: msgCount > 0,
+            thoughtDuringTask: thoughtCount > 0,
+            lastThoughtText: lastThought,
+            replyCount: msgCount,
+            thoughtPutCount: thoughtCount,
+            toolUseCount: entry.currentTaskToolUseCount,
+            numTurns: numTurns ?? entry.currentTaskNumTurns,
+            finalText: finalText ? (finalText.length > 100 ? finalText.slice(0, 100) + '…' : finalText) : undefined,
+            chatmode: entry.currentTaskChatmode ?? undefined,
+            encrypt: entry.currentTaskEncrypt ?? undefined,
+        });
+        entry.lastTaskEnd = buildTaskEnd(entry.currentTaskReplyCount, entry.currentTaskThoughtPutCount, entry.currentTaskLastThoughtText ?? undefined);
+        // 500ms 后从 jsonl 重新统计（覆盖 thought.put 异步延迟问题）
+        if (this.sessionsDir && startedAt != null) {
+            const sessionsDir = this.sessionsDir;
+            const toolUseCount = entry.currentTaskToolUseCount;
+            const resolvedNumTurns = numTurns ?? entry.currentTaskNumTurns;
+            const chatmode = entry.currentTaskChatmode;
+            const encrypt = entry.currentTaskEncrypt;
+            setTimeout(() => {
+                try {
+                    const { chatDirPath } = require('../core/session/session-fs-store.js');
+                    // 找该 aid 下所有 peer 的 messages.jsonl，统计 ts >= startedAt 的出站条目
+                    const aidDir = path.join(sessionsDir, 'aun', aid.replace(/[/%\\:*?"<>|]/g, ch => '%' + ch.charCodeAt(0).toString(16).toUpperCase().padStart(2, '0')));
+                    if (!fs.existsSync(aidDir))
+                        return;
+                    let msgCount = 0, thoughtCount = 0;
+                    let lastThoughtText;
+                    let lastMsgText;
+                    for (const peerDir of fs.readdirSync(aidDir, { withFileTypes: true })) {
+                        if (!peerDir.isDirectory() || peerDir.name.startsWith('_'))
+                            continue;
+                        const msgFile = path.join(aidDir, peerDir.name, 'messages.jsonl');
+                        if (!fs.existsSync(msgFile))
+                            continue;
+                        const lines = fs.readFileSync(msgFile, 'utf-8').split('\n').filter(Boolean);
+                        for (const line of lines) {
+                            try {
+                                const rec = JSON.parse(line);
+                                if (rec.dir !== 'out' || rec.ts < startedAt || rec.ts > taskEndTs + 2000)
+                                    continue;
+                                if (rec.msgType === 'thought') {
+                                    thoughtCount++;
+                                    if (rec.content)
+                                        lastThoughtText = rec.content.length > 100 ? rec.content.slice(0, 100) + '…' : rec.content;
+                                }
+                                else if (rec.msgType === 'text') {
+                                    msgCount++;
+                                    if (rec.content)
+                                        lastMsgText = rec.content.length > 100 ? rec.content.slice(0, 100) + '…' : rec.content;
+                                }
+                            }
+                            catch { }
+                        }
+                    }
+                    const currentEntry = this.entries.get(aid);
+                    if (currentEntry?.lastTaskEnd?.ts === taskEndTs) {
+                        currentEntry.lastTaskEnd = {
+                            ts: taskEndTs,
+                            status,
+                            errorType,
+                            sentDuringTask: msgCount > 0,
+                            thoughtDuringTask: thoughtCount > 0,
+                            lastThoughtText: lastThoughtText,
+                            replyCount: msgCount,
+                            thoughtPutCount: thoughtCount,
+                            toolUseCount,
+                            numTurns: resolvedNumTurns,
+                            finalText: finalText ? (finalText.length > 100 ? finalText.slice(0, 100) + '…' : finalText) : undefined,
+                            chatmode: chatmode ?? undefined,
+                            encrypt: encrypt ?? undefined,
+                        };
+                        // 更新 lastSentText 为最后一条 msg（如果有）
+                        if (lastMsgText && msgCount > 0) {
+                            currentEntry.lastSentText = lastMsgText;
+                        }
+                    }
+                }
+                catch { }
+            }, 500);
+        }
+        entry.currentTaskStartAt = null;
+        entry.currentTaskReplyCount = 0;
+        entry.currentTaskThoughtPutCount = 0;
+        entry.currentTaskToolUseCount = 0;
+        entry.currentTaskNumTurns = 0;
+        entry.currentTaskLastThoughtText = null;
+    }
     setSelfName(aid, name) {
         const entry = this.getOrCreate(aid);
         entry.selfName = name;
     }
-    recordInbound(aid, fromPeer, byteLength, text, isSystem = false) {
+    recordInbound(aid, fromPeer, byteLength, text, isSystem = false, encrypt, chatmode) {
         const entry = this.getOrCreate(aid);
         if (isSystem) {
             entry.systemReceived++;
@@ -142,11 +335,15 @@ export class AidStatsCollector {
             entry.lastReceivedFrom = fromPeer;
             if (text)
                 entry.lastReceivedText = text.length > 100 ? text.slice(0, 100) + '…' : text;
+            if (encrypt != null)
+                entry.lastReceivedEncrypt = encrypt;
+            if (chatmode)
+                entry.lastReceivedChatmode = chatmode;
         }
         entry.bytesReceived += byteLength;
         entry.uniquePeers.add(fromPeer);
     }
-    recordOutbound(aid, toPeer, byteLength, text, isSystem = false) {
+    recordOutbound(aid, toPeer, byteLength, text, isSystem = false, encrypt, chatmode) {
         const entry = this.getOrCreate(aid);
         if (isSystem) {
             entry.systemSent++;
@@ -157,6 +354,18 @@ export class AidStatsCollector {
             entry.lastSentTo = toPeer;
             if (text)
                 entry.lastSentText = text.length > 100 ? text.slice(0, 100) + '…' : text;
+            if (encrypt != null)
+                entry.lastSentEncrypt = encrypt;
+            if (chatmode)
+                entry.lastSentChatmode = chatmode;
+            // 累计当前 task 的回复数
+            if (entry.currentTaskStartAt != null) {
+                entry.currentTaskReplyCount++;
+                if (chatmode)
+                    entry.currentTaskChatmode = chatmode;
+                if (encrypt != null)
+                    entry.currentTaskEncrypt = encrypt;
+            }
         }
         entry.bytesSent += byteLength;
         entry.uniquePeers.add(toPeer);
@@ -180,11 +389,16 @@ export class AidStatsCollector {
                 lastSentAt: entry.lastSentAt,
                 lastReceivedText: entry.lastReceivedText,
                 lastReceivedFrom: entry.lastReceivedFrom,
+                lastReceivedEncrypt: entry.lastReceivedEncrypt,
+                lastReceivedChatmode: entry.lastReceivedChatmode,
                 lastSentText: entry.lastSentText,
                 lastSentTo: entry.lastSentTo,
+                lastSentEncrypt: entry.lastSentEncrypt,
+                lastSentChatmode: entry.lastSentChatmode,
                 uniquePeerCount: entry.uniquePeers.size,
                 processing: queueStats.processing,
                 queued: queueStats.queued,
+                lastTaskEnd: entry.lastTaskEnd,
             });
         }
         return out;

package/dist/watch-msg.js

@@ -11,6 +11,7 @@ const CYAN = isTTY ? '\x1b[36m' : '';
 const GREEN = isTTY ? '\x1b[32m' : '';
 const BLUE = isTTY ? '\x1b[34m' : '';
 const ORANGE = isTTY ? '\x1b[38;5;208m' : '';
+const BG_SEL = isTTY ? '\x1b[48;5;236m' : ''; // dark gray background for selected row
 // ==================== Helpers ====================
 function visualWidth(s) {
     const stripped = s.replace(/\x1b\[[0-9;]*m/g, '');
@@ -56,6 +57,14 @@ function formatTime(ts) {
     const d = new Date(ts);
     return `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`;
 }
+function formatDateTime(ts) {
+    const d = new Date(ts);
+    const mo = String(d.getMonth() + 1).padStart(2, '0');
+    const dd = String(d.getDate()).padStart(2, '0');
+    const hh = String(d.getHours()).padStart(2, '0');
+    const mm = String(d.getMinutes()).padStart(2, '0');
+    return `${mo}-${dd} ${hh}:${mm}`;
+}
 function shortAid(aid) {
     return aid.split('.')[0];
 }
@@ -169,10 +178,12 @@ function renderScopePanel(state, width, height) {
         const a = state.localAids[i];
         const sel = isActive && i === state.scopeIndex;
         const chosen = state.selectedLocalAid === a.aid;
-        const marker = sel ? `${CYAN}${BOLD}▸ ` : (chosen ? `${CYAN}  ` : '  ');
+        const bg = sel ? BG_SEL : '';
+        const marker = sel ? `${bg}${CYAN}${BOLD}▸ ` : (chosen ? `${CYAN}  ` : '  ');
         const name = truncate(shortAid(a.aid), width - 4);
         lines.push(padRight(`${marker}${name}${RST}`, width));
-        const stats = `  ${DIM}↓${a.totalIn} ↑${a.totalOut} peers:${a.peerCount}${RST}`;
+        const statsBg = sel ? BG_SEL : '';
+        const stats = `${statsBg}  ${DIM}↓${a.totalIn} ↑${a.totalOut} peers:${a.peerCount}${RST}`;
         lines.push(padRight(stats, width));
         if (lines.length < height)
             lines.push(padRight('', width));
@@ -195,19 +206,22 @@ function renderStatsPanel(state, width, height) {
     const now = Date.now();
     // "All" item at index 0
     const allSel = isActive && state.statsIndex === 0;
-    const allMarker = allSel ? `${CYAN}${BOLD}▸ ` : '  ';
+    const allBg = allSel ? BG_SEL : '';
+    const allMarker = allSel ? `${allBg}${CYAN}${BOLD}▸ ` : '  ';
     lines.push(padRight(`${allMarker}All (${state.peers.length} peers)${RST}`, width));
     if (lines.length < height)
         lines.push(padRight('', width));
     for (let i = 0; i < state.peers.length && lines.length < height; i++) {
         const p = state.peers[i];
         const sel = isActive && state.statsIndex === i + 1;
-        const marker = sel ? `${CYAN}${BOLD}▸ ` : '  ';
+        const bg = sel ? BG_SEL : '';
+        const marker = sel ? `${bg}${CYAN}${BOLD}▸ ` : '  ';
         const displayName = p.peerName || shortAid(p.peerId);
         const name = truncate(displayName, width - 4);
         lines.push(padRight(`${marker}${name}${RST}`, width));
+        const detailBg = sel ? BG_SEL : '';
         const ago = p.lastAt ? formatTimeAgo(now - p.lastAt) : '-';
-        const detail = `  ${DIM}↓${p.inbound} ↑${p.outbound}  ${ago}${RST}`;
+        const detail = `${detailBg}  ${DIM}↓${p.inbound} ↑${p.outbound}  ${ago}${RST}`;
         lines.push(padRight(detail, width));
         if (lines.length < height)
             lines.push(padRight('', width));
@@ -231,10 +245,11 @@ function renderMessagesPanel(state, width, height) {
     const msgWidth = width - 3;
     for (let i = startIdx; i < endIdx; i++) {
         const m = msgs[i];
-        const time = formatTime(m.ts);
+        const time = formatDateTime(m.ts);
         const dir = m.dir === 'in' ? `${GREEN}↓${RST}` : `${BLUE}↑${RST}`;
-        const peer = m.dir === 'in' ? shortAid(m.from) : shortAid(m.to);
-        const header = `${DIM}${time}${RST} ${dir} ${ORANGE}${peer}${RST}`;
+        const from = shortAid(m.from);
+        const to = shortAid(m.to);
+        const header = `${DIM}${time}${RST} ${dir} ${ORANGE}${from}${RST}${DIM}→${RST}${GREEN}${to}${RST}`;
         const headerLine = padRight(header, msgWidth);
         const sbIdx = lines.length - 1;
         lines.push(`${headerLine} ${scrollbar[sbIdx] || ' '}`);
@@ -255,9 +270,9 @@ function renderMessagesPanel(state, width, height) {
 function renderFrame(state) {
     const cols = process.stdout.columns || 120;
     const rows = (process.stdout.rows || 40) - 3;
-    const leftW = Math.max(24, Math.floor(cols * 0.28));
-    const midW = Math.max(28, Math.floor(cols * 0.30));
-    const rightW = Math.max(30, cols - leftW - midW - 4);
+    const leftW = Math.max(20, Math.floor(cols * 0.20));
+    const midW = Math.max(24, Math.floor(cols * 0.22));
+    const rightW = Math.max(40, cols - leftW - midW - 4);
     const bodyHeight = rows - 2;
     const leftLines = renderScopePanel(state, leftW, bodyHeight);
     const midLines = renderStatsPanel(state, midW, bodyHeight);

package/evolclaw-install-aun.md

@@ -19,6 +19,8 @@ EvolClaw 是一个开源的 AI Agent 网关，将 Claude/Codex 等 AI 后端连
 
 ## 安装步骤
 
+> **⚠️ 给执行安装的 AI Agent**：本文档中所有破坏性命令（`evolclaw stop` / `evolclaw restart` / `rm -rf` / `evolclaw aid delete` 等）**必须先 `AskUserQuestion` 等用户明确回复后才能执行**，不要因为已经发出确认提示就默认 yes 自动跑。用户在打字的几秒内决定 "等等先别停"，比事后回滚要省事得多。
+
 ### 步骤 1：检查环境
 
 ```bash
@@ -169,23 +171,33 @@ AUN 通道由 `agent.aid` 隐式驱动，不需要单独配 channel——`evolcl
 cat $EVOLCLAW_HOME/agents/<aid>/config.json
 ```
 
-检查：
+检查关键字段：
 
 - `aid` — 你的 AID
 - `owners` — Owner AID 数组（可为空，留给自动绑定）
 - `active_baseagent` — `claude` / `codex` / `gemini`
 - `projects.defaultPath` — 项目路径（目录需存在）
-- `channels` — 数组，初始可为空（AUN 隐式上线）
+- `channels` — 数组，初始为空（AUN 隐式上线，无需在此配置）
 - `initialized` — 应为 `false`（首次连接成功后由系统更新为 `true`）
 
+> 注：config.json 还包含 `$schema_version`、`enabled`、`baseagents`、`chatmode`、`dispatch` 等字段，由 `agent new` 自动填入，无需手动检查。
+
 如发现缺失或异常，向用户说明并提供修复方案。
 
 ### 步骤 9：启动服务
 
+首次安装（服务未运行）：
+
 ```bash
 evolclaw start
 ```
 
+若服务已在运行（升级/重装场景，步骤 3 已停止旧进程）：
+
+```bash
+evolclaw restart
+```
+
 ### 步骤 10：验证运行状态
 
 ```bash

package/kits/docs/GUIDE.md

@@ -0,0 +1,20 @@
+# 文档查阅指南
+
+## 查阅流程
+
+1. 先看 `$KITS_RULES`（自动加载的 8 个规则文件）了解机制骨架
+2. 需要详细信息时，按 `INDEX.md` 找到对应文档路径
+3. Read 对应文档
+
+## 路径解析
+
+文档中用 `$名称` 引用路径。解析步骤：
+1. 查 `$KITS_RULES/01-entry.md` 的路径体系速查表
+2. 如需完整定义，Read `$KITS_DOCS/path-registry.md`
+3. 如需运行时实际值，Read `$ECK/path-registry.md`
+
+## 不要做的事
+
+- 不要一次性加载所有文档——按需逐个 Read
+- 不要猜测路径——查注册表
+- 不要在当前会话输出对外消息——用 CLI

package/kits/docs/INDEX.md

@@ -0,0 +1,52 @@
+# EvolClaw 文档索引
+
+本文件是 `$KITS_DOCS` 下所有文档的索引。
+
+## 路径与机制
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| 查阅指南 | `GUIDE.md` | 文档查阅流程 |
+| 路径定义 | `path-registry.md` | 所有预定义路径及派生规则 |
+
+## AUN 协议
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| 速查表 | `aun/CHEATSHEET.md` | AUN 协议命名空间与常用操作速查 |
+| 同步协议 | `aun/SYNC_PROTOCOL.md` | 上游协议同步 SOP |
+
+## EvolClaw 命令
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| Agent 命令 | `evolclaw/AGENT_CMD.md` | agent 全生命周期管理命令 |
+| 运行时工具 | `evolclaw/tools.md` | ctl 命令集 |
+| 自我总结 | `evolclaw/self-summary.md` | 自我总结流程指南 |
+| 私聊消息 | `evolclaw/MSG_PRIVATE.md` | 私聊消息命令 |
+| 群聊消息 | `evolclaw/MSG_GROUP.md` | 群聊消息命令 |
+
+## 身份
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| 身份工具 | `identity/identity-tools.md` | 身份识别与环境层工具 |
+| 角色详情 | `identity/ROLE_DETAIL.md` | 角色与场景详细规则 |
+| AID 档案规范 | `identity/AID_PROFILE_SPEC.md` | AID 档案格式规范 |
+| 路径运维 | `identity/PATH_OPS.md` | 路径运维操作 |
+
+## 渠道
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| AUN 渠道 | `channels/aun.md` | AUN 通信约定 |
+| 飞书渠道 | `channels/feishu.md` | 飞书渠道接入 |
+
+## ECK 模板
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| 运行时配置模板 | `eck_templates/runtime.template.md` | agent 运行时配置模板 |
+| 路径注册表模板 | `eck_templates/path-registry.template.md` | 路径实例模板 |
+| 索引模板 | `eck_templates/INDEX.template.md` | agent 级索引模板 |
+| 指南模板 | `eck_templates/GUIDE.template.md` | agent 级查阅指南模板 |

package/kits/docs/aun/CHEATSHEET.md

@@ -0,0 +1,17 @@
+# AUN 协议速查表
+
+<!-- TODO: 填充 AUN 协议命名空间与常用操作速查内容 -->
+
+## 命名空间
+
+| 命名空间 | 作用 |
+|---|---|
+| `auth.*` | AID 创建、认证、JWT |
+| `message.*` | 点对点消息收发 |
+| `group.*` | 群组生命周期、群消息 |
+| `storage.*` | 文件上传下载 |
+| `stream.*` | 实时流（语音/视频/token） |
+| `meta.*` | ping、状态、信任根查询 |
+| `nameservice.*` | AID 名字注册查询 |
+| `custody.*` | AID 托管 |
+| `peer.*` / `relay.*` | 直连/中继认证 |

package/kits/docs/aun/SYNC_PROTOCOL.md

@@ -0,0 +1,15 @@
+# AUN 协议同步 SOP
+
+<!-- TODO: 填充上游协议同步流程 -->
+
+## 同步时机
+
+- AUN SDK 有新版本发布时
+- 协议文档有重大变更时
+
+## 同步步骤
+
+1. 拉取上游最新协议文档
+2. 对比本地认知包与上游差异
+3. 更新 `$KITS_RULES/04-aun.md` 和 `$KITS_DOCS/aun/` 下相关文档
+4. 更新索引

package/kits/docs/channels/feishu.md

@@ -0,0 +1,27 @@
+# 飞书渠道
+
+<!-- TODO: 填充飞书渠道接入文档 -->
+
+## 概述
+
+飞书渠道通过 evolclaw 的 feishu channel 实现，支持：
+- 单聊消息收发
+- 群聊消息收发
+- 合并转发消息解析
+- 文件/图片/视频消息
+
+## 配置
+
+在 evolclaw 配置中启用飞书渠道：
+
+```json
+{
+  "channels": {
+    "feishu": {
+      "enabled": true,
+      "appId": "<app-id>",
+      "appSecret": "<app-secret>"
+    }
+  }
+}
+```

package/kits/docs/eck_templates/GUIDE.template.md

@@ -0,0 +1,22 @@
+# Agent 查阅指南
+
+本文件是 {{SELF_AID}} 的个人查阅指南。
+
+## 查阅优先级
+
+1. `$KITS_RULES`（自动加载）— ECK 机制骨架
+2. `$AGENT_INDEX/INDEX.md`（本目录）— 个人索引
+3. `$KITS_DOCS/INDEX.md` — evolclaw 级文档索引
+4. 按索引中的路径 Read 具体文档
+
+## 路径解析
+
+遇到 `$名称` 时：
+1. 查 `$ECK/path-registry.md` 获取实际路径
+2. 如果实例文件中没有，查 `$KITS_DOCS/path-registry.md` 了解派生规则
+
+## 索引维护
+
+当以下范围内有文档变动时，更新本索引：
+- `{{CURRENT_PROJECT}}`
+- `{{AGENT_DIR}}`

package/kits/docs/eck_templates/INDEX.template.md

@@ -0,0 +1,28 @@
+# Agent 索引
+
+本文件是 {{SELF_AID}} 的 agent 级文档索引。
+
+## 项目文档
+
+| 文档 | 路径 | 说明 | 最后更新 |
+|------|------|------|----------|
+| — | — | （初始化后由 agent 维护） | — |
+
+## 个人档案
+
+| 文档 | 路径 | 说明 | 最后更新 |
+|------|------|------|----------|
+| 人格档案 | `$SELF_DIR/persona.md` | 行为规范与人格定义 | {{CREATED_AT}} |
+| 工作记忆 | `$SELF_DIR/memory/working.md` | 短期关注点 | {{CREATED_AT}} |
+
+## 关系档案
+
+| 对端 AID | 路径 | 最后交互 |
+|----------|------|----------|
+| — | — | — |
+
+## 场所档案
+
+| 场所 | 路径 | 说明 |
+|------|------|------|
+| — | — | — |

package/kits/docs/eck_templates/path-registry.template.md

@@ -0,0 +1,33 @@
+# 路径注册表实例
+
+本文件记录运行时解析出的实际路径值。由 evolclaw 初始化时生成。
+
+## 基础路径
+
+| 名称 | 实际路径 |
+|------|----------|
+| `$EVOLCLAW_HOME` | {{EVOLCLAW_HOME}} |
+| `$PACKAGE_ROOT` | {{PACKAGE_ROOT}} |
+| `$CURRENT_PROJECT` | {{CURRENT_PROJECT}} |
+
+## 派生路径
+
+| 名称 | 实际路径 |
+|------|----------|
+| `$KITS` | {{KITS}} |
+| `$KITS_RULES` | {{KITS_RULES}} |
+| `$KITS_DOCS` | {{KITS_DOCS}} |
+| `$KITS_TEMPLATES` | {{KITS_TEMPLATES}} |
+| `$ECK` | {{ECK}} |
+| `$AGENT_DIR` | {{AGENT_DIR}} |
+| `$SELF_DIR` | {{SELF_DIR}} |
+| `$RELATIONS_DIR` | {{RELATIONS_DIR}} |
+| `$VENUES_DIR` | {{VENUES_DIR}} |
+| `$AGENT_INDEX` | {{AGENT_INDEX}} |
+
+## 外部依赖
+
+| 名称 | 实际路径 | 状态 |
+|------|----------|------|
+| `$KITE` | {{KITE}} | {{KITE_STATUS}} |
+| `$AUN_SDK_CORE` | {{AUN_SDK_CORE}} | {{AUN_SDK_STATUS}} |

package/kits/docs/eck_templates/runtime.template.md

@@ -0,0 +1,19 @@
+# 运行时配置
+
+## 基本信息
+
+- AID: {{SELF_AID}}
+- 名称: {{AGENT_NAME}}
+- 创建时间: {{CREATED_AT}}
+
+## 运行时参数
+
+- 模型: {{MODEL_ID}}
+- 推理强度: {{EFFORT_LEVEL}}
+- 权限模式: {{PERMISSION_MODE}}
+
+## 行为配置
+
+- 自我总结: {{SELF_SUMMARY_ENABLED}}
+- 空闲总结间隔: {{IDLE_SUMMARY_MINUTES}} 分钟
+- 每日总结 token 预算: {{DAILY_SUMMARY_BUDGET}}