ppxans-harness 2.4.0 → 3.2.0

package/src/channels-cli.js

@@ -1,124 +1,126 @@
-#!/usr/bin/env node
-// src/channels-cli.js - `ppx channels` 通道管理 CLI (借鉴 openclaw `channels add`)
-// 让用户自己连通道: 交互式配置 → 写 config/ppx.json → 测试连通性 → 重启服务生效
-//
-// 用法:
-//   ppx-channels list                    列出全部通道 + 启用状态
-//   ppx-channels add <name>              交互式配置通道 (默认写盘并启用)
-//   ppx-channels test <name>             测试连通性 (网络探测)
-//   ppx-channels enable|disable <name>   启用/禁用
-//   ppx-channels remove <name>           移除配置 (恢复默认)
-//   ppx-channels --root <dir> ...        指定项目根目录 (默认当前目录)
-import { ensureUTF8Console } from "./utils/winutf8.js";
-import path from "node:path";
-import readline from "node:readline/promises";
-import {
-ensureUTF8Console();
-  CHANNEL_SCHEMAS, readChannels, listChannels,
-  updateChannel, setChannelEnabled, removeChannel,
-} from "./config/channels.js";
-import { ChannelManager } from "./channels/index.js";
-
-const args = process.argv.slice(2);
-let root = process.cwd();
-if (args[0] === "--root") { root = path.resolve(args[1]); args.splice(0, 2); }
-const [cmd, name] = args;
-
-const HELP = `ppx-channels - 皮皮虾通道管理 (让用户自己连)
-用法:
-  ppx-channels list                   列出全部通道 + 启用状态
-  ppx-channels add <name>             交互式配置通道
-  ppx-channels test <name>            测试连通性
-  ppx-channels enable <name>          启用通道
-  ppx-channels disable <name>         禁用通道
-  ppx-channels remove <name>          移除配置 (恢复默认)
-  ppx-channels --root <dir> <cmd>     指定项目根目录
-可用通道: ${Object.keys(CHANNEL_SCHEMAS).join(" / ")}`;
-
-// ---- list ----
-function doList() {
-  const rows = listChannels(root);
-  for (const r of rows) {
-    const marks = Object.entries(r.fields)
-      .map(([k, v]) => (k.endsWith("_set") ? `${k}=✓` : `${k}=${v}`))
-      .join(" ");
-    console.log(`${r.enabled ? "✓ 启用" : "· 禁用"}  ${r.name}${marks ? "   " + marks : ""}`);
-  }
-  const enabled = rows.filter((r) => r.enabled).map((r) => r.name);
-  console.log(`\n${enabled.length ? "已启用: " + enabled.join(", ") : "全部未启用 — 用 add <name> 配置一个"}`);
-}
-
-// ---- add (交互式引导, 借鉴 openclaw channels add) ----
-async function doAdd(name) {
-  const schema = CHANNEL_SCHEMAS[name];
-  if (!schema) {
-    console.error(`未知通道: ${name} (可用: ${Object.keys(CHANNEL_SCHEMAS).join(", ")})`);
-    process.exit(1);
-  }
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  const existing = readChannels(root).channels[name] || {};
-  const patch = {};
-  console.log(`\n配置 ${name} 通道 (回车用默认值, 需要密码的字段直接粘贴):`);
-  for (const key of Object.keys(schema).filter((k) => k !== "enabled")) {
-    const f = schema[key];
-    const def = existing[key] ?? f.def ?? "";
-    const defHint = def !== "" ? ` [${def}]` : "";
-    const prompt = f.prompt ? `  ${f.label} — ${f.prompt}${defHint}: ` : `  ${f.label}${defHint}: `;
-    const ans = (await rl.question(prompt)).trim();
-    const val = ans === "" ? def : ans;
-    if (val !== "") patch[key] = f.type === "number" ? Number(val) : val;
-  }
-  rl.close();
-  try {
-    updateChannel(root, name, { ...patch, enabled: true });
-    console.log(`\n✓ ${name} 已配置并启用 (config/ppx.json 已原子写盘, 原文件已备份).`);
-    console.log(`  重启服务生效: ppx-serve`);
-    console.log(`  验证连通性: ppx-channels test ${name}`);
-  } catch (e) {
-    console.error(`✗ 保存失败: ${e.message}`);
-    process.exit(1);
-  }
-}
-
-// ---- test (连通性) ----
-async function doTest(name) {
-  if (!(name in CHANNEL_SCHEMAS)) {
-    console.error(`未知通道: ${name} (可用: ${Object.keys(CHANNEL_SCHEMAS).join(", ")})`);
-    process.exit(1);
-  }
-  const { channels } = readChannels(root);
-  // 轻量 agent stub: 通道 test() 只用 root 构造, 不触发完整 agent 启动
-  const mgr = new ChannelManager({ root, config: { agent: {} } }, channels);
-  const r = await mgr.test(name);
-  console.log(`${r.ok ? "✓" : "✗"} ${name}: ${r.detail}`);
-  process.exit(r.ok ? 0 : 1);
-}
-
-// ---- enable/disable/remove ----
-function doToggle(name, enabled) {
-  if (!(name in CHANNEL_SCHEMAS)) { console.error(`未知通道: ${name}`); process.exit(1); }
-  try {
-    const out = setChannelEnabled(root, name, enabled);
-    console.log(`✓ ${name} 已${enabled ? "启用" : "禁用"}${Object.keys(out).length ? ` (${Object.keys(out).join(", ")})` : ""}`);
-  } catch (e) { console.error(`✗ 操作失败: ${e.message}`); process.exit(1); }
-}
-
-function doRemove(name) {
-  if (!(name in CHANNEL_SCHEMAS)) { console.error(`未知通道: ${name}`); process.exit(1); }
-  const ok = removeChannel(root, name);
-  console.log(ok ? `✓ ${name} 配置已移除 (恢复默认, 默认禁用)` : `${name} 本来就没有自定义配置`);
-}
-
-// ---- main ----
-(async () => {
-  if (!cmd || cmd === "-h" || cmd === "--help") { console.log(HELP); return; }
-  switch (cmd) {
-    case "list": doList(); break;
-    case "add": await doAdd(name); break;
-    case "test": await doTest(name); break;
-    case "enable": doToggle(name, true); break;
-    case "disable": doToggle(name, false); break;
-    case "remove": doRemove(name); break;
-    default: console.error(`未知命令: ${cmd}\n${HELP}`); process.exit(1);
-  }
-})();
+#!/usr/bin/env node
+// src/channels-cli.js - `ppx channels` 通道管理 CLI (借鉴 openclaw `channels add`)
+// 让用户自己连通道: 交互式配置 → 写 config/ppx.json → 测试连通性 → 重启服务生效
+//
+// 用法:
+//   ppx-channels list                    列出全部通道 + 启用状态
+//   ppx-channels add <name>              交互式配置通道 (默认写盘并启用)
+//   ppx-channels test <name>             测试连通性 (网络探测)
+//   ppx-channels enable|disable <name>   启用/禁用
+//   ppx-channels remove <name>           移除配置 (恢复默认)
+//   ppx-channels --root <dir> ...        指定项目根目录 (默认当前目录)
+import { ensureUTF8Console } from "./utils/winutf8.js";
+import path from "node:path";
+import readline from "node:readline/promises";
+import {
+  CHANNEL_SCHEMAS, readChannels, listChannels,
+  updateChannel, setChannelEnabled, removeChannel,
+} from "./config/channels.js";
+import { ChannelManager } from "./channels/index.js";
+
+// 必须在任何 console 输出之前完成代码页切换 (Windows 中文控制台)
+ensureUTF8Console();
+
+const args = process.argv.slice(2);
+let root = process.cwd();
+if (args[0] === "--root") { root = path.resolve(args[1]); args.splice(0, 2); }
+const [cmd, name] = args;
+
+const HELP = `ppx-channels - 皮皮虾通道管理 (让用户自己连)
+用法:
+  ppx-channels list                   列出全部通道 + 启用状态
+  ppx-channels add <name>             交互式配置通道
+  ppx-channels test <name>            测试连通性
+  ppx-channels enable <name>          启用通道
+  ppx-channels disable <name>         禁用通道
+  ppx-channels remove <name>          移除配置 (恢复默认)
+  ppx-channels --root <dir> <cmd>     指定项目根目录
+可用通道: ${Object.keys(CHANNEL_SCHEMAS).join(" / ")}`;
+
+// ---- list ----
+function doList() {
+  const rows = listChannels(root);
+  for (const r of rows) {
+    const marks = Object.entries(r.fields)
+      .map(([k, v]) => (k.endsWith("_set") ? `${k}=✓` : `${k}=${v}`))
+      .join(" ");
+    console.log(`${r.enabled ? "✓ 启用" : "· 禁用"}  ${r.name}${marks ? "   " + marks : ""}`);
+  }
+  const enabled = rows.filter((r) => r.enabled).map((r) => r.name);
+  console.log(`\n${enabled.length ? "已启用: " + enabled.join(", ") : "全部未启用 — 用 add <name> 配置一个"}`);
+}
+
+// ---- add (交互式引导, 借鉴 openclaw channels add) ----
+async function doAdd(name) {
+  const schema = CHANNEL_SCHEMAS[name];
+  if (!schema) {
+    console.error(`未知通道: ${name} (可用: ${Object.keys(CHANNEL_SCHEMAS).join(", ")})`);
+    process.exit(1);
+  }
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const existing = readChannels(root).channels[name] || {};
+  const patch = {};
+  console.log(`\n配置 ${name} 通道 (回车用默认值, 需要密码的字段直接粘贴):`);
+  for (const key of Object.keys(schema).filter((k) => k !== "enabled")) {
+    const f = schema[key];
+    const def = existing[key] ?? f.def ?? "";
+    const defHint = def !== "" ? ` [${def}]` : "";
+    const prompt = f.prompt ? `  ${f.label} — ${f.prompt}${defHint}: ` : `  ${f.label}${defHint}: `;
+    const ans = (await rl.question(prompt)).trim();
+    const val = ans === "" ? def : ans;
+    if (val !== "") patch[key] = f.type === "number" ? Number(val) : val;
+  }
+  rl.close();
+  try {
+    updateChannel(root, name, { ...patch, enabled: true });
+    console.log(`\n✓ ${name} 已配置并启用 (config/ppx.json 已原子写盘, 原文件已备份).`);
+    console.log(`  重启服务生效: ppx-serve`);
+    console.log(`  验证连通性: ppx-channels test ${name}`);
+  } catch (e) {
+    console.error(`✗ 保存失败: ${e.message}`);
+    process.exit(1);
+  }
+}
+
+// ---- test (连通性) ----
+async function doTest(name) {
+  if (!(name in CHANNEL_SCHEMAS)) {
+    console.error(`未知通道: ${name} (可用: ${Object.keys(CHANNEL_SCHEMAS).join(", ")})`);
+    process.exit(1);
+  }
+  const { channels } = readChannels(root);
+  // 轻量 agent stub: 通道 test() 只用 root 构造, 不触发完整 agent 启动
+  const mgr = new ChannelManager({ root, config: { agent: {} } }, channels);
+  const r = await mgr.test(name);
+  console.log(`${r.ok ? "✓" : "✗"} ${name}: ${r.detail}`);
+  process.exit(r.ok ? 0 : 1);
+}
+
+// ---- enable/disable/remove ----
+function doToggle(name, enabled) {
+  if (!(name in CHANNEL_SCHEMAS)) { console.error(`未知通道: ${name}`); process.exit(1); }
+  try {
+    const out = setChannelEnabled(root, name, enabled);
+    console.log(`✓ ${name} 已${enabled ? "启用" : "禁用"}${Object.keys(out).length ? ` (${Object.keys(out).join(", ")})` : ""}`);
+  } catch (e) { console.error(`✗ 操作失败: ${e.message}`); process.exit(1); }
+}
+
+function doRemove(name) {
+  if (!(name in CHANNEL_SCHEMAS)) { console.error(`未知通道: ${name}`); process.exit(1); }
+  const ok = removeChannel(root, name);
+  console.log(ok ? `✓ ${name} 配置已移除 (恢复默认, 默认禁用)` : `${name} 本来就没有自定义配置`);
+}
+
+// ---- main ----
+(async () => {
+  if (!cmd || cmd === "-h" || cmd === "--help") { console.log(HELP); return; }
+  switch (cmd) {
+    case "list": doList(); break;
+    case "add": await doAdd(name); break;
+    case "test": await doTest(name); break;
+    case "enable": doToggle(name, true); break;
+    case "disable": doToggle(name, false); break;
+    case "remove": doRemove(name); break;
+    default: console.error(`未知命令: ${cmd}\n${HELP}`); process.exit(1);
+  }
+})();

