evolclaw 2.6.3 → 2.7.0

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/dist/utils/channel-fingerprint.js

@@ -0,0 +1,59 @@
+/**
+ * Channel Fingerprint
+ *
+ * 为每个 channel 实例提取一个全局唯一标识，用于冲突检测和路由索引。
+ * 格式：{type}:{primaryKey}
+ */
+/** Channel 类型 → 主键字段映射 */
+const PRIMARY_KEY_MAP = {
+    feishu: 'appId',
+    aun: 'aid',
+    wechat: 'token',
+    wecom: 'botId',
+    dingtalk: 'clientId',
+    qqbot: 'appId',
+};
+export function extractFingerprint(channelType, instance) {
+    const keyField = PRIMARY_KEY_MAP[channelType];
+    if (!keyField)
+        return null;
+    const value = instance[keyField];
+    if (!value || typeof value !== 'string')
+        return null;
+    return `${channelType}:${value}`;
+}
+export function detectDuplicates(config) {
+    const seen = new Map();
+    const channels = config.channels || {};
+    for (const [type, raw] of Object.entries(channels)) {
+        if (type === 'defaultChannel')
+            continue;
+        const instances = Array.isArray(raw) ? raw : [raw];
+        for (const inst of instances) {
+            if (!inst || typeof inst !== 'object')
+                continue;
+            const fingerprint = extractFingerprint(type, inst);
+            if (!fingerprint)
+                continue;
+            const instName = inst.name ?? type;
+            const entry = seen.get(fingerprint);
+            if (entry) {
+                entry.instances.push(instName);
+            }
+            else {
+                seen.set(fingerprint, { channelType: type, instances: [instName] });
+            }
+        }
+    }
+    const duplicates = [];
+    for (const [fingerprint, entry] of seen) {
+        if (entry.instances.length > 1) {
+            duplicates.push({
+                fingerprint,
+                channelType: entry.channelType,
+                instances: entry.instances,
+            });
+        }
+    }
+    return duplicates;
+}

package/dist/utils/init.js

@@ -503,7 +503,7 @@ export async function cmdInit(options) {
         const config = JSON.parse(fs.readFileSync(sampleSrc, 'utf-8'));
         config.projects.defaultPath = defaultPath;
         config.projects.list = { [path.basename(defaultPath)]: defaultPath };
-        config.agents.anthropic.model = model;
+        config.agents.claude.model = model;
         let channelConfigured = false;
         while (!channelConfigured) {
             console.log('\n选择消息渠道:');

package/dist/utils/logger.js

@@ -2,7 +2,7 @@ import fs from 'fs';
 import path from 'path';
 import { resolvePaths } from '../paths.js';
 const LOG_DIR = resolvePaths().logs;
-const LOG_LEVEL = process.env.LOG_LEVEL || 'INFO';
+let currentLevel = process.env.LOG_LEVEL || 'INFO';
 const LEVELS = { DEBUG: 0, INFO: 1, WARN: 2, ERROR: 3 };
 const config = {
     messageLog: process.env.MESSAGE_LOG === 'true',
@@ -17,7 +17,7 @@ const streams = {
     event: config.eventLog ? fs.createWriteStream(path.join(LOG_DIR, 'events.log'), { flags: 'a' }) : null
 };
 function shouldLog(level) {
-    return LEVELS[level] >= LEVELS[LOG_LEVEL];
+    return (LEVELS[level] ?? 1) >= (LEVELS[currentLevel] ?? 1);
 }
 function write(stream, data) {
     if (!stream)
@@ -35,9 +35,21 @@ function log(level, ...args) {
         return;
     const timestamp = localTimestamp();
     const msg = `[${timestamp}] [${level}] ${args.join(' ')}`;
-    // 只写文件，不输出到 console（避免重定向时重复）
     write(streams.main, msg);
 }
+/**
+ * 设置日志级别（config 加载后调用，覆盖环境变量默认值）
+ * 优先级：config.debug.logLevel → LOG_LEVEL 环境变量 → 'INFO'
+ */
+export function setLogLevel(level) {
+    const upper = level.toUpperCase();
+    if (upper in LEVELS) {
+        currentLevel = upper;
+    }
+}
+export function getLogLevel() {
+    return currentLevel;
+}
 export const logger = {
     debug: (...args) => log('DEBUG', ...args),
     info: (...args) => log('INFO', ...args),

package/package.json

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