evolclaw 3.0.0 → 3.1.0

package/dist/paths.js

@@ -36,15 +36,13 @@ export function resolvePaths() {
         readySignal: path.join(root, 'data', 'instance', 'ready.signal'),
         selfHealLog: path.join(root, 'logs', 'self-heal.md'),
         socket: resolveInstanceSocketPath(root),
-        // ── 新结构（evolclaw-home-directory.md）────────────────
+        // ── 新结构（evolclaw-directory-design.md）────────────────
         defaultsConfig: path.join(root, 'agents', 'defaults.json'),
-        kitsDir: path.join(root, 'kits'),
-        kitsAunDir: path.join(root, 'kits', 'aun'),
-        kitsChannelsDir: path.join(root, 'kits', 'channels'),
-        kitsEvolclawDir: path.join(root, 'kits', 'evolclaw'),
-        kitsTemplatesDir: path.join(root, 'kits', 'templates'),
+        processConfig: path.join(root, 'config.json'),
+        eckDir: path.join(root, 'eck'),
         instanceReadySignal: path.join(root, 'data', 'instance', 'ready.signal'),
         instanceSocket: resolveInstanceSocketPath(root),
+        aidLogsDir: path.join(root, 'logs', 'aids'),
     };
 }
 // ── per-agent 路径（参数化，不进 resolvePaths() 的固定 map）──
