dsh-memory-palace 1.2.0

package/lib/common/paths.mjs

@@ -0,0 +1,78 @@
+// memory-palace 记忆文件路径解析（工厂）。
+// 全部函数接受可选 cwd（缺省用运行时 activeCwd）——按钮蒸馏 route 按 session.header.cwd 显式传参，
+// 避免依赖闭包 activeCwd 造成「会话 cwd ≠ 活跃 cwd」时写错位置（v1.2.0 修过的手动蒸馏 bug）。
+import { join, dirname } from "node:path";
+import { existsSync } from "node:fs";
+
+/**
+ * @param {() => object} getConfig - 读取当前生效配置（settings 热读）。
+ * @param {() => string | null} [getCwd] - 默认 cwd 读取器（运行时 activeCwd）。
+ */
+export function createPaths(getConfig, getCwd = () => null) {
+  const cfg = () => getConfig();
+  const activeCwd = () => getCwd() || null;
+
+  // 磁盘上【已存在】的 buddy 项目记忆目录（按配置顺序）。绝不主动新建 buddy 目录。
+  function buddyDirs(cwd = activeCwd()) {
+    const c = cfg();
+    if (!c.enabled || !c.bridgeBuddyMemory || !cwd) return [];
+    return c.buddyWorkspaceMemoryDirs
+      .map((rel) => join(cwd, rel))
+      .filter((d) => existsSync(d));
+  }
+  // 读取源：存在 buddy 目录则用它们；否则仅当 legacy dsh 目录已存在才读（不创建）。
+  function readDirs(cwd = activeCwd()) {
+    const c = cfg();
+    if (!c.enabled) return [];
+    const b = buddyDirs(cwd);
+    if (b.length) return b;
+    const d = cwd ? join(cwd, c.workspaceMemoryDir) : null;
+    // 不设 existsSync 门槛：即便每日日志目录尚未创建，也要能读到同级的 .deepseek-harness/MEMORY.md
+    return d ? [d] : [];
+  }
+  // 写入目标：存在 buddy 目录则全部同步写入；否则回退 dsh 目录（按需创建）。
+  function writeDirs(cwd = activeCwd()) {
+    const c = cfg();
+    if (!c.enabled) return [];
+    const b = buddyDirs(cwd);
+    if (b.length) return b;
+    const d = cwd ? join(cwd, c.workspaceMemoryDir) : null;
+    return d ? [d] : [];
+  }
+
+  // 项目级 MEMORY.md 路径解析：
+  // - dsh 原生目录（workspaceMemoryDir，默认 .deepseek-harness/memory）：MEMORY.md 与 memory/ 同级
+  //   = join(cwd, dirname(workspaceMemoryDir), "MEMORY.md")，即 .deepseek-harness/MEMORY.md
+  //   （读取兼容：旧嵌套位置 .deepseek-harness/memory/MEMORY.md 仍存在时不丢数据）
+  // - buddy 目录（.workbuddy/memory 等）：保持嵌套 memory/MEMORY.md（与 WB/CB 原生格式兼容）
+  function dshDailyDir(cwd = activeCwd()) {
+    const c = cfg();
+    return cwd ? join(cwd, c.workspaceMemoryDir) : null;
+  }
+  function dshMemoryFile(cwd = activeCwd()) {
+    const c = cfg();
+    return cwd ? join(cwd, dirname(c.workspaceMemoryDir), "MEMORY.md") : null;
+  }
+  function isDshDir(dir, cwd = activeCwd()) {
+    const d = dshDailyDir(cwd);
+    return !!(d && dir && dir === d);
+  }
+  // 写入用：返回该目录对应的 MEMORY.md 绝对路径（dsh 原生→同级；buddy→嵌套；已是文件则原样返回）
+  function memoryFileOf(dir, cwd = activeCwd()) {
+    if (!dir) return dir;
+    if (dir.endsWith("MEMORY.md")) return dir; // 用户级路径本身即文件
+    return isDshDir(dir, cwd) ? dshMemoryFile(cwd) : join(dir, "MEMORY.md");
+  }
+  // 读取用：dsh 原生返回 [同级, 旧嵌套] 两个候选；buddy 仅嵌套；已是文件则原样返回
+  function memoryReadCandidates(dir, cwd = activeCwd()) {
+    if (!dir) return [];
+    if (dir.endsWith("MEMORY.md")) return [dir];
+    if (isDshDir(dir, cwd)) {
+      const f = dshMemoryFile(cwd);
+      return f ? [f, join(dir, "MEMORY.md")] : [join(dir, "MEMORY.md")];
+    }
+    return [join(dir, "MEMORY.md")];
+  }
+
+  return { buddyDirs, readDirs, writeDirs, dshDailyDir, dshMemoryFile, isDshDir, memoryFileOf, memoryReadCandidates };
+}

