ppxans-harness 2.4.0 → 3.2.0

package/src/memory/l3.js

@@ -1,112 +1,112 @@
-// src/memory/l3.js - L3 核心画像 (腾讯风格 persona generation)
-// 从记忆提炼: 用户画像 (user.persona.md) + agent 人格 (agent.persona.md)
-// 零依赖: 高频词统计 + 主题聚合, 输出结构化画像
-import fs from "node:fs";
-import path from "node:path";
-import { ensureDir, readText, writeText, logicalDay } from "../utils/store.js";
-
-const STOP = new Set(["这个","那个","我们","你们","他们","什么","怎么","可以","一个","就是","知道","没有","如果","因为","所以","但是","然后","现在","今天","昨天","明天","已经","还有","所有","这样","那样","自己","的东西","的事情","一下","一点","一些","这些","那些","东西","事情","问题","觉得","应该","需要","开始","继续","大家","真的","只是","可能","不是","都是","一直","非常","其实","最后","主要","联系","关系","喜欢","讨厌","不要","想要","认为"]);
-
-export class PersonaStore {
-  constructor(dataDir, { userName = "兄弟" } = {}) {
-    this.dir = path.join(dataDir, "memory", "l3");
-    ensureDir(this.dir);
-    this.userFile = path.join(this.dir, "user.persona.md");
-    this.agentFile = path.join(this.dir, "agent.persona.md");
-    this.userName = userName;
-  }
-
-  // 从一批事实提炼用户画像
-  buildUserPersona(facts, { force = false } = {}) {
-    if (!force && this._exists(this.userFile)) return this._read(this.userFile);
-    // 聚焦用户相关的记忆 (来源: 对话 / LLM提炼 / 主动记 / 手动 / 用户分享)
-    // 注: 事实的来源标记在 source 字段 (type 恒为 general), 之前按 type 过滤永远为空 -> 修正为按 source
-    const USER_SOURCES = ["conversation", "extract", "agent-self", "manual", "user-shared"];
-    const userFacts = facts.filter((f) => USER_SOURCES.includes(f.source) || USER_SOURCES.includes(f.type));
-    const interests = this._topTopics(userFacts);
-    // 记忆概要: 内容去重后取最近 10 条 (防 LLM 提炼变体/重复记忆稀释画像)
-    const uniq = this._uniqByContent(userFacts).slice(-10);
-    const md = `# ${this.userName} 的用户画像
-
-> 由皮皮虾 L3 画像引擎生成 | 更新: ${logicalDay()}
-
-## 关注主题
-${interests.length ? interests.map(([w, n]) => `- ${w} (出现${n}次)`).join("\n") : "- 暂无足够数据"}
-
-## 记忆概要
-${uniq.map((f) => `- ${f.content}`).join("\n") || "- 暂无"}
-
-## 画像版本
-- 生成时间: ${logicalDay()}
-- 数据来源: 对话记忆 + 用户主动分享
-`;
-    writeText(this.userFile, md);
-    return md;
-  }
-
-  // 提炼 agent 自身人格 (从经验/工具使用学习)
-  buildAgentPersona(lessons, { force = false } = {}) {
-    if (!force && this._exists(this.agentFile)) return this._read(this.agentFile);
-    // 学到的经验: 内容去重后取最近 10 条 (防重复经验污染自我画像)
-    const uniq = this._uniqByContent(lessons, (l) => l.lesson).slice(-10);
-    const md = `# 皮皮虾 自我画像
-
-> 从经验库自动学习 | 更新: ${logicalDay()}
-
-## 学到的经验
-${uniq.map((l) => `- ${l.lesson}`).join("\n") || "- 暂无"}
-
-## 能力画像
-- 工具: 文件操作 / 命令执行 / 搜索 / HTTP / 定时任务
-- 记忆: 四层架构 (L0对话→L1原子→L2场景→L3画像)
-- 自愈: 崩溃恢复 / 数据修复
-- 军团: 多进程并行协作
-`;
-    writeText(this.agentFile, md);
-    return md;
-  }
-
-  // 内容去重: 按归一化内容 (去空白折叠) 过滤, 保留首次出现的条目
-  _uniqByContent(items, pick = (x) => x.content) {
-    const seen = new Set();
-    const out = [];
-    for (const it of items || []) {
-      const key = String(pick(it) || "").trim().replace(/\s+/g, " ");
-      if (!key || seen.has(key)) continue;
-      seen.add(key);
-      out.push(it);
-    }
-    return out;
-  }
-
-  // 读取已生成的画像 (供 agent._context 注入; 未生成返回 "")
-  userPersona() { return this._read(this.userFile); }
-  agentPersona() { return this._read(this.agentFile); }
-
-  // 可观测: L3 画像更新时间 (无文件返回 null), 供 agent.stats() 聚合
-  stats() {
-    return {
-      user_updated: this._mtime(this.userFile),
-      agent_updated: this._mtime(this.agentFile),
-    };
-  }
-
-  _mtime(f) {
-    try { return new Date(fs.statSync(f).mtime).toISOString().slice(0, 10); } catch { return null; }
-  }
-
-  _topTopics(facts) {
-    const freq = new Map();
-    for (const f of facts) {
-      const words = String(f.content).match(/[\u4e00-\u9fa5]{2,4}/g) || [];
-      for (const w of words) {
-        if (STOP.has(w)) continue;
-        freq.set(w, (freq.get(w) || 0) + 1);
-      }
-    }
-    return [...freq.entries()].sort((a, b) => b[1] - a[1]).slice(0, 8);
-  }
-
-  _exists(f) { try { return fs.existsSync(f); } catch { return false; } }
-  _read(f) { return readText(f, ""); }
+// src/memory/l3.js - L3 核心画像 (腾讯风格 persona generation)
+// 从记忆提炼: 用户画像 (user.persona.md) + agent 人格 (agent.persona.md)
+// 零依赖: 高频词统计 + 主题聚合, 输出结构化画像
+import fs from "node:fs";
+import path from "node:path";
+import { ensureDir, readText, writeText, logicalDay } from "../utils/store.js";
+
+const STOP = new Set(["这个","那个","我们","你们","他们","什么","怎么","可以","一个","就是","知道","没有","如果","因为","所以","但是","然后","现在","今天","昨天","明天","已经","还有","所有","这样","那样","自己","的东西","的事情","一下","一点","一些","这些","那些","东西","事情","问题","觉得","应该","需要","开始","继续","大家","真的","只是","可能","不是","都是","一直","非常","其实","最后","主要","联系","关系","喜欢","讨厌","不要","想要","认为"]);
+
+export class PersonaStore {
+  constructor(dataDir, { userName = "兄弟" } = {}) {
+    this.dir = path.join(dataDir, "memory", "l3");
+    ensureDir(this.dir);
+    this.userFile = path.join(this.dir, "user.persona.md");
+    this.agentFile = path.join(this.dir, "agent.persona.md");
+    this.userName = userName;
+  }
+
+  // 从一批事实提炼用户画像
+  buildUserPersona(facts, { force = false } = {}) {
+    if (!force && this._exists(this.userFile)) return this._read(this.userFile);
+    // 聚焦用户相关的记忆 (来源: 对话 / LLM提炼 / 主动记 / 手动 / 用户分享)
+    // 注: 事实的来源标记在 source 字段 (type 恒为 general), 之前按 type 过滤永远为空 -> 修正为按 source
+    const USER_SOURCES = ["conversation", "extract", "agent-self", "manual", "user-shared"];
+    const userFacts = facts.filter((f) => USER_SOURCES.includes(f.source) || USER_SOURCES.includes(f.type));
+    const interests = this._topTopics(userFacts);
+    // 记忆概要: 内容去重后取最近 10 条 (防 LLM 提炼变体/重复记忆稀释画像)
+    const uniq = this._uniqByContent(userFacts).slice(-10);
+    const md = `# ${this.userName} 的用户画像
+
+> 由皮皮虾 L3 画像引擎生成 | 更新: ${logicalDay()}
+
+## 关注主题
+${interests.length ? interests.map(([w, n]) => `- ${w} (出现${n}次)`).join("\n") : "- 暂无足够数据"}
+
+## 记忆概要
+${uniq.map((f) => `- ${f.content}`).join("\n") || "- 暂无"}
+
+## 画像版本
+- 生成时间: ${logicalDay()}
+- 数据来源: 对话记忆 + 用户主动分享
+`;
+    writeText(this.userFile, md);
+    return md;
+  }
+
+  // 提炼 agent 自身人格 (从经验/工具使用学习)
+  buildAgentPersona(lessons, { force = false } = {}) {
+    if (!force && this._exists(this.agentFile)) return this._read(this.agentFile);
+    // 学到的经验: 内容去重后取最近 10 条 (防重复经验污染自我画像)
+    const uniq = this._uniqByContent(lessons, (l) => l.lesson).slice(-10);
+    const md = `# 皮皮虾 自我画像
+
+> 从经验库自动学习 | 更新: ${logicalDay()}
+
+## 学到的经验
+${uniq.map((l) => `- ${l.lesson}`).join("\n") || "- 暂无"}
+
+## 能力画像
+- 工具: 文件操作 / 命令执行 / 搜索 / HTTP / 定时任务
+- 记忆: 四层架构 (L0对话→L1原子→L2场景→L3画像)
+- 自愈: 崩溃恢复 / 数据修复
+- 军团: 多进程并行协作
+`;
+    writeText(this.agentFile, md);
+    return md;
+  }
+
+  // 内容去重: 按归一化内容 (去空白折叠) 过滤, 保留首次出现的条目
+  _uniqByContent(items, pick = (x) => x.content) {
+    const seen = new Set();
+    const out = [];
+    for (const it of items || []) {
+      const key = String(pick(it) || "").trim().replace(/\s+/g, " ");
+      if (!key || seen.has(key)) continue;
+      seen.add(key);
+      out.push(it);
+    }
+    return out;
+  }
+
+  // 读取已生成的画像 (供 agent._context 注入; 未生成返回 "")
+  userPersona() { return this._read(this.userFile); }
+  agentPersona() { return this._read(this.agentFile); }
+
+  // 可观测: L3 画像更新时间 (无文件返回 null), 供 agent.stats() 聚合
+  stats() {
+    return {
+      user_updated: this._mtime(this.userFile),
+      agent_updated: this._mtime(this.agentFile),
+    };
+  }
+
+  _mtime(f) {
+    try { return new Date(fs.statSync(f).mtime).toISOString().slice(0, 10); } catch { return null; }
+  }
+
+  _topTopics(facts) {
+    const freq = new Map();
+    for (const f of facts) {
+      const words = String(f.content).match(/[\u4e00-\u9fa5]{2,4}/g) || [];
+      for (const w of words) {
+        if (STOP.has(w)) continue;
+        freq.set(w, (freq.get(w) || 0) + 1);
+      }
+    }
+    return [...freq.entries()].sort((a, b) => b[1] - a[1]).slice(0, 8);
+  }
+
+  _exists(f) { try { return fs.existsSync(f); } catch { return false; } }
+  _read(f) { return readText(f, ""); }
 }

package/src/memory/legion-board.js

@@ -0,0 +1,71 @@
+// src/memory/legion-board.js - 军团共享记忆板 (2026-10-02)
+// 跨 agent 实时共享知识: 主 agent 与所有 worker 子 agent 通过同一全局文件互通。
+// 与 FactStore (内存快照, 私有) 不同: 每次读/写都走盘 + 文件锁, 保证多进程实时一致性。
+// 并发模式对齐 Experience: 锁内「重读 → 改 → 写」, 防陈旧覆盖。
+import path from "node:path";
+import { ensureDir, readJson, writeJson, nowISO, withFileLock } from "../utils/store.js";
+
+export class LegionBoard {
+  constructor(globalDataDir, opts = {}) {
+    this.dir = path.join(globalDataDir, "legion");
+    ensureDir(this.dir);
+    this.file = path.join(this.dir, "board.json");
+    this.opts = {
+      maxEntries: 500, // 容量上限: 超限裁剪最旧 (FIFO, 记忆板是临时协作区不是档案库)
+      ttlDays: 7,      // 条目存活期: 0/负 = 永不过期
+      ...opts,
+    };
+  }
+
+  // 发布一条共享知识 (topic 可选作频道, tags 可选作检索辅助)
+  publish({ from, topic, content, tags = [] }) {
+    if (!content || !String(content).trim()) throw new Error("board_publish: content 不能为空");
+    return withFileLock(this.file, () => {
+      const entries = readJson(this.file, []);
+      const entry = {
+        id: `bd_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`,
+        from: String(from || "unknown").slice(0, 64),
+        topic: String(topic || "general").slice(0, 64),
+        content: String(content).slice(0, 2000),
+        tags: (Array.isArray(tags) ? tags : []).map((t) => String(t).slice(0, 32)).slice(0, 8),
+        ts: nowISO(),
+      };
+      entries.push(entry);
+      // 写入时统一裁剪: TTL 过滤 + 容量 FIFO
+      const cutoff = this.opts.ttlDays > 0 ? Date.now() - this.opts.ttlDays * 86400000 : 0;
+      const kept = entries
+        .filter((x) => !cutoff || new Date(x.ts).getTime() >= cutoff)
+        .slice(-this.opts.maxEntries);
+      writeJson(this.file, kept);
+      return entry;
+    });
+  }
+
+  // 查询: 读时重读磁盘 → 实时可见其他 agent 刚发布的内容 (跨进程)
+  query({ q, topic, from, limit = 10 } = {}) {
+    let entries = readJson(this.file, []);
+    if (topic) entries = entries.filter((x) => x.topic === topic);
+    if (from) entries = entries.filter((x) => x.from === from);
+    if (q) {
+      const kw = String(q).toLowerCase();
+      entries = entries.filter((x) =>
+        x.content.toLowerCase().includes(kw) ||
+        x.topic.toLowerCase().includes(kw) ||
+        (x.tags || []).some((t) => t.toLowerCase().includes(kw))
+      );
+    }
+    // 新的在前
+    entries.sort((a, b) => (a.ts < b.ts ? 1 : -1));
+    return entries.slice(0, Math.max(1, Math.min(50, Number(limit) || 10)));
+  }
+
+  // 概况: 当前板上条数 + 参与过的 agent (可观测性)
+  stats() {
+    const entries = readJson(this.file, []);
+    return {
+      count: entries.length,
+      agents: [...new Set(entries.map((x) => x.from))],
+      topics: [...new Set(entries.map((x) => x.topic))],
+    };
+  }
+}