dsh-memory-palace 1.6.3 → 1.7.0

package/README.md

@@ -2,22 +2,22 @@
 
 把 WorkBuddy 的文件式记忆系统移植进 [DeepSeek Harness](https://www.deepseek.com/harness/) —— 为 Harness 提供**跨会话持久化、人类可直接编辑的 Markdown 记忆**。
 
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE) [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com) [![npm](https://img.shields.io/npm/v/dsh-memory-palace.svg?label=npm&color=CB3837&labelColor=4D6BFE)](https://www.npmjs.com/package/dsh-memory-palace) [![DeepSeek Harness:0.1.2-rc.1](https://img.shields.io/badge/DeepSeek%20Harness-0.1.2--rc.1-success.svg?labelColor=4D6BFE)](https://github.com/deepseek-ai/deepseek-harness)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE) [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com) [![npm](https://img.shields.io/npm/v/dsh-memory-palace.svg?label=npm&labelColor=000000&color=ff4b01)](https://www.npmjs.com/package/dsh-memory-palace) [![DeepSeek Harness:0.1.2-rc.1](https://img.shields.io/badge/DeepSeek%20Harness-0.1.2--rc.1-success.svg?labelColor=4D6BFE)](https://github.com/deepseek-ai/deepseek-harness)
 
 ## 特性
 
-- **人类可读的真源**：记忆全部存储在 Markdown 文件中（`MEMORY.md` + 每日日志 `YYYY-MM-DD.md`），任何编辑器可直接修改，数据永远属于你。
-- **双层记忆**：用户级（跨项目个人偏好，默认 `~/.deepseek-harness/MEMORY.md`）+ 工作区级（项目约定，默认 `<cwd>/.deepseek-harness/memory/`）。
-- **日志迁移**：超过保留天数（默认 30 天）的每日日志自动迁移进 `MEMORY.md` 后删除，长期记忆持续沉淀。
-- **WorkBuddy / CodeBuddy 桥接**：项目已存在 `.workbuddy/memory` 或 `.codebuddy/memory` 时直接读写这些目录，无需重复维护记忆。
-- **记忆工具**：`memory_note`（项目级写入）、`memory_note_user`（用户级写入）、`memory_read`（聚合读取）、`memory_delete`（按内容删除，两阶段确认），全部内置去重，防止重复追加。
-- **会话标题栏「记忆」按钮**：支持手动蒸馏：①蒸馏会话 / ②蒸馏项目记忆。
-- **设置页集成**：DSH 设置中内置「记忆」面板（中英双语），所有配置均可图形化调整，无需改配置文件。
-- **主动记忆（主路径，插件模式）**：注入「记忆公民指令」引导 agent 在「修复 bug/根因+绕过」「验证 build/test 通过」「完成里程碑/关键决策」「用户表达偏好/约束」时主动调 `memory_note` / `memory_note_user` 落档 — 对标 WorkBuddy 的"智能记一笔"手感。
-- **智能模式（LLM 智能会话摘要）**：智能模式下，每轮命中防闲聊闸门后由 harness 把本会话**新增对话增量**（按 session 事件 seq 断点）提炼成摘要——`summary` 写每日日志 + durable 事实写 MEMORY.md。
-- **记忆注入**：记忆块仅在会话**首次**构建时注入（DSH 会话自身继承历史轮次，逐轮注入冗余且有过时断言干扰）；发生上下文压缩（compaction）后自动重注。
-- **混合模式（子Agent+主Agent混合处理 🔥推荐）**：记忆子代理在每轮 turn/end 自动把本轮摘要写入**今日工作日志**（章节化组织、回喂今日日志做增量去重、重复/过时条目标删除线墓碑）；MEMORY.md 写入权归还 agent（`memory_write` 章节化追加 / `memory_update_section` 整章节精确替换 / 双门禁内 `memory_reorganize` 全量重整）。
-- **标准 npm 插件包**：经 `dsh plugin` 一键装入 profile，`cordis.patch.yml` 声明 bundle patch，零手动改动 harness。
+- **人类可读的真源**：记忆以纯 Markdown 存储，任何编辑器都能直接修改，数据始终属于你。
+- **双层记忆**：用户级（跨项目个人偏好）+ 工作区级（项目约定），互不干扰。
+- **日志自动沉淀**：超过保留期的每日日志自动并入长期记忆，结论不丢。
+- **WorkBuddy / CodeBuddy 桥接**：项目已有对应记忆目录时直接读写，无需重复维护。
+- **记忆工具**：AI 可主动写入、聚合读取、按内容删除（删除需人工确认），写入自带去重。
+- **手动蒸馏**：会话标题栏一键把当前对话或项目记忆提炼成长期记忆。
+- **设置页集成**：全部配置均可在 DSH 设置面板中图形化调整，无需改配置文件。
+- **主动记忆（插件模式）**：以指令引导 AI 在完成任务、修复问题、确定决策、获知偏好时主动落档。
+- **智能模式**：由模型自动提炼每轮新增内容，摘要进日志、长期事实进记忆。
+- **记忆注入**：长期记忆全程常驻、每个步骤都可见；今日日志按轮次注入，避免上下文膨胀。
+- **混合模式（🔥推荐）**：子代理每轮自动整理日志并去重，长期记忆由主 AI 主动维护，兼顾自动化与可控性。
+- **标准插件包**：经官方插件机制一键安装，无需改动 harness。
 
 ## 记忆文件布局
 
@@ -26,11 +26,11 @@
 └── MEMORY.md                      # 用户级记忆（跨项目个人偏好）
 
 <项目根>/
-├── .workbuddy/memory/             # 桥接 WorkBuddy 记忆（已存在时，按序优先）
+├── .workbuddy/memory/             # 桥接 WorkBuddy 记忆（存在时优先写入）
 │   ├── MEMORY.md                  # 项目级约定（buddy 目录保持嵌套，兼容 WB/CB 原生格式）
 │   └── 2026-08-16.md              # 每日工作日志
-├── .codebuddy/memory/             # 桥接 CodeBuddy 记忆（已存在时，结构同 .workbuddy）
-└── .deepseek-harness/             # 回退目录（无 buddy 目录时自动创建）
+├── .codebuddy/memory/             # 桥接 CodeBuddy 记忆（存在时，结构同 .workbuddy）
+└── .deepseek-harness/             # dsh 原生目录（读取恒在首位；无 buddy 时作为写入目标创建）
     ├── MEMORY.md                  # 项目级约定（长期记忆，与 memory/ 同级）
     └── memory/
         └── 2026-08-16.md          # 每日工作日志
@@ -38,26 +38,25 @@
 
 ## 工作原理
 
-**读取（每轮对话）**——`systemPrompt.section` 同步读盘，把以下内容拼进系统提示词：
+**读取（每轮对话）**——两条通道并行：
 
 ```
-用户级 MEMORY.md
-+ 工作区 MEMORY.md
-+ 今日日志 YYYY-MM-DD.md
-→ 注入 system prompt，让 AI 跨会话保持一致
+① 长期记忆：全程常驻，每个步骤都可见；内容未变只写一次，压缩后自动重注
+② 今日日志：随系统提示词按轮次注入（高频变化，不进对话历史以免膨胀）
 ```
 
-**写入（每轮结束）**——监听 `session/event` 的 `turn/end`，经「防闲聊闸门」判定后异步追加：
+**写入（每轮结束）**——经「防闲聊闸门」判定后异步追加：
 
 ```
-turn/end ──► 轻量兜底闸门
-         │     有工具调用 / 有错误 / agent 主动记 / 命中偏好·决策关键词 → 放行
-         │     否则：跳过（不写、不调 LLM）
-         ├─► 轻量条目写入 YYYY-MM-DD.md（全部目标目录；可关）
-         ├─► 若本轮出错且开启「对话出错自动记录」→ 「错误现象」写入对应 MEMORY.md
-         └─► prune：超过 dailyLogRetentionDays 的日志蒸馏进 MEMORY.md 后删除
+本轮结束 ──► 闸门：有工具调用 / 有错误 / AI 主动记 / 命中偏好·决策关键词 → 放行
+         │      否则跳过（不写、不调模型）
+         ├─► 摘要写入今日日志
+         ├─► 出错且开启「自动记录错误」→ 错误现象写入长期记忆
+         └─► 超期日志并入长期记忆后删除
 ```
 
+日志文件头统一为日期标题，写入时自动补齐（历史文件不回填）。
+
 **工具**——AI 在对话中按需调用：
 
 | 工具 | 层级 | 作用 |
@@ -78,7 +77,7 @@ turn/end ──► 轻量兜底闸门
 
 ```bash
 dsh plugin --profile web add github:lovezi0/dsh-memory-palace
-# 锁定版本：dsh plugin --profile web add github:lovezi0/dsh-memory-palace#v1.6.3
+# 锁定版本：dsh plugin --profile web add github:lovezi0/dsh-memory-palace#v1.7.0
 ```
 
 方式二：clone 后本地安装（开发 / 修改源码场景）
@@ -119,6 +118,12 @@ dsh plugin --profile web remove dsh-memory-palace
 
 ## 版本历史
 
+- **1.7.0**
+    - **1.7.0.alpha.1**
+        - 🔥新增独立通道注入记忆文件
+        - 🐛修复存在多种记忆路径时读取冲突的问题
+        - 💪优化记忆子 agent 投影消息节省 token
+        - 💪优化 SUBAGENT_SYSTEM 记忆输出格式
 - **1.6.3**
     - npm publish
     - **1.6.3.alpha.4**

package/lib/common/paths.mjs

@@ -20,17 +20,23 @@ export function createPaths(getConfig, getCwd = () => null) {
       .map((rel) => join(cwd, rel))
       .filter((d) => existsSync(d));
   }
-  // 读取源：存在 buddy 目录则用它们；否则仅当 legacy dsh 目录已存在才读（不创建）。
+  // 读取源：dsh 原生目录恒在首位（不设 existsSync 门槛——即便每日日志目录尚未创建，
+  // 也要能读到同级的 .deepseek-harness/MEMORY.md），其后叠加磁盘上已存在的 buddy 目录。
+  // v1.7.0 修复：旧实现是「目录级排他」——buddyDirs() 命中即 return b，导致项目同时存在
+  // .workbuddy/memory（哪怕只有日志、无 MEMORY.md）时，.deepseek-harness/MEMORY.md 既读不到
+  // 也写不进、长期静默失效。现改为「dsh 优先 + buddy 叠加」，两者都可被读到。
+  // 顺序定义：[.deepseek-harness > .workbuddy > .codebuddy]
   function readDirs(cwd = activeCwd()) {
     const c = cfg();
     if (!c.enabled) return [];
-    const b = buddyDirs(cwd);
-    if (b.length) return b;
+    const out = [];
     const d = cwd ? join(cwd, c.workspaceMemoryDir) : null;
-    // 不设 existsSync 门槛：即便每日日志目录尚未创建，也要能读到同级的 .deepseek-harness/MEMORY.md
-    return d ? [d] : [];
+    if (d) out.push(d);
+    out.push(...buddyDirs(cwd));
+    return out;
   }
   // 写入目标：存在 buddy 目录则全部同步写入；否则回退 dsh 目录（按需创建）。
+  // 写入优先级保持 buddy 优先不变（读 dsh 优先 / 写 buddy 优先，读写刻意不对称）。
   function writeDirs(cwd = activeCwd()) {
     const c = cfg();
     if (!c.enabled) return [];

package/lib/common/prompts.mjs

@@ -42,7 +42,7 @@ export function SUMMARY_PROMPT({ allowDelete = false, outputBudget } = {}) {
   );
 }
 
-// v1.2.0 项目记忆蒸馏 prompt（固化自 upgrade plan/v1.2.0/记忆蒸馏Prompt.md，供按钮「蒸馏项目记忆」稳定调用）。
+// 项目记忆蒸馏 prompt（供按钮「蒸馏项目记忆」稳定调用）。
 // 用法：system = 本 prompt，user = 项目 MEMORY.md 全文，输出 = 精炼后的项目记忆（直接覆盖写回）。
 export function DISTILL_PROMPT({ outputBudget } = {}) {
   return (

package/lib/common/sections.mjs

@@ -21,6 +21,20 @@ const normBlock = (t) =>
 
 const SECTION_RE = /^##\s+(.+?)\s*$/;
 
+// v1.7.0 特性4：确保每日日志有规范文件头 `# YYYY-MM-DD`。
+// 现状有三种形态（实测）：①正常 `# 2026-09-08`；②首行空；③直接以 `## 章节` 开头（无文件头）。
+// 本函数幂等：已有当日标题则原样返回；否则在文件头补一行标题 + 空行。
+// 只在【写入时】调用（不回填历史文件），故存量日志可能新旧混存——可接受。
+export function ensureLogHeader(md, date) {
+  const title = `# ${date}`;
+  const text = md || "";
+  const lines = text.split("\n");
+  // 已存在同日标题（不限首行，容忍前置空行）→ 不动
+  if (lines.some((l) => l.trim() === title)) return text;
+  const body = text.replace(/^\s+/, "");
+  return body ? `${title}\n\n${body}` : `${title}\n`;
+}
+
 // 解析 `## ` 章节。返回 { head: string[], sections: [{ title, lines }] }；
 // lines 含标题行本体；`#` 文件标题、前言与 `<!--` 注释归 head；`###` 及更深归当前章节。
 export function parseSections(md) {

package/lib/hybrid/prompts.mjs

@@ -1,7 +1,7 @@
 // memory-palace v1.6.0 hybrid 模式提示词：注入段二（HYBRID_PROACTIVE）+ 记忆子 agent
 // system prompt（SUBAGENT_SYSTEM）。纯常量，无状态。
 //
-// 定案锚点（爹 2026-08-30 拍板）：
+// 定案锚点：
 // - 日志由子 agent 每轮自动维护，agent 无需重复记录过程性信息；
 // - MEMORY.md 写入权归还 agent（主动调工具、章节化格式）；
 // - 项目级全量重整双门禁（超预算 + 冷却 ≥7 天，机器校验），用户级禁止重整；
@@ -17,6 +17,9 @@ export const HYBRID_PROACTIVE =
 
 // 记忆子 agent system prompt（turn/end 触发，判定 + 产出一体）。
 // {date} 注入今日日期；回喂正文见 subagent.mjs 的首轮 user 消息。
+// v1.7.0 特性4：新增【格式规范】段（7 正 + 3 反）——旧产物是"一堵墙"（单章节 + 零嵌套 +
+// 零加粗 + 200 字长句），可读性差。格式细节写进 prompt 是因为 log_write_ops 的 entry 是
+// 任意字符串（支持多行），缩进/加粗全靠模型自己写，机器侧不代劳。
 export function SUBAGENT_SYSTEM() {
   return (
     "你是记忆子代理，负责把本轮对话沉淀进【今日工作日志】（Markdown 文件，按 `## 章节` + `- 条目` 组织）。\n" +
@@ -37,6 +40,20 @@ export function SUBAGENT_SYSTEM() {
     "6. 今日日志为空（新的一天）时直接用 append/new_section 建章节写入即可。\n" +
     "7. 需要读取日志章节（目录模式回喂时）用 log_read_section；需要多个章节时务必在单次调用中把 sections 数组全部传齐，避免多轮往返浪费轮次。\n" +
     "\n" +
+    "【格式规范（必须遵守）】\n" +
+    "正面规则：\n" +
+    "1. 文件头由插件自动维护（`# YYYY-MM-DD`），你不要写文件头，直接写 `## 章节`。\n" +
+    "2. 一个主题一个 `##` 章节，章节之间留一个空行；同一主题条目超过 3 条时再拆 `###` 小节。\n" +
+    "3. 一条只记一个事实，≤ 120 字；超长拆成 `- 父项` + 两个空格缩进的 `  - 子项`（缩进必须自己写，插件不会替你缩进）。\n" +
+    "4. 关键结论 / 决策 / 纠错用 `**加粗**`；重要约束在句末标 `（重要）`。\n" +
+    "5. 条目内可用行内分组：`**结论**：` / `**待办**：` / `**约束**：` / `**产出**：` / `**用户约定**：`。\n" +
+    "6. 允许用一句「用户意图/反馈」作语境，只一句；禁止流水账。\n" +
+    "7. 可复现的命令 / 脚本用三反引号代码块包裹。\n" +
+    "反模式（明确禁止）：\n" +
+    "- ❌ 「用户提出…我已改…产出文档…」式过程流水。\n" +
+    "- ❌ 自我过程表述（「我搜索了 A/B/C」）——除非结论依赖它。\n" +
+    "- ❌ 把 5 个结论塞进一条 200 字长句。\n" +
+    "\n" +
     "【输出】全程只做上述两件事：要么纯文本收尾，要么调工具写日志后收尾。不要向用户提问，不要输出多余解释。\n" +
     "\n" +
     "【环境边界】本环境不是代码执行环境，run_code 等工具均不存在；不要模仿上文出现过的任何工具调用，只能用 log_write_ops / log_read_section。"

package/lib/hybrid/subagent.mjs

@@ -11,7 +11,7 @@ import { join, dirname } from "node:path";
 import { BlockAssembler, createUserMessage, createToolResultMessage } from "@deepseek-ai/dsh-llm";
 import { todayISO, readMdSync } from "../common/text.mjs";
 import { eventsFrom } from "../common/session.mjs";
-import { appendToSectionText, upsertSectionText, createSectionText, markEntryDeletedText, parseSections, locateSection } from "../common/sections.mjs";
+import { appendToSectionText, upsertSectionText, createSectionText, markEntryDeletedText, parseSections, locateSection, ensureLogHeader } from "../common/sections.mjs";
 import { HYBRID_PROACTIVE, SUBAGENT_SYSTEM } from "./prompts.mjs";
 
 export { HYBRID_PROACTIVE };
@@ -69,12 +69,26 @@ async function streamTurn(ctx, params, timeoutMs) {
 
 // 把本轮 surface 事件投影为消息数组（seq >= fromSeq；与 distillSessionCore 同源逻辑）。
 // v1.6.2-alpha.4：eventsFrom 兼容层（宿主 0.1.2-alpha.4 删除 Session.events getter）。
-function projectTurnMessages(session, fromSeq) {
+// v1.7.0 特性3（投影去噪）：user 侧排除【注入类消息】，只留真实用户对话。
+// 旧实现只看事件类型不看 source，导致首轮 lastSummarizedSeq 较小时把 agent-instructions
+// baseline（AGENTS.md，可达 ~19k 字符）、system-prompt 快照、skill-catalog、以及本插件
+// 自己的 E 投影全部当成"本轮对话"喂给子 agent（污染日志 + 白烧 token）。
+// 判定用【黑名单】而非白名单（fail-open）：source 存在且非 'user' 才排除——
+// 注入类消息（agent-instructions / plugin / skill-catalog / skill-invocation …）在 DSH 中
+// 必带 source.kind，故排除效果与白名单等价；而 source 缺失时保留，避免误丢真实用户请求
+// 导致子 agent 空转（与 index.mjs 的 turnBuffer 采集口径保持一致）。
+// assistant/message 与 tool/result 原样保留。
+// 导出供单测直接断言（tests/test-v1.7.0.mjs），运行时仍只在 runMemorySubagent 内调用。
+export function projectTurnMessages(session, fromSeq) {
   const hist = [];
   for (const e of eventsFrom(session, fromSeq)) {
     if (!SURFACE.has(e.type)) continue;
     const m = session.deriveEventMessage ? session.deriveEventMessage(e) : null;
-    if (m) hist.push(m);
+    if (!m) continue;
+    // deriveEventMessage 对 user/message 直接返回 event.data（含 source），故此处可安全读取。
+    const srcKind = m.source?.kind;
+    if (e.type === "user/message" && srcKind && srcKind !== "user") continue;
+    hist.push(m);
   }
   return hist;
 }
@@ -205,9 +219,12 @@ function applyLogOps(logFiles, dateStr, ops) {
         md = readFileSync(file, "utf8");
       } catch { /* 文件尚不存在 */ }
       const { cur, results } = apply(md);
-      if (cur !== md) {
+      // v1.7.0 特性4：落盘前确保文件头为规范 `# YYYY-MM-DD`（空文件/首行空/直接以 ## 开头
+      // 三种形态都会补上；已有同日标题则原样）。仅在写入时补齐，不回填历史文件。
+      const withHeader = ensureLogHeader(cur, dateStr);
+      if (withHeader !== md) {
         await mkdir(dirname(file), { recursive: true });
-        await writeFile(file, cur, "utf8");
+        await writeFile(file, withHeader, "utf8");
       }
       all.push(...results);
     }

package/lib/index.js

@@ -26,7 +26,7 @@ import { join } from "node:path";
 import Schema from "@deepseek-ai/schemastery";
 // v1.6.0-rc1：适配 DSH 0.1.2-alpha.2——dsh-settings 不再导出自由函数 installSettingsSection /
 // settingsNamespace，设置节注册改用 SettingsProvider 实例方法 installSection（经 ctx.inject(["settings"])）。
-import { todayISO, expandHome, toHomeShort, readMdSync, budgetClip, stripSmartTag, stripDeletedLines, extractText, extractToolErrorText } from "./common/text.mjs";
+import { todayISO, toHomeShort, readMdSync, budgetClip, stripSmartTag, stripDeletedLines, extractText, extractToolErrorText } from "./common/text.mjs";
 import { SCENE_KEYWORDS } from "./common/prompts.mjs";
 import { createPaths } from "./common/paths.mjs";
 import { createRecords } from "./common/records.mjs";
@@ -35,6 +35,7 @@ import { createDistill } from "./distill.mjs";
 import { registerTools } from "./tools.mjs";
 import { registerApi } from "./api.mjs";
 import { registerHybrid, HYBRID_PROACTIVE } from "./hybrid/index.mjs";
+import { registerProjection } from "./projection.mjs";
 
 export const name = "memory-palace";
 // v1.6.0-rc1：settingsNamespace() 已删除，namespace 直接用字符串（宿主侧做类型级校验）。
@@ -125,9 +126,8 @@ export function apply(ctx, config) {
     lastSummarizedSeq: -1,    // 智能模式增量摘要断点（session 事件 seq）
     summarySessionId: null,
     planModeActive: false,    // 计划模式：禁写记忆（硬编码默认，无开关；仅经 session/event 的 plan/mode 翻转；未装 dsh-plan-mode 永不触发=不拦截）
-    // v1.4.1：已注入记忆的 session 集合——仅首次注入（DSH 会话自身继承历史轮次，逐轮注入
-    // = 内容重复 + 过时断言每轮在场）；compaction 发生后清除对应 id，下次构建重注。
-    injectedSessionIds: new Set(),
+    // v1.7.0：injectedSessionIds 已删除——记忆正文改经 E 投影（src/projection.mjs）注入为
+    // 常驻消息，compaction 后由投影自动重注，不再需要"仅首次注入"的会话级标记。
   };
   const TURN_BUFFER_MAX = 30;
   // v1.1.3：字符上限提升到 30k（长工具型 request 的工具结果动辄数千字符，6k 上限会触发
@@ -149,6 +149,9 @@ export function apply(ctx, config) {
   // 运行时分派靠 _settle / proactive 的热 source() 判断；工具注册无副作用（plugin/smart
   // 的 prompt 不引导使用，guards 白名单只拦 hybrid 工具）。
   const hybrid = registerHybrid({ ctx, getConfig: () => source(), paths, records, state });
+  // v1.7.0 特性1：E 投影通道（记忆正文常驻注入）。与 hybrid 同理，无条件注册——
+  // 其内部读热配置，无副作用（enabled=false 时 buildProjections 返回空）。
+  registerProjection({ ctx, getConfig: () => source(), paths });
 
   // ---- session/event 跟踪：更新 activeCwd/activeSession/增量断点 + 累积 turnBuffer ----
   // 关键：一次用户请求在 dsh agent 循环里会被拆成多个 turn（每个工具调用一轮），
@@ -170,6 +173,15 @@ export function apply(ctx, config) {
       return;
     }
     if (type === "user/message" || type === "assistant/message" || type === "tool/result") {
+      // v1.7.0 特性1 连带修复：turnBuffer 只采集【真实用户消息】。
+      // E 投影的 user/message（source.kind === 'plugin'）也在 SURFACE 里，若不过滤会被
+      // 采集进 buffer，并触发下方 `type === "user/message" && state.turnBuffer.length` 的
+      // _flushTurn() —— 打乱 request 边界、污染关键词闸门（结算时取第一条 user 文本）。
+      // 判定用【黑名单】而非白名单（fail-open）：只在 source 明确存在且非 'user' 时排除。
+      // 理由：source 缺失时若按"非 user"丢弃，真实用户消息会被漏掉 → 闸门关闭 → 记忆整体
+      // 丢失（本项目历史上最严重的一类 bug）。注入类消息在 DSH 中必带 source，故放行风险极低。
+      const srcKind = event?.data?.source?.kind;
+      if (type === "user/message" && srcKind && srcKind !== "user") return;
       const text = extractText(event);
       if (text) {
         const role = type === "tool/result" ? "tool" : type === "user/message" ? "user" : "assistant";
@@ -194,48 +206,33 @@ export function apply(ctx, config) {
       // 不清空 buffer；用 debounce 在整段请求安静后结算一次。
       _scheduleSettle();
     } else if (type === "compaction" || type?.startsWith?.("compaction/")) {
-      // v1.4.1：compaction 压缩上下文后，记忆块可能被压掉——清除已注入标记，
-      // 下次 system prompt 构建时重注（压缩后上下文变薄，重注时机依然正确）。
-      if (session?.id) state.injectedSessionIds.delete(session.id);
+      // v1.7.0：无需再清"已注入标记"（该机制已删）——记忆正文改经 E 投影注入，
+      // compaction 把投影消息移出 surface 后，后续 step 的去重扫描找不到它 → 自动重注。
     }
   });
 
   // ---------- 读取：同步 section text（systemPrompt 要求同步） ----------
+  // v1.7.0：section 只保留「常量指令（intro）+ 今日工作日志」。
+  // 用户级 / 项目级 MEMORY.md 已移出 section，改由 E 投影（src/projection.mjs）承载为
+  // 常驻消息（每个 step 可见）。分流依据是「变化频率」：MEMORY.md 低频 durable → 投影；
+  // 今日日志高频易变 → 留 section 每步注入（不进历史以免膨胀）。
   ctx.systemPrompt.section({
     name: "memory-palace",
     order: 50,
     text: () => {
       const cfg = source();
       if (!cfg.enabled) return "";
-      const userFileResolved = expandHome(cfg.userMemoryPath);
-      const userFileShort = toHomeShort(userFileResolved);
       const blocks = [];
-      // v1.2.0：注入按预算截断——用户级 ≤ userBudgetChars、工作区级（MEMORY.md 与今日日志）
-      // 各自 ≤ workspaceBudgetChars。v1.4.1：budgetClip 改为"结构行 + 尾部最新条目"（修
-      // LIFO/FIFO 错配——写入追加在尾部，旧实现只留头部导致最新结论永远进不了视野），
-      // stripSmartTag 剥除行首 [smart] 标记（模型不可见该标签，存量自然消亡）。
-      // v1.6.0：stripDeletedLines 剔除整行删除线墓碑（文件保留、注入不过）。
-      const u = readMdSync(userFileResolved);
-      if (u) blocks.push(`# 用户级记忆 (${userFileShort})\n${stripSmartTag(stripDeletedLines(budgetClip(u, cfg.userBudgetChars)))}`);
+      // 今日工作日志：每 step 注入，预算 workspaceBudgetChars（与项目 MEMORY.md 同字段，
+      // 但各自独立 budgetClip 截断，互不挤占）。v1.4.1 的 budgetClip 已是"结构行 + 尾部最新"。
       for (const dir of paths.readDirs()) {
         const dirShort = toHomeShort(dir);
-        const w = paths.memoryReadCandidates(dir).map(readMdSync).filter(Boolean).join("\n\n");
-        if (w) blocks.push(`# 工作区记忆 (${dirShort})\n${stripSmartTag(stripDeletedLines(budgetClip(w, cfg.workspaceBudgetChars)))}`);
         const t = readMdSync(join(dir, `${todayISO()}.md`));
         if (t) blocks.push(`# 今日工作日志 (${todayISO()} @ ${dirShort})\n${stripSmartTag(stripDeletedLines(budgetClip(t, cfg.workspaceBudgetChars)))}`);
       }
-      // v1.4.1：仅首次注入。DSH 会话自身引用历史轮次作为上下文，逐轮注入 = 内容重复 +
-      // 过时断言每轮在场；记忆注入的价值大头在冷启动第一轮。已注入过的 session 返回
-      // 空串；compaction 后经 session/event 清除标记实现重注。
-      // intro 指令仍始终注入（无记忆时也不例外——否则 agent 不知道记忆系统存在，形成
-      // 「无记忆→无指令→永不记」死循环）；被跳过的只是记忆正文块。
-      const sessionId = state.activeSession?.id ?? null;
-      const alreadyInjected = sessionId ? state.injectedSessionIds.has(sessionId) : false;
-      if (sessionId && !alreadyInjected && blocks.length) state.injectedSessionIds.add(sessionId);
-      if (alreadyInjected) blocks.length = 0;
-      // 记忆正文可能为空（冷启动 / 全新环境尚无任何记忆）。
-      // 注意：intro（含记忆公民指令）必须【始终】注入——若因记忆为空而整体返回空串，
-      // agent 将不知道记忆系统存在、不会主动记，形成「无记忆 → 无指令 → 永不记」的死循环。
+      // v1.7.0：alreadyInjected / injectedSessionIds 已整体删除（记忆正文改走 E 投影）。
+      // intro（含记忆公民指令）仍【始终】注入——若因记忆为空而整体返回空串，agent 将不知道
+      // 记忆系统存在、不会主动记，形成「无记忆 → 无指令 → 永不记」死循环。
       const bridged = paths.buddyDirs().length > 0;
       const antiMangle =
         "提及记忆文件路径时一律用 ~ 简写（如 ~/.deepseek-harness/MEMORY.md），不要逐字拼写绝对路径——你转述绝对路径容易漏掉目录分隔符。";
@@ -266,8 +263,8 @@ export function apply(ctx, config) {
         ? "\n\n[plan 模式] 当前处于 plan 模式，不要调用 memory_note / memory_note_user 写入记忆，也不要请求删除记忆（读取记忆用 memory_read，仍可用）。"
         : "";
       const introFull = intro + planNote;
-      // v1.4.1：blocks 为空（已注入过）时只返回 intro 指令；返回值永非空串，
-      // 避免 harness 对空 section 的处理歧义。
+      // v1.7.0：blocks 仅含今日日志（用户级/项目级 MEMORY.md 已移出，改由 E 投影注入）。
+      // 返回值永非空串（只含 intro 时亦然），避免 harness 对空 section 的处理歧义。
       return blocks.length ? [introFull, ...blocks].join("\n\n") : introFull;
     },
   });

package/lib/projection.mjs

@@ -0,0 +1,132 @@
+// memory-palace v1.7.0 特性1：E 投影 —— 记忆正文的独立注入通道。
+//
+// 背景（v1.6.3 及以前）：用户级 + 项目级 MEMORY.md 走 systemPrompt.section，受
+// 「仅首次注入」限制（`alreadyInjected` 打了标记就不撕，只有 compaction 清），
+// 导致记忆正文在 turn 1 的 step 2 之后就消失、全程不再进场。
+//
+// 现在：两份 MEMORY.md 改经 `agent/pre-step` 投影为**独立 user 消息**，常驻对话历史：
+// - 每个 step 都可见（消息在历史里，不依赖注入时机）；
+// - 内容未变只写一次（进历史后后续 step 的 decision.messages 已含它 → 去重命中）；
+// - compaction 把消息移出 surface 后，后续 step 找不到 → 自动重注（白送）。
+//
+// 实现照抄宿主 `packages/context/agent-instructions/src/index.ts` 三件套（API 全公开、无第一方特权）：
+// 1. `inject: ['sessionProjections']`（服务随 dsh-base 默认装载）
+// 2. `ctx.on('agent/pre-step', async ({agent, messages, step, signal}, next) => {...})`
+// 3. `createUserMessage()`（来自 @deepseek-ai/dsh-llm）
+// 投递方式：同步版——折叠进 `decision.messages`（`toSpliced(lastClaimedIndex + 1, 0, desired)`），
+// 不做异步 inbox 刷新（agent-instructions 注释明写异步投影有两个 commit 边界的时序约束，
+// 本版刻意回避；记忆更新后下一步自然带上新内容）。
+//
+// 🔴 契约风险：pre-step 监听器抛错会让**整个 turn 失败**（宿主测试
+// packages/acp/acp/tests/turns.spec.ts:150-156 锚定），故钩子内整体 try-catch，
+// 任何异常降级为「本步不投影」并留一行 stderr 线索，绝不冒泡。详见 DEVELOPMENT.md §7.4。
+import { isDeepStrictEqual } from "node:util";
+import { createUserMessage } from "@deepseek-ai/dsh-llm";
+import { expandHome, toHomeShort, readMdSync, budgetClip, stripSmartTag, stripDeletedLines } from "./common/text.mjs";
+
+// 投影消息的 source 标注。
+// - kind: 'plugin' → 明确标注"插件注入"，供下游按 source 过滤（子 agent 去噪 / turnBuffer 采集）。
+// - form: 'instructions' → 宿主 ContextForm 联合内的合法值（曾拟用 'memory'，但其不在该联合内，
+//   属类型不合法；'instructions' 语义接近"指令性内容"且类型安全，UI 按指令样式呈现）。
+const PROJECTION_SOURCE = Object.freeze({
+  kind: "plugin",
+  plugin: "dsh-memory-palace",
+  form: "instructions",
+});
+
+// 同一份内容是否已在这批消息里（逐字段深比较，照抄 agent-instructions 的 sameContextPayload）。
+function sameContextPayload(left, right) {
+  return isDeepStrictEqual(left.content, right.content)
+    && isDeepStrictEqual(left.source, right.source);
+}
+
+// 扫描当前 surface，判断该 payload 是否已经作为本插件消息存在于会话历史中。
+// 存在 → 不重复注入（"内容不变只写一次"靠它实现）。
+function alreadyOnSurface(session, desired) {
+  const nodes = session?.surface?.nodes;
+  if (!Array.isArray(nodes)) return false;
+  for (const seq of nodes) {
+    const event = typeof session.eventAt === "function" ? session.eventAt(seq) : undefined;
+    if (event?.type === "user/message" && sameContextPayload(event.data, desired)) return true;
+  }
+  return false;
+}
+
+// 构造一条投影消息；内容为空（文件不存在 / 无记忆）时返回 null。
+function buildProjection(text, heading) {
+  if (!text) return null;
+  return createUserMessage({
+    content: [{ type: "text", text: `${heading}\n${text}` }],
+    source: PROJECTION_SOURCE,
+  });
+}
+
+/**
+ * 收集本步要投影的记忆消息（用户级 + 项目级，各自独立一条）。
+ * 两者拆成两条独立消息（v1.7.0 定案）：否则"项目记忆一改，用户记忆连带重发"。
+ * @param {{ getConfig: () => object, paths: object }} deps
+ * @returns {object[]} 按 [用户级, 项目级…] 顺序的消息数组（可能为空）
+ */
+export function buildProjections({ getConfig, paths }) {
+  const cfg = getConfig();
+  if (!cfg.enabled) return [];
+  const out = [];
+  // 用户级 MEMORY.md
+  const userFile = expandHome(cfg.userMemoryPath);
+  const userText = readMdSync(userFile);
+  if (userText) {
+    const clipped = stripSmartTag(stripDeletedLines(budgetClip(userText, cfg.userBudgetChars)));
+    const msg = buildProjection(clipped, `# 用户级记忆 (${toHomeShort(userFile)})`);
+    if (msg) out.push(msg);
+  }
+  // 项目级 MEMORY.md：按 readDirs 顺序（dsh 优先叠加 buddy），同一文件路径只取一次。
+  const seen = new Set();
+  for (const dir of paths.readDirs()) {
+    for (const file of paths.memoryReadCandidates(dir)) {
+      if (seen.has(file)) continue;
+      seen.add(file);
+      const text = readMdSync(file);
+      if (!text) continue;
+      const clipped = stripSmartTag(stripDeletedLines(budgetClip(text, cfg.workspaceBudgetChars)));
+      const msg = buildProjection(clipped, `# 项目级记忆 (${toHomeShort(file)})`);
+      if (msg) out.push(msg);
+    }
+  }
+  return out;
+}
+
+/**
+ * 注册 E 投影钩子。
+ * @param {{ ctx: object, getConfig: () => object, paths: object }} deps
+ */
+export function registerProjection({ ctx, getConfig, paths }) {
+  ctx.on("agent/pre-step", async ({ agent, messages, step, signal }, next) => {
+    // 先让瀑布流继续，拿到宿主与其他插件合成后的决策——投影要折叠进它的 messages。
+    const decision = await next();
+    try {
+      signal?.throwIfAborted?.();
+      if (decision.kind !== "enter") return decision;
+      const session = agent?.session;
+      const desired = buildProjections({ getConfig, paths });
+      if (!desired.length) return decision;
+      // 逐条去重：已被本步的 messages 覆盖、或已在 surface 上的，跳过。
+      const pending = desired.filter((msg) =>
+        !messages.some((m) => sameContextPayload(m, msg))
+        && !decision.messages.some((m) => sameContextPayload(m, msg))
+        && !alreadyOnSurface(session, msg));
+      if (!pending.length) return decision;
+      // 折叠位置：紧跟在"本步被认领的消息"之后，使直接提示在前、驱动追加的 runtime context 在后。
+      // 照抄 agent-instructions：lastClaimedIndex 可能为 -1（本步无认领消息），此时插到最前。
+      const lastClaimedIndex = decision.messages.findLastIndex((m) => messages.includes(m));
+      const entered = decision.messages.toSpliced(lastClaimedIndex + 1, 0, ...pending);
+      return { ...decision, messages: entered };
+    } catch (error) {
+      // 🔴 绝不冒泡：pre-step 抛错会让整个 turn 失败（宿主契约，见文件头）。
+      // 契约失效时表现为"记忆正文不注入"，这行 warn 是唯一排查线索。
+      console.error(
+        `[memory-palace] projection skipped (step ${step}): ${error?.message || String(error)}`,
+      );
+      return decision;
+    }
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-memory-palace",
-  "version": "1.6.3",
+  "version": "1.7.0",
   "description": "把 WorkBuddy 的文件式记忆系统移植进 DeepSeek Harness：用户级 + 工作区的人类可读 Markdown 记忆（~/.deepseek-harness/MEMORY.md 与 <cwd>/.deepseek-harness/memory/）。",
   "type": "module",
   "main": "lib/index.js",