package/src/cli.js

@@ -1,120 +1,129 @@
-#!/usr/bin/env node
-// src/cli.js - 皮皮虾 CLI 交互入口 (readline 历史 + interrupt 中断)
-import { ensureUTF8Console } from "./utils/winutf8.js";
-import path from "node:path";
-import readline from "node:readline";
-import { fileURLToPath } from "node:url";
-import { PPXAgent } from "./agent/index.js";
-import { suggestProactive } from "./ans/proactive.js";
-
-ensureUTF8Console();
-const ROOT = path.join(path.dirname(fileURLToPath(import.meta.url)), "..");
-const agent = new PPXAgent({ root: ROOT });
-
-console.log("======================================");
-console.log("  皮皮虾 (PPX) - 自我修复·自我学习 Agent");
-console.log(`  记忆:${agent.facts.count()}条 | 经验:${agent.experience.lessons.length}条`);
-console.log(`  模型: ${agent.llm ? "已配置" : "未配置(离线记忆模式)"}`);
-console.log("  命令: quit/exit 退出 | /stop 中断当前任务 | /reset 清空会话");
-console.log("        /proactive 主动提醒(扫描记忆待办) | /proactive-done <id> 标记待办完成 | ↑↓ 浏览历史 | Ctrl+C 中断(再按一次退出)");
-console.log("======================================");
-
-const rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout,
-  prompt: "皮皮虾> ",
-  terminal: true,
-});
-
-let busy = false; // 防止任务执行中重复输入
-
-// 主动任务生成定时器 (ANS 自主性): config.agent.proactive.enabled 时启动
-// 有待办信号才推送 (suggestProactive 无信号返回 null 不打扰), 输出到 stdout
-if (agent.config.agent?.proactive?.enabled) {
-  agent.startProactiveTicker((payload) => {
-    console.log("\n[主动提醒] " + payload.text);
-    rl.prompt();
-  });
-  console.log(`  (主动提醒已开启: 每 ${Math.round(agent.config.agent.proactive.interval_ms / 60000)} 分钟扫描记忆待办)`);
-}
-
-rl.on("line", async (line) => {
-  const text = line.trim();
-  if (!text) return rl.prompt();
-  if (busy) return rl.prompt(); // 上一轮任务未结束, 忽略输入 (可用 /stop 或 Ctrl+C 打断)
-
-  // 退出
-  if (["quit", "exit", "q"].includes(text.toLowerCase())) {
-    agent.shutdown();
-    console.log("皮皮虾 收工, 已保存记忆。");
-    process.exit(0);
-  }
-  // 中断当前任务 (Human-in-the-loop)
-  if (text === "/stop") {
-    agent.interrupt();
-    console.log("(已发送中断信号, 当前任务将尽快停下)");
-    return rl.prompt();
-  }
-  // 清空会话
-  if (text === "/reset") {
-    agent.resetSession("default");
-    console.log("(会话已清空)");
-    return rl.prompt();
-  }
-  // 主动任务生成: 扫描记忆里的待办/偏好, 给出主动提醒 (ANS 自主性)
-  // 输出含 id, 可用 /proactive-done <id> 标记完成 (窗口去重, 24h 内不重复提醒)
-  if (text === "/proactive") {
-    busy = true;
-    try {
-      const out = await suggestProactive(agent);
-      if (out) {
-        console.log("\n" + out.text + "\n");
-        for (const it of out.items) console.log(`  [${it.id}] ${it.content}`);
-        console.log("\n(用 /proactive-done <id> 标记完成, 之后不再提醒)\n");
-      } else {
-        console.log("\n(暂时没有需要提醒的事项)\n");
-      }
-    } catch (e) {
-      console.log("\n[错误] " + e.message + "\n");
-    } finally {
-      busy = false;
-    }
-    return rl.prompt();
-  }
-  // 标记待办完成: /proactive-done <factId>
-  if (text.startsWith("/proactive-done")) {
-    const id = text.replace("/proactive-done", "").trim();
-    const ok = agent.proactiveMarkDone(id);
-    console.log(ok ? "(已标记完成, 之后不再提醒)" : "(待办不存在: " + id + ")");
-    return rl.prompt();
-  }
-
-  busy = true;
-  try {
-    const r = await agent.chat(text);
-    console.log("\n" + r + "\n");
-  } catch (e) {
-    console.log("\n[错误] " + e.message + "\n");
-  } finally {
-    busy = false;
-  }
-  rl.prompt();
-});
-
-// Ctrl+C: 第一次中断任务, 第二次退出
-let ctrlC = 0;
-rl.on("SIGINT", () => {
-  ctrlC += 1;
-  if (ctrlC >= 2) {
-    agent.shutdown();
-    console.log("\n皮皮虾 收工。");
-    process.exit(0);
-  }
-  agent.interrupt();
-  console.log("\n(已中断, 再按一次 Ctrl+C 退出)");
-  rl.prompt();
-  // 重置计数 (若任务继续则允许再次单次中断)
-  setTimeout(() => { ctrlC = 0; }, 1000);
-});
-
-rl.prompt();
+#!/usr/bin/env node
+// src/cli.js - 皮皮虾 CLI 交互入口 (readline 历史 + interrupt 中断)
+import { ensureUTF8Console } from "./utils/winutf8.js";
+import path from "node:path";
+import readline from "node:readline";
+import { fileURLToPath } from "node:url";
+import { PPXAgent } from "./agent/index.js";
+import { suggestProactive } from "./ans/proactive.js";
+import { installCrashGuard } from "./utils/crashguard.js";
+
+ensureUTF8Console();
+// v3.0.1 (P1#6): CLI 直跑入口装全局异常兜底 —— 此前只有 server 入口装了, chat 直跑时
+// 任何未捕获 rejection (调度器/proactive ticker/流式回调) 会按 Node>=15 默认行为直接杀进程
+installCrashGuard({ tag: "ppx-cli" });
+const ROOT = path.join(path.dirname(fileURLToPath(import.meta.url)), "..");
+const agent = new PPXAgent({ root: ROOT });
+
+console.log("======================================");
+console.log("  皮皮虾 (PPX) - 自我修复·自我学习 Agent");
+console.log(`  记忆:${agent.facts.count()}条 | 经验:${agent.experience.lessons.length}条`);
+console.log(`  模型: ${agent.llm ? "已配置" : "未配置(离线记忆模式)"}`);
+console.log("  命令: quit/exit 退出 | /stop 中断当前任务 | /reset 清空会话");
+console.log("        /proactive 主动提醒(扫描记忆待办) | /proactive-done <id> 标记待办完成 | ↑↓ 浏览历史 | Ctrl+C 中断(再按一次退出)");
+console.log("======================================");
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+  prompt: "皮皮虾> ",
+  terminal: true,
+});
+
+let busy = false; // 防止任务执行中重复输入
+
+// 主动任务生成定时器 (ANS 自主性): config.agent.proactive.enabled 时启动
+// 有待办信号才推送 (suggestProactive 无信号返回 null 不打扰), 输出到 stdout
+if (agent.config.agent?.proactive?.enabled) {
+  agent.startProactiveTicker((payload) => {
+    console.log("\n[主动提醒] " + payload.text);
+    rl.prompt();
+  });
+  const proactiveMs = Number(agent.config.agent.proactive.interval_ms) || 3600000;
+  console.log(`  (主动提醒已开启: 每 ${Math.round(proactiveMs / 60000)} 分钟扫描记忆待办)`);
+}
+
+rl.on("line", async (line) => {
+  const text = line.trim();
+  if (!text) return rl.prompt();
+  if (busy) {
+    // 2026-10-03 修复: 原 silently 忽略, 用户以为输入丢失。改为可判读提示。
+    console.log("  (任务执行中, 输入已忽略; /stop 可中断当前任务)");
+    return rl.prompt();
+  }
+
+  // 退出
+  if (["quit", "exit", "q"].includes(text.toLowerCase())) {
+    agent.shutdown();
+    console.log("皮皮虾 收工, 已保存记忆。");
+    process.exit(0);
+  }
+  // 中断当前任务 (Human-in-the-loop)
+  if (text === "/stop") {
+    agent.interrupt();
+    console.log("(已发送中断信号, 当前任务将尽快停下)");
+    return rl.prompt();
+  }
+  // 清空会话
+  if (text === "/reset") {
+    agent.resetSession("default");
+    console.log("(会话已清空)");
+    return rl.prompt();
+  }
+  // 主动任务生成: 扫描记忆里的待办/偏好, 给出主动提醒 (ANS 自主性)
+  // 输出含 id, 可用 /proactive-done <id> 标记完成 (窗口去重, 24h 内不重复提醒)
+  if (text === "/proactive") {
+    busy = true;
+    try {
+      const out = await suggestProactive(agent);
+      if (out) {
+        console.log("\n" + out.text + "\n");
+        for (const it of out.items) console.log(`  [${it.id}] ${it.content}`);
+        console.log("\n(用 /proactive-done <id> 标记完成, 之后不再提醒)\n");
+      } else {
+        console.log("\n(暂时没有需要提醒的事项)\n");
+      }
+    } catch (e) {
+      console.log("\n[错误] " + e.message + "\n");
+    } finally {
+      busy = false;
+    }
+    return rl.prompt();
+  }
+  // 标记待办完成: /proactive-done <factId>
+  if (text.startsWith("/proactive-done")) {
+    const id = text.replace("/proactive-done", "").trim();
+    const ok = agent.proactiveMarkDone(id);
+    console.log(ok ? "(已标记完成, 之后不再提醒)" : "(待办不存在: " + id + ")");
+    return rl.prompt();
+  }
+
+  busy = true;
+  try {
+    const r = await agent.chat(text);
+    console.log("\n" + r + "\n");
+  } catch (e) {
+    console.log("\n[错误] " + e.message + "\n");
+  } finally {
+    busy = false;
+  }
+  rl.prompt();
+});
+
+// Ctrl+C: 第一次中断任务, 第二次退出
+let ctrlC = 0;
+rl.on("SIGINT", () => {
+  ctrlC += 1;
+  if (ctrlC >= 2) {
+    agent.shutdown();
+    console.log("\n皮皮虾 收工。");
+    process.exit(0);
+  }
+  agent.interrupt();
+  console.log("\n(已中断, 再按一次 Ctrl+C 退出)");
+  rl.prompt();
+  // 重置计数 (若任务继续则允许再次单次中断)
+  setTimeout(() => { ctrlC = 0; }, 1000);
+});
+
+rl.prompt();