evolclaw 2.8.3 → 3.1.0

package/dist/templates/prompts.md

@@ -1,104 +0,0 @@
-# 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 模式] 你的所有文本输出都会被静默丢弃，用户永远看不到。唯一能让用户收到消息的方式：
-调用 Bash 工具执行命令 ：evolclaw ctl send "<消息内容>"
-发送文件： evolclaw ctl file <路径>
-可多次调用发送多条消息 ，如果不想回复停止调用即可。
-禁止使用 AskUserQuestion 和 ExitPlanMode 工具——proactive 模式下应由你主动用 ctl send 与用户沟通。
-
-
----
-
-## 格式说明
-
-模板由多个以 `## 段名` 分隔的段组成，加载器只识别 `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/templates/skills.md

@@ -1,66 +0,0 @@
----
-name: evolclaw-ctl
-version: 1.1.0
-description: 仅在 evolclaw 运行时可用
-trigger: 用户询问或需要切换模型、调整推理强度、查看运行状态、压缩上下文、检查通道健康、管理权限模式、重启服务、重连渠道等
----
-
-# EvolClaw Ctl
-
-通过 `evolclaw ctl <command> [args]` 管理运行时配置。仅在 evolclaw 托管环境中可用（`EVOLCLAW_SESSION_ID` 已设置）。
-
-## 可用指令
-
-### 查询类（所有用户）
-- `evolclaw ctl help` — 显示帮助
-- `evolclaw ctl status` — 显示会话状态
-- `evolclaw ctl check` — 检查渠道健康状态
-
-### 配置类（管理员）
-- `evolclaw ctl model` — 查看当前模型和可选列表
-- `evolclaw ctl model <model-id>` — 切换模型（如 `opus`, `sonnet`, `haiku`）
-- `evolclaw ctl effort` — 查看当前推理强度
-- `evolclaw ctl effort <low|medium|high|max>` — 切换推理强度
-- `evolclaw ctl compact` — 压缩当前会话上下文
-
-### 权限类
-- `evolclaw ctl perm` — 查看当前权限模式（管理员）
-- `evolclaw ctl perm <mode>` — 切换权限模式（仅 owner）
-
-### 运维类（仅 owner）
-- `evolclaw ctl activity <all|dm|owner|none>` — 查看/控制中间输出显示模式
-- `evolclaw ctl send [channel] <path>` — 发送项目内文件（仅限项目目录内）
-- `evolclaw ctl restart` — 重启服务（慎用：中断所有会话）
-- `evolclaw ctl restart <channel>` — 重连指定渠道（管理员可用）
-- `evolclaw ctl agentmd` — 查看当前 agent.md
-- `evolclaw ctl agentmd put` — 发布本地 agent.md
-- `evolclaw ctl agentmd set <内容>` — 直接设置 agent.md 内容
-- `evolclaw ctl aid` — 列出所有 AUN 实例及连接状态
-- `evolclaw ctl aid new <aid>` — 创建新 AID 并热加载（仅 AUN 通道）
-
-## 使用示例
-
-```bash
-# 查看当前模型
-evolclaw ctl model
-
-# 切换到 opus
-evolclaw ctl model opus
-
-# 降低推理强度以加快响应
-evolclaw ctl effort low
-
-# 压缩上下文
-evolclaw ctl compact
-
-# 查看服务状态
-evolclaw ctl status
-```
-
-## 注意事项
-
-- 仅在 evolclaw 托管环境中可用（EVOLCLAW_SESSION_ID 环境变量已设置时）
-- 权限继承当前会话用户的角色（owner / admin / guest）
-- `compact` 不能在当前会话处理消息期间执行
-- `send` 只能发送项目目录下的文件
-- `restart` 会中断当前所有会话，谨慎使用

package/dist/utils/channel-fingerprint.js

@@ -1,59 +0,0 @@
-/**
- * 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/error-dict.js

@@ -1,63 +0,0 @@
-import fs from 'fs';
-import { logger } from './logger.js';
-let rules = [];
-/**
- * 加载错误字典文件
- * 文件不存在或格式错误 → 警告日志，rules = []（不影响启动）
- */
-export function loadErrorDict(dictPath) {
-    try {
-        if (!fs.existsSync(dictPath)) {
-            logger.debug('[error-dict] 字典文件不存在，使用内置规则: %s', dictPath);
-            rules = [];
-            return;
-        }
-        const raw = JSON.parse(fs.readFileSync(dictPath, 'utf-8'));
-        if (!Array.isArray(raw?.rules)) {
-            logger.warn('[error-dict] 字典格式错误（缺少 rules 数组），忽略: %s', dictPath);
-            rules = [];
-            return;
-        }
-        // 校验每条规则的必填字段
-        rules = raw.rules.filter((r) => {
-            if (!r.id || !r.match || !r.action) {
-                logger.warn('[error-dict] 跳过无效规则（缺少 id/match/action）: %o', r);
-                return false;
-            }
-            if (!['retry', 'stop', 'ignore'].includes(r.action)) {
-                logger.warn('[error-dict] 跳过无效 action "%s": %s', r.action, r.id);
-                return false;
-            }
-            return true;
-        });
-        logger.info('[error-dict] 已加载 %d 条规则: %s', rules.length, dictPath);
-    }
-    catch (err) {
-        logger.warn('[error-dict] 加载失败: %s — %s', dictPath, err.message);
-        rules = [];
-    }
-}
-/** 运行时重新加载（供 /reload 命令使用） */
-export function reloadErrorDict(dictPath) {
-    loadErrorDict(dictPath);
-}
-/**
- * 匹配错误消息，返回首条命中的规则
- * @param errorMessage 已 toLowerCase 的错误消息
- */
-export function matchErrorRule(errorMessage) {
-    for (const rule of rules) {
-        if (errorMessage.includes(rule.match.toLowerCase())) {
-            return rule;
-        }
-    }
-    return null;
-}
-/** 获取当前已加载的规则数量（供测试和状态查询使用） */
-export function getLoadedRuleCount() {
-    return rules.length;
-}
-/** 重置规则（仅供测试使用） */
-export function _resetRules() {
-    rules = [];
-}

package/dist/utils/format.js

@@ -1,32 +0,0 @@
-// ── Markdown → Plain Text ───────────────────────────────────────────────────
-export function markdownToPlainText(text) {
-    let result = text;
-    // Code blocks: strip fences, keep content
-    result = result.replace(/```[^\n]*\n?([\s\S]*?)```/g, (_, code) => code.trim());
-    // Images: remove entirely
-    result = result.replace(/!\[[^\]]*\]\([^)]*\)/g, '');
-    // Links: keep display text only
-    result = result.replace(/\[([^\]]+)\]\([^)]*\)/g, '$1');
-    // Tables: remove separator rows
-    result = result.replace(/^\|[\s:|-]+\|$/gm, '');
-    result = result.replace(/^\|(.+)\|$/gm, (_, inner) => inner.split('|').map(cell => cell.trim()).join('  '));
-    // Bold/italic
-    result = result.replace(/\*\*(.+?)\*\*/g, '$1');
-    result = result.replace(/\*(.+?)\*/g, '$1');
-    result = result.replace(/__(.+?)__/g, '$1');
-    result = result.replace(/_(.+?)_/g, '$1');
-    // Strikethrough
-    result = result.replace(/~~(.+?)~~/g, '$1');
-    // Inline code
-    result = result.replace(/`([^`]+)`/g, '$1');
-    // Headers
-    result = result.replace(/^#{1,6}\s+/gm, '');
-    // Blockquotes
-    result = result.replace(/^>\s?/gm, '');
-    // Horizontal rules
-    result = result.replace(/^[-*_]{3,}$/gm, '');
-    // List markers
-    result = result.replace(/^(\s*)[-*+]\s/gm, '$1');
-    result = result.replace(/^(\s*)\d+\.\s/gm, '$1');
-    return result.trim();
-}