dsh-memory-palace 1.8.3-alpha.2 → 1.8.4-alpha.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.2.1-rc.2](https://img.shields.io/badge/DeepSeek%20Harness-0.2.1--rc.2-success.svg?labelColor=4D6BFE)](https://github.com/deepseek-ai/deepseek-harness) [![Desktop: supported](https://img.shields.io/badge/Desktop-supported-success.svg?labelColor=4D6BFE)](#安装)
+[![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.2.1-rc.5](https://img.shields.io/badge/DeepSeek%20Harness-0.2.1--rc.5-success.svg?labelColor=4D6BFE)](https://github.com/deepseek-ai/deepseek-harness) [![Desktop: supported](https://img.shields.io/badge/Desktop-supported-success.svg?labelColor=4D6BFE)](#安装)
 
 ## 特性
 
@@ -10,12 +10,11 @@
 - **双层记忆**：用户级（跨项目个人偏好）+ 工作区级（项目约定），互不干扰。
 - **WorkBuddy / CodeBuddy 桥接**：项目已有对应记忆目录时直接读写，无需重复维护。
 - **记忆工具**：AI 可主动写入、聚合读取、按内容删除（删除需人工确认），写入自带去重。
-- **会话命令重整记忆**：手打 `/memory_reorganize` 触发项目记忆全量重整（沿用「超出注入预算 且 过冷却期」双门禁 + 原生确认，原文件自动整档备份）；
+- **会话命令重整记忆**：手打 `/memory_reorganize`（中文可打 `/记忆重整`）触发项目记忆全量重整（沿用「超出注入预算 且 过冷却期」双门禁 + 原生确认，原文件自动整档备份）；
 - **设置页集成**：全部配置均可在 DSH 设置面板中图形化调整（按板块折叠），无需改配置文件。
-- **自定义指令**：不适合写进记忆的特殊指令可在设置页配置，插件经系统提示词注入。
+- **自定义指令**：不适合写进记忆的特殊指令写在 profile 的 `.memory-palace/user-commands.md`（设置页也能编辑），插件经系统提示词注入。
 - **记忆注入**：长期记忆与今日日志以「会话起始快照」常驻上下文、按文件身份各只注入一次 —— 既保证每个步骤都可见，又不破坏前缀缓存、不堆积冗余快照。
-- **记忆写入（v1.8.0 起唯一模式）**：**记忆子代理**每轮自动整理今日日志并去重（章节化、标删），**长期记忆 `MEMORY.md` 由主 AI 主动维护**，兼顾自动化与可控性。
-    - v1.8.0 破坏性变更：原「主动记忆（插件模式）」与「智能模式」已整体移除。二者的能力已被覆盖——主动落档由分工指令引导主 AI 承担，逐轮摘要由记忆子代理写进日志承担。
+- **记忆写入**：**记忆子代理**每轮自动整理今日日志并去重（章节化、标删），**长期记忆 `MEMORY.md` 由主 AI 主动维护**，兼顾自动化与可控性。
 - **标准插件包**：经官方插件机制一键安装，无需改动 harness。
 
 ## 记忆文件布局
@@ -35,6 +34,8 @@
         └── 2026-08-16.md          # 每日工作日志
 ```
 
+> 自定义指令**不放在记忆目录里**，而是 profile 私有文件：`$DSH_HOME/profiles/<profile>/.memory-palace/user-commands.md`（与排障日志同根）。它是个人偏好而非项目事实，跟着 profile 走、可被编辑器直接修改。
+
 ## 工作原理
 
 **读取（每轮对话）**——两条通道并行：
@@ -69,8 +70,6 @@
 
 ## 安装
 
-> 要求 DeepSeek Harness **`^0.2.1-alpha.1`**（由 `package.json` 的 `engines.dsh` 判定，0.2.0 线及以下会被插件管理器直接拒绝）。
-
 ### CLI 版（`web` profile）
 
 方式一：直接通过 GitHub 安装（推荐，`lib/` 构建产物已随仓库分发，装即用）
@@ -107,7 +106,6 @@ dsh plugin --profile web remove dsh-memory-palace
 ```
 
 ### Desktop 版
-- github: `github:lovezi0/dsh-memory-palace`
 - npm: `dsh-memory-palace`
 
 ## 配置
@@ -121,6 +119,11 @@ dsh plugin --profile web remove dsh-memory-palace
 
 ## 版本历史
 
+- **1.8.4**
+    - **1.8.4-alpha.1**
+        - 💥用户自定义指令落盘位置迁移
+        - 💪memory_reorganize 指令支持中文
+        - 🐛memory_reorganize 指令无效问题修复
 - **1.8.3**
     - **1.8.3-alpha.2**
         - 💪超预算回显附重整门禁指引，避免 agent 多轮精简替换凑数

package/lib/api.mjs

@@ -1,9 +1,10 @@
-// memory-palace 自有同源 route（/memory-palace/api）：设置读写（真保存）。
-// 经 registerApi 注入 ctx/paths/设置面；在 index.mjs 装配时调用一次。
+// memory-palace 自有同源 route（/memory-palace/api）：设置读写（真保存）+ 自定义指令读写。
+// 经 registerApi 注入 ctx/设置面/userCommands；在 index.mjs 装配时调用一次。
 // 机制：client 直接 fetch 本 route，handler 内走服务端 settings.replace → settings-file 持久化，
 // 绕开 settingsScope（非 loopback 下 set() no-op）与 apiproxy allowlist 两层限制（参考 dsh-better-sidebar）。
-// distill.project / distill.project.preview 两个 action 已随「蒸馏项目记忆」功能移除，
-// 本 route 现仅剩设置读写（settings.get / settings.update）。
+// distill.project / distill.project.preview 两个 action 已随「蒸馏项目记忆」功能移除。
+// userCommands.* 走文件而不是配置：真源 = <profile>/.memory-palace/user-commands.md
+// （旧配置项 customInstructions 已摘除，本 route 不再读写它）。
 const API_MAX_BODY_BYTES = 1 << 20;
 
 function apiHeader(headers, name) {
@@ -113,9 +114,9 @@ export function applyDebugLogLinkage(section) {
 }
 
 /**
- * @param {{ ctx: object, getSettingsFace: () => object | null }} deps
+ * @param {{ ctx: object, getSettingsFace: () => object | null, userCommands: object }} deps
  */
-export function registerApi({ ctx, getSettingsFace }) {
+export function registerApi({ ctx, getSettingsFace, userCommands }) {
   ctx.effect(
     () =>
       ctx.webServer.register({
@@ -162,6 +163,19 @@ export function registerApi({ ctx, getSettingsFace }) {
               apiWriteOk(res, await face.replace(section, expectedRevision));
               return;
             }
+            // 自定义指令：真源是 profile 目录下的 Markdown 文件，不经过配置节。
+            if (method === "userCommands.get") {
+              apiWriteOk(res, { path: userCommands.file(), text: await userCommands.read() });
+              return;
+            }
+            if (method === "userCommands.update") {
+              const text = payload?.text;
+              if (typeof text !== "string") {
+                throw Object.assign(new Error("text must be a string"), { code: "bad-request", status: 400 });
+              }
+              apiWriteOk(res, await userCommands.write(text));
+              return;
+            }
             apiWriteError(res, Object.assign(new Error(`unknown memory-palace API method "${method}"`), { code: "not-found", status: 404 }));
           } catch (error) {
             apiWriteError(res, error);

package/lib/client.js

@@ -62,7 +62,12 @@ window.__ModuleLoader__.load({
       distillTimeoutHint: "单次记忆子代理 LLM 调用的超时上限（秒）；超时视为失败并降级。默认 60 秒。",
       customLabel: "自定义指令内容",
       customHint: "非空时注入系统提示词，位置在记忆插件与分工说明之后。对全部会话生效；留空则不注入。",
-      customPlaceholder: "例如：回答用中文；代码注释用英文；提交信息用祈使句…"
+      customPath: "落盘位置：",
+      customPlaceholder: "例如：回答用中文；代码注释用英文；提交信息用祈使句…",
+      reorgAliasLabel: "记忆重整",
+      reorgAliasDesc: "全量重整项目记忆 MEMORY.md（沿用双门禁与确认弹窗）",
+      commandFailed: "命令未执行：",
+      commandStarted: "命令已提交"
     };
 
     const en = {
@@ -116,7 +121,12 @@ window.__ModuleLoader__.load({
       distillTimeoutHint: "Timeout (in seconds) for a single memory sub-agent LLM call; on timeout it fails and degrades. Default 60s.",
       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…"
+      customPath: "Stored at:",
+      customPlaceholder: "e.g. Answer in Chinese; write code comments in English; use imperative commit subjects…",
+      reorgAliasLabel: "Reorganize memory",
+      reorgAliasDesc: "Fully reorganize the project MEMORY.md (gated, with a confirmation dialog)",
+      commandFailed: "Command did not run:",
+      commandStarted: "Command submitted"
     };
 
 
@@ -138,8 +148,9 @@ window.__ModuleLoader__.load({
         summaryTimeoutMs: v.summaryTimeoutMs != null ? String(Math.round((Number(v.summaryTimeoutMs) || 0) / 1000)) : "60",
         summaryModel: v.summaryModel || "",
         reorgCooldownDays: v.reorgCooldownDays != null ? String(v.reorgCooldownDays) : "7",
-        subagentLogBudget: v.subagentLogBudget != null ? String(v.subagentLogBudget) : "20000",
-        customInstructions: v.customInstructions || ""
+        subagentLogBudget: v.subagentLogBudget != null ? String(v.subagentLogBudget) : "20000"
+        // customInstructions 已移出配置：真源是 profile 目录下的
+        // .memory-palace/user-commands.md，走 apiGetUserCommands / apiUpdateUserCommands。
       };
     }
 
@@ -178,6 +189,31 @@ window.__ModuleLoader__.load({
       return { value: v.value || {}, user: v.user || {}, revision: v.revision };
     }
 
+    // 自定义指令：不再属于配置节，真源是 <profile>/.memory-palace/user-commands.md。
+    async function apiGetUserCommands() {
+      const resp = await fetch("/memory-palace/api/userCommands.get", {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: "{}",
+      });
+      const parsed = await resp.json().catch(() => null);
+      if (!parsed || parsed.ok !== true) throw new Error(parsed?.error?.message ?? `HTTP ${resp.status}`);
+      const v = parsed.value || {};
+      return { path: typeof v.path === "string" ? v.path : "", text: typeof v.text === "string" ? v.text : "" };
+    }
+
+    async function apiUpdateUserCommands(text) {
+      const resp = await fetch("/memory-palace/api/userCommands.update", {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ text }),
+      });
+      const parsed = await resp.json().catch(() => null);
+      if (!parsed || parsed.ok !== true) throw new Error(parsed?.error?.message ?? `HTTP ${resp.status}`);
+      const v = parsed.value || {};
+      return { path: typeof v.path === "string" ? v.path : "", text: typeof v.text === "string" ? v.text : "" };
+    }
+
 
     // 模型枚举改走 ctx.remote.session.modelCatalog()——ApiProxy 包已在
     // DSH 0.1.2-alpha.2 删除（旧 conn.api.llm.models 死了）。服务缺席 / 非 ok / 异常
@@ -206,6 +242,10 @@ window.__ModuleLoader__.load({
       const [remote, setRemote] = react.useState({ value: null, user: {}, revision: undefined, loaded: false });
       const [draft, setDraft] = react.useState(() => projectDraft({ value: null }));
       const [dirty, setDirty] = react.useState(false);
+      // 自定义指令不属于配置节：独立状态，真源是 user-commands.md。
+      // saved = 磁盘上最后一次读到/写入的内容，供「放弃」还原。
+      const [commands, setCommands] = react.useState({ path: "", text: "", saved: "" });
+      const [cmdDirty, setCmdDirty] = react.useState(false);
       const [saving, setSaving] = react.useState(false);
       const [failed, setFailed] = react.useState(false);
       const [validation, setValidation] = react.useState(null);
@@ -214,15 +254,16 @@ window.__ModuleLoader__.load({
       // 的语义 —— 纯前端临时状态、**不持久化**：「用户打开哪张卡」是一次阅读手势，不是配置。
       const [openCards, setOpenCards] = react.useState({});
 
-      // 初始加载（从自有 route 读真实值）。
+      // 初始加载（从自有 route 读真实值）。自定义指令走独立 action（文件真源），与配置并行拉取。
       react.useEffect(() => {
         let alive = true;
         (async () => {
           try {
-            const full = await apiGetFull();
+            const [full, cmd] = await Promise.all([apiGetFull(), apiGetUserCommands()]);
             if (alive) {
               setRemote({ value: full.value, user: full.user, revision: full.revision, loaded: true });
               setDraft(projectDraft({ value: full.value }));
+              setCommands({ path: cmd.path, text: cmd.text, saved: cmd.text });
             }
           } catch (e) {
             if (alive) setRemote((r) => ({ ...r, loaded: true }));
@@ -272,10 +313,23 @@ window.__ModuleLoader__.load({
         if (FIELD_NUMERIC.has(field)) setValidation((v) => (v === field ? null : v));
       }
 
+      // 自定义指令：独立于配置 draft，保存走 userCommands.update（写文件）。
+      function editCommands(text) {
+        setCommands((c) => ({ ...c, text }));
+        setCmdDirty(true);
+        setFailed(false);
+      }
+
       async function save() {
         setSaving(true);
         setFailed(false);
         try {
+          // 自定义指令先落盘：它写的是独立文件，没有 revision 冲突，失败即整体失败提示。
+          if (cmdDirty) {
+            const saved = await apiUpdateUserCommands(commands.text);
+            setCommands({ path: saved.path, text: saved.text, saved: saved.text });
+            setCmdDirty(false);
+          }
           // 整节替换（replace 语义）：空值字段省略 → 自动回退 base/schema 默认。
           const section = {};
           for (const field of Object.keys(draft)) {
@@ -312,6 +366,8 @@ window.__ModuleLoader__.load({
       function discard() {
         setDraft(projectDraft(remote));
         setDirty(false);
+        setCommands((c) => ({ ...c, text: c.saved }));
+        setCmdDirty(false);
         setFailed(false);
         setValidation(null);
       }
@@ -338,11 +394,15 @@ window.__ModuleLoader__.load({
           })
         ]);
 
-      const row = (label, hint, control, field) => h("div", { style: fieldStyle }, [
+      // dirtyNow：该行自己的「未保存」判据（默认跟随整节 dirty）。
+      // 自定义指令写的是独立文件，与配置节的 dirty 不同步，故单独传。
+      const row = (label, hint, control, field, dirtyNow) => h("div", { style: fieldStyle }, [
         h("div", { style: headStyle }, [
           h("label", { style: labelStyle }, label),
-          dirty && field ? h("span", { style: mutedBadgeStyle }, t("unsaved")) : null,
-          !dirty && field && isOverridden(field) ? h("span", { style: badgeStyle }, t("overridden")) : null
+          (dirtyNow === undefined ? dirty : dirtyNow) && field
+            ? h("span", { style: mutedBadgeStyle }, t("unsaved")) : null,
+          !(dirtyNow === undefined ? dirty : dirtyNow) && field && isOverridden(field)
+            ? h("span", { style: badgeStyle }, t("overridden")) : null
         ]),
         control,
         hint ? h("p", { style: hintStyle }, hint) : null
@@ -602,12 +662,14 @@ window.__ModuleLoader__.load({
               onChange: (e) => edit("silentPresets", e.target.value)
             }), "silentPresets")
         ]),
-        // 自定义指令。非空时经 system prompt 追加到「记忆分工说明」之后；
-        // 它是恒定内容（用户配置一次不变），故放 section 而非 E 投影 —— 零缓存成本。
+        // 自定义指令。真源是 <profile>/.memory-palace/user-commands.md（不再进配置）；
+        // 非空时经 system prompt 追加到「记忆分工说明」之后。
+        // 它是恒定内容（改文件才变），故放 section 而非 E 投影 —— 零缓存成本。
         card("custom", t("custom"), t("customDesc"), [
-          row(t("customLabel"), t("customHint"),
+          row(t("customLabel"),
+            commands.path ? t("customHint") + " " + t("customPath") + commands.path : t("customHint"),
             h("textarea", {
-              value: draft.customInstructions,
+              value: commands.text,
               disabled,
               rows: 6,
               placeholder: t("customPlaceholder"),
@@ -619,8 +681,8 @@ window.__ModuleLoader__.load({
                 lineHeight: "1.6",
                 resize: "vertical"
               },
-              onChange: (e) => edit("customInstructions", e.target.value)
-            }), "customInstructions")
+              onChange: (e) => editCommands(e.target.value)
+            }), "userCommands", cmdDirty)
         ]),
         card("smartSummary", t("smartSummary"), t("smartSummaryDesc"), [
           // ---- 本卡片内三处删除已落地——① 记忆写入总开关：写入恒定进行，停写只剩
@@ -719,9 +781,89 @@ window.__ModuleLoader__.load({
     }
 
 
+    // 中文会话命令：宿主 server 命令名限 ^[a-z][a-z0-9_-]*$，中文无法直接注册；
+    // 但 client 的 commandUi contribution 只查重名、不限字符集——把 name 写成中文，
+    // 斜杠菜单即可用中文检索，回车 / 点选都能精确认领（与宿主 /model 的菜单行为同源）。
+    // 执行链与英文命令完全一致：action 里转发 /memory_reorganize，服务端逻辑零分叉。
+    const REORG_COMMAND_NAME = "memory_reorganize";
+    const REORG_ALIAS_NAME = "记忆重整";
+
+    // 命令反馈：command/run 与 command/done 都是宿主 log-only 事件，
+    // 客户端要等下一次会话装载才随日志回放渲染——命令执行完当场"什么都没发生"。
+    // 故命令结算后一律经 composer notice 立即回显（成功 info / 失败 error），
+    // 不依赖会话流刷新，也不污染模型上下文。
+    // 通道不可用时静默（会话流里最终仍有命令行，不影响主流程）。
+    function notifyComposer(ctx, sessionId, level, text) {
+      try {
+        const sessions = typeof ctx.get === "function" ? ctx.get("sessions") : undefined;
+        const actx = sessions && typeof sessions.scope === "function" ? sessions.scope(sessionId) : undefined;
+        const conversation = actx && typeof actx.get === "function" ? actx.get("conversation") : undefined;
+        if (conversation && conversation.input && typeof conversation.input.for === "function") {
+          conversation.input.for(actx).notify(level, text);
+        }
+      } catch {
+        /* 提示通道不可用：忽略 */
+      }
+    }
+
+    function registerCommandAlias(ctx, t) {
+      // commandUi 是可选服务：无命令面的部署（或测试替身）缺席时静默跳过，绝不阻塞主体。
+      if (typeof ctx.inject !== "function") return;
+      ctx.inject(["commandUi"], (scope) => {
+        const commandUi = scope && scope.commandUi;
+        if (!commandUi || typeof commandUi.register !== "function") return;
+        const contribution = {
+          name: REORG_ALIAS_NAME,
+          label: () => t("reorgAliasLabel"),
+          description: () => t("reorgAliasDesc"),
+          available: () => true,
+          ui: {
+            kind: "action",
+            run: (session) => {
+              const sessionId = session && session.sessionId;
+              if (!sessionId) return;
+              void (async () => {
+                try {
+                  // 成功/失败结果由下方的 command/executed 监听统一回显（转发同样会 emit）。
+                  const response = await ctx.remote.commands.execute(sessionId, "/" + REORG_COMMAND_NAME, []);
+                  if (!response || response.ok !== true) {
+                    // RPC 本身失败（未进入 handler）→ 不会有 command/executed，自行提示。
+                    const message = response && response.error && response.error.message
+                      ? response.error.message
+                      : "";
+                    notifyComposer(ctx, sessionId, "error", t("commandFailed") + (message ? " " + message : ""));
+                  }
+                } catch (error) {
+                  const message = error && error.message ? error.message : String(error);
+                  notifyComposer(ctx, sessionId, "error", t("commandFailed") + " " + message);
+                }
+              })();
+            }
+          }
+        };
+        if (typeof scope.effect === "function") {
+          scope.effect(() => commandUi.register(contribution), "memory-palace: 中文命令 alias");
+        } else {
+          commandUi.register(contribution);
+        }
+      });
+      // 英文命令与中文别名的结算都经过这里：log-only 事件不实时推送，必须主动回显。
+      if (typeof ctx.on === "function") {
+        ctx.on("command/executed", (sessionId, name, result) => {
+          if (name !== REORG_COMMAND_NAME || !result) return;
+          const failed = result.kind === "error";
+          const text = result.text || (failed ? t("commandFailed") : t("commandStarted"));
+          notifyComposer(ctx, sessionId, failed ? "error" : "info", text);
+        });
+      }
+    }
+
+
     function apply(ctx) {
       ctx.effect(() => ctx.locale.register(NS, { zh, en }), "memory-palace: dictionaries");
       const t = ctx.locale.bind(NS);
+      // 中文会话命令（/记忆重整）+ 命令失败提示（composer notice）。
+      registerCommandAlias(ctx, t);
       // 设置读写走自有 route（/memory-palace/api），不再 bind settingsScope——
       // 非 loopback 下 settingsScope persistence=memory（set() no-op），保存永不落盘。
       const controller = new MemoryPalaceController(ctx);

package/lib/common/user-commands.mjs

@@ -0,0 +1,84 @@
+// 用户自定义指令的唯一真源：<profileContext.dir>/.memory-palace/user-commands.md
+//
+// 旧版把自定义指令放在配置项 `customInstructions`（profile 的 cordis.patch.yml），
+// 本模块【不读配置】——该字段已从 schema 摘除，存量值静默失效。
+//
+// 取径依据：profileContext.dir = $DSH_HOME/profiles/<profile>，由宿主 CLI 与 Desktop
+// 经同一个 runProfile 提供（与 common/logger.mjs 的日志落点同根），故两端都可用。
+// 拿不到 profileContext 时**绝不猜路径**：读取返回空串、写入抛错。
+//
+// 读路径是同步的（systemPrompt.section.text() 必须是同步函数，每步调用），
+// 故按 mtimeMs 缓存：文件未变就复用上次内容，避免每步都读盘。
+import { mkdir, rename, writeFile } from "node:fs/promises";
+import { readFileSync, statSync } from "node:fs";
+import { dirname, join } from "node:path";
+
+/** profile 私有目录名（与日志落点共用）。 */
+export const USER_COMMANDS_DIR = ".memory-palace";
+/** 自定义指令文件名。 */
+export const USER_COMMANDS_FILE = "user-commands.md";
+
+/** 去掉 BOM，其余原样保留（用户排版由用户决定）。 */
+function stripBom(text) {
+  return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+}
+
+/**
+ * @param {{ ctx: object }} deps
+ * @returns {{ file: () => string | null, readSync: () => string, read: () => Promise<string>, write: (text: string) => Promise<{ path: string, text: string }> }}
+ */
+export function createUserCommands({ ctx }) {
+  // file → 上次读到的内容；mtimeMs = -1 表示强制重读。
+  let cache = { file: null, mtimeMs: -1, text: "" };
+
+  function file() {
+    const pc = typeof ctx?.get === "function" ? ctx.get("profileContext") : undefined;
+    const dir = pc?.dir;
+    return typeof dir === "string" && dir ? join(dir, USER_COMMANDS_DIR, USER_COMMANDS_FILE) : null;
+  }
+
+  // 同步读取（供 system prompt 每步调用）。任何异常都不外抛——section.text() 抛错会毁整轮对话。
+  function readSync() {
+    const target = file();
+    if (!target) {
+      cache = { file: null, mtimeMs: -1, text: "" };
+      return "";
+    }
+    try {
+      const info = statSync(target);
+      if (cache.file === target && cache.mtimeMs === info.mtimeMs) return cache.text;
+      const text = stripBom(readFileSync(target, "utf8"));
+      cache = { file: target, mtimeMs: info.mtimeMs, text };
+      return text;
+    } catch {
+      // 文件不存在 / 不可读：视为无自定义指令，并清掉旧缓存（防删除后仍注入）。
+      cache = { file: target, mtimeMs: -1, text: "" };
+      return "";
+    }
+  }
+
+  async function read() {
+    return readSync();
+  }
+
+  // 原子写：先写同目录临时文件再 rename，避免半截内容被注入。
+  async function write(text) {
+    const target = file();
+    if (!target) {
+      throw Object.assign(new Error("无法定位 user-commands.md：当前运行环境没有 profileContext.dir"), {
+        code: "no-profile",
+        status: 503,
+      });
+    }
+    const body = stripBom(String(text ?? ""));
+    await mkdir(dirname(target), { recursive: true, mode: 0o700 });
+    const tmp = `${target}.tmp`;
+    await writeFile(tmp, body, { encoding: "utf8", mode: 0o600 });
+    await rename(tmp, target);
+    // 强制下次 readSync 重新 stat（同毫秒写入时 mtime 可能未变）。
+    cache = { file: target, mtimeMs: -1, text: body };
+    return { path: target, text: body };
+  }
+
+  return { file, readSync, read, write };
+}

package/lib/index.js

@@ -32,6 +32,7 @@ import Schema from "@deepseek-ai/schemastery";
 import { extractText, extractToolErrorText } from "./common/text.mjs";
 import { createPaths } from "./common/paths.mjs";
 import { createLogger } from "./common/logger.mjs";
+import { createUserCommands } from "./common/user-commands.mjs";
 import { planModeOf } from "./common/planmode.mjs";
 import { REORG_COMMAND_PROMPT, REORG_MESSAGE_PREFIX } from "./common/prompts.mjs";
 import { registerTools } from "./tools.mjs";
@@ -92,9 +93,10 @@ export const Config = Schema.object({
   // ---- 记忆子代理配置 ----
   reorgCooldownDays: Schema.number().default(7).description("项目级 MEMORY.md 全量重整的冷却天数（距上次重整）。与「超出注入预算」（`workspaceBudgetChars`，即项目级 MEMORY.md 大于该值）双条件同时满足才允许 memory_reorganize；时间戳以 HTML 注释落在 MEMORY.md 文件尾。").volatile(),
   subagentLogBudget: Schema.number().default(20000).description("记忆子代理回喂今日工作日志的字符上限。超出时仅回喂章节目录，子代理用 log_read_section 按需读取章节。").volatile(),
-  // ---- ：自定义指令（用户自写，经 system prompt 注入到「记忆分工 prompt」之后） ----
-  // 放 system 而非 E 投影：用户配置一次即恒定 → 零缓存成本（见下方 section 的分流原则）。
-  customInstructions: Schema.string().default("").description("自定义指令：非空时追加到系统提示词「记忆分工说明」之后，用于承载不适合写进用户记忆的特殊指令。对全部会话生效；留空则不注入。").volatile(),
+  // ---- 原自定义指令配置项（customInstructions）已移除 ----
+  // 破坏性变更：自定义指令改由 <profile>/.memory-palace/user-commands.md 承载，
+  // 配置里不再有该字段，也不再读取存量值（老 profile 的旧键作为未知键透传、静默失效）。
+  // 理由：人类可读 Markdown 才是真源，指令不该埋在 profile patch 里。
 });
 
 // 适配 dsh 0.2.1-alpha.1——Web 面删除 webRuntime 服务，信任权威改由 webStartup 携带
@@ -268,9 +270,11 @@ export function apply(ctx, config) {
   // 落点 `<profileDir>/.memory-palace/logs/<sessionId>/{info,debug}.log`，统一受 distillDebugLog 门控。
   // 取径与分级依据见 src/common/logger.mjs 文件头。
   const logger = createLogger({ ctx, getConfig: () => source() });
+  // 自定义指令真源 = <profile>/.memory-palace/user-commands.md（不读配置；profileContext 缺失时读取为空）。
+  const userCommands = createUserCommands({ ctx });
   registerTools({ ctx, getConfig: () => source(), paths, state });
-  // distill 句柄已随「蒸馏项目记忆」功能移除；route 现只剩设置读写。
-  registerApi({ ctx, getSettingsFace });
+  // distill 句柄已随「蒸馏项目记忆」功能移除；route 现剩设置读写 + 自定义指令读写。
+  registerApi({ ctx, getSettingsFace, userCommands });
   // 记忆子代理模块（原 hybrid）。必须【无条件注册】——apply() 同步段执行时 settings 服务
   // 尚未挂载，此刻 source() 读的是 cordis 组合配置（未显式配置时即 schema 默认）；
   // 条件注册会在热配置变化后导致工具/子代理从未注册（实装踩坑：配置写着启用但
@@ -633,8 +637,10 @@ export function apply(ctx, config) {
       const introFull = [lead, files, read, proactive, tail].join("\n\n") + planNote;
       // 自定义指令追加在「记忆插件 prompt + 记忆分工 prompt」之后 ——
       // 拼接顺序即 system prompt 里的实际排布（同一 section 内完成，order 不变）。
-      // 它由用户在设置页配置，内容恒定 → 放 system 零缓存成本，不违反本节的分流原则。
-      const custom = typeof cfg.customInstructions === "string" ? cfg.customInstructions.trim() : "";
+      // 真源是 <profile>/.memory-palace/user-commands.md（用户手改或设置页编辑）；
+      // 内容恒定（改文件才变）→ 放 system 零缓存成本，不违反本节的分流原则。
+      // readSync 内部按 mtimeMs 缓存，文件未变时不读盘。
+      const custom = userCommands.readSync().trim();
       // 本 section 已无任何动态块（日志迁出 E 投影），直接返回常量指令。
       // 返回值仍非空串（即便自定义指令为空也含 intro），避免 harness 对空 section 的处理歧义。
       return custom ? `${introFull}\n\n[用户自定义指令] ${custom}` : introFull;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-memory-palace",
-  "version": "1.8.3-alpha.2",
+  "version": "1.8.4-alpha.1",
   "description": "把 WorkBuddy 的文件式记忆系统移植进 DeepSeek Harness：用户级 + 工作区的人类可读 Markdown 记忆（~/.deepseek-harness/MEMORY.md 与 <cwd>/.deepseek-harness/memory/）。",
   "type": "module",
   "main": "lib/index.js",
@@ -41,7 +41,7 @@
     }
   },
   "engines": {
-    "dsh": "^0.2.1-alpha.1"
+    "dsh": "^0.2.1-rc.5"
   },
   "peerDependencies": {
     "@deepseek-ai/schemastery": "~3.18.5-alpha.1"