@@ -57,8 +55,15 @@ export function agentConfig(aid) {
 export function agentPersonalDir(aid) {
     return path.join(agentDir(aid), 'personal');
 }
+export function agentRelationsDir(aid) {
+    return path.join(agentDir(aid), 'relations');
+}
+/** @deprecated Use agentRelationsDir instead */
 export function agentIdentitiesDir(aid) {
-    return path.join(agentDir(aid), 'identities');
+    return agentRelationsDir(aid);
+}
+export function agentIndexDir(aid) {
+    return path.join(agentDir(aid), 'index');
 }
 export function agentVenuesDir(aid) {
     return path.join(agentDir(aid), 'venues');
@@ -86,44 +91,30 @@ export function ensureDataDirs() {
     const p = resolvePaths();
     fs.mkdirSync(p.dataDir, { recursive: true });
     fs.mkdirSync(p.logs, { recursive: true });
+    fs.mkdirSync(p.aidLogsDir, { recursive: true });
     fs.mkdirSync(p.agentsDir, { recursive: true });
     fs.mkdirSync(p.sessionsDir, { recursive: true });
     fs.mkdirSync(p.instanceDir, { recursive: true });
     fs.mkdirSync(p.outboxDir, { recursive: true });
-    fs.mkdirSync(p.kitsDir, { recursive: true });
+    fs.mkdirSync(p.eckDir, { recursive: true });
+    fs.mkdirSync(eckDebugDir(), { recursive: true });
 }
-/**
- * 首次启动或升级时，把包内 kits/ 复制到 EVOLCLAW_HOME/kits/。
- * 策略：如果目标 kits/ 为空或包版本更新，整体覆盖。
- */
-export function syncKitsFromPackage() {
-    const p = resolvePaths();
-    const srcKits = path.join(getPackageRoot(), 'kits');
-    if (!fs.existsSync(srcKits))
-        return;
-    const destKits = p.kitsDir;
-    // 包内自用场景：EVOLCLAW_HOME 等于包根（开发仓 / 用户家目录恰好是安装目录），
-    // src === dest 会让 cpSync 抛 ERR_FS_CP_EINVAL。直接跳过同步。
-    if (path.resolve(srcKits) === path.resolve(destKits))
-        return;
-    // 用 .kits-version 文件跟踪已安装的版本
-    const versionFile = path.join(destKits, '.kits-version');
-    const pkgJsonPath = path.join(getPackageRoot(), 'package.json');
-    let pkgVersion = '0.0.0';
-    try {
-        pkgVersion = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8')).version || '0.0.0';
-    }
-    catch { }
-    let installedVersion = '';
-    try {
-        installedVersion = fs.readFileSync(versionFile, 'utf-8').trim();
-    }
-    catch { }
-    if (installedVersion === pkgVersion)
-        return;
-    // 递归复制（覆盖）
-    fs.cpSync(srcKits, destKits, { recursive: true, force: true });
-    fs.writeFileSync(versionFile, pkgVersion, 'utf-8');
+// ── kits 路径（始终从包内读取，不复制到 EVOLCLAW_HOME）──
+export function kitsDir() {
+    return path.join(getPackageRoot(), 'kits');
+}
+export function kitsRulesDir() {
+    return path.join(getPackageRoot(), 'kits', 'rules');
+}
+export function kitsDocsDir() {
+    return path.join(getPackageRoot(), 'kits', 'docs');
+}
+export function kitsTemplatesDir() {
+    return path.join(getPackageRoot(), 'kits', 'templates');
+}
+// ── 调试输出 ──
+export function eckDebugDir() {
+    return path.join(resolveRoot(), 'data', 'eck-debug');
 }
 export function getPackageRoot() {
     // import.meta.dirname is available in Node.js 21.2+ and always returns

package/dist/utils/aid-lifecycle-log.js

@@ -0,0 +1,33 @@
+import fs from 'fs';
+import path from 'path';
+import { resolvePaths } from '../paths.js';
+function ensureDir(dir) {
+    fs.mkdirSync(dir, { recursive: true });
+}
+function logPath(aid) {
+    const aidName = aid.startsWith('@') ? aid.slice(1) : aid;
+    return path.join(resolvePaths().aidLogsDir, `${aidName}.jsonl`);
+}
+export function appendAidLifecycle(event) {
+    const filePath = logPath(event.aid);
+    ensureDir(path.dirname(filePath));
+    fs.appendFileSync(filePath, JSON.stringify(event) + '\n');
+}
+export function readAidLifecycle(aid, lastN = 50) {
+    const filePath = logPath(aid);
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.trim().split('\n').filter(Boolean);
+        const events = [];
+        for (const line of lines.slice(-lastN)) {
+            try {
+                events.push(JSON.parse(line));
+            }
+            catch { }
+        }
+        return events;
+    }
+    catch {
+        return [];
+    }
+}

package/dist/utils/atomic-write.js

@@ -77,3 +77,13 @@ export function ensureDir(dirPath) {
         fs.mkdirSync(dirPath, { recursive: true });
     }
 }
+/**
+ * Simple atomic write for plain-text files (ECK runtime files).
+ * Uses write-tmp-then-rename (no hot-backup needed for these files).
+ */
+export function atomicWriteText(filePath, content) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const tmp = filePath + '.tmp.' + process.pid;
+    fs.writeFileSync(tmp, content, 'utf-8');
+    fs.renameSync(tmp, filePath);
+}

package/dist/utils/cross-platform.js

@@ -1,6 +1,6 @@
 import path from 'path';
 import { fileURLToPath } from 'url';
-import { execFileSync, execFile, spawn } from 'child_process';
+import { execFileSync, execFile, spawn, spawnSync } from 'child_process';
 import { promisify } from 'util';
 import fs from 'fs';
 const execFileAsync = promisify(execFile);
@@ -33,7 +33,7 @@ export function isProcessRunning(pid) {
 export function killProcess(pid, force = false) {
     if (isWindows && force) {
         try {
-            execFileSync('taskkill', ['/PID', String(pid), '/F']);
+            spawnSync('taskkill', ['/PID', String(pid), '/F'], { windowsHide: true });
         }
         catch { }
     }
@@ -51,7 +51,8 @@ export function killProcess(pid, force = false) {
 export function findProcesses(pattern) {
     try {
         if (isWindows) {
-            const output = execFileSync('wmic', ['process', 'where', `CommandLine like '%${pattern}%'`, 'get', 'ProcessId'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+            const result = spawnSync('wmic', ['process', 'where', `CommandLine like '%${pattern}%'`, 'get', 'ProcessId'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
+            const output = result.stdout || '';
             return output.split('\n')
                 .map(line => parseInt(line.trim(), 10))
                 .filter(pid => !isNaN(pid) && pid !== process.pid);
@@ -68,8 +69,8 @@ export function findProcesses(pattern) {
 export function getProcessInfo(pid) {
     try {
         if (isWindows) {
-            // Use wmic on Windows
-            const output = execFileSync('wmic', ['process', 'where', `ProcessId=${pid}`, 'get', 'WorkingSetSize,CreationDate'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+            const result = spawnSync('wmic', ['process', 'where', `ProcessId=${pid}`, 'get', 'WorkingSetSize,CreationDate'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
+            const output = result.stdout || '';
             const lines = output.trim().split('\n').filter(l => l.trim());
             if (lines.length >= 2) {
                 const parts = lines[1].trim().split(/\s+/);
@@ -109,19 +110,27 @@ function formatUptime(totalSeconds) {
 /**
  * Cross-platform command existence check.
  */
+const _commandExistsCache = new Map();
 export function commandExists(cmd) {
+    const cached = _commandExistsCache.get(cmd);
+    if (cached !== undefined)
+        return cached;
+    let exists = false;
     try {
         if (isWindows) {
-            execFileSync('where', [cmd], { encoding: 'utf-8', stdio: 'pipe' });
+            const r = spawnSync('where', [cmd], { encoding: 'utf-8', stdio: 'pipe', windowsHide: true });
+            exists = r.status === 0;
         }
         else {
             execFileSync('which', [cmd], { encoding: 'utf-8', stdio: 'pipe' });
+            exists = true;
         }
-        return true;
     }
     catch {
-        return false;
+        exists = false;
     }
+    _commandExistsCache.set(cmd, exists);
+    return exists;
 }
 /**
  * Cross-platform live log tailing (replaces tail -f).

package/dist/utils/error-utils.js

@@ -73,7 +73,14 @@ let _rules = [];
 let _lastMtime = 0;
 function getDictPath() {
     if (!_dictPath) {
-        _dictPath = path.join(resolvePaths().dataDir, 'error-dict.json');
+        const userDict = path.join(resolvePaths().dataDir, 'error-dict.json');
+        if (fs.existsSync(userDict)) {
+            _dictPath = userDict;
+        }
+        else {
+            // Bundled default: src/utils/ → src/data/ (dev) or dist/utils/ → dist/data/ (prod)
+            _dictPath = path.resolve(import.meta.dirname, '..', 'data', 'error-dict.json');
+        }
     }
     return _dictPath;
 }
@@ -199,7 +206,8 @@ export function classifyError(error) {
     }
     // 内置兜底规则（结构性、稳定的错误模式）
     if (msg.includes('context_length_exceeded') || msg.includes('context_compact_failed')
-        || msg.includes('context limit')) {
+        || msg.includes('context limit') || msg.includes('input is too long')
+        || msg.includes('上下文过长')) {
         return ErrorType.CONTEXT_TOO_LONG;
     }
     if (msg.includes('401') || msg.includes('authentication_error')) {

package/dist/utils/instance-registry.js

@@ -10,7 +10,7 @@
  */
 import fs from 'fs';
 import path from 'path';
-import { execFileSync } from 'child_process';
+import { spawnSync } from 'child_process';
 import { resolvePaths } from '../paths.js';
 import { isProcessRunning, killProcess, isWindows, findProcesses } from './cross-platform.js';
 import { getProcessStartTime, startTimeMatches } from './process-introspect.js';
@@ -389,7 +389,8 @@ export function killOrphans(orphans) {
 function readCmdline(pid) {
     if (isWindows) {
         try {
-            const out = execFileSync('wmic', ['process', 'where', `ProcessId=${pid}`, 'get', 'CommandLine', '/value'], { encoding: 'utf-8', timeout: 3000, stdio: ['pipe', 'pipe', 'pipe'] });
+            const result = spawnSync('wmic', ['process', 'where', `ProcessId=${pid}`, 'get', 'CommandLine', '/value'], { encoding: 'utf-8', timeout: 3000, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
+            const out = result.stdout || '';
             const m = out.match(/CommandLine=([^\r\n]+)/);
             return m ? m[1].trim() : '';
         }
@@ -401,13 +402,13 @@ function readCmdline(pid) {
         return fs.readFileSync(`/proc/${pid}/cmdline`, 'utf-8').replace(/\0/g, ' ').trim();
     }
     catch {
-        // macOS / 权限不足
         try {
-            return execFileSync('ps', ['-p', String(pid), '-o', 'args='], {
+            const result = spawnSync('ps', ['-p', String(pid), '-o', 'args='], {
                 encoding: 'utf-8',
                 timeout: 3000,
                 stdio: ['pipe', 'pipe', 'pipe'],
-            }).trim();
+            });
+            return result.stdout?.trim() || '';
         }
         catch {
             return '';

package/dist/utils/log-writer.js

@@ -207,7 +207,8 @@ export class LogWriter {
                 continue;
             const full = path.join(logDir, name);
             try {
-                if (fs.statSync(full).mtimeMs < cutoff)
+                const st = fs.lstatSync(full);
+                if (st.isSymbolicLink() || st.mtimeMs < cutoff)
                     fs.unlinkSync(full);
             }
             catch { }

package/dist/utils/logger.js

@@ -22,6 +22,10 @@ const messageWriter = config.messageLog
 const eventWriter = config.eventLog
     ? new LogWriter({ baseName: 'events', logDir: LOG_DIR, rotation: 'hourly', retention: { hours: 12 } })
     : null;
+// 渠道入站日志：记录从渠道收到的原始消息
+const channelInWriter = new LogWriter({ baseName: 'channel-in', logDir: LOG_DIR, rotation: 'hourly', retention: { hours: 12 } });
+// 渠道出站日志：记录发往渠道的所有消息
+const channelOutWriter = new LogWriter({ baseName: 'channel-out', logDir: LOG_DIR, rotation: 'hourly', retention: { hours: 12 } });
 function shouldLog(level) {
     return (LEVELS[level] ?? 1) >= (LEVELS[currentLevel] ?? 1);
 }
@@ -63,5 +67,11 @@ export const logger = {
         if (!eventWriter)
             return;
         eventWriter.write(JSON.stringify({ ts: localTimestamp(), ...data }));
+    },
+    channelIn: (data) => {
+        channelInWriter.write(JSON.stringify({ ts: localTimestamp(), ...data }));
+    },
+    channelOut: (data) => {
+        channelOutWriter.write(JSON.stringify({ ts: localTimestamp(), ...data }));
     }
 };

package/dist/utils/npm-ops.js

@@ -83,12 +83,12 @@ export function getLocalVersion() {
     return pkg.version;
 }
 /**
- * 查询 npm registry 上 evolclaw 的最新版本。
+ * 查询 npm registry 上指定包的最新版本。
  * 超时 15 秒，失败返回 null。
  */
-export function checkLatestVersion() {
+export function checkLatestVersion(pkg = 'evolclaw') {
     return new Promise((resolve) => {
-        execFile('npm', ['view', 'evolclaw', 'version'], { timeout: 15000 }, (err, stdout) => {
+        execFile('npm', ['view', pkg, 'version'], { timeout: 15000 }, (err, stdout) => {
             if (err) {
                 resolve(null);
                 return;
@@ -129,3 +129,35 @@ export async function tryUpgrade() {
     }
     return { status: 'failed', from: localVer, to: remoteVer, error: lastError };
 }
+/**
+ * AUN SDK 升级流程：检查 → 比较 → 安装
+ * 仅在 SDK 已安装时检查升级，未安装则跳过。
+ */
+export async function tryUpgradeAunSdk(resolveAunCoreSdkPkg, AUN_CORE_SDK_PKG) {
+    if (isLinkedInstall()) {
+        return { status: 'skipped' };
+    }
+    const installed = resolveAunCoreSdkPkg();
+    if (!installed) {
+        return { status: 'skipped' }; // SDK not installed, skip
+    }
+    const localVer = installed.version;
+    const remoteVer = await checkLatestVersion(AUN_CORE_SDK_PKG);
+    if (!remoteVer) {
+        return { status: 'skipped', error: 'Failed to check remote version' };
+    }
+    if (compareVersions(localVer, remoteVer) >= 0) {
+        return { status: 'no-update', from: localVer };
+    }
+    let lastError;
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            await npmInstallGlobal(`${AUN_CORE_SDK_PKG}@latest`);
+            return { status: 'upgraded', from: localVer, to: remoteVer };
+        }
+        catch (e) {
+            lastError = e.stderr || e.message || String(e);
+        }
+    }
+    return { status: 'failed', from: localVer, to: remoteVer, error: lastError };
+}

package/dist/utils/process-introspect.js

@@ -7,7 +7,7 @@
  * killing the wrong process).
  */
 import fs from 'fs';
-import { execFileSync } from 'child_process';
+import { spawnSync } from 'child_process';
 import { isWindows } from './cross-platform.js';
 const isMacOS = process.platform === 'darwin';
 /** 容差：2 秒（覆盖 macOS 秒级精度 + 时钟漂移） */
@@ -39,8 +39,6 @@ export function startTimeMatches(recorded, actual) {
 }
 // ── Linux ──
 function getStartTimeLinux(pid) {
-    // /proc/<pid>/stat 第 22 字段：starttime（jiffies since boot）
-    // 注意 comm 字段（第 2 字段）含括号，可能包含空格，从最后一个 ')' 之后切
     let stat;
     try {
         stat = fs.readFileSync(`/proc/${pid}/stat`, 'utf-8');
@@ -50,7 +48,6 @@ function getStartTimeLinux(pid) {
     }
     const tail = stat.slice(stat.lastIndexOf(')') + 2);
     const fields = tail.split(' ');
-    // tail 从第 3 字段（state）开始，第 22 字段索引为 22 - 3 = 19
     const starttimeJiffies = parseInt(fields[19], 10);
     if (isNaN(starttimeJiffies))
         return null;
@@ -63,62 +60,44 @@ function getStartTimeLinux(pid) {
     }
     if (isNaN(uptimeSec))
         return null;
-    // CLK_TCK 在绝大多数 Linux 系统是 100
     const clkTck = 100;
     const bootTimeMs = Date.now() - uptimeSec * 1000;
     return bootTimeMs + (starttimeJiffies / clkTck) * 1000;
 }
 // ── macOS ──
 function getStartTimeMacOS(pid) {
-    let out;
-    try {
-        out = execFileSync('ps', ['-p', String(pid), '-o', 'lstart='], {
-            encoding: 'utf-8',
-            timeout: 5000,
-            stdio: ['pipe', 'pipe', 'pipe'],
-        }).trim();
-    }
-    catch {
-        return null;
-    }
+    const result = spawnSync('ps', ['-p', String(pid), '-o', 'lstart='], {
+        encoding: 'utf-8',
+        timeout: 5000,
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    const out = result.stdout?.trim();
     if (!out)
         return null;
-    // 输出格式："Fri May 16 08:00:00 2026"
     const t = Date.parse(out);
     return isNaN(t) ? null : t;
 }
 // ── Windows ──
 function getStartTimeWindows(pid) {
-    // 优先 PowerShell Get-CimInstance（现代）
     const fromPwsh = winPowerShellCreationDate(pid);
     if (fromPwsh !== null)
         return fromPwsh;
-    // 降级 wmic
     return winWmicCreationDate(pid);
 }
 function winPowerShellCreationDate(pid) {
-    let out;
-    try {
-        out = execFileSync('powershell', [
-            '-NoProfile',
-            '-Command',
-            `(Get-CimInstance Win32_Process -Filter 'ProcessId=${pid}').CreationDate`,
-        ], { encoding: 'utf-8', timeout: 8000, stdio: ['pipe', 'pipe', 'pipe'] }).trim();
-    }
-    catch {
+    const result = spawnSync('powershell', [
+        '-NoProfile',
+        '-Command',
+        `(Get-CimInstance Win32_Process -Filter 'ProcessId=${pid}').CreationDate`,
+    ], { encoding: 'utf-8', timeout: 8000, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
+    const out = result.stdout?.trim();
+    if (!out)
         return null;
-    }
     return parseCimDate(out);
 }
 function winWmicCreationDate(pid) {
-    let out;
-    try {
-        out = execFileSync('wmic', ['process', 'where', `ProcessId=${pid}`, 'get', 'CreationDate', '/value'], { encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] });
-    }
-    catch {
-        return null;
-    }
-    // wmic 输出 "CreationDate=20260516080000.000000+480"
+    const result = spawnSync('wmic', ['process', 'where', `ProcessId=${pid}`, 'get', 'CreationDate', '/value'], { encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
+    const out = result.stdout || '';
     const m = out.match(/CreationDate=([^\r\n]+)/);
     if (!m)
         return null;
@@ -138,7 +117,6 @@ export function parseCimDate(s) {
     const tzMin = parseInt(tz, 10);
     if (isNaN(tzMin))
         return null;
-    // CIM 的时间是"本地时区时间"，要换成 UTC：UTC = local - offset
     const localUtcMs = Date.UTC(+y, +mo - 1, +d, +h, +mi, +sec, Math.floor(+us / 1000));
     return localUtcMs - tzMin * 60 * 1000;
 }

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