dsh-memory-palace 1.4.1 → 1.6.1

package/lib/common/prompts.mjs

@@ -52,11 +52,12 @@ export function DISTILL_PROMPT({ outputBudget } = {}) {
   "只保留「以后还会用到」的信息，删掉「一次性过程」。\n" +
   "唯一判断标准：删了这条，下次开工会不会出错 / 返工 / 重踩坑？会 → 留；不会 → 删。\n" +
   "\n" +
-  "【只提炼 7 类信息，无关的类别直接省略，不要硬凑】\n" +
+  "【只提炼「以后还会用到」的信息，无关的类别直接省略，不要硬凑】\n" +
+  "常见归档维度（参考，可按材料实际内容增删维度）：\n" +
   "1. 定位 —— 一句话说清任务本质 + 最终产出什么。\n" +
   "2. 当前状态 —— 现在推进到哪一步、卡在哪、下一步是什么。\n" +
   "3. 核心约束 —— 什么绝对不能变。注意：丢了会出事的才叫约束，丢了只是不方便的是细节，细节不写。\n" +
-  "4. AI 行为边界 —— AI 能做什么、绝不能做什么、什么留给用户。所有「谁来做 / 谁授权 / 谁拍板」的约定都要显式归入这里，不能混在别的条目里。\n" +
+  "4. AI 行为边界 —— AI 能做什么、绝不能做什么、什么留给用户。若设置该章节，则所有「谁来做 / 谁授权 / 谁拍板」的约定集中于此。\n" +
   "5. 关键路径 —— 绝对路径、命令、数据源、模板、依赖。原样精确保留，禁止用占位符。\n" +
   "6. 决策记录 —— 为什么这么做（而非只记做了什么），尽量带日期或版本锚点。废弃方案单独标注为「已废弃」，不要删除。\n" +
   "7. 坑与教训 —— 现象 → 根因 → 解法，一条一个坑。一句话能讲清的坑不算坑、不记。\n" +
@@ -67,7 +68,9 @@ export function DISTILL_PROMPT({ outputBudget } = {}) {
   "- 精确值：路径、命令、字段名、版本号原样保留，禁用 ~/、占位符或「大概」。\n" +
   "- 时间锚点：决策和坑尽量带日期或版本，让人知道这是哪个阶段的结论。\n" +
   "\n" +
-  "【输出格式】严格按以下骨架输出，无关章节整节删除：\n" +
+  // v1.4.1：骨架从强制改为参考——章节可按内容增删/合并/改名，以契合为先（修实测的
+  // 「章节与内容不匹配」）。下方自检第 6 条同步翻转为「查错位」，防收尾自检把自由度撤销。
+  "【输出格式】参考以下骨架组织输出，章节可按材料实际内容增删/合并/改名，以内容与章节契合为先，无关章节不硬凑：\n" +
   "\n" +
   "# <项目名> 项目笔记\n" +
   "<一句话定位 + 当前状态>\n" +
@@ -93,7 +96,7 @@ export function DISTILL_PROMPT({ outputBudget } = {}) {
   "3. 边界是否显式、无歧义、没有混在别的条目里？\n" +
   "4. 路径 / 命令 / 版本号是否精确？\n" +
   "5. 每个坑是否「现象 → 根因 → 解法」三要素齐全？\n" +
-  "6. 是否只输出了骨架要求的章节，没有额外发挥？\n" +
+  "6. 每个条目是否归在了最契合的章节？有没有为凑骨架而错位归类？\n" +
   "\n" +
   (outputBudget != null ? "【输出长度约束】你提炼后的项目记忆请控制在约 " + outputBudget + " token（≈" + Math.round(outputBudget * 1.8) + " 字）以内。思考不受限，但成稿须精炼、不超预算；只保留「以后还会用到」的信息，删掉「一次性过程」。\n" : "") +
   "现在开始处理我提供的材料。"

package/lib/common/records.mjs

@@ -3,7 +3,7 @@
 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";
+import { todayISO, expandHome, readMdSync, toHomeShort, normLine, isStructural, stripSmartTag } from "./text.mjs";
 
 // 追加一行记忆，若目标文件已包含相同内容则跳过（去重），返回是否实际写入。
 export async function appendLineDedup(file, line) {
@@ -78,6 +78,8 @@ export async function removeLineByMatch(file, match) {
 // 全文逐行编号读取（v1.4.0 特性3：回喂存量记忆）。返回 { lines:[{n,raw,structural}], text }。
 // 行号 n 与文件实际行一一对应（1 起），供 LLM 通过 line 引用；text 为每行 `n|raw` 拼接，直接喂模型。
 // 不截断、无字符预算（用户明确要求全量回喂，避免截断导致记忆错误）。
+// v1.4.1：回喂行经 stripSmartTag 剥除行首 [smart] 标记——模型不可见该标签（写侧已停拼），
+// 存量磁盘条目读时透明剥除。replace/delete 的 oldText 校验仍以磁盘原文（raw）为准，不受影响。
 export function readNumberedMemory(file) {
   let cur = "";
   try {
@@ -90,7 +92,7 @@ export function readNumberedMemory(file) {
     const t = raw.trim();
     return { n: i + 1, raw, structural: isStructural(t) };
   });
-  const text = lines.map((l) => `${l.n}|${l.raw}`).join("\n");
+  const text = lines.map((l) => `${l.n}|${stripSmartTag(l.raw)}`).join("\n");
   return { lines, text };
 }
 
@@ -203,6 +205,9 @@ export function createRecords({ getConfig, paths }) {
 
   async function prune(dir) {
     const c = cfg();
+    // v1.6.0：hybrid 模式下日志永不过期不删（dailyLogRetentionDays 不可用，定案）——
+    // 日志是子代理维护的证据层，过期并入 MEMORY.md 的旧逻辑在 hybrid 下也不应触达。
+    if (c.memoryMode === "hybrid") return;
     const cutoff = Date.now() - c.dailyLogRetentionDays * 86400000;
     let files = [];
     try {

package/lib/common/sections.mjs

@@ -0,0 +1,167 @@
+// memory-palace v1.6.0 hybrid 模式：Markdown 章节纯函数（无 IO、无副作用）。
+// 服务三类调用方：记忆子 agent 的日志 ops（追加/新增/标删）、agent 的 memory_write /
+// memory_update_section 工具、memory_reorganize 的门禁计算。
+// 设计约束（v1.6.0 定案）：
+// - 全部返回 { ok, reason, ... }，永不抛错——LLM 产出的 ops 不可信，机器侧兜底；
+// - 只拆两级标题（`## `），`#` 文件标题与前言归 head，`###` 及更深归当前章节内容；
+// - 不改动 text.mjs 既有函数（normLine/budgetClip 有 v1.4.1 测试锚定），本文件自持归一化。
+
+// 章节标题归一化：剥 `#` 前缀、合空白、转小写。标题匹配全部走它，"带不带 ## 前缀"都鲁棒。
+const normTitle = (s) =>
+  (s || "").trim().replace(/^#+\s*/, "").replace(/\s+/g, " ").toLowerCase();
+
+// 章节块归一化：逐行 trim + 合空白、丢空行、转小写。整章节 stale 比对（防并发/重试错位）用。
+const normBlock = (t) =>
+  (t || "")
+    .split("\n")
+    .map((l) => l.trim().replace(/\s+/g, " "))
+    .filter((l) => l)
+    .join("\n")
+    .toLowerCase();
+
+const SECTION_RE = /^##\s+(.+?)\s*$/;
+
+// 解析 `## ` 章节。返回 { head: string[], sections: [{ title, lines }] }；
+// lines 含标题行本体；`#` 文件标题、前言与 `<!--` 注释归 head；`###` 及更深归当前章节。
+export function parseSections(md) {
+  const lines = (md || "").split("\n");
+  const head = [];
+  const sections = [];
+  let cur = null;
+  for (const line of lines) {
+    const m = SECTION_RE.exec(line);
+    if (m) {
+      cur = { title: m[1].trim(), lines: [line] };
+      sections.push(cur);
+      continue;
+    }
+    if (cur) cur.lines.push(line);
+    else head.push(line);
+  }
+  return { head, sections };
+}
+
+// 在 md 中定位章节，返回 { start, end, lines }（end 为下一章节起点或文件尾，不含）。
+// 未命中返回 null。供内部函数与 hybrid/tools.mjs（memory_update_section 的 stale 校验）共用。
+export function locateSection(md, section) {
+  const lines = (md || "").split("\n");
+  const want = normTitle(section);
+  if (!want) return null;
+  let start = -1;
+  for (let i = 0; i < lines.length; i++) {
+    const m = SECTION_RE.exec(lines[i]);
+    if (m && normTitle(m[1]) === want) {
+      start = i;
+      break;
+    }
+  }
+  if (start < 0) return null;
+  let end = lines.length;
+  for (let j = start + 1; j < lines.length; j++) {
+    if (SECTION_RE.test(lines[j])) {
+      end = j;
+      break;
+    }
+  }
+  return { start, end, lines };
+}
+
+// 章节内追加条目。章节存在 → 内容最后一个非空行后插入 `- entry`（全空行则插在标题行后）；
+// 章节不存在 → { ok:false, reason:"section-miss" }（调用方决定是否走新增）。
+// entry 写入前剥除行首列表符（`- `/`* `/`-`/`*`，含缩进）——LLM 常按描述示例自带 `- ` 前缀，
+// 不剥会导致 `- - xxx` 双列表符脏数据（v1.6.0 实装踩坑）。
+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 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") };
+}
+
+// 章节追加（upsert 语义）：存在则追加，不存在则文件尾新增章节。日志 ops 的 "append" 与
+// memory_write 工具共用——"不要强行匹配现有章节，不符合章节标题就走新增"。
+export function upsertSectionText(md, section, entry) {
+  const r = appendToSectionText(md, section, entry);
+  if (r.ok) return r;
+  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 text = base ? `${base}\n\n${title}\n${entryLine}\n` : `${title}\n${entryLine}\n`;
+  return { ok: true, reason: "section-created", text };
+}
+
+// 显式新建章节（与 upsert 的区别：章节已存在时拒绝而非追加）——子 agent 日志 ops 的
+// "new_section" 专用，防止模型把该走 append 的操作误标为 new_section 造成静默混写。
+export function createSectionText(md, section, entry) {
+  if (locateSection(md, section)) return { ok: false, reason: "section-exists" };
+  return upsertSectionText(md, section, entry);
+}
+
+// 整章节精确替换（stale 防护）：oldSectionText 与当前章节全文（含标题行，归一化后）必须完全
+// 一致才执行替换，否则拒绝并回显当前实际内容（供 agent 重读后再试）。newSectionText 原样落盘
+// （模型负责含 `## 标题` 与删除线标记）；匹配/拒绝的归一化对首尾空行不敏感。
+export function replaceSectionText(md, section, oldSectionText, newSectionText) {
+  const newText = String(newSectionText ?? "").trim();
+  if (!newText) return { ok: false, reason: "empty-replacement" };
+  const loc = locateSection(md, section);
+  if (!loc) return { ok: false, reason: "section-miss" };
+  const { start, end, lines } = loc;
+  const current = lines.slice(start, end).join("\n").trim();
+  if (normBlock(current) !== normBlock(String(oldSectionText ?? ""))) {
+    return { ok: false, reason: "conflict", actual: current };
+  }
+  // 保留章节末尾的分隔空行（章节与下一章节之间通常有空行，整块替换时不能吞掉，
+  // 否则下一章节标题会紧贴上一章节最后一条目）。
+  const hasTrailingBlank = end > start && !lines[end - 1].trim();
+  const spliceEnd = hasTrailingBlank ? end - 1 : end;
+  lines.splice(start, spliceEnd - start, ...newText.split("\n"));
+  return { ok: true, reason: "replaced", text: lines.join("\n") };
+}
+
+// 章节内标记删除（墓碑，不物理删除）：命中行改写为删除线格式；已删除线 → already；
+// 结构行（# / <!--）与已删除线条目永不被改写；章节未命中 / 行未命中分别上报。
+// 删除线格式：保留原列表符（`- text` → `- ~~text~~`；无列表符 → `~~text~~`）。
+export function markEntryDeletedText(md, section, entryOldText) {
+  const want = normLineLoose(entryOldText);
+  if (!want) return { ok: false, reason: "empty-entry" };
+  const loc = locateSection(md, section);
+  if (!loc) return { ok: false, reason: "section-miss" };
+  const { start, end, lines } = loc;
+  for (let i = start + 1; i < end; i++) {
+    const raw = lines[i];
+    const trimmed = raw.trim();
+    if (!trimmed || isStructuralLine(trimmed)) continue;
+    if (/^(-\s+)?~~[\s\S]+~~$/.test(trimmed)) {
+      if (normLineLoose(trimmed) === want) return { ok: true, reason: "already", text: md };
+      continue;
+    }
+    if (normLineLoose(trimmed) !== want) continue;
+    const struck = /^-\s+/.test(trimmed)
+      ? trimmed.replace(/^(-\s+)([\s\S]+)$/, "$1~~$2~~")
+      : `~~${trimmed}~~`;
+    lines[i] = raw.replace(trimmed, struck);
+    return { ok: true, reason: "marked", text: lines.join("\n") };
+  }
+  return { ok: false, reason: "entry-miss" };
+}
+
+// 宽松行归一化：剥列表符与删除线包裹、合空白、转小写。标删比对专用（与 text.mjs normLine
+// 语义相近但多剥一层 ~~，避免"已标删行"永远无法二次匹配）。
+function normLineLoose(s) {
+  return (s || "")
+    .trim()
+    .replace(/^-\s+/, "")
+    .replace(/^~~([\s\S]+)~~$/, "$1")
+    .replace(/\s+/g, " ")
+    .toLowerCase();
+}
+
+function isStructuralLine(t) {
+  return t.startsWith("#") || t.startsWith("<!--");
+}

package/lib/common/text.mjs

@@ -33,7 +33,7 @@ export function expandHome(p) {
 }
 
 // 反向简写：home 下的绝对路径 → ~ 简写（统一正斜杠）。AI 转述绝对路径极易拼错
-// （实测出现过 lovezi0.deepseek-harness 缺分隔符），一律喂给它 ~ 简写。
+// （实测出现过缺分隔符，如 ~/.deepseek-harness 被拼成 ~.deepseek-harness），一律喂给它 ~ 简写。
 export function toHomeShort(p) {
   if (!p) return p;
   const h = homedir();
@@ -54,13 +54,59 @@ export function readMdSync(path) {
   }
 }
 
-// v1.2.0 预算截断：注入 system prompt 时按字符上限截断（保留头部 + 截断标记）。
-// budget <= 0 / 未配置视为不限。userBudgetChars / workspaceBudgetChars 在 text() 注入路径生效，
-// 修复 v1.1.x 之前两配置为死配置的问题（与 README「注入系统提示词的长度上限」语义对齐）。
+// v1.4.1 重写：修 LIFO/FIFO 错配（旧实现 slice(0, budget) 只留头部，而写入追加在尾部——
+// 最新结论永远进不了注入视野，"写了等于没写"）。新策略：保留全部结构行（# / <!--）+
+// 从尾部向前累积内容行至预算用尽，中间以截断标记衔接。budget <= 0 / 未配置视为不限。
 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} 字符）`;
+  const lines = text.split("\n");
+  const head = [];
+  let i = 0;
+  // 头部连续结构行（文件标题/注释区）与空行无条件保留
+  while (i < lines.length && (!lines[i].trim() || isStructural(lines[i].trim()))) {
+    head.push(lines[i]);
+    i++;
+  }
+  // 尾部向前累积内容行至预算用尽
+  const tail = [];
+  let used = 0;
+  let j = lines.length - 1;
+  while (j >= i && used < budget) {
+    const cost = lines[j].length + 1;
+    if (used + cost > budget && tail.length > 0) break;
+    tail.unshift(lines[j]);
+    used += cost;
+    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.4.1：剥除行首 `[smart]` 标记（含重复），保留列表符与其余内容。用于注入与回喂的读侧——
+// 模型全程不可见该标签（写侧 v1.4.1 起不再拼接），存量磁盘条目自然消亡、无需迁移。
+// 逐行处理：允许行首有 `N|` 计数前缀（readNumberedMemory 的回喂格式）与列表符，
+// 只剥「列表符/行首之后紧跟的 [smart] 标记序列」；正文中间的 "smart" 字样不误伤。
+export function stripSmartTag(text) {
+  if (!text) return text;
+  return text
+    .split("\n")
+    .map((line) =>
+      line.replace(/^(\s*(?:\d+\|)?\s*[-*]\s+|\s*(?:\d+\|)\s*)?(\[smart\]\s*)+/, "$1"),
+    )
+    .join("\n");
+}
+
+// v1.6.0：注入侧删除线过滤——整行都是删除线墓碑（`~~...~~`，可带 `- ` 列表符）的条目
+// 视为已作废，注入 system prompt 时剔除（省 token、防模型把墓碑当现行有效）；
+// 行内局部删除线（`- 旧名 ~~原名~~` 之类）不是墓碑，不滤。文件本体保留墓碑供审计。
+export function stripDeletedLines(text) {
+  if (!text) return text;
+  return text
+    .split("\n")
+    .filter((line) => !/^\s*(?:-\s+)?~~[\s\S]+~~\s*$/.test(line))
+    .join("\n");
 }
 
 // 行归一化：去掉 `- `/`* ` 前缀、合并空白、转小写，使"带不带前缀"的子串匹配都鲁棒。

package/lib/distill.mjs

@@ -4,7 +4,7 @@ import { mkdir, unlink, writeFile, rename } from "node:fs/promises";
 import { join, dirname } from "node:path";
 import { BlockAssembler, createUserMessage } from "@deepseek-ai/dsh-llm";
 import { SUMMARY_PROMPT, DISTILL_PROMPT } from "./common/prompts.mjs";
-import { expandHome, readMdSync, toHomeShort, nowStamp } from "./common/text.mjs";
+import { expandHome, readMdSync, toHomeShort, nowStamp, stripSmartTag } from "./common/text.mjs";
 import { appendLineDedup, readNumberedMemory, applyMemoryOp } from "./common/records.mjs";
 import { runWithRetry, RETRY_CONSTANTS } from "./common/retry.mjs";
 
@@ -239,9 +239,12 @@ export function createDistill({ ctx, getConfig, paths, records, state }) {
     }
     for (const d of durable) {
       if (!d || typeof d !== "object") continue;
-      const fact = String(d.fact ?? "").trim();
+      let fact = String(d.fact ?? "").trim();
       if (!fact) continue;
-      const line = `- [smart] ${fact}`;
+      // v1.4.1：写侧不再拼接 [smart] 标签（防回喂二次拼接形成 [smart] [smart] 双前缀、
+      // 防标签注意力稀释）；防御性剥除 LLM 自行带回的标签，保证落盘条目干净。
+      fact = stripSmartTag(fact).trim();
+      const line = `- ${fact}`;
       if (d.scope === "user") {
         await appendLineDedup(expandHome(c.userMemoryPath), line).catch(() => {});
       } else {

package/lib/hybrid/index.mjs

@@ -0,0 +1,18 @@
+// memory-palace v1.6.0 hybrid 模式：模块入口（装配）。
+// 仅在 memoryMode === "hybrid" 时由 index.mjs 调用 registerHybrid（memoryMode 切换需重启
+// dsh——注册时机安全）。不注册任何 DSH 全局资源以外的东西；runMemorySubagent 由 index.mjs
+// 的 _settle hybrid 分支每轮调用。
+import { runMemorySubagent } from "./subagent.mjs";
+import { registerHybridTools, attachHybridGuards } from "./tools.mjs";
+
+export { HYBRID_PROACTIVE } from "./prompts.mjs";
+
+/**
+ * @param {{ ctx: object, getConfig: () => object, paths: object, records: object, state: object }} deps
+ * @returns {{ runMemorySubagent: Function }}
+ */
+export function registerHybrid({ ctx, getConfig, paths, records, state }) {
+  registerHybridTools({ ctx, getConfig, paths, records, state });
+  attachHybridGuards(ctx, getConfig, paths, state);
+  return { runMemorySubagent };
+}

package/lib/hybrid/prompts.mjs

@@ -0,0 +1,42 @@
+// memory-palace v1.6.0 hybrid 模式提示词：注入段二（HYBRID_PROACTIVE）+ 记忆子 agent
+// system prompt（SUBAGENT_SYSTEM）。纯常量，无状态。
+//
+// 定案锚点（爹 2026-08-30 拍板）：
+// - 日志由子 agent 每轮自动维护，agent 无需重复记录过程性信息；
+// - MEMORY.md 写入权归还 agent（主动调工具、章节化格式）；
+// - 项目级全量重整双门禁（超预算 + 冷却 ≥7 天，机器校验），用户级禁止重整；
+// - 操作规范写在工具 description（定案 #11），本文件只做方向性引导，不堆格式细节。
+
+// hybrid 模式注入 system prompt 的段二（替换 plugin 的记忆公民指令 / smart 的"无需主动"说明）。
+export const HYBRID_PROACTIVE =
+  "\n\n[记忆说明] 分工如下：\n" +
+  "① 每轮结束由记忆子代理自动提炼摘要写入今日工作日志（含去重：重复/过时条目会以删除线标记），你无需调用工具记录过程性信息，也无需复述日志内容。\n" +
+  "② 长期记忆 MEMORY.md（项目级与用户级）由你主动维护：完成任务、关键决策、踩坑修复、用户偏好等 durable 事实，用 memory_write 追加（章节不存在会自动新建）；过时内容用 memory_update_section 整章节精确替换或标删，绝不手写覆盖记忆文件。\n" +
+  "③ 项目级 MEMORY.md 仅在「超出注入预算 且 距上次重整 ≥ 重整冷却期」两条件同时满足时，才可调用 memory_reorganize 全量重整；重整前先读日志与现有记忆对照，切勿丢失关键信息。不满足条件时只能用 memory_update_section 做章节级修正。\n" +
+  "④ 用户级 MEMORY.md 禁止全量重整，只允许增量写入与整章节精确替换。";
+
+// 记忆子 agent system prompt（turn/end 触发，判定 + 产出一体）。
+// {date} 注入今日日期；回喂正文见 subagent.mjs 的首轮 user 消息。
+export function SUBAGENT_SYSTEM() {
+  return (
+    "你是记忆子代理，负责把本轮对话沉淀进【今日工作日志】（Markdown 文件，按 `## 章节` + `- 条目` 组织）。\n" +
+    "\n" +
+    "【判定（第一优先）】先判断本轮对话是否包含值得写入日志的实质内容：完成了任务、修了 bug、做了决策、得出结论、用户表达了偏好或约束。\n" +
+    "- 无重点（闲聊、寒暄、一句话问答、无任何可沉淀信息）：直接输出一行纯文本说明，不调用任何工具，立即结束。\n" +
+    "- 有重点：通过工具把格式化摘要写入日志，然后输出一行简短确认，结束。\n" +
+    "\n" +
+    "【日志写入规则（严格）】\n" +
+    "1. 只能通过 log_write_ops 工具写入，每次可批量提交多个操作；禁止请求重写整个文件。\n" +
+    "2. 三种操作：\n" +
+    "   - append：章节存在则在其末尾追加条目，不存在则自动新增章节（不要强行匹配现有章节，语义确实不符就走新章节名）；\n" +
+    "   - new_section：显式新建章节并写入首条条目（若章节已存在会被拒绝，此时改用 append）；\n" +
+    "   - mark_delete：把日志中重复、过时或被本轮推翻的旧条目标记删除（删除线墓碑，非物理删除）。oldText 必须是日志中该条目的原文（可含或不含 `- ` 前缀），逐行匹配，匹配失败会被拒绝。\n" +
+    "3. 去重是你的职责：回喂的今日日志中已存在的结论禁止再次追加；发现语义重复或相互矛盾的旧条目，用 mark_delete 标记其中过时的一条（保留更完整/更新的那条）。\n" +
+    "4. 条目格式：一行一条、以结论开头、带关键细节（命令/路径/数字），客观第三人称，禁止对话体、请示、内心独白；禁止输出 [smart] 等任何标签。【entry 一律不带列表符（`- `/`* `）——插件写入时会自动补齐，你带了会变成双列表符脏数据】\n" +
+    "5. 章节名用简短的中文主题词（如 `## 环境必知`、`## 渠道映射排查`），宁多章节少混杂。\n" +
+    "6. 今日日志为空（新的一天）时直接用 append/new_section 建章节写入即可。\n" +
+    "7. 需要读取日志章节（目录模式回喂时）用 log_read_section；需要多个章节时务必在单次调用中把 sections 数组全部传齐，避免多轮往返浪费轮次。\n" +
+    "\n" +
+    "【输出】全程只做上述两件事：要么纯文本收尾，要么调工具写日志后收尾。不要向用户提问，不要输出多余解释。"
+  );
+}