package/lib/common/prompts.mjs

@@ -0,0 +1,71 @@
+// memory-palace 共享常量：场景关键词 + 两个 LLM prompt（智能模式摘要 / 项目记忆蒸馏）。
+// 纯常量模块，无状态、可被任意模块与单测直接引用。
+
+// 场景关键词（增强原方案 D）：命中即视为"用户告知偏好 / 做出技术决策"，纯文本轮次也写。
+export const SCENE_KEYWORDS = ["记住", "记一下", "remind", "偏好", "决定", "以后都", "约定", "采用", "根因", "修复"];
+
+// 智能模式（memoryMode==="smart"）的摘要提炼 prompt：让 LLM 输出 {summary, durable:[{scope,fact}]}。
+// 产物：summary → 每日日志（带 [smart] 标记）；durable → MEMORY.md（- [smart] <fact>，按 scope 分层）。
+export const SUMMARY_PROMPT =
+  "你是会话记忆提炼助手。根据下面这段【新产生的】对话（含工具调用与结果），提炼两样东西：\n" +
+  "1) summary：一段简洁中文摘要——这段对话做了什么、关键结果（路径/命令/数字）。\n" +
+  "2) durable：值得跨 session 长期记住的事实列表（最多 3 条），每条带 scope：\n" +
+  '   - "project" = 当前项目的约定/决策/技术事实\n' +
+  '   - "user" = 跨项目的个人偏好/习惯\n' +
+  "   闲聊、一次性操作、显而易见的内容、纯错误现象（错误已有独立记录）不要提炼；没有就留空数组。\n" +
+  "只输出 JSON，不要多余文字，格式：\n" +
+  '{"summary":"...","durable":[{"scope":"project","fact":"一句话"}]}';
+
+// v1.2.0 项目记忆蒸馏 prompt（固化自 upgrade plan/v1.2.0/记忆蒸馏Prompt.md，供按钮「蒸馏项目记忆」稳定调用）。
+// 用法：system = 本 prompt，user = 项目 MEMORY.md 全文，输出 = 精炼后的项目记忆（直接覆盖写回）。
+export const DISTILL_PROMPT =
+  "你是一名「项目记忆蒸馏器」。我会给你一份项目的原始材料（可能是记忆文件、会话记录、零散笔记，或多份材料的拼合）。你的任务：把它提炼成一段精炼的项目记忆。\n" +
+  "\n" +
+  "【提炼总原则】\n" +
+  "只保留「以后还会用到」的信息，删掉「一次性过程」。\n" +
+  "唯一判断标准：删了这条，下次开工会不会出错 / 返工 / 重踩坑？会 → 留；不会 → 删。\n" +
+  "\n" +
+  "【只提炼 7 类信息，无关的类别直接省略，不要硬凑】\n" +
+  "1. 定位 —— 一句话说清任务本质 + 最终产出什么。\n" +
+  "2. 当前状态 —— 现在推进到哪一步、卡在哪、下一步是什么。\n" +
+  "3. 核心约束 —— 什么绝对不能变。注意：丢了会出事的才叫约束，丢了只是不方便的是细节，细节不写。\n" +
+  "4. AI 行为边界 —— AI 能做什么、绝不能做什么、什么留给用户。所有「谁来做 / 谁授权 / 谁拍板」的约定都要显式归入这里，不能混在别的条目里。\n" +
+  "5. 关键路径 —— 绝对路径、命令、数据源、模板、依赖。原样精确保留，禁止用占位符。\n" +
+  "6. 决策记录 —— 为什么这么做（而非只记做了什么），尽量带日期或版本锚点。废弃方案单独标注为「已废弃」，不要删除。\n" +
+  "7. 坑与教训 —— 现象 → 根因 → 解法，一条一个坑。一句话能讲清的坑不算坑、不记。\n" +
+  "\n" +
+  "【写法规则】\n" +
+  "- 结论先行：一条 = 结论 + 关键参数，不写推导过程。\n" +
+  "- 强动词：约束/边界用「必须 / 绝不 / 勿 / 除非…明确同意」这类词，不留模糊空间。\n" +
+  "- 精确值：路径、命令、字段名、版本号原样保留，禁用 ~/、占位符或「大概」。\n" +
+  "- 时间锚点：决策和坑尽量带日期或版本，让人知道这是哪个阶段的结论。\n" +
+  "\n" +
+  "【输出格式】严格按以下骨架输出，无关章节整节删除：\n" +
+  "\n" +
+  "# <项目名> 项目笔记\n" +
+  "<一句话定位 + 当前状态>\n" +
+  "\n" +
+  "## 核心约束\n" +
+  "- ...\n" +
+  "\n" +
+  "## AI 行为边界\n" +
+  "- ...\n" +
+  "\n" +
+  "## 关键路径\n" +
+  "- ...\n" +
+  "\n" +
+  "## 决策记录\n" +
+  "- ...\n" +
+  "\n" +
+  "## 坑与教训\n" +
+  "- ...\n" +
+  "\n" +
+  "【输出前自检，逐条过一遍】\n" +
+  "1. 有没有混入一次性过程 / 临时路径 / 某次报错全文？\n" +
+  "2. 每条「约束」删了会不会出事？\n" +
+  "3. 边界是否显式、无歧义、没有混在别的条目里？\n" +
+  "4. 路径 / 命令 / 版本号是否精确？\n" +
+  "5. 每个坑是否「现象 → 根因 → 解法」三要素齐全？\n" +
+  "6. 是否只输出了骨架要求的章节，没有额外发挥？\n" +
+  "\n" +
+  "现在开始处理我提供的材料。";

