dsh-memory-palace 1.7.2 → 1.8.0-alpha.1

package/lib/common/sections.mjs

@@ -4,7 +4,8 @@
 // 设计约束（v1.6.0 定案）：
 // - 全部返回 { ok, reason, ... }，永不抛错——LLM 产出的 ops 不可信，机器侧兜底；
 // - 只拆两级标题（`## `），`#` 文件标题与前言归 head，`###` 及更深归当前章节内容；
-// - 不改动 text.mjs 既有函数（normLine/budgetClip 有 v1.4.1 测试锚定），本文件自持归一化。
+// - text.mjs 的 normLine 不动；budgetClip 已在 v1.8.0-alpha.1 按 D2 修复重写（兑现「保留全部
+//   结构行」声明），v1.4.1 锚点同步更新——本文件自持归一化，不依赖其内部实现。
 
 // 章节标题归一化：剥 `#` 前缀、合空白、转小写。标题匹配全部走它，"带不带 ## 前缀"都鲁棒。
 const normTitle = (s) =>
@@ -80,34 +81,49 @@ export function locateSection(md, section) {
   return { start, end, lines };
 }
 
+// 条目扁平化（v1.8.0-alpha.1 修复 D1）：LLM 传来的 entry 可能内嵌换行——含 `\n## x` / `\n# x`
+// 时会原样落盘生成真实章节标题、把原章节从中间劈开（实测结构损坏且无插件路径可复原）。
+// 处理：按行拆开，逐行剥行首列表符（- / *）与井号（#），去空行后以「；」连接为单行——
+// 内容零丢失、结构损坏向量消除。返回 { text, lines }（lines = 非空行数），调用方可在
+// message 里明示「已合并单行」。memory_write 与子代理 log_write_ops 共用，一处修两条路径闭环。
+export function flattenEntry(entry) {
+  const parts = String(entry ?? "")
+    .split(/\r?\n/)
+    .map((l) => l.trim().replace(/^[-*]\s+/, "").replace(/^#+\s*/, "").trim())
+    .filter(Boolean);
+  return { text: parts.join("；"), lines: parts.length };
+}
+
 // 章节内追加条目。章节存在 → 内容最后一个非空行后插入 `- entry`（全空行则插在标题行后）；
 // 章节不存在 → { ok:false, reason:"section-miss" }（调用方决定是否走新增）。
-// entry 写入前剥除行首列表符（`- `/`* `/`-`/`*`，含缩进）——LLM 常按描述示例自带 `- ` 前缀，
-// 不剥会导致 `- - xxx` 双列表符脏数据（v1.6.0 实装踩坑）。
+// entry 先经 flattenEntry 扁平化为单行（防多行/标题注入破坏结构），行首列表符在此一并剥除。
 export function appendToSectionText(md, section, entry) {
-  const clean = String(entry ?? "").trim().replace(/^[-*]\s+/, "").trim();
-  const entryLine = `- ${clean}`;
-  if (!entryLine.slice(2).trim()) return { ok: false, reason: "empty-entry" };
+  const f = flattenEntry(entry);
+  const entryLine = `- ${f.text}`;
+  if (!f.text) return { ok: false, reason: "empty-entry" };
   const loc = locateSection(md, section);
   if (!loc) return { ok: false, reason: "section-miss" };
   const { start, end, lines } = loc;
   let insertAt = end;
   while (insertAt > start + 1 && !lines[insertAt - 1].trim()) insertAt--;
   lines.splice(insertAt, 0, entryLine);
-  return { ok: true, reason: "appended", text: lines.join("\n") };
+  return { ok: true, reason: "appended", text: lines.join("\n"), flattened: f.lines > 1 };
 }
 
 // 章节追加（upsert 语义）：存在则追加，不存在则文件尾新增章节。日志 ops 的 "append" 与
 // memory_write 工具共用——"不要强行匹配现有章节，不符合章节标题就走新增"。
 export function upsertSectionText(md, section, entry) {
-  const r = appendToSectionText(md, section, entry);
-  if (r.ok) return r;
+  const f = flattenEntry(entry);
+  const r = appendToSectionText(md, section, f.text);
+  // appendToSectionText 会把已扁平化的文本再走一次 flattenEntry（幂等）——此时其 flattened
+  // 恒为 false，故这里必须用**本函数**的 f.lines 覆盖标记，否则多行 entry 的标记被吃掉。
+  if (r.ok) return { ...r, flattened: f.lines > 1 };
   if (r.reason === "empty-entry") return r;
   const title = `## ${String(section ?? "").trim()}`;
   const base = (md || "").replace(/\s+$/, "");
-  const entryLine = `- ${String(entry ?? "").trim().replace(/^[-*]\s+/, "").trim()}`;
+  const entryLine = `- ${f.text}`;
   const text = base ? `${base}\n\n${title}\n${entryLine}\n` : `${title}\n${entryLine}\n`;
-  return { ok: true, reason: "section-created", text };
+  return { ok: true, reason: "section-created", text, flattened: f.lines > 1 };
 }
 
 // 显式新建章节（与 upsert 的区别：章节已存在时拒绝而非追加）——子 agent 日志 ops 的
@@ -130,6 +146,14 @@ export function replaceSectionText(md, section, oldSectionText, newSectionText)
   if (normBlock(current) !== normBlock(String(oldSectionText ?? ""))) {
     return { ok: false, reason: "conflict", actual: current };
   }
+  // v1.8.0-alpha.1 修复（D3）：newText 的标题行必须与 section 参数一致——否则会把章节静默
+  // 改名（实测标题改写成功而 message 仍回报旧名，掩盖误操作），且 newText 缺标题行时会把
+  // 章节标题整行吃掉（内容并入上一章节）。归一化比对（大小写/空白/`##` 前缀差异均容忍）。
+  const firstLine = newText.split("\n").find((l) => l.trim())?.trim() ?? "";
+  const heading = /^##\s+(.+)$/.exec(firstLine);
+  if (!heading || normTitle(heading[1]) !== normTitle(section)) {
+    return { ok: false, reason: "heading-mismatch", actual: current };
+  }
   // 保留章节末尾的分隔空行（章节与下一章节之间通常有空行，整块替换时不能吞掉，
   // 否则下一章节标题会紧贴上一章节最后一条目）。
   const hasTrailingBlank = end > start && !lines[end - 1].trim();

package/lib/common/text.mjs

@@ -90,8 +90,13 @@ export function budgetClip(text, budget) {
     j--;
   }
   if (j < i) return head.join("\n") + (head.length ? "\n" : "") + tail.join("\n");
-  const marker = `…（已截断，原 ${text.length} 字符，仅注入结构行与尾部最近条目）`;
-  return [...head, marker, ...tail].join("\n");
+  // v1.8.0-alpha.1 修复（D2）：中部结构行不再随内容一起丢弃——旧实现把中部的 `## 章节标题`
+  // 当普通内容行处理，落在尾部窗口外即消失，而截断标记却自称「仅注入结构行与尾部最近条目」
+  // （声明与行为不符，实测中部 3 个章节标题整体丢失）。现把窗口外幸存的结构行按原序
+  // 列在标记之后，保证章节大纲始终完整可见。结构行不计预算（大纲优先于条目）。
+  const middleStructural = lines.slice(i, j + 1).filter((l) => isStructural(l.trim()));
+  const marker = [`…（已截断，原 ${text.length} 字符，仅注入结构行与尾部最近条目）`, ...middleStructural];
+  return [...head, ...marker, ...tail].join("\n");
 }
 
 // v1.4.1：剥除行首 `[smart]` 标记（含重复），保留列表符与其余内容。用于注入与回喂的读侧——
@@ -164,7 +169,7 @@ export function extractText(event) {
 
 // 从工具执行结果中识别错误。in-session 错误未必以 turn/end 的 reason.kind==='error' 暴露——
 // 代码运行报错、工具执行失败常以 tool/result 形式呈现，agent 看到错误后正常收尾（reason.kind 为 completed），
-// 故需单独扫描工具结果文本。命中即视为错误信号（受 autoCaptureErrors 门控）。
+// 故需单独扫描工具结果文本。命中即视为错误信号（作为 isError 传给记忆子代理）。
 export function extractToolErrorText(turn) {
   for (const b of turn) {
     if (b.role !== "tool") continue;

package/lib/distill.mjs

@@ -1,5 +1,6 @@
-// memory-palace 蒸馏业务：会话蒸馏核心（自动智能模式 + 按钮「蒸馏会话」共用）+ 项目记忆蒸馏。
-// 经 createDistill 工厂注入 ctx/config/paths/records/运行时状态；返回句柄供 index.mjs 装配与 api.mjs 调用。
+// memory-palace 蒸馏业务：会话蒸馏核心（按钮「蒸馏会话」）+ 项目记忆蒸馏。
+// 经 createDistill 工厂注入 ctx/config/paths/records；返回句柄供 index.mjs 装配与 api.mjs 调用。
+// v1.8.0：原 smart 模式自动摘要入口 summarizeTurn 已删除，distillSessionCore 唯一调用方 = 手动按钮。
 import { mkdir, unlink, writeFile, rename } from "node:fs/promises";
 import { join, dirname } from "node:path";
 import { BlockAssembler, createUserMessage } from "@deepseek-ai/dsh-llm";
@@ -10,9 +11,9 @@ import { appendLineDedup, readNumberedMemory, applyMemoryOp } from "./common/rec
 import { runWithRetry, RETRY_CONSTANTS } from "./common/retry.mjs";
 
 /**
- * @param {{ ctx: object, getConfig: () => object, paths: object, records: object, state: object }} deps
+ * @param {{ ctx: object, getConfig: () => object, paths: object, records: object }} deps
  */
-export function createDistill({ ctx, getConfig, paths, records, state }) {
+export function createDistill({ ctx, getConfig, paths, records }) {
   const cfg = () => getConfig();
 
   // 调试日志（v1.3.0）：dbgFail=失败/跳过留痕（无条件输出，不受开关控制，保证排障可观测）；
@@ -93,13 +94,12 @@ export function createDistill({ ctx, getConfig, paths, records, state }) {
   }
 
   // 蒸馏核心（v1.2.0 抽取）：对指定 session 的 [fromSeq, ∞) surface 事件做 LLM 智能摘要并写盘。
-  // 自动智能模式（summarizeTurn，增量断点）与按钮「蒸馏会话」（全量 fromSeq=0）共用本核心。
+  // v1.8.0：唯一调用方 = 按钮「蒸馏会话」（全量 fromSeq=0）；原 smart 模式自动摘要链路已删除。
   // 返回 { ok, summary, durableCount }；失败 { ok:false }（调用方各自决定降级策略）。
   async function distillSessionCore(session, dirs, fromSeq, opts) {
     const allowDelete = !!(opts && opts.allowDelete);
-    // 回喂存量记忆（v1.4.0 特性3）：智能模式级能力——feedbackEnabled 开启即在【自动智能模式（turn/end）
-    // 与手动蒸馏按钮】两条链路都回喂项目级 + 用户级 MEMORY.md 全文（逐行编号、无截断）。
-    // delete 仍仅手动蒸馏（allowDelete=true）开放；自动模式 memoryOps 中的 delete 在 §5.5 被 !allowDelete 跳过。
+    // 回喂存量记忆（v1.4.0 特性3）：feedbackEnabled 开启即回喂项目级 + 用户级 MEMORY.md 全文
+    // （逐行编号、无截断）。delete 由 allowDelete 决定（手动按钮传 true）。
     // 回喂目标严格限定为 MEMORY.md；每日日志（.deepseek-harness/memory/YYYY-MM-DD.md）不读取、不改写、不删旧行。
     const useFeedback = !!cfg().feedbackEnabled;
     if (!session) {
@@ -275,17 +275,6 @@ export function createDistill({ ctx, getConfig, paths, records, state }) {
     return { ok: true, summary, durableCount: durable.length };
   }
 
-  // 智能模式核心：LLM 智能会话摘要（增量范围，产物带 [smart] 标记）。
-  // 输入：capturedTurn（本轮缓冲，仅用于失败降级）、dirs（写盘目标）、isError。
-  // 核心逻辑在 distillSessionCore；此处只负责增量断点（state.lastSummarizedSeq）的推进。
-  // 失败返回 false 由调用方降级轻量条目；handler 永不 reject（调用方包 catch）。
-  async function summarizeTurn(capturedTurn, dirs, isError) {
-    if (!state.activeSession) return false;
-    const r = await distillSessionCore(state.activeSession, dirs, state.lastSummarizedSeq);
-    if (r.ok) state.lastSummarizedSeq = state.activeSession.seq;
-    return r.ok;
-  }
-
   // ---------- v1.2.0 项目记忆蒸馏（按钮「蒸馏项目记忆」） ----------
   // 流程：读主目标 MEMORY.md → DISTILL_PROMPT 蒸馏 → 写 memory-cover.md（同目录，保证 rename 原子）
   // → 完整性检查 → 备份 MEMORY.md.{时间戳} → rename 覆盖 → cover 随 rename 消失。
@@ -399,5 +388,5 @@ export function createDistill({ ctx, getConfig, paths, records, state }) {
     }
   }
 
-  return { distillSessionCore, summarizeTurn, distillProjectMemory, distillLocks };
+  return { distillSessionCore, distillProjectMemory, distillLocks };
 }

package/lib/hybrid/index.mjs

@@ -1,7 +1,6 @@
-// memory-palace v1.6.0 hybrid 模式：模块入口（装配）。
-// 仅在 memoryMode === "hybrid" 时由 index.mjs 调用 registerHybrid（memoryMode 切换需重启
-// dsh——注册时机安全）。不注册任何 DSH 全局资源以外的东西；runMemorySubagent 由 index.mjs
-// 的 _settle hybrid 分支每轮调用。
+// memory-palace 记忆子代理模块：模块入口（装配）。
+// v1.8.0：原 hybrid 模式已成唯一写入路径（plugin / smart 已删除），本模块由 index.mjs 无条件装配。
+// 不注册任何 DSH 全局资源以外的东西；runMemorySubagent 由 index.mjs 的 _settle 每轮调用。
 import { runMemorySubagent } from "./subagent.mjs";
 import { registerHybridTools, attachHybridGuards } from "./tools.mjs";
 

package/lib/hybrid/subagent.mjs

@@ -235,7 +235,7 @@ function applyLogOps(logFiles, dateStr, ops) {
 
 // 记忆子 agent 主入口。每轮必跑（定案：不走闸门）；plan 模式拦截由调用方（index.mjs _settle）负责。
 // 返回 { ok, mode }：mode = "noop"（无重点收尾）| "written"（有落盘）| "no-tool-support"；
-// ok=false 表示整体失败（调用方降级 writeLightEntry，不推进断点）。
+// ok=false 表示整体失败（不推进断点、下一次 turn/end 自动补蒸；不降级为任何轻量写入）。
 export async function runMemorySubagent({ ctx, getConfig, paths, state, session, dirs, isError }) {
   const cfg = getConfig();
   // 调试日志（v1.6.0）：与 distill.mjs 同款门控。dbgFail=失败/跳过留痕（无条件输出，排障可观测）；
@@ -379,7 +379,7 @@ export async function runMemorySubagent({ ctx, getConfig, paths, state, session,
       }
       if (finish.kind !== "tool-calls") {
         // max-tokens 等异常收尾：返回失败，断点不推进——下一次 turn/end 子代理自动补蒸。
-        // v1.6.0 定案：不降级 writeLightEntry（无格式原文会破坏日志章节化结构），宁缺勿滥。
+        // v1.6.0 定案：不降级为轻量原文写入（无格式原文会破坏日志章节化结构），宁缺勿滥。
         dbgFail(`finish ${finish.kind}`, { round });
         return { ok: false, mode: `finish-${finish.kind}` };
       }

package/lib/hybrid/tools.mjs

@@ -35,7 +35,7 @@ export function readLastReorg(md) {
 export function checkReorgGate(memFile, cfg) {
   const md = readMdSync(memFile);
   const size = md.length;
-  const overBudget = size > (cfg.workspaceBudgetChars || 3000);
+  const overBudget = size > (cfg.workspaceBudgetChars || 6000);
   const last = readLastReorg(md);
   const cooldownMs = (cfg.reorgCooldownDays ?? 7) * 86400000;
   const cooled = Date.now() - last >= cooldownMs;
@@ -49,7 +49,7 @@ export function checkReorgGate(memFile, cfg) {
       ? cooled
         ? "ok"
         : `重整冷却期内（上次重整 ${new Date(last).toLocaleString()}，冷却 ${cfg.reorgCooldownDays ?? 7} 天），请用 memory_update_section 做章节级修正。`
-      : `MEMORY.md 当前 ${size} 字符未超出注入预算（${cfg.workspaceBudgetChars || 3000}），无需重整；请用 memory_write / memory_update_section 维护。`,
+      : `MEMORY.md 当前 ${size} 字符未超出注入预算（${cfg.workspaceBudgetChars || 6000}），无需重整；请用 memory_write / memory_update_section 维护。`,
   };
 }
 
@@ -65,8 +65,8 @@ function sectionHasEntry(md, section, entry) {
 }
 
 /**
- * 注册 hybrid 工具 + pre-execute 闸门。仅在 memoryMode === "hybrid" 时由 index.mjs 调用
- * （memoryMode 切换需重启 dsh——注册时机安全，不存在运行中换挡错配）。
+ * 注册记忆工具（MEMORY.md 章节化写入 / 整章节替换 / 全量重整）+ pre-execute 闸门。
+ * v1.8.0：由 index.mjs 无条件装配（原 hybrid 已成唯一写入路径）。
  * @param {{ ctx: object, getConfig: () => object, paths: object, records: object, state: object }} deps
  */
 export function registerHybridTools({ ctx, getConfig, paths, records, state }) {
@@ -118,7 +118,6 @@ export function registerHybridTools({ ctx, getConfig, paths, records, state }) {
         render: (_args, value) => [{ type: "text", text: value?.message ?? "Saved." }],
       },
       async execute(args, exec) {
-        state.recentAgentWrote = true;
         const c = cfg();
         if (!c.enabled) return { ok: false, message: "memory-palace is currently disabled in settings." };
         const section = String(args.section ?? "").trim();
@@ -127,28 +126,33 @@ export function registerHybridTools({ ctx, getConfig, paths, records, state }) {
         const cwd = sessionCwd(exec);
         const target = memFileOf(args.scope === "user" ? "user" : "project", cwd);
         if (!target) return { ok: false, message: "No active workspace." };
-        try {
-          let wrote = 0;
-          let skipped = 0;
-          const files = target.dirs.length ? target.dirs.map((d) => paths.memoryFileOf(d, cwd)) : [target.file];
-          for (const file of files) {
-            const md = readMdSync(file);
-            if (sectionHasEntry(md, section, entry)) {
-              skipped++;
-              continue;
-            }
-            const r = upsertSectionText(md, section, entry);
-            if (!r.ok) {
-              skipped++;
-              continue;
+          try {
+            let wrote = 0;
+            let skipped = 0;
+            let flattened = false;
+            const files = target.dirs.length ? target.dirs.map((d) => paths.memoryFileOf(d, cwd)) : [target.file];
+            for (const file of files) {
+              const md = readMdSync(file);
+              if (sectionHasEntry(md, section, entry)) {
+                skipped++;
+                continue;
+              }
+              const r = upsertSectionText(md, section, entry);
+              if (!r.ok) {
+                skipped++;
+                continue;
+              }
+              await writeFile(file, r.text, "utf8");
+              wrote++;
+              flattened = flattened || r.flattened === true;
             }
-            await writeFile(file, r.text, "utf8");
-            wrote++;
-          }
+            // v1.8.0-alpha.1 修复（D1）：entry 经 flattenEntry 扁平化为单行——含内嵌换行/标题行
+            // 时不再原样落盘破坏结构，message 明示合并，不静默撒谎。
+            const flatNote = flattened ? "（entry 含多行，已合并为单行）" : "";
           return {
             ok: wrote > 0,
             message: wrote > 0
-              ? `Saved to ${wrote} MEMORY.md file(s) under 「${section}」${skipped ? ` (${skipped} duplicate skipped)` : ""}.`
+              ? `Saved to ${wrote} MEMORY.md file(s) under 「${section}」${flatNote}${skipped ? ` (${skipped} duplicate skipped)` : ""}.`
               : `Duplicate entry under 「${section}」; nothing written.`,
           };
         } catch (e) {
@@ -202,7 +206,6 @@ export function registerHybridTools({ ctx, getConfig, paths, records, state }) {
           [{ type: "text", text: value?.actual ? `${value.message}\n\n当前实际内容：\n${value.actual}` : value?.message ?? "Done." }],
       },
       async execute(args, exec) {
-        state.recentAgentWrote = true;
         const c = cfg();
         if (!c.enabled) return { ok: false, message: "memory-palace is currently disabled in settings.", actual: "" };
         const section = String(args.section ?? "").trim();
@@ -217,7 +220,10 @@ export function registerHybridTools({ ctx, getConfig, paths, records, state }) {
             ? markEntryDeletedText(md, section, oldText)
             : replaceSectionText(md, section, oldText, args.newText);
           if (!r.ok) {
-            return { ok: false, message: `更新被拒绝（${r.reason}）：请先 memory_read 重读后再试。`, actual: r.actual ?? "" };
+            const msg = r.reason === "heading-mismatch"
+              ? `更新被拒绝（heading-mismatch）：newText 的标题行与 section 参数「${section}」不一致（或缺少 ## 标题行）。请保持两者一致后重试；确需重命名章节，请同步修改标题行与 section 参数。`
+              : `更新被拒绝（${r.reason}）：请先 memory_read 重读后再试。`;
+            return { ok: false, message: msg, actual: r.actual ?? "" };
           }
           await writeFile(file, r.text, "utf8");
           return { ok: true, message: `Updated 「${section}」 in ${toHomeShort(file)} (${r.reason}).`, actual: "" };
@@ -258,7 +264,6 @@ export function registerHybridTools({ ctx, getConfig, paths, records, state }) {
         render: (_args, value) => [{ type: "text", text: value?.message ?? "Done." }],
       },
       async execute(args, exec) {
-        state.recentAgentWrote = true;
         const c = cfg();
         if (!c.enabled) return { ok: false, message: "memory-palace is currently disabled in settings." };
         const cwd = sessionCwd(exec);
@@ -327,7 +332,7 @@ export function attachHybridGuards(ctx, getConfig, paths, state) {
       kind: "ask",
       reason:
         `⚠️ 项目级 MEMORY.md 全量重整确认\n` +
-        `当前 ${gate.size} 字符（已超预算 ${c.workspaceBudgetChars || 3000}），冷却已满足（上次重整 ${gate.last ? new Date(gate.last).toLocaleString() : "从未"}）。\n` +
+        `当前 ${gate.size} 字符（已超预算 ${c.workspaceBudgetChars || 6000}），冷却已满足（上次重整 ${gate.last ? new Date(gate.last).toLocaleString() : "从未"}）。\n` +
         `即将用 ${size} 字符的新全文覆盖 ${file}（原文件会自动备份）。\n` +
         `请确认是否执行重整？`,
     };