evolclaw 2.6.3 → 2.6.4

package/dist/agents/claude-runner.js

@@ -130,6 +130,8 @@ export class AgentRunner {
         return this.permissionMode;
     }
     listModes() {
+        // readonly 模式暂时禁用：与 proactive 模式系统提示词存在语义冲突，
+        // 且 READONLY_WRITE_PATTERNS 未覆盖 evolclaw ctl send/file，契约不稳固
         return [
             { key: 'auto', nameZh: '自动', description: 'AI 分类器自动判断', available: true },
             { key: 'bypass', nameZh: '放行', description: '全部自动放行', available: true },
@@ -137,7 +139,6 @@ export class AgentRunner {
             { key: 'edit', nameZh: '编辑', description: '自动接受编辑，其他询问', available: true },
             { key: 'plan', nameZh: '规划', description: '只规划不执行', available: true },
             { key: 'noask', nameZh: '静默', description: '未批准则拒绝', available: true },
-            { key: 'readonly', nameZh: '只读', description: '禁止修改项目文件，可在临时目录生成文件', available: true },
         ];
     }
     setPermissionGateway(gateway) {

package/dist/agents/codex-runner.js

@@ -77,7 +77,6 @@ export class CodexRunner {
             { key: 'bypass', nameZh: '放行', description: '全部自动（受 sandbox 约束）', available: true },
             { key: 'request', nameZh: '审批', description: '需要审批时询问', available: true },
             { key: 'noask', nameZh: '静默', description: '只执行已知安全操作', available: true },
-            { key: 'readonly', nameZh: '只读', description: '禁止修改项目文件，可在临时目录生成文件', available: true },
         ];
     }
     setSendPrompt(_fn) { }

package/dist/agents/gemini-runner.js

@@ -70,7 +70,6 @@ export class GeminiRunner {
             { key: 'edit', nameZh: '编辑', description: '仅 Claude 支持', available: false, unavailableReason: 'Gemini CLI 不支持此模式' },
             { key: 'plan', nameZh: '规划', description: 'Gemini 规划模式', available: true },
             { key: 'noask', nameZh: '静默', description: '仅 Claude 支持', available: false, unavailableReason: 'Gemini CLI 不支持此模式' },
-            { key: 'readonly', nameZh: '只读', description: '禁止修改项目文件，可在临时目录生成文件', available: true },
         ];
     }
     setSendPrompt(_fn) { }
@@ -121,6 +120,9 @@ export class GeminiRunner {
         if (this.currentMode === 'plan') {
             args.push('--approval-mode=plan');
         }
+        else if (this.currentMode === 'noask') {
+            args.push('--approval-mode=default');
+        }
         else {
             args.push('--yolo');
         }

package/dist/channels/aun.js

@@ -877,15 +877,18 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             encrypt: true,
         };
         try {
+            const stage = payload?.stage ?? 'unknown';
             if (this.isGroupId(channelId)) {
                 params.group_id = targetId;
                 this.trace('OUT', 'group.thought.put', params);
                 await this.client.call('group.thought.put', params);
+                logger.debug(`[AUN] thought.put ok group=${targetId} task=${taskId} stage=${stage}`);
             }
             else {
                 params.to = targetId;
                 this.trace('OUT', 'message.thought.put', params);
                 await this.client.call('message.thought.put', params);
+                logger.debug(`[AUN] thought.put ok p2p=${targetId} task=${taskId} stage=${stage}`);
             }
         }
         catch (e) {
@@ -1095,6 +1098,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             this.trace('OUT', 'message.send.status', params);
             sendWithFallback('message.send');
         }