package/lib/common/records.mjs

@@ -0,0 +1,209 @@
+// memory-palace 记忆记录读写（去重追加 / 匹配删除 / 每日日志 / 迁移 / 轻量条目 / 错误捕获）。
+// 纯函数直接导出；依赖配置/路径解析的写入类函数经 createRecords 工厂注入。
+import { mkdir, readdir, unlink, readFile, writeFile } from "node:fs/promises";
+import { readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { todayISO, expandHome, readMdSync, toHomeShort, normLine, isStructural } from "./text.mjs";
+
+// 追加一行记忆，若目标文件已包含相同内容则跳过（去重），返回是否实际写入。
+export async function appendLineDedup(file, line) {
+  await mkdir(dirname(file), { recursive: true });
+  let cur = "";
+  try {
+    cur = readFileSync(file, "utf8");
+  } catch {
+    /* 文件尚不存在 */
+  }
+  if (cur.includes(line)) return false;
+  await writeFile(file, `${cur}\n${line}\n`, "utf8");
+  return true;
+}
+
+// 在文件中按内容匹配查找记忆条目行（不修改文件）。返回每条匹配：{tier,path,content}。
+export function findMatches(file, match, tier, pathShort) {
+  const m = (match || "").trim();
+  if (!m) return [];
+  let cur = "";
+  try {
+    cur = readFileSync(file, "utf8");
+  } catch {
+    return [];
+  }
+  const nm = normLine(m);
+  const out = [];
+  for (const raw of cur.split("\n")) {
+    const t = raw.trim();
+    if (!t || isStructural(t)) continue;
+    if (normLine(t).includes(nm)) out.push({ tier, path: pathShort, content: t });
+  }
+  return out;
+}
+
+// 按内容匹配删除 MEMORY.md / 每日日志中的条目行；保护结构行；返回删除条数与被删内容明细。
+export async function removeLineByMatch(file, match) {
+  const m = (match || "").trim();
+  if (!m) return { removed: 0, ok: false, reason: "empty-match", lines: [] };
+  let cur = "";
+  try {
+    cur = readFileSync(file, "utf8");
+  } catch {
+    return { removed: 0, ok: true, reason: "no-file", lines: [] };
+  }
+  const nm = normLine(m);
+  const lines = cur.split("\n");
+  const kept = [];
+  let removed = 0;
+  const removedLines = [];
+  for (const line of lines) {
+    const t = line.trim();
+    if (!t) {
+      kept.push(line);
+      continue;
+    }
+    if (isStructural(t)) {
+      kept.push(line);
+      continue;
+    }
+    if (normLine(t).includes(nm)) {
+      removed++;
+      removedLines.push(t);
+      continue;
+    }
+    kept.push(line);
+  }
+  if (removed > 0) await writeFile(file, kept.join("\n"), "utf8");
+  return { removed, ok: true, reason: "done", lines: removedLines };
+}
+
+// 读取目录下最近的非今日每日日志日期（最多 limit 份，降序）。供删除范围圈定。
+export async function recentLogDates(dir, limit = 3) {
+  let files = [];
+  try {
+    files = await readdir(dir);
+  } catch {
+    return [];
+  }
+  const today = todayISO();
+  return files
+    .map((f) => /^(\d{4}-\d{2}-\d{2})\.md$/.exec(f))
+    .filter((mm) => mm && mm[1] < today)
+    .map((mm) => mm[1])
+    .sort()
+    .reverse()
+    .slice(0, limit);
+}
+
+/**
+ * 依赖配置/路径解析的记录写入类函数工厂。
+ * @param {{ getConfig: () => object, paths: ReturnType<import("./paths.mjs").createPaths> }} deps
+ */
+export function createRecords({ getConfig, paths }) {
+  const cfg = () => getConfig();
+
+  async function appendDaily(dir, entry) {
+    await mkdir(dir, { recursive: true });
+    const file = join(dir, `${todayISO()}.md`);
+    let existing = "";
+    try {
+      existing = readFileSync(file, "utf8");
+    } catch {
+      /* 文件尚不存在 */
+    }
+    // v1.1.0：每日日志按天分割，文件头写当天日期（# YYYY-MM-DD），条目不再每条带时间戳。
+    // 新文件 → 标题+条目；旧文件（无当天一级标题，含历史 `## 时间戳` 条目）→ 补标题到文件头。
+    const todayTitle = `# ${todayISO()}`;
+    const trimmed = existing.trim();
+    if (!trimmed) {
+      await writeFile(file, `${todayTitle}\n\n${entry}`, "utf8");
+    } else {
+      const hasTitle = existing.split("\n").some((l) => l.trim() === todayTitle);
+      await writeFile(file, (hasTitle ? "" : `${todayTitle}\n\n`) + existing + entry, "utf8");
+    }
+    await prune(dir);
+  }
+
+  async function prune(dir) {
+    const c = cfg();
+    const cutoff = Date.now() - c.dailyLogRetentionDays * 86400000;
+    let files = [];
+    try {
+      files = await readdir(dir);
+    } catch {
+      return;
+    }
+    const mem = paths.memoryFileOf(dir);
+    for (const f of files) {
+      const m = /^(\d{4}-\d{2}-\d{2})\.md$/.exec(f);
+      if (!m) continue;
+      if (new Date(m[1]).getTime() < cutoff) {
+        const old = join(dir, f);
+        const text = await readFile(old, "utf8").catch(() => "");
+        if (text) {
+          let cur = "";
+          try {
+            cur = readFileSync(mem, "utf8");
+          } catch {
+            /* 尚无 MEMORY.md */
+          }
+          await mkdir(dirname(mem), { recursive: true });
+          await writeFile(mem, `${cur}\n<!-- distilled from ${f} -->\n${text}`, "utf8");
+        }
+        await unlink(old).catch(() => {});
+      }
+    }
+  }
+
+  // 读取目录里最近的（非今日）每日日志，拼成一段供 memory_read 展示（最多 3 份）。
+  async function recentLogs(dir) {
+    let files = [];
+    try {
+      files = await readdir(dir);
+    } catch {
+      return "";
+    }
+    const today = todayISO();
+    const dated = files
+      .map((f) => /^(\d{4}-\d{2}-\d{2})\.md$/.exec(f))
+      .filter((m) => m && m[1] < today)
+      .map((m) => m[1])
+      .sort()
+      .reverse()
+      .slice(0, 3);
+    const parts = [];
+    for (const date of dated) {
+      const text = readMdSync(join(dir, `${date}.md`));
+      if (text) parts.push(`# 日志 ${date} @ ${toHomeShort(dir)}\n${text.slice(0, cfg().workspaceBudgetChars)}`);
+    }
+    return parts.join("\n\n");
+  }
+
+  // 轻量结构化条目（无 LLM）：截断原始文本，错误带 [ERROR] 前缀。
+  async function writeLightEntry(dirs, turn, isError) {
+    const userText = turn.find((b) => b.role === "user")?.text ?? "";
+    const asstText = turn.filter((b) => b.role === "assistant").map((b) => b.text).join(" ");
+    const summary = (userText || asstText || "(no message captured)").slice(0, 200);
+    const tag = isError ? "[ERROR] " : "";
+    const entry = `\n${tag}${summary}\n\n`;
+    for (const dir of dirs) await appendDaily(dir, entry);
+  }
+
+  // 错误捕获（目标2）：按 scope 落对应 MEMORY.md，条目仅含「错误现象」。
+  // （v0.7.1 起不再调 LLM 生成方案——「根因/绕过手法」由 agent 按记忆公民指令场景①主动调 memory_note 记。）
+  async function captureError(turn, reason) {
+    const c = cfg();
+    const dirs = paths.writeDirs();
+    if (!dirs.length && !expandHome(c.userMemoryPath)) return;
+    const scope = dirs.length ? "project" : "user";
+    const errText = (reason?.message || reason?.error?.message || "(in-session error, no message)")
+      .toString()
+      .slice(0, 300);
+    const line = `- [${new Date().toISOString().slice(0, 10)}] in-session 错误（${scope}）：${errText}`;
+    const targets = dirs.length ? dirs : [expandHome(c.userMemoryPath)];
+    for (const dir of targets) {
+      const mem = paths.memoryFileOf(dir);
+      await appendLineDedup(mem, line).catch(() => {});
+    }
+  }
+
+  return { appendDaily, prune, recentLogs, writeLightEntry, captureError };
+}

package/lib/common/text.mjs

@@ -0,0 +1,120 @@
+// memory-palace 共享纯函数：日期/时间戳、路径简写、文本提取、预算截断、行归一化。
+// 全部无状态、纯函数，可被任意模块与单测直接引用。
+
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { readFileSync } from "node:fs";
+
+// 本地日期（YYYY-MM-DD）。绝不能再用 toISOString()——它返回 UTC 日期，本地 0-8 点会
+// 把记忆写到"昨天"的日志（真机实测：本地 2026-08-18 00:26 的条目写进了 2026-08-17.md）。
+export const todayISO = () => {
+  const d = new Date();
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return `${d.getFullYear()}-${m}-${day}`;
+};
+
+// 本地时间戳（YYYY-MM-DDTHH-mm-ss，`:` 换 `-` 兼容 Windows 文件名）。
+// 同 todayISO 的教训：必须用本地时间，不能用 toISOString()（UTC 会差 8 小时）。
+// 供项目记忆蒸馏备份文件名（MEMORY.md.{时间戳}）使用。
+export const nowStamp = () => {
+  const d = new Date();
+  const p = (n) => String(n).padStart(2, "0");
+  return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}T${p(d.getHours())}-${p(d.getMinutes())}-${p(d.getSeconds())}`;
+};
+
+// 自己展开 ~，避免依赖 dsh-home-paths 的解析负担（homedir 即可）。
+export function expandHome(p) {
+  if (!p) return p;
+  if (p === "~" || p.startsWith("~/") || p.startsWith("~\\")) {
+    return join(homedir(), p.slice(1));
+  }
+  return p;
+}
+
+// 反向简写：home 下的绝对路径 → ~ 简写（统一正斜杠）。AI 转述绝对路径极易拼错
+// （实测出现过 lovezi0.deepseek-harness 缺分隔符），一律喂给它 ~ 简写。
+export function toHomeShort(p) {
+  if (!p) return p;
+  const h = homedir();
+  if (p === h) return "~";
+  if (p.startsWith(h + "\\") || p.startsWith(h + "/")) {
+    return "~" + p.slice(h.length).replace(/\\/g, "/");
+  }
+  return p;
+}
+
+// 读取 Markdown 文件（同步，systemPrompt section 要求同步）。
+export function readMdSync(path) {
+  if (!path) return "";
+  try {
+    return readFileSync(path, "utf8").trim();
+  } catch {
+    return "";
+  }
+}
+
+// v1.2.0 预算截断：注入 system prompt 时按字符上限截断（保留头部 + 截断标记）。
+// budget <= 0 / 未配置视为不限。userBudgetChars / workspaceBudgetChars 在 text() 注入路径生效，
+// 修复 v1.1.x 之前两配置为死配置的问题（与 README「注入系统提示词的长度上限」语义对齐）。
+export function budgetClip(text, budget) {
+  if (!text || !budget || budget <= 0) return text;
+  if (text.length <= budget) return text;
+  return text.slice(0, budget) + `\n…（已截断，原 ${text.length} 字符，仅注入前 ${budget} 字符）`;
+}
+
+// 行归一化：去掉 `- `/`* ` 前缀、合并空白、转小写，使"带不带前缀"的子串匹配都鲁棒。
+export const normLine = (s) => s.replace(/^[-*]\s+/, "").replace(/\s+/g, " ").trim().toLowerCase();
+
+// 结构行（标题 / 蒸馏注释）受保护，永不被删除。
+export const isStructural = (t) => t.startsWith("#") || t.startsWith("<!--");
+
+// 从单个 content block 抽取文本。兼容两类：
+// - text block：顶层 {type:"text", text:"..."}（user/assistant 消息）
+// - tool-result block：{type:"tool-result", content: ContentBlock[]}，文本嵌套在 content 内（真机 tool/result 即如此，
+//   若只取 .text 会取空——这是此前「工具任务轮次不落记忆」的根因）
+export function blockText(x) {
+  if (typeof x === "string") return x;
+  if (!x || typeof x !== "object") return "";
+  if (typeof x.text === "string") {
+    // 丢弃 harness 注入的运行时上下文快照块（真机 assistant/message 常以一个
+    // "Current runtime context. This snapshot supersedes…" 开头的独立 text block 出现），
+    // 避免把 DSH file policy 等系统噪声记进记忆。
+    if (/^Current runtime context\./i.test(x.text)) return "";
+    return x.text;
+  }
+  if (Array.isArray(x.content)) return x.content.map(blockText).join("");
+  return "";
+}
+
+export function extractText(event) {
+  try {
+    const d = event?.data ?? {};
+    // user/message 的 event.data 直接是 UserMessage（无外层包装）→ 走 d.content；
+    // assistant/message、tool/result 的 event.data 带 {message: ...} → 走 d.message.content。
+    const c = d.message?.content ?? d.content ?? d.text;
+    let text;
+    if (typeof c === "string") text = c;
+    else if (Array.isArray(c)) text = c.map(blockText).join("");
+    else if (c && typeof c === "object") text = JSON.stringify(c);
+    else text = "";
+    // 剥离 harness 注入的 <system-reminder>…</system-reminder> 系统块（实测 hello 轮次会抓到可用 skills 列表），
+    // 避免把系统噪声记进记忆 / 误命中关键词。runtime-context 快照块在 blockText 层按块丢弃。
+    return text.replace(/<system-reminder[\s\S]*?<\/system-reminder>/gi, "").trim();
+  } catch {
+    return "";
+  }
+}
+
+// 从工具执行结果中识别错误。in-session 错误未必以 turn/end 的 reason.kind==='error' 暴露——
+// 代码运行报错、工具执行失败常以 tool/result 形式呈现，agent 看到错误后正常收尾（reason.kind 为 completed），
+// 故需单独扫描工具结果文本。命中即视为错误信号（受 autoCaptureErrors 门控）。
+export function extractToolErrorText(turn) {
+  for (const b of turn) {
+    if (b.role !== "tool") continue;
+    if (/code run failed|exception[:\s]|referenceerror|typeerror|syntaxerror|error:\s|traceback|执行失败|运行出错|运行报错/i.test(b.text)) {
+      return b.text.slice(0, 300);
+    }
+  }
+  return null;
+}