evolclaw 3.1.3 → 3.1.5

package/dist/watch-msg.js

@@ -1,544 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import { resolvePaths, getPackageRoot } from './paths.js';
-import { decodeDirSegment, readAllJsonlLines } from './core/session/session-fs-store.js';
-// ==================== ANSI ====================
-const isTTY = !!process.stdout.isTTY;
-const RST = isTTY ? '\x1b[0m' : '';
-const DIM = isTTY ? '\x1b[2m' : '';
-const BOLD = isTTY ? '\x1b[1m' : '';
-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, '');
-    let w = 0;
-    for (const ch of stripped) {
-        const code = ch.charCodeAt(0);
-        w += (code >= 0x4e00 && code <= 0x9fff) || (code >= 0x3000 && code <= 0x30ff) ||
-            (code >= 0xff00 && code <= 0xffef) ? 2 : 1;
-    }
-    return w;
-}
-function padRight(s, width) {
-    const pad = Math.max(0, width - visualWidth(s));
-    return s + ' '.repeat(pad);
-}
-function truncate(s, maxWidth) {
-    let w = 0;
-    let i = 0;
-    for (const ch of s) {
-        const code = ch.charCodeAt(0);
-        const cw = (code >= 0x4e00 && code <= 0x9fff) || (code >= 0x3000 && code <= 0x30ff) ||
-            (code >= 0xff00 && code <= 0xffef) ? 2 : 1;
-        if (w + cw > maxWidth - 1)
-            return s.slice(0, i) + '…';
-        w += cw;
-        i += ch.length;
-    }
-    return s;
-}
-function formatTimeAgo(ms) {
-    const sec = Math.floor(ms / 1000);
-    if (sec < 60)
-        return `${sec}s`;
-    const min = Math.floor(sec / 60);
-    if (min < 60)
-        return `${min}m`;
-    const hour = Math.floor(min / 60);
-    if (hour < 24)
-        return `${hour}h`;
-    return `${Math.floor(hour / 24)}d`;
-}
-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];
-}
-// ==================== Data Layer ====================
-function getSessionsAunDir() {
-    const p = resolvePaths();
-    return path.join(p.sessionsDir, 'aun');
-}
-function listLocalAids(aunDir) {
-    try {
-        return fs.readdirSync(aunDir, { withFileTypes: true })
-            .filter(e => e.isDirectory())
-            .map(e => decodeDirSegment(e.name));
-    }
-    catch {
-        return [];
-    }
-}
-function listPeers(aunDir, localAid) {
-    const aidDir = path.join(aunDir, encodeSegment(localAid));
-    try {
-        return fs.readdirSync(aidDir, { withFileTypes: true })
-            .filter(e => e.isDirectory() && !e.name.startsWith('_'))
-            .map(e => decodeDirSegment(e.name));
-    }
-    catch {
-        return [];
-    }
-}
-function readMessages(aunDir, localAid, peerId) {
-    const msgPath = path.join(aunDir, encodeSegment(localAid), encodeSegment(peerId), 'messages.jsonl');
-    return readAllJsonlLines(msgPath);
-}
-function readPeerName(aunDir, localAid, peerId) {
-    const activePath = path.join(aunDir, encodeSegment(localAid), encodeSegment(peerId), 'active.json');
-    try {
-        const data = JSON.parse(fs.readFileSync(activePath, 'utf-8'));
-        return data?.metadata?.peerName || null;
-    }
-    catch {
-        return null;
-    }
-}
-function encodeSegment(s) {
-    return s.replace(/[/%\\:*?"<>|]/g, ch => '%' + ch.charCodeAt(0).toString(16).toUpperCase().padStart(2, '0'));
-}
-function loadAidInfo(aunDir, aid) {
-    const peers = listPeers(aunDir, aid);
-    let totalIn = 0, totalOut = 0;
-    for (const peer of peers) {
-        const msgs = readMessages(aunDir, aid, peer);
-        for (const m of msgs) {
-            if (m.dir === 'in')
-                totalIn++;
-            else
-                totalOut++;
-        }
-    }
-    return { aid, totalIn, totalOut, peerCount: peers.length };
-}
-function loadPeerInfos(aunDir, localAid) {
-    const peers = listPeers(aunDir, localAid);
-    const infos = [];
-    for (const peerId of peers) {
-        const msgs = readMessages(aunDir, localAid, peerId);
-        let inbound = 0, outbound = 0, lastAt = 0;
-        for (const m of msgs) {
-            if (m.dir === 'in')
-                inbound++;
-            else
-                outbound++;
-            if (m.ts > lastAt)
-                lastAt = m.ts;
-        }
-        const peerName = readPeerName(aunDir, localAid, peerId);
-        infos.push({ peerId, peerName, inbound, outbound, lastAt });
-    }
-    infos.sort((a, b) => b.lastAt - a.lastAt);
-    return infos;
-}
-function loadAllMessages(aunDir, localAid) {
-    const peers = listPeers(aunDir, localAid);
-    const all = [];
-    for (const peer of peers) {
-        all.push(...readMessages(aunDir, localAid, peer));
-    }
-    all.sort((a, b) => a.ts - b.ts);
-    if (all.length > 1000)
-        return all.slice(-1000);
-    return all;
-}
-// ==================== Rendering ====================
-function renderScrollbar(totalLines, visibleLines, offset, height) {
-    if (totalLines <= visibleLines)
-        return Array(height).fill(' ');
-    const thumbSize = Math.max(1, Math.floor(height * visibleLines / totalLines));
-    const maxOffset = totalLines - visibleLines;
-    const thumbPos = Math.floor((maxOffset - offset) / maxOffset * (height - thumbSize));
-    const bar = [];
-    for (let i = 0; i < height; i++) {
-        bar.push(i >= thumbPos && i < thumbPos + thumbSize ? `${DIM}█${RST}` : `${DIM}░${RST}`);
-    }
-    return bar;
-}
-function renderScopePanel(state, width, height) {
-    const lines = [];
-    const title = `${DIM}─ Scope ─${RST}`;
-    lines.push(padRight(title, width));
-    const isActive = state.activePanel === 'scope';
-    for (let i = 0; i < state.localAids.length && lines.length < height; i++) {
-        const a = state.localAids[i];
-        const sel = isActive && i === state.scopeIndex;
-        const chosen = state.selectedLocalAid === a.aid;
-        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 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));
-    }
-    while (lines.length < height)
-        lines.push(padRight('', width));
-    return lines.slice(0, height);
-}
-function renderStatsPanel(state, width, height) {
-    const lines = [];
-    const title = `${DIM}─ Stats ─${RST}`;
-    lines.push(padRight(title, width));
-    if (!state.selectedLocalAid) {
-        lines.push(padRight(`${DIM}  select an AID${RST}`, width));
-        while (lines.length < height)
-            lines.push(padRight('', width));
-        return lines.slice(0, height);
-    }
-    const isActive = state.activePanel === 'stats';
-    const now = Date.now();
-    // "All" item at index 0
-    const allSel = isActive && state.statsIndex === 0;
-    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 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 = `${detailBg}  ${DIM}↓${p.inbound} ↑${p.outbound}  ${ago}${RST}`;
-        lines.push(padRight(detail, width));
-        if (lines.length < height)
-            lines.push(padRight('', width));
-    }
-    while (lines.length < height)
-        lines.push(padRight('', width));
-    return lines.slice(0, height);
-}
-// ==================== Messages Panel ====================
-function renderMessagesPanel(state, width, height) {
-    const lines = [];
-    const title = `${DIM}─ Messages ─${RST}`;
-    lines.push(padRight(title, width));
-    const contentHeight = height - 1;
-    const msgs = state.messages;
-    const totalMsgs = msgs.length;
-    const visibleCount = contentHeight;
-    const startIdx = Math.max(0, totalMsgs - visibleCount - state.messageScrollOffset);
-    const endIdx = Math.min(totalMsgs, startIdx + visibleCount);
-    const scrollbar = renderScrollbar(totalMsgs, visibleCount, state.messageScrollOffset, contentHeight);
-    const msgWidth = width - 3;
-    for (let i = startIdx; i < endIdx; i++) {
-        const m = msgs[i];
-        const time = formatDateTime(m.ts);
-        const dir = m.dir === 'in' ? `${GREEN}↓${RST}` : `${BLUE}↑${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] || ' '}`);
-        if (lines.length - 1 < contentHeight) {
-            const content = truncate(m.content.replace(/\n/g, ' '), msgWidth - 2);
-            const contentLine = padRight(`  ${content}`, msgWidth);
-            const sbIdx2 = lines.length - 1;
-            lines.push(`${contentLine} ${scrollbar[sbIdx2] || ' '}`);
-        }
-    }
-    while (lines.length < height) {
-        const sbIdx = lines.length - 1;
-        lines.push(padRight('', msgWidth) + ` ${scrollbar[sbIdx] || ' '}`);
-    }
-    return lines.slice(0, height);
-}
-// ==================== Main Render ====================
-function renderFrame(state) {
-    const cols = process.stdout.columns || 120;
-    const rows = (process.stdout.rows || 40) - 3;
-    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);
-    const msgLines = renderMessagesPanel(state, rightW, bodyHeight);
-    const sep = `${DIM}│${RST}`;
-    let buf = '\x1b[H';
-    const topBorder = `${DIM}┌${'─'.repeat(leftW)}┬${'─'.repeat(midW)}┬${'─'.repeat(rightW + 1)}┐${RST}`;
-    buf += `\x1b[2K${topBorder}\n`;
-    for (let i = 0; i < bodyHeight; i++) {
-        const l = leftLines[i] || padRight('', leftW);
-        const m = midLines[i] || padRight('', midW);
-        const r = msgLines[i] || padRight('', rightW);
-        buf += `\x1b[2K${sep}${l}${sep}${m}${sep}${r}${sep}\n`;
-    }
-    const bottomBorder = `${DIM}├${'─'.repeat(leftW)}┴${'─'.repeat(midW)}┴${'─'.repeat(rightW + 1)}┤${RST}`;
-    buf += `\x1b[2K${bottomBorder}\n`;
-    const pkgRoot = getPackageRoot();
-    const helpLine = `${DIM}│ Tab: panel  ↑↓: nav  Enter: select  Backspace: back  ESC: exit  ${pkgRoot}${RST}`;
-    buf += `\x1b[2K${helpLine}\n`;
-    const closeBorder = `${DIM}└${'─'.repeat(cols - 2)}┘${RST}`;
-    buf += `\x1b[2K${closeBorder}\n`;
-    return buf;
-}
-// ==================== Main ====================
-export async function cmdWatchMsg() {
-    const aunDir = getSessionsAunDir();
-    if (!fs.existsSync(aunDir)) {
-        console.log('No session data found.');
-        return;
-    }
-    let watcher = null;
-    const state = {
-        activePanel: 'scope',
-        localAids: [],
-        scopeIndex: 0,
-        selectedLocalAid: null,
-        peers: [],
-        statsIndex: 0,
-        selectedPeer: null,
-        messages: [],
-        messageScrollOffset: 0,
-        dirty: true,
-    };
-    function loadScope() {
-        const aids = listLocalAids(aunDir);
-        state.localAids = aids.map(aid => loadAidInfo(aunDir, aid));
-        state.localAids.sort((a, b) => (b.totalIn + b.totalOut) - (a.totalIn + a.totalOut));
-    }
-    function selectAid(aid) {
-        state.selectedLocalAid = aid;
-        state.peers = loadPeerInfos(aunDir, aid);
-        state.statsIndex = 0;
-        state.selectedPeer = null;
-        state.messages = loadAllMessages(aunDir, aid);
-        state.messageScrollOffset = 0;
-        startWatching(aid);
-    }
-    function selectPeer(peerId) {
-        state.selectedPeer = peerId;
-        if (!state.selectedLocalAid)
-            return;
-        if (peerId) {
-            state.messages = readMessages(aunDir, state.selectedLocalAid, peerId);
-            if (state.messages.length > 1000)
-                state.messages = state.messages.slice(-1000);
-        }
-        else {
-            state.messages = loadAllMessages(aunDir, state.selectedLocalAid);
-        }
-        state.messageScrollOffset = 0;
-    }
-    function startWatching(aid) {
-        if (watcher) {
-            watcher.close();
-            watcher = null;
-        }
-        const aidDir = path.join(aunDir, encodeSegment(aid));
-        try {
-            watcher = fs.watch(aidDir, { recursive: true }, (_, filename) => {
-                if (filename && filename.endsWith('messages.jsonl')) {
-                    refreshData();
-                    render();
-                }
-            });
-        }
-        catch { /* directory may not exist */ }
-    }
-    function refreshData() {
-        if (!state.selectedLocalAid)
-            return;
-        state.peers = loadPeerInfos(aunDir, state.selectedLocalAid);
-        if (state.selectedPeer) {
-            state.messages = readMessages(aunDir, state.selectedLocalAid, state.selectedPeer);
-            if (state.messages.length > 1000)
-                state.messages = state.messages.slice(-1000);
-        }
-        else {
-            state.messages = loadAllMessages(aunDir, state.selectedLocalAid);
-        }
-        // Also refresh scope stats for the selected AID
-        const idx = state.localAids.findIndex(a => a.aid === state.selectedLocalAid);
-        if (idx >= 0) {
-            state.localAids[idx] = loadAidInfo(aunDir, state.selectedLocalAid);
-        }
-    }
-    function render() {
-        process.stdout.write(renderFrame(state));
-    }
-    function cleanup() {
-        if (watcher) {
-            watcher.close();
-            watcher = null;
-        }
-        if (process.stdin.isTTY)
-            try {
-                process.stdin.setRawMode(false);
-            }
-            catch { }
-        process.stdin.pause();
-        process.stdout.write('\x1b[?25h\x1b[2J\x1b[H');
-    }
-    function handleKey(data) {
-        // ESC
-        if (data[0] === 0x1b && data.length === 1) {
-            cleanup();
-            process.exit(0);
-        }
-        // Ctrl+C
-        if (data[0] === 0x03) {
-            cleanup();
-            process.exit(0);
-        }
-        // Arrow keys
-        if (data[0] === 0x1b && data[1] === 0x5b) {
-            const code = data[2];
-            if (code === 0x41)
-                handleUp();
-            else if (code === 0x42)
-                handleDown();
-            else if (code === 0x43)
-                handleRight();
-            else if (code === 0x44)
-                handleLeft();
-            else if (code === 0x35)
-                handlePageUp(); // Page Up: \x1b[5~
-            else if (code === 0x36)
-                handlePageDown(); // Page Down: \x1b[6~
-            render();
-            return;
-        }
-        // Tab
-        if (data[0] === 0x09) {
-            handleRight();
-            render();
-            return;
-        }
-        // Shift+Tab (some terminals: \x1b[Z)
-        if (data[0] === 0x1b && data[1] === 0x5b && data[2] === 0x5a) {
-            handleLeft();
-            render();
-            return;
-        }
-        // Enter
-        if (data[0] === 0x0d) {
-            handleEnter();
-            render();
-            return;
-        }
-        // Backspace
-        if (data[0] === 0x7f || data[0] === 0x08) {
-            handleBackspace();
-            render();
-            return;
-        }
-    }
-    function handleUp() {
-        if (state.activePanel === 'scope') {
-            state.scopeIndex = Math.max(0, state.scopeIndex - 1);
-        }
-        else if (state.activePanel === 'stats') {
-            state.statsIndex = Math.max(0, state.statsIndex - 1);
-        }
-        else if (state.activePanel === 'messages') {
-            state.messageScrollOffset = Math.min(Math.max(0, state.messages.length - 5), state.messageScrollOffset + 3);
-        }
-    }
-    function handleDown() {
-        if (state.activePanel === 'scope') {
-            state.scopeIndex = Math.min(state.localAids.length - 1, state.scopeIndex + 1);
-        }
-        else if (state.activePanel === 'stats') {
-            state.statsIndex = Math.min(state.peers.length, state.statsIndex + 1);
-        }
-        else if (state.activePanel === 'messages') {
-            state.messageScrollOffset = Math.max(0, state.messageScrollOffset - 3);
-        }
-    }
-    function handleLeft() {
-        if (state.activePanel === 'messages')
-            state.activePanel = 'stats';
-        else if (state.activePanel === 'stats')
-            state.activePanel = 'scope';
-    }
-    function handleRight() {
-        if (state.activePanel === 'scope')
-            state.activePanel = 'stats';
-        else if (state.activePanel === 'stats')
-            state.activePanel = 'messages';
-    }
-    function handlePageUp() {
-        if (state.activePanel === 'messages') {
-            const pageSize = (process.stdout.rows || 40) - 6;
-            state.messageScrollOffset = Math.min(Math.max(0, state.messages.length - 5), state.messageScrollOffset + pageSize);
-        }
-    }
-    function handlePageDown() {
-        if (state.activePanel === 'messages') {
-            const pageSize = (process.stdout.rows || 40) - 6;
-            state.messageScrollOffset = Math.max(0, state.messageScrollOffset - pageSize);
-        }
-    }
-    function handleEnter() {
-        if (state.activePanel === 'scope' && state.localAids.length > 0) {
-            const aid = state.localAids[state.scopeIndex];
-            selectAid(aid.aid);
-            state.activePanel = 'stats';
-        }
-        else if (state.activePanel === 'stats') {
-            if (state.statsIndex === 0) {
-                selectPeer(null);
-            }
-            else {
-                const peer = state.peers[state.statsIndex - 1];
-                if (peer)
-                    selectPeer(peer.peerId);
-            }
-            state.activePanel = 'messages';
-        }
-    }
-    function handleBackspace() {
-        if (state.activePanel === 'messages') {
-            state.activePanel = 'stats';
-            state.messageScrollOffset = 0;
-        }
-        else if (state.activePanel === 'stats') {
-            state.activePanel = 'scope';
-            state.selectedLocalAid = null;
-            state.peers = [];
-            state.messages = [];
-            if (watcher) {
-                watcher.close();
-                watcher = null;
-            }
-        }
-    }
-    // ── Init ──
-    process.on('SIGINT', () => { cleanup(); process.exit(0); });
-    process.on('SIGTERM', () => { cleanup(); process.exit(0); });
-    loadScope();
-    process.stdout.write('\x1b[?25l\x1b[2J\x1b[H');
-    render();
-    if (process.stdin.isTTY) {
-        process.stdin.setRawMode(true);
-        process.stdin.resume();
-        process.stdin.on('data', handleKey);
-    }
-    // Keep process alive
-    await new Promise(() => { });
-}

