@bolloon/bolloon-agent 0.4.5 → 0.4.7

package/dist/index.js

@@ -423,6 +423,9 @@ let cliStartTime = 0;
 let cliModelName = '…';
 let cliAgentName = '…';
 let cliActiveChannelId = null;
+// 2026-08-12: 当前 active channel 的 agentId (如 agent-alice). memory 落盘按 agentId 存,
+//   /memory /resume /did 读路径必须用 agentId 而非 display name (cliAgentName), 否则路径不一致读不到.
+let cliAgentId = null;
 // 2026-08-10: CLI 自动整理心跳 (与社交心跳并列, 独立于 server) — 退出时 stop
 let cliOrganizeHeartbeat = null;
 function fmtDuration(ms) {
@@ -435,6 +438,13 @@ function fmtDuration(ms) {
     const h = Math.floor(m / 60);
     return `${h}h ${m % 60}m`;
 }
+/** 2026-08-12: 返回当前 agentId (memory 路径用). 优先 cliAgentId, fallback cliAgentName. */
+function getCliAgentId() {
+    if (cliAgentId)
+        return cliAgentId;
+    // 无显式 agentId 时退到 cliAgentName (harness 默认 'agent', 其余用名字)
+    return cliAgentName === 'bolloon' ? 'agent' : (cliAgentName || 'agent');
+}
 /** 2026-08-06: 从 ContextManager 读上下文用量 (CLI 状态栏数据源, 失败退化 0/1M) */
 // 2026-08-07: 不能用 require 加载 ESM 模块 (ERR_REQUIRE_ESM) → startCLI 里 await import 一次缓存引用,
 //   同步函数 getCliCtxUsage/getStatus 复用 — 之前裸 require 与 _require 都抛错被 catch → 状态栏恒 0/1M
@@ -563,6 +573,9 @@ async function startCLI(comm) {
         if (active) {
             cliAgentName = active.name;
             cliActiveChannelId = active.channelId ?? null;
+            // 2026-08-12: 同步 agentId (memory 路径一致) — 从 rawChannels 按 channelId 取 agentId
+            const raw = active.channelId ? store.rawChannels.find((c) => c.id === active.channelId) : undefined;
+            cliAgentId = raw?.agentId || null;
         }
     }
     catch {
@@ -692,23 +705,36 @@ async function processInput(input, comm) {
     const runEndOkSteps = [];
     // each iteration
     let lastToolEvent = null;
-    // !command — 直接执行终端命令
+    // !command — 直接执行终端命令. 2026-08-12 (Task4): 支持多命令 (&& / ;) 逐段顺序执行 + 加载显示.
     if (trimmed.startsWith('!')) {
         const cmd = trimmed.slice(1).trim();
         if (!cmd) {
-            appendLine(`${C_DIM}!<命令> 执行终端命令, 如 !ls -la${RESET}`);
+            appendLine(`${C_DIM}!<命令> 执行终端命令 (支持 && 串联多命令), 如 !ls -la${RESET}`);
             return;
         }
-        appendLine(`${C_DIM}── $ ${cmd}${RESET}`);
+        const { execSync } = await import('child_process');
+        // 拆成多段: && 逻辑与 (前失败则停) / ; 无条件顺序. 保留每段顺序执行, 显示加载态.
+        const segments = cmd.split(/\s*;\s*/).filter(Boolean);
         try {
-            const { execSync } = await import('child_process');
-            const out = execSync(cmd, { timeout: 30000, encoding: 'utf-8', cwd: process.cwd() });
-            appendLine(`${C_DIM}${out || '(无输出)'}${RESET}`);
+            for (const seg of segments) {
+                const segCmds = seg.split(/\s*&&\s*/).filter(Boolean);
+                for (const c of segCmds) {
+                    appendLine(`${C_DIM}── $ ${c}${RESET}`);
+                    try {
+                        const out = execSync(c, { timeout: 30000, encoding: 'utf-8', cwd: process.cwd() });
+                        appendLine(`${C_DIM}${out || '(无输出)'}${RESET}`);
+                    }
+                    catch (e) {
+                        appendLine(`${C_ERROR}${e.stderr || e.message}${RESET}`);
+                        // && 逻辑与: 某段失败则中止后续 && 段
+                        break;
+                    }
+                }
+            }
         }
-        catch (e) {
-            appendLine(`${C_ERROR}${e.stderr || e.message}${RESET}`);
+        finally {
+            appendLine(`${C_DIM}──${RESET}`);
         }
-        appendLine(`${C_DIM}──${RESET}`);
         return;
     }
     // /channel — 切换当前智能体 (agent channel), 参数 name/id/number 自动解析
@@ -743,6 +769,7 @@ async function processInput(input, comm) {
             await store.setActive(r.channel.id);
             cliAgentName = r.identity.name;
             cliActiveChannelId = r.channel.id;
+            cliAgentId = r.channel.agentId || null; // 2026-08-12: memory 路径一致
             // 2026-08-09: 切 channel 必须重建 agent session — 否则身份/记忆停留在旧 channel (bug 修复)
             invalidateAgent();
             // 立即重建 (提前建好, 避免下次输入才卡顿; 失败不阻塞切换)
@@ -809,6 +836,7 @@ async function processInput(input, comm) {
             await store.setActive(id);
             cliAgentName = name.trim();
             cliActiveChannelId = id;
+            cliAgentId = agentId; // 2026-08-12: memory 路径一致
             // 2026-08-09: 新建 agent 后立即重建 session — 否则新 agent 身份不加载 (bug 修复)
             invalidateAgent();
             try {
@@ -1107,7 +1135,7 @@ async function processInput(input, comm) {
             const { getMemoryDir } = await import('./bootstrap/memory-compressor.js');
             const { readdir, readFile } = await import('fs/promises');
             const { join } = await import('path');
-            const dir = getMemoryDir(cliAgentName === 'bolloon' ? 'agent' : cliAgentName);
+            const dir = getMemoryDir(getCliAgentId());
             const files = (await readdir(join(dir, 'sessions')).catch(() => [])).filter((f) => f.endsWith('.summary.md'));
             appendLine(`${C_ACCENT}记忆摘要 (${files.length} 个 session):${RESET}`);
             for (const f of files.slice(-5)) {
@@ -1126,10 +1154,10 @@ async function processInput(input, comm) {
     // /resume — 恢复: 最近记忆摘要 + 进行中计划
     if (cmd === '/resume' || cmd.startsWith('/resume ')) {
         try {
-            const { getMemoryDir, getSessionSummaryPath } = await import('./bootstrap/memory-compressor.js');
+            const { getMemoryDir } = await import('./bootstrap/memory-compressor.js');
             const { readFile, readdir } = await import('fs/promises');
             const { join } = await import('path');
-            const dir = getMemoryDir(cliAgentName === 'bolloon' ? 'agent' : cliAgentName);
+            const dir = getMemoryDir(getCliAgentId());
             const files = (await readdir(join(dir, 'sessions')).catch(() => [])).filter((f) => f.endsWith('.summary.md'));
             appendLine(`${C_ACCENT}↻ 恢复上下文:${RESET}`);
             if (files.length > 0) {
@@ -1286,6 +1314,50 @@ async function processInput(input, comm) {
         catch { /* 静默 */ }
         return;
     }
+    // /skills [名] — 查看正式技能 (2026-08-12 Task5): 无参列全部, 带名看详情. 运行时开始前的技能 view.
+    if (cmd === '/skills' || cmd.startsWith('/skills ')) {
+        try {
+            const { defaultSkillPaths, loadSkillsDir } = await import('./agents/skill-loader.js');
+            const dirs = defaultSkillPaths();
+            const metas = [];
+            for (const d of dirs) {
+                const m = await loadSkillsDir(d);
+                for (const s of m)
+                    if (s.status === 'active' && !metas.some(x => x.name === s.name))
+                        metas.push(s);
+            }
+            const q = cmd.startsWith('/skills ') ? cmd.slice('/skills '.length).trim().toLowerCase() : '';
+            if (!q) {
+                appendLine(`${C_ACCENT}技能 (${metas.length}):${RESET}`);
+                if (metas.length === 0)
+                    appendLine(`  ${C_DIM}暂无正式技能 — run-end 经验可沉淀为 skill${RESET}`);
+                for (const s of metas.slice(0, 20)) {
+                    const desc = (s.description || '').slice(0, 60);
+                    appendLine(`  ${C_DIM}·${RESET} ${C_ACCENT}${s.name}${RESET}${desc ? `  ${C_DIM}${desc}${RESET}` : ''}`);
+                }
+                appendLine(`${C_DIM}用法: /skills <名> 查看详情${RESET}`);
+            }
+            else {
+                const hit = metas.find(s => s.name.toLowerCase() === q || s.name.toLowerCase().includes(q));
+                if (!hit) {
+                    appendLine(`${C_WARN}未找到技能: '${q}'${RESET}`);
+                    return;
+                }
+                appendLine(`${C_ACCENT}═ ${hit.name} ═${RESET}`);
+                if (hit.description)
+                    appendLine(`  ${C_DIM}描述:${RESET} ${hit.description}`);
+                if (hit.triggers && hit.triggers.length > 0)
+                    appendLine(`  ${C_DIM}触发:${RESET} ${hit.triggers.join(', ')}`);
+                const body = (hit.body || '').trim().slice(0, 1200);
+                if (body)
+                    appendLine(`  ${C_DIM}---${RESET}\n${body}`);
+            }
+        }
+        catch (e) {
+            appendLine(`${C_ERROR}/skills 失败: ${String(e?.message || e).slice(0, 120)}${RESET}`);
+        }
+        return;
+    }
     // /mcp — MCP 插件/工具列表
     if (cmd === '/mcp') {
         try {
@@ -1324,7 +1396,7 @@ async function processInput(input, comm) {
     if (cmd === '/did') {
         try {
             const { loadOrCreateAgentIdentity } = await import('./agents/agent-identity.js');
-            const identity = loadOrCreateAgentIdentity(cliAgentName === 'bolloon' ? 'default-agent' : cliAgentName);
+            const identity = loadOrCreateAgentIdentity(getCliAgentId());
             appendLine(`${C_ACCENT}DID 身份:${RESET}`);
             appendLine(`  ${C_DIM}did:${RESET} ${identity.did}`);
             appendLine(`  ${C_DIM}publicKey:${RESET} ${identity.publicKey?.slice(0, 32) || '—'}...`);
@@ -1649,6 +1721,7 @@ async function processInput(input, comm) {
         appendLine(`  ${C_ACCENT}/todo${RESET}   查看/勾选循环步骤  ${C_DIM}/todo <planId> <序号>${RESET}`);
         appendLine(`  ${C_ACCENT}/tools${RESET}  可用工具列表 (名/参数/简介)`);
         appendLine(`  ${C_ACCENT}/skill${RESET}  技能候选  ${C_DIM}skill-writer 沉淀候选${RESET}`);
+        appendLine(`  ${C_ACCENT}/skills${RESET} 查看正式技能  ${C_DIM}/skills <名> 看详情 (运行时开始前 view)${RESET}`);
         appendLine(`  ${C_ACCENT}/mcp${RESET}    MCP 服务器列表`);
         appendLine(`  ${C_ACCENT}/agent${RESET}  当前智能体身份`);
         appendLine(`  ${C_ACCENT}/did${RESET}    DID 身份`);
@@ -1753,15 +1826,8 @@ async function processInput(input, comm) {
                     //   真正思考内容在 status 的 Reflection/💡 事件 → 下方框渲染
                 }
                 else if (e.phase && !e.type) {
-                    const ph = String(e.phase);
-                    const detail = e.detail ? ` (${String(e.detail).slice(0, 60)})` : '';
-                    const phLabel = {
-                        intent_classified: '意图识别',
-                        tool_selected: '工具选择',
-                        reflection: '反思',
-                        planning: '规划',
-                    };
-                    appendLine(`${C_WARN}◈ ${phLabel[ph] || ph}${detail}${RESET}`);
+                    // 2026-08-12 (Task4): phase (意图识别/工具选择/规划) 是模型内部规划过程,
+                    //   用户偏好"中间过程不显示" → 静默丢弃, 不污染终端. (仅 Reflection 框保留, 走 status 分支)
                 }
                 else if (e.type === 'status' && e.content) {
                     const content = String(e.content);
@@ -1771,13 +1837,26 @@ async function processInput(input, comm) {
                         if (body.trim())
                             appendLine(renderMessageBox({ title: '💡 反思', body, color: C_WARN }));
                     }
-                    else if (!content.includes('🔄 循环') && !content.includes('📋 参数')) {
+                    else if (!content.includes('🔄 循环') && !content.includes('📋 参数')
+                        && !content.includes('🔍 任务复杂度') && !content.includes('⚙️ 动态配置')
+                        && !content.includes('⏹️ pivot loop')
+                        // 2026-08-12 (Task4): 循环过渡噪音 — "工具执行完成继续循环"/"继续总结" 是内部推进过程,
+                        //   不是给用户看的内容, 一律静默丢弃 (用户抱怨"每次显示触发下一轮循环"的真凶).
+                        && !content.includes('继续循环') && !content.includes('继续总结')) {
                         appendLine(`${C_DIM}${content}${RESET}`);
                     }
                 }
                 else if (e.type === 'step_start') {
                     tuiToolCounter++;
-                    tuiToolCalls.push({ tool: e.tool || '?', args: e.args, _t: Date.now() });
+                    const toolName = e.tool || '?';
+                    tuiToolCalls.push({ tool: toolName, args: e.args, _t: Date.now() });
+                    // 2026-08-12 (TaskA): 工具命中要干净 — step_start 不 appendLine 到消息流 (避免重复),
+                    //   改用 transient 行显示"正在执行"(消息流只在 done 时出现一次完成行).
+                    if (toolName !== 'system' && toolName !== 'loop' && toolName !== '?') {
+                        const activeNames = tuiToolCalls.map(c => c.tool).filter(t => t !== 'system' && t !== 'loop' && t !== '?');
+                        const label = activeNames.length > 1 ? `执行 ${activeNames.length} 个工具: ${activeNames.join(', ')}` : `🔧 ${toolName}`;
+                        inkSetTransient(`${C_DIM}${label} 运行中...${RESET}`);
+                    }
                 }
                 else if (e.type === 'step_done' || e.type === 'step_error') {
                     const p = tuiToolCalls.shift();
@@ -1795,7 +1874,21 @@ async function processInput(input, comm) {
                             runEndOkSteps.push({ status: 'ok', name: t, output: e.output });
                         }
                     }
-                    appendLine(renderToolCallListItem(doneItem, tuiToolCalls.length + 1, tuiToolCounter));
+                    // 2026-08-12 (TaskA): 每个工具只在消息流出现一次 (done 时 appendLine 完成行).
+                    //   不 replaceLastLine (并行/thinking 交错会替换错行); 完成行固定追加.
+                    const doneTool = e.tool ?? p?.tool;
+                    if (doneTool !== 'system' && doneTool !== 'loop' && doneTool !== '?') {
+                        appendLine(renderToolCallListItem(doneItem, tuiToolCalls.length + 1, tuiToolCounter));
+                    }
+                    // 更新 transient: 还有进行中的工具 → 显示下一个; 否则清空 (交回 thinking 动画)
+                    const remaining = tuiToolCalls.filter(c => c.tool !== 'system' && c.tool !== 'loop' && c.tool !== '?');
+                    if (remaining.length > 0) {
+                        const label = remaining.length > 1 ? `执行 ${remaining.length} 个工具: ${remaining.map(c => c.tool).join(', ')}` : `🔧 ${remaining[0].tool}`;
+                        inkSetTransient(`${C_DIM}${label} 运行中...${RESET}`);
+                    }
+                    else {
+                        inkSetTransient(null);
+                    }
                 }
             }
         });
@@ -1981,10 +2074,10 @@ async function runToolCommand(tool, args, outputJson, comm, model, prompt) {
                 const running = irohTransport.isRunning();
                 const irohPeers = irohTransport.getPeers();
                 const messenger = hybridMessenger ? 'HybridMessenger 就绪' : 'HybridMessenger 未初始化';
-                response = `iroh P2P 状态:
-  运行中: ${running ? '是' : '否'}
-  Node ID: ${nodeId ? nodeId.substring(0, 32) + '...' : 'N/A'}
-  已知节点: ${irohPeers.length}
+                response = `iroh P2P 状态:
+  运行中: ${running ? '是' : '否'}
+  Node ID: ${nodeId ? nodeId.substring(0, 32) + '...' : 'N/A'}
+  已知节点: ${irohPeers.length}
   ${messenger}`;
                 break;
             }
@@ -3118,114 +3211,114 @@ function parseArgs() {
     return result;
 }
 function printHelp() {
-    console.log(`
-🤖 Bolloon Agent - AI 可调用文档处理智能体
-
-用法:
-  npx tsx src/index.ts [选项] [参数]
-
-选项:
-  # 文档处理
-  --read <file>              读取文档 (txt, md, pdf, docx)
-  --summarize <file> [ctx]  总结文档，可选上下文
-  --improve <file> <req>     改进文档，req 为改进要求
-
-  # P2P 网络
-  --peers                    列出已连接的对等节点
-  --broadcast <msg>          广播消息到所有节点
-  --send <peerId> <msg>      向指定节点发送消息
-
-  # 智能体
-  --identity                 显示当前智能体身份
-  --logs                     显示操作日志
-  --search <keyword>         搜索文件
-  --tools                    显示所有可用工具
-
-  # SubAgent 管理
-  --agents                   列出所有 SubAgent
-  --register-agent <name> [cap1] [cap2]...  注册新 SubAgent
-  --delegate <任务描述> [能力要求...]  委派任务给最佳 Agent
-
-  # 全局共享上下文
-  --context                  显示全局共享上下文摘要
-  --global-agents            显示全局 Agent 注册表
-  --add-action <内容> [重要性]  添加用户行动到共享上下文
-
-  # Bollharness 治理框架
-  --harness-init             初始化 Bollharness 治理框架
-  --harness-gate             显示当前 Gate 状态
-  --harness-transition [PASS|BLOCK]  执行 Gate 转移
-  --harness-skill <name> [action]  执行 Harness Skill
-  --harness-classify <描述>  分类变更类型
-  --harness-context <file>   获取文件上下文
-  --harness-check <file>     执行 Guard 检查
-  --harness-archive          归档当前 Session 到 Harness
-  --harness-sessions         列出 Session 归档记录
-  --harness-session-context [id]  获取 Session 上下文
-
-  # 自动更新
-  --update-check             检查 npm 包更新
-  --update-now [pkg]        更新到最新版本
-
-  # 跨机聊天 (commits-as-messages, 共享 GitHub 仓库)
-  --chat-init                初始化 .comm/ 目录 (一次性)
-  --chat-send "消息正文"     把消息写到 .comm/<role>/, commit + push
-  --chat-pull                拉取远端 .comm/ 的新消息并显示
-  --chat-list                列出本地所有已同步消息
-  --chat-watch [--interval 15s]  后台定时拉取, 有新消息时输出
-  --chat-status              一屏查看: role / publicKey / remote / ahead-behind
-
-  # 纯 P2P 私聊 (不走 GitHub, 不写 git, 不持久化)
-  --chat-p2p-send <peer|publicKey> "消息正文"   通过 P2P 直接发一条
-  --chat-p2p-listen          后台监听对方 P2P 私聊消息 (Ctrl-C 退出)
-
-  # 跨机 agent 协作 (对方 bolloon --web 起着才能处理, 走 P2P 不经 GitHub)
-  --collab <peer|publicKey> "<任务描述>"  派任务给对端 LLM 干活, 等回结果 (90s 超时)
-
-  # 外部编码智能体委派
-  --engine, -e <id> [--model <m>] <prompt>  委派任务给外部引擎，如 opencode/codex
-  --model <name>             指定委派时使用的模型
-
-  # 输出控制
-  --json, -j                 输出 JSON 格式
-  --output, -o <file>        结果保存到文件
-  --web                      启动 Web UI 模式
-  --help, -h                 显示帮助信息
-
-示例:
-  # 文档处理
-  npx tsx src/index.ts --read 想法.md
-  npx tsx src/index.ts --summarize docs/想法.md
-  npx tsx src/index.ts --improve docs/README.md "让内容更简洁"
-  npx tsx src/index.ts --read 想法.md -o summary.txt
-
-  # P2P 网络
-  npx tsx src/index.ts --peers
-  npx tsx src/index.ts --broadcast "Hello everyone"
-  npx tsx src/index.ts --send QmABC... "私信内容"
-
-  # AI 对话
-  npx tsx src/index.ts --prompt "总结 README.md"
-  npx tsx src/index.ts -p "分析这个项目" -j
-
-  # 交互模式
-  npx tsx src/index.ts
-
-  # 外部引擎委派
-  npx tsx src/index.ts --engine opencode --model opencode/deepseek-v4-flash-free "说你好"
-
-  # Web 模式
-  npx tsx src/index.ts --web
-
-环境变量:
-  MINIMAX_API_KEY       MiniMax API 密钥
-  DEEPSEEK_API_KEY      DeepSeek API 密钥
-  KIMI_API_KEY / MOONSHOT_API_KEY  Kimi/Moonshot API 密钥
-  GLM_API_KEY / ZHIPU_API_KEY      智谱 GLM API 密钥
-  QWEN_API_KEY / DASHSCOPE_API_KEY 通义千问 API 密钥
-  OPENAI_API_KEY        OpenAI API 密钥（Pi SDK）
-  ANTHROPIC_API_KEY     Anthropic API 密钥（Pi SDK）
-  PORT                  Web 服务端口（默认 54188）
+    console.log(`
+🤖 Bolloon Agent - AI 可调用文档处理智能体
+
+用法:
+  npx tsx src/index.ts [选项] [参数]
+
+选项:
+  # 文档处理
+  --read <file>              读取文档 (txt, md, pdf, docx)
+  --summarize <file> [ctx]  总结文档，可选上下文
+  --improve <file> <req>     改进文档，req 为改进要求
+
+  # P2P 网络
+  --peers                    列出已连接的对等节点
+  --broadcast <msg>          广播消息到所有节点
+  --send <peerId> <msg>      向指定节点发送消息
+
+  # 智能体
+  --identity                 显示当前智能体身份
+  --logs                     显示操作日志
+  --search <keyword>         搜索文件
+  --tools                    显示所有可用工具
+
+  # SubAgent 管理
+  --agents                   列出所有 SubAgent
+  --register-agent <name> [cap1] [cap2]...  注册新 SubAgent
+  --delegate <任务描述> [能力要求...]  委派任务给最佳 Agent
+
+  # 全局共享上下文
+  --context                  显示全局共享上下文摘要
+  --global-agents            显示全局 Agent 注册表
+  --add-action <内容> [重要性]  添加用户行动到共享上下文
+
+  # Bollharness 治理框架
+  --harness-init             初始化 Bollharness 治理框架
+  --harness-gate             显示当前 Gate 状态
+  --harness-transition [PASS|BLOCK]  执行 Gate 转移
+  --harness-skill <name> [action]  执行 Harness Skill
+  --harness-classify <描述>  分类变更类型
+  --harness-context <file>   获取文件上下文
+  --harness-check <file>     执行 Guard 检查
+  --harness-archive          归档当前 Session 到 Harness
+  --harness-sessions         列出 Session 归档记录
+  --harness-session-context [id]  获取 Session 上下文
+
+  # 自动更新
+  --update-check             检查 npm 包更新
+  --update-now [pkg]        更新到最新版本
+
+  # 跨机聊天 (commits-as-messages, 共享 GitHub 仓库)
+  --chat-init                初始化 .comm/ 目录 (一次性)
+  --chat-send "消息正文"     把消息写到 .comm/<role>/, commit + push
+  --chat-pull                拉取远端 .comm/ 的新消息并显示
+  --chat-list                列出本地所有已同步消息
+  --chat-watch [--interval 15s]  后台定时拉取, 有新消息时输出
+  --chat-status              一屏查看: role / publicKey / remote / ahead-behind
+
+  # 纯 P2P 私聊 (不走 GitHub, 不写 git, 不持久化)
+  --chat-p2p-send <peer|publicKey> "消息正文"   通过 P2P 直接发一条
+  --chat-p2p-listen          后台监听对方 P2P 私聊消息 (Ctrl-C 退出)
+
+  # 跨机 agent 协作 (对方 bolloon --web 起着才能处理, 走 P2P 不经 GitHub)
+  --collab <peer|publicKey> "<任务描述>"  派任务给对端 LLM 干活, 等回结果 (90s 超时)
+
+  # 外部编码智能体委派
+  --engine, -e <id> [--model <m>] <prompt>  委派任务给外部引擎，如 opencode/codex
+  --model <name>             指定委派时使用的模型
+
+  # 输出控制
+  --json, -j                 输出 JSON 格式
+  --output, -o <file>        结果保存到文件
+  --web                      启动 Web UI 模式
+  --help, -h                 显示帮助信息
+
+示例:
+  # 文档处理
+  npx tsx src/index.ts --read 想法.md
+  npx tsx src/index.ts --summarize docs/想法.md
+  npx tsx src/index.ts --improve docs/README.md "让内容更简洁"
+  npx tsx src/index.ts --read 想法.md -o summary.txt
+
+  # P2P 网络
+  npx tsx src/index.ts --peers
+  npx tsx src/index.ts --broadcast "Hello everyone"
+  npx tsx src/index.ts --send QmABC... "私信内容"
+
+  # AI 对话
+  npx tsx src/index.ts --prompt "总结 README.md"
+  npx tsx src/index.ts -p "分析这个项目" -j
+
+  # 交互模式
+  npx tsx src/index.ts
+
+  # 外部引擎委派
+  npx tsx src/index.ts --engine opencode --model opencode/deepseek-v4-flash-free "说你好"
+
+  # Web 模式
+  npx tsx src/index.ts --web
+
+环境变量:
+  MINIMAX_API_KEY       MiniMax API 密钥
+  DEEPSEEK_API_KEY      DeepSeek API 密钥
+  KIMI_API_KEY / MOONSHOT_API_KEY  Kimi/Moonshot API 密钥
+  GLM_API_KEY / ZHIPU_API_KEY      智谱 GLM API 密钥
+  QWEN_API_KEY / DASHSCOPE_API_KEY 通义千问 API 密钥
+  OPENAI_API_KEY        OpenAI API 密钥（Pi SDK）
+  ANTHROPIC_API_KEY     Anthropic API 密钥（Pi SDK）
+  PORT                  Web 服务端口（默认 54188）
 `);
 }
 // ---------------------------------------------------------------------------