+        logger.info(`[AUN] task.${status} task=${taskId} session=${sessionId} target=${channelId}`);
     }
     sendCustomPayload(channelId, payload) {
         if (!this.client || !this.connected)

package/dist/core/command-handler.js

@@ -701,7 +701,7 @@ export class CommandHandler {
                 if (!hasPermissionController(permAgent)) {
                     return '❌ 权限控制不可用';
                 }
-                const defaultPermMode = identity.role === 'owner' ? 'bypass' : 'readonly';
+                const defaultPermMode = identity.role === 'owner' ? 'bypass' : identity.role === 'admin' ? 'auto' : 'noask';
                 const currentMode = permSession.metadata?.permissionMode ?? defaultPermMode;
                 const modes = permAgent.listModes();
                 // 尝试发送交互卡片

package/dist/core/message/message-processor.js

@@ -10,6 +10,7 @@ import { getErrorMessage, classifyError, ErrorType, ERROR_PREFIX, isInfraError,
 import { summarizeToolInput } from '../permission.js';
 import { getOwner } from '../../config.js';
 import { getPackageRoot, resolveRoot } from '../../paths.js';
+import { renderPromptSection } from '../../prompts/templates.js';
 /**
  * 统一消息处理器
  * 负责处理来自不同渠道的消息，协调事件流处理
@@ -313,7 +314,7 @@ export class MessageProcessor {
             const imageInfo = message.images && message.images.length > 0 ? ` [${message.images.length} image(s)]` : '';
             const modeInfo = isBackground ? ' [\u540e\u53f0]' : '';
             logger.info(`[${message.channel}] ${message.channelId}: ${message.content}${imageInfo}${modeInfo}`);
-            logger.info(`[MessageProcessor] session=${session.id} chatType=${session.chatType} sessionMode=${session.sessionMode} agentId=${session.agentId} msgChatType=${message.chatType ?? 'n/a'}`);
+            logger.info(`[MessageProcessor] session=${session.id} task=${taskId} chatType=${session.chatType} sessionMode=${session.sessionMode} agentId=${session.agentId} msgChatType=${message.chatType ?? 'n/a'}`);
             // 记录开始处理
             this.eventBus.publish({ type: 'message:processing', sessionId: session.id });
             adapter.sendProcessingStatus?.(message.channelId, 'start', session.id, taskId, this.getReplyContext(message));
@@ -353,6 +354,9 @@ export class MessageProcessor {
             }, (options?.flushDelay ?? this.config.flushDelay ?? 3) * 1000, options?.fileMarkerPattern, this.config.debug?.flusherDiag, isProactive);
             // 保存当前 flusher，用于 compact 事件
             this.currentFlusher = flusher;
+            if (isProactive) {
+                logger.info(`[MessageProcessor] proactive mode: flusher silent, outputs via thought.put task=${taskId}`);
+            }
             // Proactive 模式可观测：创建 ThoughtEmitter，将静默的流式事件转发为 thought
             // selector: context = { type: 'task', id: taskId }
             if (isProactive && adapter.putThought) {
@@ -379,9 +383,9 @@ export class MessageProcessor {
                     ? (sessionKey) => this.messageQueue.cancelIntercept(sessionKey)
                     : undefined,
             });
-            // 设置 per-session 权限模式（动态默认值：owner → bypass，admin → auto，guest → readonly）
+            // 设置 per-session 权限模式（动态默认值：owner → bypass，admin → auto，guest → noask）
             const role = session.identity?.role;
-            const defaultPermMode = role === 'owner' ? 'bypass' : role === 'admin' ? 'auto' : 'readonly';
+            const defaultPermMode = role === 'owner' ? 'bypass' : role === 'admin' ? 'auto' : 'noask';
             agent.setMode(session.metadata?.permissionMode ?? defaultPermMode);
             // 标记会话为处理中（实时持久化，重启后可恢复）
             this.sessionManager.markProcessing(session.id);
@@ -396,8 +400,7 @@ export class MessageProcessor {
                 // 动态构建运行时上下文提示
                 const contextParts = [];
                 const currentChannelType = options?.channelType || message.channel;
-                // 1. 当前环境信息
-                const peerLabel = session.identity?.role || 'unknown';
+                // 1. 构建模板变量并渲染 runtime 段
                 const peerName = message.peerName || session.metadata?.peerName;
                 const peerType = message.peerType;
                 const peerId = message.peerId;
@@ -411,52 +414,20 @@ export class MessageProcessor {
                 };
                 const selfIdentity = formatIdentity(selfName, selfAid);
                 const peerIdentity = formatIdentity(peerName, peerId);
-                const envParts = [
-                    `会话通道: ${currentChannelType}`,
-                    `当前项目: ${path.basename(absoluteProjectPath)}`,
-                ];
-                if (session.name)
-                    envParts.push(`会话名称: ${session.name}`);
-                if (selfIdentity)
-                    envParts.push(`当前名称: ${selfIdentity}`);
-                envParts.push(`对端身份: ${peerLabel}`);
-                if (peerIdentity)
-                    envParts.push(`对端名称: ${peerIdentity}`);
-                if (peerType && peerType !== 'unknown')
-                    envParts.push(`对端类型: ${peerType}`);
-                if (session.chatType)
-                    envParts.push(`聊天类型: ${session.chatType}`);
-                if (session.agentId && session.agentId !== 'claude')
-                    envParts.push(`当前Agent: ${session.agentId}`);
-                contextParts.push(`[当前环境] ${envParts.join(' | ')}`);
-                // 只读模式提示
-                if (session.metadata?.permissionMode === 'readonly') {
-                    const sendHint = isProactive
-                        ? '使用 evolclaw ctl file 发送'
-                        : '使用 [SEND_FILE:] 发送';
-                    contextParts.push(`[只读模式] 禁止修改项目文件。如需生成文件供用户下载，请写入 .evolclaw/tmp/ 目录后${sendHint}`);
-                }
-                // 2. 文件发送能力（按 channelType 去重，提示词只展示第一级通道名）
-                // proactive 模式：不推送 [SEND_FILE:] 提示，统一通过 evolclaw ctl file 显式发送（与 ctl send 契约一致）
+                // 文件发送能力（按 channelType 去重）
+                let crossChannelTypes = [];
+                let currentCanSend = false;
                 if (!isProactive) {
                     const fileChannelTypes = new Set();
-                    const currentCanSend = !!channelInfo.adapter.sendFile;
+                    currentCanSend = !!channelInfo.adapter.sendFile;
                     for (const [, info] of this.channels) {
                         if (info.adapter.sendFile) {
                             fileChannelTypes.add(info.options?.channelType || info.adapter.channelName);
                         }
                     }
-                    const crossChannelTypes = [...fileChannelTypes].filter(t => t !== currentChannelType);
-                    if (currentCanSend || crossChannelTypes.length > 0) {
-                        const hints = [];
-                        if (currentCanSend)
-                            hints.push(`[SEND_FILE:路径] 发送文件到当前通道`);
-                        if (crossChannelTypes.length > 0)
-                            hints.push(`[SEND_FILE:${crossChannelTypes[0]}:路径] 发送文件到指定通道（可用: ${crossChannelTypes.join('/')}）`);
-                        contextParts.push(hints.join('，'));
-                    }
+                    crossChannelTypes = [...fileChannelTypes].filter(t => t !== currentChannelType);
                 }
-                // 3. 当前通道能力
+                // 通道能力
                 const capParts = [];
                 if (options?.supportsImages)
                     capParts.push('图片输入');
@@ -464,30 +435,32 @@ export class MessageProcessor {
                     capParts.push('图片输出');
                 if (channelInfo.adapter.sendFile)
                     capParts.push('文件发送');
-                if (capParts.length > 0) {
-                    contextParts.push(`[通道能力] ${capParts.join('、')}`);
-                }
-                // 4. 群聊 @ 规则：告知 agent 应该 @ 谁，由 agent 自行在回复中添加
+                contextParts.push(renderPromptSection('runtime', {
+                    channel: currentChannelType,
+                    project: path.basename(absoluteProjectPath),
+                    sessionName: session.name || '',
+                    selfIdentity: selfIdentity || '',
+                    peerRole: session.identity?.role || 'unknown',
+                    peerIdentity: peerIdentity || '',
+                    peerType: peerType && peerType !== 'unknown' ? peerType : '',
+                    chatType: session.chatType || '',
+                    agent: session.agentId && session.agentId !== 'claude' ? session.agentId : '',
+                    readonly: session.metadata?.permissionMode === 'readonly',
+                    readonlySendHint: isProactive ? '使用 evolclaw ctl file 发送' : '使用 [SEND_FILE:] 发送',
+                    fileSendCurrent: !isProactive && currentCanSend,
+                    fileSendCross: !isProactive && crossChannelTypes.length > 0,
+                    crossPrimary: crossChannelTypes[0] || '',
+                    crossTypes: crossChannelTypes.join('/'),
+                    capability: capParts.length > 0,
+                    capabilities: capParts.join('、'),
+                }));
+                // 2. 群聊 @ 规则
                 if (message.chatType === 'group' && message.peerId) {
-                    contextParts.push(`[群聊回复规则] 回复时必须在开头添加 @${message.peerId} 来通知对方`);
+                    contextParts.push(renderPromptSection('group', { peerId: message.peerId }));
                 }
-                // 5. Agent ctl 自管理指令提示 + SKILLS.md 生成
-                // 暂时注释：排查 proactive 模式下 agent 未调用 Bash 工具的问题，
-                // 怀疑此段与 [Proactive 模式] 语义重合稀释了后者的权重
-                // if (!this.skillsEnsured) {
-                //   this.ensureSkillsFile();
-                //   this.skillsEnsured = true;
-                // }
-                // const skillsHint = this.getSkillsHint();
-                // if (skillsHint) {
-                //   contextParts.push(`[EvolClaw 自管理] ${skillsHint}`);
-                // }
-                // 6. Proactive 模式提示词：agent 的输出不会自动发送，必须主动调用 ctl send/file
+                // 3. Proactive 模式提示词
                 if (isProactive) {
-                    contextParts.push('[Proactive 模式] 本次对话中你的流式输出不会自动发送给用户，必须通过以下命令主动发送：\n' +
-                        '- 发送文本：evolclaw ctl send "<消息内容>"\n' +
-                        '- 发送文件：evolclaw ctl file <路径>\n' +
-                        '可多次调用。如不调用，用户将看不到任何回复。');
+                    contextParts.push(renderPromptSection('proactive', {}));
                 }
                 const effectiveSystemPrompt = [options?.systemPromptAppend, ...contextParts].filter(Boolean).join('\n') || undefined;
                 // 可重试错误（403/429/5xx）指数退避重试，最多 3 次
@@ -823,8 +796,24 @@ export class MessageProcessor {
                 // 每收到事件重置空闲超时
                 const toolName = event.type === 'tool_use' ? event.name : undefined;
                 resetTimer(event.type, toolName);
-                // 记录所有事件类型
-                logger.info(`[MessageProcessor] Event: type=${event.type}`);
+                // 记录所有事件类型（text / tool_use 附带摘要，便于排查）
+                let eventDetail = '';
+                if (event.type === 'text' && event.text) {
+                    const preview = event.text.replace(/\s+/g, ' ').slice(0, 80);
+                    eventDetail = ` text="${preview}${event.text.length > 80 ? '…' : ''}"`;
+                }
+                else if (event.type === 'tool_use') {
+                    const input = event.input;
+                    const desc = input?.description
+                        || input?.file_path
+                        || input?.pattern
+                        || (typeof input?.command === 'string' ? input.command.slice(0, 80) : '')
+                        || (typeof input?.prompt === 'string' ? input.prompt.slice(0, 80) : '')
+                        || (typeof input?.query === 'string' ? input.query.slice(0, 80) : '')
+                        || '';
+                    eventDetail = ` tool=${event.name}${desc ? ` desc="${desc}"` : ''}`;
+                }
+                logger.info(`[MessageProcessor] Event: type=${event.type}${eventDetail}`);
                 // Proactive 可观测：将事件实时透传为 thought（fire-and-forget）
                 if (thoughtEmitter) {
                     thoughtEmitter.emit(event).catch(() => { });

package/dist/core/message/thought-emitter.js

@@ -23,6 +23,7 @@ export class ThoughtEmitter {
         this.channelId = channelId;
         this.taskId = taskId;
         this.chatmode = chatmode;
+        logger.info(`[ThoughtEmitter] created channel=${channelId} task=${taskId} chatmode=${chatmode}`);
     }
     async emit(event) {
         // 对齐 interactive 的 dedup：流式 text 已推过时，complete.result 不再重复发 summary

package/dist/core/session/session-manager.js

@@ -315,6 +315,26 @@ export class SessionManager {
                 logger.info(`✓ Migrated ${migrated} session(s): rootId normalized to replyContext`);
             }
         }
+        // Migration: readonly 模式已暂时禁用，历史会话统一转为 noask
+        if (hasMetadata && tableInfo.length > 0) {
+            const rows = this.db.prepare(`SELECT id, metadata FROM sessions WHERE metadata IS NOT NULL AND metadata != ''`).all();
+            let migratedPerm = 0;
+            for (const row of rows) {
+                try {
+                    const meta = JSON.parse(row.metadata);
+                    if (meta.permissionMode === 'readonly') {
+                        meta.permissionMode = 'noask';
+                        this.db.prepare('UPDATE sessions SET metadata = ? WHERE id = ?')
+                            .run(JSON.stringify(meta), row.id);
+                        migratedPerm++;
+                    }
+                }
+                catch { /* skip malformed JSON */ }
+            }
+            if (migratedPerm > 0) {
+                logger.info(`✓ Migrated ${migratedPerm} session(s): permissionMode readonly → noask`);
+            }
+        }
         // 创建新表（首次初始化）
         this.db.exec(`
       CREATE TABLE IF NOT EXISTS sessions (
@@ -451,7 +471,7 @@ export class SessionManager {
             session.identity = this.resolveIdentity(channel, userId);
             // 新话题会话补写默认权限模式
             if (session.metadata && !session.metadata.permissionMode) {
-                session.metadata.permissionMode = session.identity?.role === 'owner' ? 'bypass' : 'readonly';
+                session.metadata.permissionMode = session.identity?.role === 'owner' ? 'bypass' : session.identity?.role === 'admin' ? 'auto' : 'noask';
                 this.db.prepare(`UPDATE sessions SET metadata = ?, updated_at = ? WHERE id = ?`)
                     .run(JSON.stringify(session.metadata), Date.now(), session.id);
             }
@@ -562,7 +582,7 @@ export class SessionManager {
         session.identity = this.resolveIdentity(channel, userId);
         // 写入默认权限模式（基于角色，只在首次创建时设置）
         if (!sessionMetadata.permissionMode) {
-            sessionMetadata.permissionMode = session.identity?.role === 'owner' ? 'bypass' : 'readonly';
+            sessionMetadata.permissionMode = session.identity?.role === 'owner' ? 'bypass' : session.identity?.role === 'admin' ? 'auto' : 'noask';
         }
         this.insertSession(session);
         this.eventBus.publish({

package/dist/index.js

@@ -25,6 +25,7 @@ import { ChannelLoader } from './core/channel-loader.js';
 import { AgentLoader } from './core/agent-loader.js';
 import { IpcServer } from './ipc.js';
 import { logger } from './utils/logger.js';
+import { loadPromptTemplates } from './prompts/templates.js';
 import path from 'path';
 import fs from 'fs';
 async function main() {
@@ -48,6 +49,8 @@ async function main() {
     logger.info('EvolClaw starting...');
     // 确保数据目录存在
     ensureDataDirs();
+    // 加载提示词模板
+    loadPromptTemplates();
     // 加载配置
     const config = loadConfig();
     const paths = resolvePaths();

package/dist/prompts/templates.js

@@ -0,0 +1,122 @@
+import fs from 'fs';
+import path from 'path';
+import { getPackageRoot, resolveRoot } from '../paths.js';
+import { logger } from '../utils/logger.js';
+const KNOWN_SECTIONS = new Set(['runtime', 'group', 'proactive']);
+const SECTION_RE = /^##\s+(\w+)\s*$/;
+let sections = null;
+let builtinSections = null;
+function parseTemplate(content) {
+    const result = new Map();
+    let currentSection = null;
+    let currentLines = [];
+    for (const line of content.split('\n')) {
+        // Stop parsing at horizontal rule separator (documentation follows)
+        if (/^---\s*$/.test(line)) {
+            if (currentSection) {
+                result.set(currentSection, currentLines.join('\n').trim());
+            }
+            break;
+        }
+        const m = line.match(SECTION_RE);
+        if (m) {
+            if (currentSection) {
+                result.set(currentSection, currentLines.join('\n').trim());
+            }
+            const name = m[1];
+            if (KNOWN_SECTIONS.has(name)) {
+                currentSection = name;
+                currentLines = [];
+            }
+            else {
+                currentSection = null;
+                currentLines = [];
+            }
+        }
+        else if (currentSection) {
+            currentLines.push(line);
+        }
+    }
+    if (currentSection) {
+        result.set(currentSection, currentLines.join('\n').trim());
+    }
+    return result;
+}
+function loadBuiltinTemplate() {
+    const builtinPath = path.join(getPackageRoot(), 'dist', 'templates', 'prompts.md');
+    const srcPath = path.join(getPackageRoot(), 'src', 'templates', 'prompts.md');
+    const filePath = fs.existsSync(builtinPath) ? builtinPath : srcPath;
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return parseTemplate(content);
+}
+export function loadPromptTemplates() {
+    builtinSections = loadBuiltinTemplate();
+    const userPath = path.join(resolveRoot(), 'data', 'prompts.md');
+    if (fs.existsSync(userPath)) {
+        try {
+            const content = fs.readFileSync(userPath, 'utf-8');
+            const parsed = parseTemplate(content);
+            sections = new Map(builtinSections);
+            for (const [key, value] of parsed) {
+                sections.set(key, value);
+            }
+            logger.info(`[PromptTemplates] Loaded user override: ${userPath}`);
+        }
+        catch (err) {
+            logger.warn(`[PromptTemplates] Failed to load user override (${userPath}), using builtin:`, err);
+            sections = builtinSections;
+        }
+    }
+    else {
+        sections = builtinSections;
+        logger.info(`[PromptTemplates] Using builtin templates`);
+    }
+    for (const name of KNOWN_SECTIONS) {
+        if (!sections.has(name)) {
+            logger.warn(`[PromptTemplates] Section "${name}" missing, using builtin fallback`);
+            const fallback = builtinSections.get(name);
+            if (fallback)
+                sections.set(name, fallback);
+        }
+    }
+}
+function isTruthy(val) {
+    if (val === undefined || val === null || val === false || val === '' || val === 0)
+        return false;
+    return true;
+}
+function renderTemplate(template, vars) {
+    // Pass 1: conditional sections {{?key}}...{{/}}
+    let result = template.replace(/\{\{\?(\w+)\}\}([\s\S]*?)\{\{\/\}\}/g, (_match, key, body) => {
+        return isTruthy(vars[key]) ? body : '';
+    });
+    // Pass 2: variable substitution {{key}}
+    result = result.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
+        const val = vars[key];
+        if (!isTruthy(val))
+            return '';
+        return String(val);
+    });
+    // Pass 3: remove blank lines
+    return result.split('\n').filter(line => line.trim() !== '').join('\n');
+}
+export function renderPromptSection(section, vars) {
+    if (!sections)
+        loadPromptTemplates();
+    const template = sections.get(section);
+    if (!template) {
+        logger.warn(`[PromptTemplates] Section "${section}" not found`);
+        return '';
+    }
+    return renderTemplate(template, vars);
+}
+/** Reset loaded templates (for testing) */
+export function _resetTemplates() {
+    sections = null;
+    builtinSections = null;
+}
+/** Load templates from a raw string (for testing) */
+export function _loadFromString(content) {
+    builtinSections = parseTemplate(content);
+    sections = builtinSections;
+}

package/dist/templates/prompts.md

@@ -0,0 +1,103 @@
+# EvolClaw 运行时系统提示模板
+
+# 本文件定义 LLM 每次收到消息时注入到 system prompt 尾部的三段内容。
+# 修改后执行 `evolclaw restart` 生效。
+# 放在 {EVOLCLAW_HOME}/data/prompts.md 会覆盖内置默认。
+
+## runtime
+
+[当前环境] 会话通道: {{channel}} | 当前项目: {{project}}{{?sessionName}} | 会话名称: {{sessionName}}{{/}}{{?selfIdentity}} | 当前名称: {{selfIdentity}}{{/}} | 对端身份: {{peerRole}}{{?peerIdentity}} | 对端名称: {{peerIdentity}}{{/}}{{?peerType}} | 对端类型: {{peerType}}{{/}}{{?chatType}} | 聊天类型: {{chatType}}{{/}}{{?agent}} | 当前Agent: {{agent}}{{/}}
+{{?readonly}}[只读模式] 禁止修改项目文件。如需生成文件供用户下载，请写入 .evolclaw/tmp/ 目录后{{readonlySendHint}}{{/}}
+{{?fileSendCurrent}}[SEND_FILE:路径] 发送文件到当前通道{{/}}
+{{?fileSendCross}}[SEND_FILE:{{crossPrimary}}:路径] 发送文件到指定通道（可用: {{crossTypes}}）{{/}}
+{{?capability}}[通道能力] {{capabilities}}{{/}}
+
+## group
+
+[群聊回复规则] 回复时必须在开头添加 @{{peerId}} 来通知对方
+
+## proactive
+
+[Proactive 模式] 本次对话中你的流式输出不会自动发送给用户，必须通过以下命令主动发送：
+- 发送文本：evolclaw ctl send "<消息内容>"
+- 发送文件：evolclaw ctl file <路径>
+可多次调用。如不调用，用户将看不到任何回复。
+
+
+---
+
+## 格式说明
+
+模板由多个以 `## 段名` 分隔的段组成，加载器只识别 `runtime`、`group`、`proactive` 三段，其它段（包括本说明）会被忽略，可以随意增删。
+
+**占位符语法：**
+
+| 语法 | 作用 | 示例 |
+|---|---|---|
+| `{{var}}` | 变量替换。值为空串/undefined/null/false 时替换为空 | `{{project}}` → `evolclaw` |
+| `{{?var}}...{{/}}` | 条件段。var 为真值时保留整段（含字面量），否则整段删除。段内可嵌套 `{{var}}` | `{{?peerId}} | @{{peerId}}{{/}}` |
+| 空行 | 渲染后若某行只剩空白，整行自动删除 | 条件段删完后的空行会消失 |
+
+**注入时机：**
+
+| 段 | 触发条件 | 说明 |
+|---|---|---|
+| `runtime` | 每次消息 | 每条用户消息都会注入 |
+| `group` | `chatType === 'group' && peerId` | 仅群聊消息注入 |
+| `proactive` | `sessionMode === 'proactive'` | 仅 proactive 会话注入 |
+
+三段以换行拼接，追加到该消息的 system prompt 末尾。
+
+---
+
+## 参数说明
+
+### runtime 段
+
+| 字段 | 类型 | 说明 | 示例 |
+|---|---|---|---|
+| `channel` | string | 当前通道类型 | `feishu` / `wechat` / `aun` |
+| `project` | string | 当前项目目录名（非完整路径） | `evolclaw` |
+| `sessionName` | string? | 会话名（用户通过 `/name` 设置） | `CLI开发` |
+| `selfIdentity` | string? | 机器人自身标识「名称 (ID)」 | `Evol (evolai.xxx.pub)` |
+| `peerRole` | string | 对端角色 | `owner` / `admin` / `guest` / `unknown` |
+| `peerIdentity` | string? | 对端标识「名称 (ID)」 | `张三 (u_abc)` |
+| `peerType` | string? | 对端类型（`unknown` 时为空） | `user` / `group` |
+| `chatType` | string? | 聊天类型 | `private` / `group` |
+| `agent` | string? | 当前 agent（`claude` 时为空不显示） | `hermes` / `gemini` |
+| `readonly` | bool | 是否只读模式（触发只读行） | `true` / `false` |
+| `readonlySendHint` | string | 只读模式下提示使用的发送方式 | `使用 [SEND_FILE:] 发送` |
+| `fileSendCurrent` | bool | 当前通道是否支持发文件（触发该行） | `true` / `false` |
+| `fileSendCross` | bool | 是否存在可跨通道发文件的其它通道 | `true` / `false` |
+| `crossPrimary` | string | 跨通道发送示例用的首选通道 | `wechat` |
+| `crossTypes` | string | 所有支持跨通道发送的通道列表 | `wechat/aun` |
+| `capability` | bool | 是否有任何通道能力要展示（触发通道能力行） | `true` / `false` |
+| `capabilities` | string | 通道能力清单 | `图片输入、图片输出、文件发送` |
+
+### group 段
+
+| 字段 | 类型 | 说明 | 示例 |
+|---|---|---|---|
+| `peerId` | string | 对端用户 ID（@ 所需） | `ou_xxx` / `wxid_xxx` |
+
+### proactive 段
+
+无参数。
+
+---
+
+## 修改示例
+
+**只改文案，不改结构：**
+
+```
+## runtime
+当前项目 {{project}}，你正在和 {{peerIdentity}} 对话。
+{{?readonly}}⚠ 只读模式，不要修改代码{{/}}
+```
+
+**关闭某一行：** 模板里删掉那一行即可。内置条件段（如只读提示）删了之后，只读模式就不再在 system prompt 里出现（但权限拦截依然生效）。
+
+**追加自定义规则：** 直接在对应段里加行文本，不需要占位符。
+
+**用英文：** 所有文案重写成英文即可，字段含义不变。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolclaw",
-  "version": "2.6.3",
+  "version": "2.6.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",