package/kits/docs/evolclaw/AGENT_CMD.md

@@ -1,31 +0,0 @@
-# EvolClaw 可用命令
-
-通过 `evolclaw ctl <command> [args]` 管理运行时配置。仅在 evolclaw 托管环境中可用。
-
-## 查询类（所有用户）
-- `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] <message>` — 发送消息
-- `evolclaw ctl file <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 并热加载

package/kits/docs/evolclaw/MSG_GROUP.md

@@ -1,30 +0,0 @@
-# 群聊消息命令
-
-<!-- TODO: 填充群聊消息命令详细参考 -->
-
-## 发送群消息
-
-```bash
-evolclaw group send <from-aid> <group-id> "<message>"
-```
-
-## 拉取群消息
-
-```bash
-evolclaw group pull <self-aid> <group-id> --app <app-name>
-```
-
-## 群管理
-
-```bash
-evolclaw group create <owner-aid> --name "<group-name>"
-evolclaw group list <self-aid>
-evolclaw group info <self-aid> <group-id>
-evolclaw group invite <self-aid> <group-id> <target-aid>
-evolclaw group kick <self-aid> <group-id> <target-aid>
-evolclaw group members <self-aid> <group-id>
-```
-
-## 自主回复策略
-
-群聊中被 @ 才默认响应，可通过 venue policy 配置其他触发条件。

package/kits/docs/evolclaw/MSG_PRIVATE.md

@@ -1,72 +0,0 @@
-# 私聊消息命令
-
-## 发送消息
-
-### 以指定 AID 发送（首选）
-
-```bash
-# 明文
-ec msg send <from-aid> <to-aid> "<message>"
-
-# 密文（E2EE）
-ec msg send <from-aid> <to-aid> "<message>" --encrypt
-```
-
-### 发送文件
-
-```bash
-ec msg send <from-aid> <to-aid> --file <path>
-ec msg send <from-aid> <to-aid> --file <path> --as image
-ec msg send <from-aid> <to-aid> --file <path> --encrypt
-```
-
-`--as` 可选值：`image` | `video` | `voice` | `file`（默认按扩展名推断）
-
-## 拉取消息
-
-```bash
-ec msg pull <self-aid> --app <app-name>
-ec msg pull <self-aid> --app <app-name> --after-seq <N> --limit <N>
-```
-
-## 确认消息已读
-
-```bash
-ec msg ack <self-aid> <seq> --app <app-name>
-```
-
-`--app` 必须传，否则会污染 daemon 游标。
-
-## 撤回消息
-
-```bash
-ec msg recall <self-aid> <message-id>
-```
-
-## 查询在线状态
-
-```bash
-ec msg online <self-aid> <target-aid>
-```
-
-## 自主回复策略
-
-收到消息 ≠ 必须回复。是否回复、怎么回复、何时回复由 agent 自主决定。
-
-加密策略：
-- 对端发来密文消息时，回复也应使用 `--encrypt`（保持对话加密一致性）
-- 对端发来明文消息时，默认明文回复
-
-## 在当前会话中快速回复（备选）
-
-仅当无法使用 `ec msg send` 时（如不知道自己的 AID），可用 `ec ctl send`：
-
-```bash
-# 明文
-ec ctl send "<text>"
-
-# 密文
-ec ctl send --encrypt "<text>"
-```
-
-`ec ctl send` 自动继承当前会话的 AID 和对端，无需指定。

package/kits/docs/evolclaw/tools.md

@@ -1,25 +0,0 @@
-# EvolClaw 可用工具
-
-evolclaw 托管环境下，baseagent 可通过 Bash 工具调用以下命令：
-
-## 消息发送
-- `evolclaw ctl send "<消息>"` — 发送文本消息给当前对话方
-- `evolclaw ctl file <路径>` — 发送项目内文件
-
-## 运行时查询
-- `evolclaw ctl status` — 当前会话状态
-- `evolclaw ctl model` — 当前模型信息
-- `evolclaw ctl effort` — 当前推理强度
-- `evolclaw ctl check` — 渠道健康检查
-- `evolclaw ctl aid` — AUN 连接状态
-
-## 运行时配置
-- `evolclaw ctl model <id>` — 切换模型
-- `evolclaw ctl effort <level>` — 切换推理强度
-- `evolclaw ctl compact` — 压缩上下文
-- `evolclaw ctl perm <mode>` — 切换权限模式
-
-## agent.md 管理
-- `evolclaw ctl agentmd` — 查看当前 agent.md
-- `evolclaw ctl agentmd put` — 发布到 AUN 网络
-- `evolclaw ctl agentmd set <内容>` — 直接设置内容