dsh-memory-palace 1.7.0 → 1.7.1

package/README.md

@@ -2,7 +2,7 @@
 
 把 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&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)
+[![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.5-rc.1](https://img.shields.io/badge/DeepSeek%20Harness-0.1.5--rc.1-success.svg?labelColor=4D6BFE)](https://github.com/deepseek-ai/deepseek-harness)
 
 ## 特性
 
@@ -12,10 +12,11 @@
 - **WorkBuddy / CodeBuddy 桥接**：项目已有对应记忆目录时直接读写，无需重复维护。
 - **记忆工具**：AI 可主动写入、聚合读取、按内容删除（删除需人工确认），写入自带去重。
 - **手动蒸馏**：会话标题栏一键把当前对话或项目记忆提炼成长期记忆。
-- **设置页集成**：全部配置均可在 DSH 设置面板中图形化调整，无需改配置文件。
+- **设置页集成**：全部配置均可在 DSH 设置面板中图形化调整（按板块折叠），无需改配置文件。
+- **自定义指令**：不适合写进记忆的特殊指令可在设置页配置，插件经系统提示词注入。
 - **主动记忆（插件模式）**：以指令引导 AI 在完成任务、修复问题、确定决策、获知偏好时主动落档。
 - **智能模式**：由模型自动提炼每轮新增内容，摘要进日志、长期事实进记忆。
-- **记忆注入**：长期记忆全程常驻、每个步骤都可见；今日日志按轮次注入，避免上下文膨胀。
+- **记忆注入**：长期记忆与今日日志以「会话起始快照」常驻上下文、按文件身份各只注入一次 —— 既保证每个步骤都可见，又不破坏前缀缓存、不堆积冗余快照。
 - **混合模式（🔥推荐）**：子代理每轮自动整理日志并去重，长期记忆由主 AI 主动维护，兼顾自动化与可控性。
 - **标准插件包**：经官方插件机制一键安装，无需改动 harness。
 
@@ -63,7 +64,7 @@
 |---|---|---|
 | `memory_note` | 项目级 | 把约定/偏好写入当前项目全部目标 `MEMORY.md`（去重） |
 | `memory_note_user` | 用户级 | 把跨项目偏好写入 `~/.deepseek-harness/MEMORY.md`（去重） |
-| `memory_read` | 聚合 | 一次性读取用户级 + 项目级记忆、今日日志与最近 3 份历史日志 |
+| `memory_read` | 按需 | 读取记忆。`scope` 默认 `memory`（用户级 + 项目级）；可选 `project`（仅项目级，与 `memory_write` 的写侧 scope 同名）/ `today` / `yesterday` / `daily`（近三天日志）/ `all`（长期记忆 + 日志） |
 | `memory_delete` | 用户级/项目级/每日级 | 按内容删除记忆条目（两阶段确认：先预览匹配位置与内容，用户确认后再删；删除动作经 harness 原生确认弹窗硬闸门，真人点允许才真正执行） |
 | `memory_write`（hybrid） | 项目级/用户级 | 章节化写入：章节存在则末尾追加，不存在则新建章节（章节化格式规范） |
 | `memory_update_section`（hybrid） | 项目级/用户级 | 整章节精确替换/单条标记删除：oldText 归一化精确匹配防 stale，失败拒绝并回显实际内容 |
@@ -77,7 +78,7 @@
 
 ```bash
 dsh plugin --profile web add github:lovezi0/dsh-memory-palace
-# 锁定版本：dsh plugin --profile web add github:lovezi0/dsh-memory-palace#v1.7.0
+# 锁定版本：dsh plugin --profile web add github:lovezi0/dsh-memory-palace#v1.7.1
 ```
 
 方式二：clone 后本地安装（开发 / 修改源码场景）
@@ -109,7 +110,7 @@ dsh plugin --profile web remove dsh-memory-palace
 
 ## 配置
 *面板路径为 DSH 设置 →「记忆」*
-所有配置项（基础 / 自动记录 / 开发 三张卡片的字段、默认值与说明）已整理至 [CONFIG.md](./CONFIG.md)
+所有配置项（核心 / 自定义指令 / 自动记录 / 存储路径与预算 / 开发 五张卡片的字段、默认值与说明）已整理至 [CONFIG.md](./CONFIG.md)
 
 ## 开发
 
@@ -118,12 +119,16 @@ dsh plugin --profile web remove dsh-memory-palace
 
 ## 版本历史
 
+- **1.7.1**
+    - 💪移除日志重注机制优化缓存命中降低堆积冗余
+    - 💪记忆设置UI优化
+    - 🔥增加自定义指令 prompt 配置与注入
+    - 💪memory_read 增加 scope 参数
 - **1.7.0**
-    - **1.7.0.alpha.1**
-        - 🔥新增独立通道注入记忆文件
-        - 🐛修复存在多种记忆路径时读取冲突的问题
-        - 💪优化记忆子 agent 投影消息节省 token
-        - 💪优化 SUBAGENT_SYSTEM 记忆输出格式
+    - 🔥新增独立通道注入记忆文件
+    - 🐛修复存在多种记忆路径时读取冲突的问题
+    - 💪优化记忆子 agent 投影消息节省 token
+    - 💪优化 SUBAGENT_SYSTEM 记忆输出格式
 - **1.6.3**
     - npm publish
     - **1.6.3.alpha.4**

package/lib/client.js

@@ -16,8 +16,13 @@ window.__ModuleLoader__.load({
       title: "记忆",
       intro: "memory-palace 记忆宫殿：跨会话持久化的 Markdown 记忆。",
       core: "核心",
+      coreDesc: "buddy 记忆桥接与项目记忆目录",
+      custom: "自定义指令",
+      customDesc: "不适合写进用户记忆的特殊指令，经系统提示词注入",
       smartSummary: "自动记录",
+      smartSummaryDesc: "记忆模式、自动记录与模型参数",
       storage: "存储路径与预算",
+      storageDesc: "记忆文件路径、日志保留与注入预算",
       bridgeLabel: "桥接 buddy 项目记忆",
       bridgeHint: "项目已存在 .workbuddy / .codebuddy 记忆目录时直接读写，不再建 .deepseek-harness/memory/",
       dirsLabel: "buddy 记忆目录（逗号分隔，按序优先）",
@@ -47,6 +52,8 @@ window.__ModuleLoader__.load({
       subagentLogBudgetHint: "记忆子代理回喂今日工作日志的字符上限；超出时仅回喂章节目录，子代理按需读取章节。默认 20000。",
       summaryModelLabel: "模型",
       summaryModelHint: "记忆插件当前使用的模型（智能模式会话摘要 / 手动蒸馏 / hybrid 记忆子代理共用）。留空=复用当前会话的 provider/model；也可固定廉价小模型省 token。",
+      expand: "展开",
+      collapse: "收起",
       save: "保存",
       saving: "保存中…",
       discard: "放弃",
@@ -73,6 +80,7 @@ window.__ModuleLoader__.load({
       distillDebugLogLabel: "蒸馏调试日志",
       distillDebugLogHint: "开启后向 dsh 服务端控制台（stderr）输出蒸馏 LLM 调用诊断。info 级别仅输出元数据（不含文本）；配合 distillLogLevel=debug 会额外打印 LLM 原始响应（分隔符包裹），仅限受信本地排障。",
       dev: "开发",
+      devDesc: "蒸馏调试日志与超时",
       distillTimeoutLabel: "蒸馏超时（秒）",
       distillTimeoutHint: "单次蒸馏 LLM 调用的超时上限（秒）；超时视为失败并降级。覆盖智能模式摘要与手动蒸馏，默认 60 秒。",
       summaryMaxTokensLabel: "会话摘要最大 Token",
@@ -80,7 +88,10 @@ window.__ModuleLoader__.load({
       projectMaxTokensLabel: "项目蒸馏最大 Token",
       projectMaxTokensHint: "最终输出软预算（prompt 约束，思考不受限；实际硬上限由模型自身 maxTokens 决定）。默认 8000。",
       feedbackEnabledLabel: "回喂存量记忆",
-      feedbackEnabledHint: "每次蒸馏时附带项目级 + 用户级记忆作为参考，使其能基于既有记忆做增量维护（delete 仅手动蒸馏开放）。混合模式下仅手动触发蒸馏受影响（自动路径走记忆子代理，自带日志回喂）。默认关。"
+      feedbackEnabledHint: "每次蒸馏时附带项目级 + 用户级记忆作为参考，使其能基于既有记忆做增量维护（delete 仅手动蒸馏开放）。混合模式下仅手动触发蒸馏受影响（自动路径走记忆子代理，自带日志回喂）。默认关。",
+      customLabel: "自定义指令内容",
+      customHint: "非空时注入系统提示词，位置在记忆插件与分工说明之后。对全部会话生效；留空则不注入。",
+      customPlaceholder: "例如：回答用中文；代码注释用英文；提交信息用祈使句…"
     };
 
     const en = {
@@ -88,8 +99,13 @@ window.__ModuleLoader__.load({
       title: "Memory",
       intro: "memory-palace: persistent, human-readable Markdown memory across sessions.",
       core: "Core",
+      coreDesc: "Buddy memory bridging and workspace memory dirs",
+      custom: "Custom instructions",
+      customDesc: "Special instructions that do not belong in user memory, injected via the system prompt",
       smartSummary: "Auto-record",
+      smartSummaryDesc: "Memory mode, auto-record and model parameters",
       storage: "Storage & budgets",
+      storageDesc: "Memory file paths, log retention and injection budgets",
       bridgeLabel: "Bridge buddy project memory",
       bridgeHint: "Read/write directly into existing .workbuddy / .codebuddy memory dirs instead of creating .deepseek-harness/memory/",
       dirsLabel: "Buddy memory dirs (comma-separated, first wins)",
@@ -119,6 +135,8 @@ window.__ModuleLoader__.load({
       subagentLogBudgetHint: "Max chars of today's daily log fed back to the memory sub-agent; beyond this only the chapter TOC is fed and the sub-agent reads sections on demand. Default 20000.",
       summaryModelLabel: "Model",
       summaryModelHint: "The model currently used by the memory plugin (shared by smart-mode session summarization / manual distillation / the hybrid memory sub-agent). Leave empty to reuse the current session's provider/model, or pin a cheap model (provider/model) to save tokens.",
+      expand: "Expand",
+      collapse: "Collapse",
       save: "Save",
       saving: "Saving…",
       discard: "Discard",
@@ -145,6 +163,7 @@ window.__ModuleLoader__.load({
       distillDebugLogLabel: "Distill debug log",
       distillDebugLogHint: "When on, prints distill LLM call diagnostics to the dsh server console (stderr). info level prints metadata only (no text); with distillLogLevel=debug it additionally prints the raw LLM response (wrapped in delimiters), for trusted local troubleshooting only.",
       dev: "Developer",
+      devDesc: "Distill debug log and timeout",
       distillTimeoutLabel: "Distill timeout (s)",
       distillTimeoutHint: "Timeout (in seconds) for a single distill LLM call; on timeout it fails and degrades. Covers both smart-mode summary and manual distillation. Default 60s.",
       summaryMaxTokensLabel: "Session summary max tokens",
@@ -152,7 +171,10 @@ window.__ModuleLoader__.load({
       projectMaxTokensLabel: "Project distill max tokens",
       projectMaxTokensHint: "Final output soft budget (prompt constraint, thinking not limited; actual hard cap is the model's own maxTokens). Default 8000.",
       feedbackEnabledLabel: "Feed existing memory into distillation",
-      feedbackEnabledHint: "Feed the project-level + user-level memory in as reference on every distillation so the LLM can maintain existing memory incrementally (delete is only allowed via manual distillation). In hybrid mode only manual distillation is affected (the automatic path runs through the memory sub-agent, which feeds the log itself). Off by default."
+      feedbackEnabledHint: "Feed the project-level + user-level memory in as reference on every distillation so the LLM can maintain existing memory incrementally (delete is only allowed via manual distillation). In hybrid mode only manual distillation is affected (the automatic path runs through the memory sub-agent, which feeds the log itself). Off by default.",
+      customLabel: "Custom instruction text",
+      customHint: "When non-empty it is injected into the system prompt right after the memory-plugin and memory-roles instructions. Applies to every session; leave empty to inject nothing.",
+      customPlaceholder: "e.g. Answer in Chinese; write code comments in English; use imperative commit subjects…"
     };
 
 
@@ -179,7 +201,8 @@ window.__ModuleLoader__.load({
         projectMaxTokens: v.projectMaxTokens != null ? String(v.projectMaxTokens) : "8000",
         reorgCooldownDays: v.reorgCooldownDays != null ? String(v.reorgCooldownDays) : "7",
         subagentLogBudget: v.subagentLogBudget != null ? String(v.subagentLogBudget) : "20000",
-        feedbackEnabled: v.feedbackEnabled === false ? "false" : "true"
+        feedbackEnabled: v.feedbackEnabled === false ? "false" : "true",
+        customInstructions: v.customInstructions || ""
       };
     }
 
@@ -250,6 +273,9 @@ window.__ModuleLoader__.load({
       const [failed, setFailed] = react.useState(false);
       const [validation, setValidation] = react.useState(null);
       const [modelOptions, setModelOptions] = react.useState([]);
+      // v1.7.1（特性2）：折叠卡片的展开态（key → bool）。照抄宿主 ui-settings-plugins/PluginCard
+      // 的语义 —— 纯前端临时状态、**不持久化**：「用户打开哪张卡」是一次阅读手势，不是配置。
+      const [openCards, setOpenCards] = react.useState({});
 
       // 初始加载（从自有 route 读真实值）。
       react.useEffect(() => {
@@ -334,6 +360,8 @@ window.__ModuleLoader__.load({
           // 保存成功后同步 remote（真实返回值），保留当前 draft（= 用户保存的目标值）。
           setRemote({ value: full.value, user: full.user, revision: full.revision, loaded: true });
           setDirty(false);
+          // 保存完成 = 这一轮编辑动作结束 → 收起全部卡片回到总览态（对齐宿主 PluginCard 行为）。
+          setOpenCards({});
         } catch (e) {
           setFailed(true);
         } finally {
@@ -423,19 +451,68 @@ window.__ModuleLoader__.load({
         borderTop: "1px solid var(--dsw-alias-border-l2, #e5e7eb)"
       };
 
+      // ---- v1.7.1（特性2）：折叠卡片样式 —— 逐值照抄宿主 ui-settings-plugins 的 PluginCard.module.css ----
+      // 竖向「name 叠在 description 上」的卡片宿主无可复用组件（它导出的 DisclosureRow 是横向 24px
+      // 紧凑行，布局不同，宿主 README 亦明确区分二者），故手写；chevron 用 data URI 内联 SVG
+      // （本项目 client 只能 require("react")，不引宿主图标包）。
       const cardStyle = {
-        border: "1px solid var(--dsw-alias-border-l2, #e5e7eb)",
-        borderRadius: "12px",
-        padding: "14px 16px",
+        border: "0.5px solid var(--dsw-alias-border-l4, #e5e7eb)",
+        // ⚠️ 必须显式写 borderColor：展开/收起靠 React diff 增删 cardOpenStyle 的 borderColor。
+        // 若只依赖 shorthand 的颜色，open 态写入的 borderColor 被移除后，CSSOM 中 border-color
+        // 声明随之删除 → 回退 UA 初始值 currentColor（文字色，近黑）→ 收起后边框变黑（真机 bug）。
+        borderColor: "var(--dsw-alias-border-l4, #e5e7eb)",
+        borderRadius: "16px",
         marginBottom: "12px",
-        background: "var(--dsw-alias-bg-layer-2, #ffffff)"
+        background: "var(--dsw-alias-bg-layer-3, #fafafa)",
+        overflow: "hidden"
       };
-      const groupTitleStyle = {
-        margin: "0 0 4px",
-        fontSize: "13px",
-        fontWeight: "500",
+      const cardOpenStyle = {
+        ...cardStyle,
+        background: "var(--dsw-alias-bg-layer-2, #ffffff)",
+        borderColor: "var(--dsw-alias-label-dimmed, #c9ced6)"
+      };
+      const cardHeaderStyle = {
+        display: "flex",
+        alignItems: "center",
+        gap: "12px",
+        width: "100%",
+        padding: "14px 16px",
+        appearance: "none",
+        WebkitAppearance: "none",
+        border: "0",
+        background: "none",
+        font: "inherit",
+        textAlign: "left",
+        cursor: "pointer"
+      };
+      const cardHeadTextStyle = { flex: 1, minWidth: 0, display: "flex", flexDirection: "column", gap: "4px" };
+      const cardNameStyle = {
+        fontSize: "15px",
+        fontWeight: "600",
+        lineHeight: "1.4",
         color: "var(--dsw-alias-label-primary, #1f2329)"
       };
+      const cardDescStyle = {
+        fontSize: "13px",
+        lineHeight: "1.5",
+        color: "var(--dsw-alias-label-tertiary, #8a919f)"
+      };
+      const cardBodyStyle = {
+        borderTop: "0.5px solid var(--dsw-alias-border-l2, #e5e7eb)",
+        margin: "0 16px",
+        paddingBottom: "8px"
+      };
+      const chevronStyle = {
+        flexShrink: 0,
+        width: "14px",
+        height: "14px",
+        backgroundImage:
+          "url(data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 14 14' fill='none'%3E%3Cpath d='M3.5 5.25L7 8.75L10.5 5.25' stroke='%2381858C' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E)",
+        backgroundRepeat: "no-repeat",
+        backgroundPosition: "center",
+        backgroundSize: "14px 14px",
+        transition: "transform .16s"
+      };
       const sectionStyle = {
         maxWidth: "760px",
         color: "var(--dsw-alias-label-primary, #1f2329)",
@@ -503,18 +580,45 @@ window.__ModuleLoader__.load({
       const hintStyle = { color: "var(--dsw-alias-label-tertiary, #8a919f)", margin: 0, fontSize: "12px", lineHeight: "1.5" };
       const errStyle = { color: "var(--dsw-alias-label-error, #d54941)", margin: 0, fontSize: "12px", lineHeight: "1.5" };
 
+      const toggleCard = (key) => setOpenCards((o) => ({ ...o, [key]: !o[key] }));
+      // 折叠卡片：header 自身是 button（整行可点 + aria-expanded + aria-label），body 仅在展开时渲染。
+      const card = (key, title, desc, children) =>
+        h("div", { style: openCards[key] ? cardOpenStyle : cardStyle }, [
+          h("button", {
+            type: "button",
+            className: "mp-card-header",
+            "aria-expanded": openCards[key] ? "true" : "false",
+            "aria-label": `${t(openCards[key] ? "collapse" : "expand")}: ${title}`,
+            style: cardHeaderStyle,
+            onClick: () => toggleCard(key)
+          }, [
+            h("span", { style: cardHeadTextStyle }, [
+              h("span", { style: cardNameStyle }, title),
+              h("span", { style: cardDescStyle }, desc)
+            ]),
+            h("span", { style: openCards[key] ? { ...chevronStyle, transform: "rotate(180deg)" } : chevronStyle })
+          ]),
+          openCards[key] ? h("div", { className: "mp-card-body", style: cardBodyStyle }, children) : null
+        ]);
+
       const num = (field) => ({
         type: "text",
         inputMode: "numeric",
         value: draft[field],
         disabled,
-        style: { ...inputStyle, borderColor: validation === field ? "var(--dsw-alias-label-error, #d54941)" : undefined },
+        style: { ...inputStyle, borderColor: validation === field ? "var(--dsw-alias-label-error, #d54941)" : "var(--dsw-alias-border-l2, #e5e7eb)" },
         onChange: (e) => edit(field, e.target.value)
       });
 
       return h("div", { className: "memory-palace-settings", style: sectionStyle }, [
         // 强制覆盖宿主 Webview 全局样式对原生 checkbox 尺寸的覆盖（内联 style 可能不敌全局 CSS）。
-        h("style", null, ".memory-palace-settings input[type=checkbox]{width:18px!important;height:18px!important;margin:0;flex-shrink:0!important;cursor:pointer;}"),
+        h("style", null,
+          ".memory-palace-settings input[type=checkbox]{width:18px!important;height:18px!important;margin:0;flex-shrink:0!important;cursor:pointer;}" +
+          // v1.7.1（特性2）：展开区首条元素自带 borderTop（row/toggle 共用该样式），会与
+          // .mp-card-body 的 border-top 叠成双线 → 去掉首条的边框与上内边距。
+          ".memory-palace-settings .mp-card-body > *:first-child{border-top:0!important;padding-top:0!important;}" +
+          ".memory-palace-settings .mp-card-header:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#4b5bff);outline-offset:-2px;border-radius:16px;}"
+        ),
         h("div", { style: { display: "flex", alignItems: "flex-start", justifyContent: "space-between", gap: "12px" } }, [
           h("div", null, [
             h("h3", { style: headingStyle }, t("title")),
@@ -526,8 +630,7 @@ window.__ModuleLoader__.load({
           ])
         ]),
         failed ? h("p", { style: errStyle }, t("saveFailed")) : null,
-        h("div", { style: cardStyle }, [
-          h("p", { style: groupTitleStyle }, t("core")),
+        card("core", t("core"), t("coreDesc"), [
           h("div", { style: toggleStyle }, [
             h("div", { style: { flexShrink: 1, minWidth: 0 } }, [
               h("p", { style: { ...labelStyle, margin: 0 } }, t("bridgeLabel")),
@@ -548,8 +651,27 @@ window.__ModuleLoader__.load({
               placeholder: ".workbuddy/memory, .codebuddy/memory"
             }), "buddyWorkspaceMemoryDirs")
         ]),
-        h("div", { style: cardStyle }, [
-          h("p", { style: groupTitleStyle }, t("smartSummary")),
+        // v1.7.1（特性3）：自定义指令。非空时经 system prompt 追加到「记忆分工说明」之后；
+        // 它是恒定内容（用户配置一次不变），故放 section 而非 E 投影 —— 零缓存成本。
+        card("custom", t("custom"), t("customDesc"), [
+          row(t("customLabel"), t("customHint"),
+            h("textarea", {
+              value: draft.customInstructions,
+              disabled,
+              rows: 6,
+              placeholder: t("customPlaceholder"),
+              style: {
+                ...inputStyle,
+                height: "auto",
+                minHeight: "120px",
+                padding: "10px 12px",
+                lineHeight: "1.6",
+                resize: "vertical"
+              },
+              onChange: (e) => edit("customInstructions", e.target.value)
+            }), "customInstructions")
+        ]),
+        card("smartSummary", t("smartSummary"), t("smartSummaryDesc"), [
           // 轮次结束自动记录(summarize)：三种记忆模式的共用总闸门，始终显示，置于记忆模式之上、不随模式切换隐藏。
           toggle(t("summarizeLabel"), t("summarizeHint"), "summarize"),
           row(t("memoryModeLabel"),
@@ -599,16 +721,14 @@ window.__ModuleLoader__.load({
             row(t("projectMaxTokensLabel"), t("projectMaxTokensHint"), h("input", num("projectMaxTokens")), "projectMaxTokens")
           ])
         ]),
-        h("div", { style: cardStyle }, [
-          h("p", { style: groupTitleStyle }, t("storage")),
+        card("storage", t("storage"), t("storageDesc"), [
           row(t("userPathLabel"), t("userPathHint"), h("input", { ...num("userMemoryPath"), type: "text" }), "userMemoryPath"),
           row(t("wsDirLabel"), t("wsDirHint"), h("input", { ...num("workspaceMemoryDir"), type: "text" }), "workspaceMemoryDir"),
           row(t("retentionLabel"), draft.memoryMode === "hybrid" ? t("retentionHintHybrid") : t("retentionHint"), h("input", num("dailyLogRetentionDays")), "dailyLogRetentionDays"),
           row(t("userBudgetLabel"), t("userBudgetHint"), h("input", num("userBudgetChars")), "userBudgetChars"),
           row(t("wsBudgetLabel"), t("wsBudgetHint"), h("input", num("workspaceBudgetChars")), "workspaceBudgetChars")
         ]),
-        h("div", { style: cardStyle }, [
-          h("p", { style: groupTitleStyle }, t("dev")),
+        card("dev", t("dev"), t("devDesc"), [
           row(t("distillTimeoutLabel"), t("distillTimeoutHint"), h("input", num("summaryTimeoutMs")), "summaryTimeoutMs"),
           toggle(t("distillDebugLogLabel"), t("distillDebugLogHint"), "distillDebugLog")
         ])

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, stripSmartTag } from "./text.mjs";
+import { todayISO, expandHome, normLine, isStructural, stripSmartTag } from "./text.mjs";
 
 // 追加一行记忆，若目标文件已包含相同内容则跳过（去重），返回是否实际写入。
 export async function appendLineDedup(file, line) {
@@ -237,30 +237,6 @@ export function createRecords({ getConfig, paths }) {
     }
   }
 
-  // 读取目录里最近的（非今日）每日日志，拼成一段供 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 ?? "";
@@ -289,5 +265,7 @@ export function createRecords({ getConfig, paths }) {
     }
   }
 
-  return { appendDaily, prune, recentLogs, writeLightEntry, captureError };
+  // v1.7.1：recentLogs 已删除 —— memory_read 的 scope='daily' 改为按日期（isoDaysAgo）直读，
+  // 不再需要"最近 N 份文件"语义（跨日跳空会取偏）。
+  return { appendDaily, prune, writeLightEntry, captureError };
 }

package/lib/common/text.mjs

@@ -14,6 +14,16 @@ export const todayISO = () => {
   return `${d.getFullYear()}-${m}-${day}`;
 };
 
+// 本地日期偏移（0=今天，1=昨天，2=前天…），供 memory_read 按**日期**取日志
+// （而不是"最近 N 份文件"——跨日跳空时会取偏）。同 todayISO 的教训：必须本地时间。
+export const isoDaysAgo = (n = 0) => {
+  const d = new Date();
+  d.setDate(d.getDate() - n);
+  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.{时间戳}）使用。

package/lib/hybrid/tools.mjs

@@ -232,7 +232,7 @@ export function registerHybridTools({ ctx, getConfig, paths, records, state }) {
         "(workspaceBudgetChars); (2) at least reorgCooldownDays (default 7) since the last reorganize. " +
         "If either gate fails the call is REJECTED — use memory_update_section instead. " +
         "Requirements for newContent: keep the full `## 章节` + `- 条目` format; NEVER lose still-valid key " +
-        "information — read the daily logs (memory_read) and current MEMORY.md for cross-checking first; " +
+        "information — read the daily logs and current MEMORY.md for cross-checking first (memory_read with scope 'all'); " +
         "merge duplicates, drop only strikethrough/obsolete content; keep user-level MEMORY.md untouched " +
         "(user-level reorganization is FORBIDDEN). A last-reorg timestamp comment is appended automatically. " +
         "A user confirmation dialog is shown before execution.",

package/lib/index.js

@@ -22,11 +22,10 @@
 // - src/index.mjs：最薄入口——apply() 装配 + 闭包运行时（session/event 跟踪、settle 时序、section 注入）
 // - src/client/（00-head…90-tail）：浏览器 bundle 源码（build 时零依赖拼接为 lib/client.js 单文件，
 //   硬约束——dsh 客户端模块系统不支持插件相对 require）
-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, toHomeShort, readMdSync, budgetClip, stripSmartTag, stripDeletedLines, extractText, extractToolErrorText } from "./common/text.mjs";
+import { 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";
@@ -61,7 +60,7 @@ export const Config = Schema.object({
   summaryTimeoutMs: Schema.number().default(60000).description("蒸馏 LLM 调用的超时（毫秒），超时视为失败并降级；覆盖智能模式摘要与手动蒸馏两条链路；默认 60000（60s）。"),
   distillDebugLog: Schema.boolean().default(false).description("调试开关：向 dsh 服务端 stderr 输出蒸馏 LLM 调用诊断。distillLogLevel=info 时仅输出元数据（模型解析/请求参数/流进度/错误详情，不含文本）；distillLogLevel=debug 会额外打印 LLM 原始响应文本（分隔符包裹），仅限受信本地排障开启。"),
   // ---- v1.4.1：蒸馏 stderr 日志级别（平铺键，不进 UI；默认 info；distillDebugLog=true 时生效） ----
-  distillLogLevel: Schema.string().default("info").description("蒸馏 stderr 日志级别：info=仅元数据诊断（默认，不打印 LLM 原始响应）；debug=额外打印 LLM 原始响应文本（分隔符包裹），仅限受信本地排障开启。无需 UI 配置，经 profile/settings.yaml 设置 distillLogLevel 键。"),
+  distillLogLevel: Schema.string().default("info").description("蒸馏 stderr 日志级别：info=仅元数据诊断（默认，不打印 LLM 原始响应）；debug=额外打印 LLM 原始响应文本（分隔符包裹），仅限受信本地排障开启。无需 UI 配置，经 DSH home（$DSH_HOME）根目录的 settings.yaml 设置 distillLogLevel 键。"),
   // ---- v1.4.0：智能模式最终输出软预算（v1.4.1 起语义变更：prompt 软约束，思考不受限；实际硬上限由模型自身 maxTokens 决定） ----
   summaryMaxTokens: Schema.number().default(2000).description("会话摘要 LLM 的最终输出软预算（prompt 约束，思考不受限；实际硬上限由模型自身 maxTokens 决定）。默认 2000；可调大以容纳更多 durable 事实。"),
   projectMaxTokens: Schema.number().default(8000).description("手动「蒸馏项目记忆」LLM 的最终输出软预算（prompt 约束，思考不受限；实际硬上限由模型自身 maxTokens 决定）。默认 8000。"),
@@ -70,6 +69,9 @@ export const Config = Schema.object({
   // ---- v1.6.0：hybrid 模式配置（仅 memoryMode=hybrid 时生效） ----
   reorgCooldownDays: Schema.number().default(7).description("hybrid 模式：项目级 MEMORY.md 全量重整的冷却天数（距上次重整）。与「超出注入预算」双条件同时满足才允许 memory_reorganize；时间戳以 HTML 注释落在 MEMORY.md 文件尾。"),
   subagentLogBudget: Schema.number().default(20000).description("hybrid 模式：记忆子代理回喂今日工作日志的字符上限。超出时仅回喂章节目录，子代理用 log_read_section 按需读取章节。"),
+  // ---- v1.7.1（特性3）：自定义指令（用户自写，经 system prompt 注入到「记忆分工 prompt」之后） ----
+  // 放 system 而非 E 投影：用户配置一次即恒定 → 零缓存成本（见下方 section 的分流原则）。
+  customInstructions: Schema.string().default("").description("自定义指令：非空时追加到系统提示词「记忆分工说明」之后，用于承载不适合写进用户记忆的特殊指令。对全部会话与三种记忆模式生效；留空则不注入。"),
 });
 
 export const inject = ["systemPrompt", "tools", "llm", "webServer", "webRuntime"];
@@ -139,7 +141,7 @@ export function apply(ctx, config) {
   const paths = createPaths(() => source(), () => state.activeCwd);
   const records = createRecords({ getConfig: () => source(), paths });
   const distill = createDistill({ ctx, getConfig: () => source(), paths, records, state });
-  registerTools({ ctx, getConfig: () => source(), paths, records, state });
+  registerTools({ ctx, getConfig: () => source(), paths, state });
   registerApi({ ctx, paths, distill, state, getSettingsFace });
   // v1.6.0：hybrid 模式独立模块。必须【无条件注册】——apply() 同步段执行时 settings 服务
   // 尚未挂载（v1.6.0-rc1 起设置节经 SettingsProvider.installSection 在 ctx.inject(["settings"])
@@ -212,24 +214,18 @@ export function apply(ctx, config) {
   });
 
   // ---------- 读取：同步 section text（systemPrompt 要求同步） ----------
-  // v1.7.0：section 只保留「常量指令（intro）+ 今日工作日志」。
-  // 用户级 / 项目级 MEMORY.md 已移出 section，改由 E 投影（src/projection.mjs）承载为
-  // 常驻消息（每个 step 可见）。分流依据是「变化频率」：MEMORY.md 低频 durable → 投影；
-  // 今日日志高频易变 → 留 section 每步注入（不进历史以免膨胀）。
+  // v1.7.1：section **只保留恒定内容**（intro 指令 + 记忆分工说明 + planNote），
+  // 今日工作日志已迁入 E 投影（src/projection.mjs）。
+  // 分流依据是「内容是否恒定」：恒定 → 留 section（system prompt 在序列最前，内容恒定则
+  // 前缀缓存永久有效）；易变 → 走 E 投影追加到历史尾部，且按文件身份只注一次。
+  // ⚠️ 切勿把任何「每步可能变化」的内容放回本 section —— 变一次就会让其后整段前缀作废。
+  //    实测代价：9 次全量重算、命中率从 99.26% 掉到 94.53%（见 testdata/session.v3.jsonl）。
   ctx.systemPrompt.section({
     name: "memory-palace",
     order: 50,
     text: () => {
       const cfg = source();
       if (!cfg.enabled) return "";
-      const blocks = [];
-      // 今日工作日志：每 step 注入，预算 workspaceBudgetChars（与项目 MEMORY.md 同字段，
-      // 但各自独立 budgetClip 截断，互不挤占）。v1.4.1 的 budgetClip 已是"结构行 + 尾部最新"。
-      for (const dir of paths.readDirs()) {
-        const dirShort = toHomeShort(dir);
-        const t = readMdSync(join(dir, `${todayISO()}.md`));
-        if (t) blocks.push(`# 今日工作日志 (${todayISO()} @ ${dirShort})\n${stripSmartTag(stripDeletedLines(budgetClip(t, cfg.workspaceBudgetChars)))}`);
-      }
       // v1.7.0：alreadyInjected / injectedSessionIds 已整体删除（记忆正文改走 E 投影）。
       // intro（含记忆公民指令）仍【始终】注入——若因记忆为空而整体返回空串，agent 将不知道
       // 记忆系统存在、不会主动记，形成「无记忆 → 无指令 → 永不记」死循环。
@@ -241,7 +237,7 @@ export function apply(ctx, config) {
       // v1.6.0：hybrid=记忆子代理自动维护日志 + agent 主动维护 MEMORY.md（见 HYBRID_PROACTIVE）。
       const proactive =
         source().memoryMode === "smart"
-          ? "\n\n[记忆说明] 你的跨 session 记忆由 LLM 智能摘要自动维护（每轮结束自动提炼摘要并沉淀 durable 事实到 MEMORY.md），无需主动调用 memory_note / memory_note_user；读取全部记忆用 memory_read 工具（不要手动 glob/read 记忆文件）。"
+          ? "\n\n[记忆说明] 你的跨 session 记忆由 LLM 智能摘要自动维护（每轮结束自动提炼摘要并沉淀 durable 事实到 MEMORY.md），无需主动调用 memory_note / memory_note_user；读取记忆用 memory_read 工具，scope 默认 'memory'，需要日志时显式传 scope（不要手动 glob/read 记忆文件）。"
           : source().memoryMode === "hybrid"
             ? HYBRID_PROACTIVE
             : "\n\n[记忆公民指令] 你拥有跨 session 的 Markdown 记忆。以下场景【必须】主动调用 memory_note（项目级约定）或 memory_note_user（跨项目个人偏好）落档，不要依赖轮次结束的自动兜底——它只做原始文本截断，无法代替你的高质量总结：\n" +
@@ -253,19 +249,25 @@ export function apply(ctx, config) {
               "判定标准：这条信息「下个 session 的我」还需要吗？不需要（闲聊、一次性操作、显而易见）就不记。格式：一句话结论开头 + 关键细节（命令/路径/数字），不写流水账。";
       const intro = bridged
         ? "你拥有持久化、人类可直接编辑的 Markdown 记忆文件。当前项目已存在 WorkBuddy/CodeBuddy 项目记忆目录，本插件直接读写这些目录（不再单独创建 .deepseek-harness/memory/）。" +
-          "写入记忆：项目级约定用 memory_note 工具，跨项目个人偏好用 memory_note_user 工具；读取全部记忆用 memory_read 工具（不要手动 glob/read 记忆文件）。用它保持跨 session 一致性；看不到的内容不要编造。" +
+          "写入记忆：项目级约定用 memory_note 工具，跨项目个人偏好用 memory_note_user 工具；读取记忆用 memory_read 工具，scope 默认 'memory'（用户级 + 项目级 MEMORY.md），需要今日/历史日志时显式传 scope:'daily' 或 'all'（不要手动 glob/read 记忆文件）。用它保持跨 session 一致性；看不到的内容不要编造。" +
+          "注意：上下文中的记忆是**会话起始快照**，不随记忆文件之后的更新自动刷新；需要以当前状态为依据时（改记忆前、或据记忆作答前）用 memory_read 重读。" +
           antiMangle + proactive
         : "你拥有持久化、人类可直接编辑的 Markdown 记忆文件（位于 ~/.deepseek-harness/MEMORY.md，以及各项目的 .deepseek-harness/MEMORY.md（长期记忆）与 .deepseek-harness/memory/（每日日志））。" +
-          "写入记忆：项目级约定用 memory_note 工具，跨项目个人偏好用 memory_note_user 工具；读取全部记忆用 memory_read 工具（不要手动 glob/read 记忆文件）。用它保持跨 session 一致性；看不到的内容不要编造。" +
+          "写入记忆：项目级约定用 memory_note 工具，跨项目个人偏好用 memory_note_user 工具；读取记忆用 memory_read 工具，scope 默认 'memory'（用户级 + 项目级 MEMORY.md），需要今日/历史日志时显式传 scope:'daily' 或 'all'（不要手动 glob/read 记忆文件）。用它保持跨 session 一致性；看不到的内容不要编造。" +
+          "注意：上下文中的记忆是**会话起始快照**，不随记忆文件之后的更新自动刷新；需要以当前状态为依据时（改记忆前、或据记忆作答前）用 memory_read 重读。" +
           antiMangle + proactive;
       // 计划模式禁写提示（硬编码默认行为，无开关）：无论记忆模式都追加，让 agent 自觉不写（网关物理兜底仍生效）
       const planNote = state.planModeActive
         ? "\n\n[plan 模式] 当前处于 plan 模式，不要调用 memory_note / memory_note_user 写入记忆，也不要请求删除记忆（读取记忆用 memory_read，仍可用）。"
         : "";
       const introFull = intro + planNote;
-      // v1.7.0：blocks 仅含今日日志（用户级/项目级 MEMORY.md 已移出，改由 E 投影注入）。
-      // 返回值永非空串（只含 intro 时亦然），避免 harness 对空 section 的处理歧义。
-      return blocks.length ? [introFull, ...blocks].join("\n\n") : introFull;
+      // v1.7.1（特性3）：自定义指令追加在「记忆插件 prompt + 记忆分工 prompt」之后 ——
+      // 拼接顺序即 system prompt 里的实际排布（同一 section 内完成，order 不变）。
+      // 它由用户在设置页配置，内容恒定 → 放 system 零缓存成本，不违反本节的分流原则。
+      const custom = typeof cfg.customInstructions === "string" ? cfg.customInstructions.trim() : "";
+      // v1.7.1：本 section 已无任何动态块（日志迁出 E 投影），直接返回常量指令。
+      // 返回值仍非空串（即便自定义指令为空也含 intro），避免 harness 对空 section 的处理歧义。
+      return custom ? `${introFull}\n\n[用户自定义指令] ${custom}` : introFull;
     },
   });
 

package/lib/projection.mjs

@@ -1,28 +1,35 @@
-// memory-palace v1.7.0 特性1：E 投影 —— 记忆正文的独立注入通道。
+// memory-palace E 投影 —— 记忆正文与今日日志的独立注入通道。
 //
 // 背景（v1.6.3 及以前）：用户级 + 项目级 MEMORY.md 走 systemPrompt.section，受
 // 「仅首次注入」限制（`alreadyInjected` 打了标记就不撕，只有 compaction 清），
 // 导致记忆正文在 turn 1 的 step 2 之后就消失、全程不再进场。
 //
-// 现在：两份 MEMORY.md 改经 `agent/pre-step` 投影为**独立 user 消息**，常驻对话历史：
+// 现在：记忆正文改经 `agent/pre-step` 投影为**独立 user 消息**，常驻对话历史：
 // - 每个 step 都可见（消息在历史里，不依赖注入时机）；
-// - 内容未变只写一次（进历史后后续 step 的 decision.messages 已含它 → 去重命中）；
-// - compaction 把消息移出 surface 后，后续 step 找不到 → 自动重注（白送）。
+// - v1.7.1 起去重判据由「全文深比较」改为「**文件身份**」（首行 heading，含路径 + 日期）：
+//   同一文件只注一次，内容再变也不重注 —— 记忆正文由 agent 自己写入，其内容本就在
+//   上下文（tool/call 参数）里，重注纯属冗余；换文件（跨日期日志）才视为新身份注入；
+// - v1.7.1 起**今日工作日志由 systemPrompt.section 迁入本通道**。日志是 agent 唯一
+//   「不知道自己缺」的内容（hybrid 子代理以独立 LLM stream 写入、不回注主对话），
+//   必须注入；迁出后 section 只剩恒定指令 → system prompt 恒定 → 前缀缓存永久有效
+//   （此前日志在 section 里每步求值，一变就让序列最前的整段前缀作废）。
+// - compaction 把消息移出 surface 后，身份判据即判为缺失 → 自动重注**磁盘最新版**，
+//   顺带完成一次「刷新到最新」。
 //
 // 实现照抄宿主 `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)`），
+// 投递方式：同步版——折叠进 `decision.messages`（`toSpliced(lastClaimedIndex + 1, 0, ...pending)`），
 // 不做异步 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 { join } from "node:path";
 import { createUserMessage } from "@deepseek-ai/dsh-llm";
-import { expandHome, toHomeShort, readMdSync, budgetClip, stripSmartTag, stripDeletedLines } from "./common/text.mjs";
+import { expandHome, toHomeShort, todayISO, readMdSync, budgetClip, stripSmartTag, stripDeletedLines } from "./common/text.mjs";
 
 // 投影消息的 source 标注。
 // - kind: 'plugin' → 明确标注"插件注入"，供下游按 source 过滤（子 agent 去噪 / turnBuffer 采集）。
@@ -34,20 +41,35 @@ const PROJECTION_SOURCE = Object.freeze({
   form: "instructions",
 });
 
-// 同一份内容是否已在这批消息里（逐字段深比较，照抄 agent-instructions 的 sameContextPayload）。
-function sameContextPayload(left, right) {
-  return isDeepStrictEqual(left.content, right.content)
-    && isDeepStrictEqual(left.source, right.source);
+// v1.7.1 判据：投影身份 = 消息首行 heading（已编码目标文件路径 + 日期）。
+// 只比身份、不比正文 —— 同一文件投影过一次后，内容再变也不重注。
+function projectionIdentity(msg) {
+  const text = msg?.content?.[0]?.text ?? "";
+  const i = text.indexOf("\n");
+  return i === -1 ? text : text.slice(0, i);
 }
 
-// 扫描当前 surface，判断该 payload 是否已经作为本插件消息存在于会话历史中。
-// 存在 → 不重复注入（"内容不变只写一次"靠它实现）。
+// 只在双方都是本插件投影时才比身份 —— 规避真实用户消息与宿主注入消息
+// （runtime context / skill 目录等）因首行文本巧合而误撞。
+function isOwnProjection(msg) {
+  return msg?.source?.kind === "plugin" && msg?.source?.plugin === "dsh-memory-palace";
+}
+
+function sameProjectionIdentity(left, right) {
+  return isOwnProjection(left) && isOwnProjection(right)
+    && projectionIdentity(left) === projectionIdentity(right);
+}
+
+// 扫描当前 surface，判断该身份是否已经作为本插件消息存在于会话历史中。
+// 存在 → 不重复注入（"同一文件只注一次"靠它实现）。
+// compaction 把消息移出 surface 后即判为缺失 → 自动重注磁盘最新版
+// （身份不变、正文刷新，故无需 injectedSessionIds 之类的标记机制）。
 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;
+    if (event?.type === "user/message" && sameProjectionIdentity(event.data, desired)) return true;
   }
   return false;
 }
@@ -62,10 +84,10 @@ function buildProjection(text, heading) {
 }
 
 /**
- * 收集本步要投影的记忆消息（用户级 + 项目级，各自独立一条）。
- * 两者拆成两条独立消息（v1.7.0 定案）：否则"项目记忆一改，用户记忆连带重发"。
+ * 收集本步要投影的消息（用户级 / 项目级 MEMORY.md / 今日工作日志，各自独立一条）。
+ * 拆成多条独立消息（v1.7.0 定案，v1.7.1 扩展）：否则"某一条内容一改，其余连带重发"。
  * @param {{ getConfig: () => object, paths: object }} deps
- * @returns {object[]} 按 [用户级, 项目级…] 顺序的消息数组（可能为空）
+ * @returns {object[]} 按 [用户级, 项目级…, 今日日志…] 顺序的消息数组（可能为空）
  */
 export function buildProjections({ getConfig, paths }) {
   const cfg = getConfig();
@@ -92,6 +114,16 @@ export function buildProjections({ getConfig, paths }) {
       if (msg) out.push(msg);
     }
   }
+  // 今日工作日志（v1.7.1 由 systemPrompt.section 迁入）。heading 沿用原 section 格式，
+  // 天然含日期与目录 → 跨天 / 换目录自动成为新身份。预算沿用 workspaceBudgetChars，
+  // 与项目级 MEMORY.md 各自独立 budgetClip，互不挤占。
+  for (const dir of paths.readDirs()) {
+    const text = readMdSync(join(dir, `${todayISO()}.md`));
+    if (!text) continue;
+    const clipped = stripSmartTag(stripDeletedLines(budgetClip(text, cfg.workspaceBudgetChars)));
+    const msg = buildProjection(clipped, `# 今日工作日志 (${todayISO()} @ ${toHomeShort(dir)})`);
+    if (msg) out.push(msg);
+  }
   return out;
 }
 
@@ -109,10 +141,10 @@ export function registerProjection({ ctx, getConfig, paths }) {
       const session = agent?.session;
       const desired = buildProjections({ getConfig, paths });
       if (!desired.length) return decision;
-      // 逐条去重：已被本步的 messages 覆盖、或已在 surface 上的，跳过。
+      // 逐条去重（按**文件身份**、非内容）：已被本步 messages 覆盖、或已在 surface 上的，跳过。
       const pending = desired.filter((msg) =>
-        !messages.some((m) => sameContextPayload(m, msg))
-        && !decision.messages.some((m) => sameContextPayload(m, msg))
+        !messages.some((m) => sameProjectionIdentity(m, msg))
+        && !decision.messages.some((m) => sameProjectionIdentity(m, msg))
         && !alreadyOnSurface(session, msg));
       if (!pending.length) return decision;
       // 折叠位置：紧跟在"本步被认领的消息"之后，使直接提示在前、驱动追加的 runtime context 在后。

package/lib/tools.mjs

@@ -1,15 +1,15 @@
 // memory-palace 记忆工具：memory_note / memory_note_user / memory_read / memory_delete
 // + 删除硬确认闸门（tools/pre-execute → harness 原生确认弹窗）。
-// 经 registerTools 注入 ctx/config/paths/records/运行时状态；在 index.mjs 装配时调用一次。
+// 经 registerTools 注入 ctx/config/paths/运行时状态；在 index.mjs 装配时调用一次。
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import { join } from "node:path";
-import { todayISO, expandHome, toHomeShort, readMdSync } from "./common/text.mjs";
+import { todayISO, isoDaysAgo, expandHome, toHomeShort, readMdSync, budgetClip } from "./common/text.mjs";
 import { appendLineDedup, findMatches, removeLineByMatch, recentLogDates } from "./common/records.mjs";
 
 /**
- * @param {{ ctx: object, getConfig: () => object, paths: object, records: object, state: object }} deps
+ * @param {{ ctx: object, getConfig: () => object, paths: object, state: object }} deps
  */
-export function registerTools({ ctx, getConfig, paths, records, state }) {
+export function registerTools({ ctx, getConfig, paths, state }) {
   const cfg = () => getConfig();
 
   // 删除作用域的中文标签。
@@ -162,18 +162,34 @@ export function registerTools({ ctx, getConfig, paths, records, state }) {
     }),
   );
 
-  // ---------- 可选工具：读取全部记忆（用户级 + 项目级 MEMORY.md 与每日日志） ----------
-  // AI 说"读取项目记忆/看看记忆"时直接调用，返回聚合内容，避免 AI 自己翻文件、只找 MEMORY.md 而漏掉每日日志。
+  // ---------- 可选工具：读取记忆（scope 控制范围，默认只读 durable 长期记忆） ----------
+  // AI 说"读取项目记忆/看看记忆"时直接调用，返回聚合内容，避免 AI 自己翻文件、只找 MEMORY.md 而漏掉项目级记忆。
+  // v1.7.1：加 scope（memory 默认 / project / today / yesterday / daily / all）—— 当日日志实测
+  // 可达 1.7 万字符，默认值刻意不含它；确实需要日志时必须显式传 scope。
+  // project 原名 node —— 为与 memory_write / memory_update_section 的 scope='project' 统一而更名，消除读写两侧命名歧义。
   ctx.tools.register(
     defineTool({
       name: "memory_read",
       description:
-        "Read all persistent memory: user-level MEMORY.md (cross-project preferences), " +
-        "and for the current project the workspace MEMORY.md plus recent daily logs " +
-        "(YYYY-MM-DD.md) from .workbuddy/memory, .codebuddy/memory, or .deepseek-harness/memory. " +
-        "Use this instead of manually globbing/reading memory files — it aggregates everything. " +
-        "This tool takes no parameters; call it with an empty object, e.g. tools.memory_read({}) — the runtime rejects undefined arguments.",
-      parameters: {},
+        "Read persistent memory. scope defaults to 'memory' and decides what comes back: " +
+        "'memory' (default) = user-level MEMORY.md (cross-project preferences) + this project's workspace MEMORY.md; " +
+        "'project' = this project's workspace MEMORY.md only (same naming as the write-side scope of memory_write / memory_update_section); " +
+        "'today' / 'yesterday' = that single day's daily log; " +
+        "'daily' = the last three days of logs (today + yesterday + the day before); " +
+        "'all' = memory + daily (large — only when the logs are genuinely needed). " +
+        "Start from the default scope and widen it only when the question is really about logs. " +
+        "Use this instead of manually globbing/reading memory files. " +
+        "Call it as tools.memory_read({}) or tools.memory_read({ scope: 'daily' }) — the runtime rejects undefined arguments.",
+      parameters: {
+        scope: {
+          type: "string",
+          enum: ["memory", "project", "today", "yesterday", "daily", "all"],
+          description:
+            "What to read. 'memory' (default) = user-level + workspace MEMORY.md (durable long-term memory; usually all you need). " +
+            "'project' = workspace MEMORY.md only (same value as the write-side scope of memory_write). 'today' / 'yesterday' = that single day's log. " +
+            "'daily' = last three days of logs. 'all' = memory + daily.",
+        },
+      },
       output: {
         schema: {
           type: "object",
@@ -186,28 +202,50 @@ export function registerTools({ ctx, getConfig, paths, records, state }) {
         },
         render: (_args, value) => [{ type: "text", text: value?.memory ?? value?.message ?? "No memory." }],
       },
-      async execute() {
+      async execute(args = {}) {
         const c = cfg();
         if (!c.enabled) return { ok: false, message: "memory-palace is currently disabled in settings.", memory: "" };
+        // v1.7.1：默认 scope='memory'（长期记忆）。刻意不设 'all' —— 默认全量会让 agent
+        // 不加思考地把日志（实测单日可达 1.7 万字符）一起吞下，白白吃掉上下文。
+        const scope = args?.scope ?? "memory";
+        const wantUser = scope === "memory" || scope === "all";
+        const wantProject = scope === "memory" || scope === "project" || scope === "all";
+        // 日志按**日期**取（而非"最近 N 份文件"——跨日跳空会取偏）：today / yesterday / daily(近三天) / all
+        const logDays =
+          scope === "today" ? [0]
+            : scope === "yesterday" ? [1]
+              : scope === "daily" || scope === "all" ? [0, 1, 2]
+                : [];
         try {
           const blocks = [];
-          const userFile = expandHome(c.userMemoryPath);
-          const userFileShort = toHomeShort(userFile);
-          const u = readMdSync(userFile);
-          if (u) blocks.push(`# 用户级记忆 (${userFileShort})\n${u}`);
+          if (wantUser) {
+            const userFile = expandHome(c.userMemoryPath);
+            const u = readMdSync(userFile);
+            if (u) blocks.push(`# 用户级记忆 (${toHomeShort(userFile)})\n${u}`);
+          }
           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${w}`);
-            const t = readMdSync(join(dir, `${todayISO()}.md`));
-            if (t) blocks.push(`# 今日工作日志 (${todayISO()} @ ${dirShort})\n${t}`);
-            const recent = await records.recentLogs(dir);
-            if (recent) blocks.push(recent);
+            if (wantProject) {
+              // 标题必须用实际读到的 MEMORY.md 路径，而非日志目录 —— dsh 布局下 MEMORY.md 位于
+              // 日志目录的上一级，旧实现拿 dir（.../memory）当标题会误导真实路径（buddy 布局
+              // MEMORY.md 恰在 memory/ 内所以未暴露）。与 E 投影的 per-file 粒度对齐。
+              for (const f of paths.memoryReadCandidates(dir)) {
+                const t = readMdSync(f);
+                if (t) blocks.push(`# 工作区记忆 (${toHomeShort(f)})\n${t}`);
+              }
+            }
+            for (const n of logDays) {
+              const day = isoDaysAgo(n);
+              const t = readMdSync(join(dir, `${day}.md`));
+              if (!t) continue;
+              const label = n === 0 ? "今日" : n === 1 ? "昨日" : "前日";
+              blocks.push(`# ${label}工作日志 (${day} @ ${dirShort})\n${budgetClip(t, c.workspaceBudgetChars)}`);
+            }
           }
           if (!blocks.length) {
-            return { ok: true, message: "No memory files found yet.", memory: "" };
+            return { ok: true, message: `No memory files found (scope=${scope}).`, memory: "" };
           }
-          return { ok: true, message: "Memory loaded.", memory: blocks.join("\n\n") };
+          return { ok: true, message: `Memory loaded (scope=${scope}).`, memory: blocks.join("\n\n") };
         } catch (e) {
           return { ok: false, message: `Failed: ${e}`, memory: "" };
         }

package/package.json

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