@max-null/dsh-memory 0.5.2 → 0.6.0

package/README.md

@@ -46,6 +46,11 @@ npm install @max-null/dsh-memory
 
 ## 使用流程（人工确认闸门）
 
+提示词模板库（0.6.0）：`prompt_search / prompt_get / prompt_list / prompt_add` 四个工具管理**模板库**——
+md 文件是唯一事实源（`~/.dsh/prompt-library/*.md` 为 global；`<workspace>/.dsh/prompt-library/` 随工作区分享），
+前端（记忆面板「模板」tab / 模型工具）检索同一份索引；模板存在即生效（`source: agent` 角标标识模型新增），
+**永不注入 system prompt**。
+
 ```
 模型 memory_save     →  status: suggested（只是建议，未生效）
 人 memory_confirm    →  status: approved（已审核；是否常驻注入由独立开关 injected 决定）

package/client.js

@@ -153,6 +153,26 @@ function registerSettingsNavIcon(label) {
 var STRINGS = {
   zh: {
     tabMemory: "\u8BB0\u5FC6",
+    tabPrompt: "\u6A21\u677F",
+    promptEmpty: "\u6682\u65E0\u6A21\u677F\uFF08\u70B9\u300C\u65B0\u589E\u6A21\u677F\u300D\u6216\u5F80 ~/.dsh/prompt-library \u653E md \u6587\u4EF6\uFF09",
+    promptRefresh: "\u5237\u65B0\u7D22\u5F15",
+    promptAdd: "\u65B0\u589E\u6A21\u677F",
+    promptInsert: "\u63D2\u5165\u8F93\u5165\u6846",
+    promptInserted: "\u5DF2\u63D2\u5165",
+    promptInsertUnavailable: "\u65E0\u6D3B\u52A8\u4F1A\u8BDD/\u8F93\u5165\u6846",
+    promptDelete: "\u5220\u9664",
+    promptDeleteConfirm: "\u5220\u9664\u6A21\u677F\uFF08md \u6587\u4EF6\u4E0E\u7D22\u5F15\u4E00\u5E76\u5220\u9664\uFF09\uFF1F",
+    promptFormName: "\u540D\u79F0",
+    promptFormContent: "\u6B63\u6587",
+    promptFormDimension: "\u7EF4\u5EA6\uFF08\u524D\u7AEF/\u540E\u7AEF/\u2026\uFF09",
+    promptFormDifficulty: "\u96BE\u5EA6\uFF08L1-L5/LX\uFF09",
+    promptFormTags: "\u6807\u7B7E\uFF08\u9017\u53F7\u5206\u9694\uFF09",
+    promptFormFallback: "\u5907\u7528\u63D0\u793A\u8BCD",
+    promptFormSubmit: "\u5199\u5165\u6A21\u677F\u5E93",
+    promptFormCancel: "\u53D6\u6D88",
+    promptSearch: "\u641C\u7D22\u6A21\u677F\u2026",
+    promptAgent: "agent",
+    promptFilterAll: "\u5168\u90E8",
     memorySearch: "\u641C\u7D22\u8BB0\u5FC6\u2026",
     empty: "\u9ED1\u6697\u4E2D\u672A\u89C1\u7075\u5149",
     confirm: "\u786E\u8BA4",
@@ -178,6 +198,26 @@ var STRINGS = {
   },
   en: {
     tabMemory: "Memory",
+    tabPrompt: "Templates",
+    promptEmpty: 'No templates yet (use "Add template" or drop md files into ~/.dsh/prompt-library)',
+    promptRefresh: "Refresh index",
+    promptAdd: "Add template",
+    promptInsert: "Insert into input",
+    promptInserted: "Inserted",
+    promptInsertUnavailable: "No active session/input",
+    promptDelete: "Delete",
+    promptDeleteConfirm: "Delete this template (md file + index)?",
+    promptFormName: "Name",
+    promptFormContent: "Body",
+    promptFormDimension: "Dimension (\u524D\u7AEF/\u540E\u7AEF/\u2026)",
+    promptFormDifficulty: "Difficulty (L1-L5/LX)",
+    promptFormTags: "Tags (comma separated)",
+    promptFormFallback: "Fallback prompt",
+    promptFormSubmit: "Write to library",
+    promptFormCancel: "Cancel",
+    promptSearch: "Search templates\u2026",
+    promptAgent: "agent",
+    promptFilterAll: "All",
     memorySearch: "Search memory\u2026",
     empty: "No spark in the dark",
     confirm: "Confirm",
@@ -298,9 +338,240 @@ var memoryApi = {
   },
   injectionPreview(cwd) {
     return api("injectionPreview", { ...cwd === void 0 ? {} : { cwd } });
+  },
+  // ── 提示词模板库（0.6.0）──
+  promptList(cwd) {
+    return api("prompt.list", { ...cwd === void 0 ? {} : { cwd } });
+  },
+  promptGet(nameOrId, cwd) {
+    return api("prompt.get", { name: nameOrId, ...cwd === void 0 ? {} : { cwd } });
+  },
+  promptAdd(payload, cwd) {
+    return api("prompt.add", { ...payload, ...cwd === void 0 ? {} : { cwd } });
+  },
+  promptRemove(nameOrId, cwd) {
+    return api("prompt.remove", { name: nameOrId, ...cwd === void 0 ? {} : { cwd } });
+  },
+  promptRefresh(cwd) {
+    return api("prompt.refresh", { ...cwd === void 0 ? {} : { cwd } });
   }
 };
 var ORGANIZE_PROMPT = "\u8BF7\u6574\u7406\u6211\u7684\u8BB0\u5FC6\u5E93\uFF1A\u7528 memory_list \u67E5\u770B\u5168\u90E8\u8BB0\u5FC6\u3002\u6574\u7406\u89C4\u5219\uFF08\u5FC5\u987B\u6267\u884C\uFF09\uFF1A\u2460\u540C\u7C7B\u6761\u76EE\u5408\u5E76\u2014\u2014\u5DE5\u4F5C\u4E60\u60EF/\u7EA6\u5B9A\u7C7B\u591A\u6761\u5408\u5E76\u4E3A\u4E00\u6761\uFF08\u5185\u5BB9\u7528 \u2460\u2461\u2462 \u5E76\u5217\uFF0C\u907F\u514D\u788E\u7247\u5316\uFF09\uFF1B\u2461\u4E0E\u300C[\u8BB0\u5FC6\u7CFB\u7EDF\u81EA\u8FF0]\u300D\uFF08\u4F60\u4E0A\u4E0B\u6587\u4E2D\u7684\u8BB0\u5FC6\u673A\u5236\u8BF4\u660E\uFF09\u5185\u5BB9\u91CD\u590D\u7684\u63D2\u4EF6\u4ECB\u7ECD\u6761\u76EE\uFF08\u5982 dsh-memory \u63D2\u4EF6\u53D1\u5E03\u4FE1\u606F\uFF09\u5E94\u5220\u9664\u2014\u2014\u673A\u5236\u8BF4\u660E\u5DF2\u7531\u7CFB\u7EDF\u5E38\u9A7B\u63D0\u4F9B\uFF0C\u65E0\u9700\u7528\u6237\u5B58\u50A8\uFF1B\u2462\u5BF9\u8FC7\u65F6\u3001\u9519\u8BEF\u6216\u5DF2\u53D8\u5316\u7684\u5185\u5BB9\u7528 memory_update \u4FEE\u6B63\uFF08\u4F1A\u91CD\u7F6E\u4E3A\u5F85\u5BA1\u6838\uFF09\uFF1B\u2463\u7CBE\u7B80\u5197\u957F\u5185\u5BB9\uFF0C\u4E3A\u6BCF\u6761\u8865\u5145\u6216\u4FEE\u6B63 keywords\uFF1B\u2464\u9700\u8981\u5220\u9664\u7684\u7528 memory_forget\uFF0C\u9700\u8981\u65B0\u589E\u7684\u7528 memory_save\u3002\u5224\u65AD\u5185\u5BB9\u662F\u5426\u8FC7\u65F6\u7684\u65B9\u6CD5\uFF1A\u628A\u8BB0\u5FC6\u91CC\u63D0\u5230\u7684\u5DE5\u5177\u540D/\u6570\u91CF\u4E0E\u4F60\u5F53\u524D\u5B9E\u9645\u53EF\u7528\u7684\u8BB0\u5FC6\u5DE5\u5177\u5BF9\u7167\u2014\u2014\u4F60\u5F53\u524D\u53EF\u7528\uFF1Amemory_save / memory_list / memory_search / memory_confirm / memory_forget / memory_update\uFF08\u5171 6 \u4E2A\uFF09\uFF1B\u82E5\u8BB0\u5FC6\u4E2D\u7684\u5DE5\u5177\u5217\u8868\u3001\u6570\u91CF\u3001\u6D41\u7A0B\u4E0E\u6B64\u4E0D\u7B26\u5373\u4E3A\u8FC7\u65F6\uFF0C\u7528 memory_update \u4FEE\u6B63\u3002\u6539\u52A8\u5168\u90E8\u843D\u5728 suggested \u7B49\u5F85\u5BA1\u6838\uFF08\u4E0D\u8981\u8C03\u7528 memory_confirm\uFF09\uFF0C\u5B8C\u6210\u540E\u7528\u4E00\u53E5\u8BDD\u6C47\u62A5\u6574\u7406\u7ED3\u679C\u3002";
+function insertIntoInput(ctx, text) {
+  const sessions = ctx.get?.("sessions");
+  const conversation = ctx.get?.("conversation");
+  if (sessions === void 0 || conversation?.input?.for === void 0) return { ok: false, reason: "unavailable" };
+  const current = sessions.list?.getSnapshot?.()?.current;
+  if (current === void 0 || current === "") return { ok: false, reason: "no-active-session" };
+  const actx = sessions.scope(current);
+  if (actx === void 0) return { ok: false, reason: "no-scope" };
+  const input = conversation.input.for(actx);
+  if (input === void 0) return { ok: false, reason: "no-input" };
+  try {
+    input.setDraft(text);
+    return { ok: true };
+  } catch {
+    return { ok: false, reason: "setDraft-failed" };
+  }
+}
+function PromptView(props) {
+  const t = useT();
+  const [items, setItems] = (0, import_react.useState)([]);
+  const [query, setQuery] = (0, import_react.useState)("");
+  const [expanded, setExpanded] = (0, import_react.useState)(null);
+  const [detail, setDetail] = (0, import_react.useState)(null);
+  const [note, setNote] = (0, import_react.useState)(null);
+  const [formOpen, setFormOpen] = (0, import_react.useState)(false);
+  const [form, setForm] = (0, import_react.useState)({});
+  const reload = async () => {
+    try {
+      setItems(await memoryApi.promptList(props.cwd));
+    } catch {
+    }
+  };
+  (0, import_react.useEffect)(() => {
+    if (props.visible) void reload();
+  }, [props.visible]);
+  const flash = (text) => {
+    setNote(text);
+    setTimeout(() => setNote(null), 2e3);
+  };
+  const q = query.trim().toLowerCase();
+  const filtered = items.filter((item) => {
+    if (q === "") return true;
+    const hay = [
+      String(item.name ?? ""),
+      String(item.dimension ?? ""),
+      String(item.difficulty ?? ""),
+      (item.tags ?? []).join(" "),
+      String(item.summary ?? "")
+    ].join(" ").toLowerCase();
+    return hay.includes(q);
+  });
+  const openPrompt = async (item) => {
+    const key = String(item.id ?? item.name);
+    if (expanded === key) {
+      setExpanded(null);
+      setDetail(null);
+      return;
+    }
+    setExpanded(key);
+    try {
+      setDetail(await memoryApi.promptGet(String(item.name ?? item.id), props.cwd));
+    } catch {
+      setDetail(null);
+    }
+  };
+  const insert = (item) => {
+    const text = String(detail?.body ?? item.summary ?? "");
+    const result = insertIntoInput(props.ctx, text);
+    flash(result.ok ? t("promptInserted") : `${t("promptInsertUnavailable")} (${result.reason ?? "?"})`);
+  };
+  const remove = async (item) => {
+    if (!window.confirm(t("promptDeleteConfirm"))) return;
+    await memoryApi.promptRemove(String(item.name ?? item.id), props.cwd).catch(() => null);
+    await reload();
+  };
+  const submitForm = async () => {
+    if ((form.name ?? "").trim() === "" || (form.content ?? "").trim() === "") return;
+    await memoryApi.promptAdd({
+      name: form.name.trim(),
+      content: form.content,
+      ...(form.dimension ?? "").trim() === "" ? {} : { dimension: form.dimension.trim() },
+      ...(form.difficulty ?? "").trim() === "" ? {} : { difficulty: form.difficulty.trim() },
+      ...(form.tags ?? "").trim() === "" ? {} : { tags: form.tags.split(",").map((tag) => tag.trim()).filter((tag) => tag !== "") },
+      ...(form.fallback ?? "").trim() === "" ? {} : { fallback: form.fallback }
+    }, props.cwd);
+    setForm({});
+    setFormOpen(false);
+    await reload();
+  };
+  const field = (key, hint, multiline = false) => (0, import_react.createElement)(multiline ? "textarea" : "input", {
+    key,
+    value: form[key] ?? "",
+    placeholder: hint,
+    rows: multiline ? 4 : void 0,
+    onChange: (event) => {
+      setForm((prev) => ({ ...prev, [key]: event.target.value }));
+    },
+    style: {
+      width: "100%",
+      boxSizing: "border-box",
+      padding: "6px 10px",
+      fontSize: 12,
+      fontFamily: "inherit",
+      background: "var(--dsw-alias-bg-layer-1, #0f141d)",
+      border: "1px solid var(--dsw-alias-border-l2, #1e2836)",
+      borderRadius: 6,
+      color: "var(--dsw-alias-label-primary, #d8e0ea)",
+      outline: "none"
+    }
+  });
+  return (0, import_react.createElement)(
+    "div",
+    { style: { display: "flex", flexDirection: "column", gap: 8, flex: 1, minHeight: 0, overflowY: "auto" } },
+    (0, import_react.createElement)(
+      "div",
+      { style: { display: "flex", gap: 6 } },
+      (0, import_react.createElement)("button", { type: "button", style: { ...ssid.btn, color: ssid.accent, borderColor: ssid.accent }, onClick: () => {
+        setFormOpen((open) => !open);
+      } }, t("promptAdd")),
+      (0, import_react.createElement)("button", { type: "button", style: ssid.btn, onClick: () => {
+        void reload();
+      } }, t("promptRefresh")),
+      (0, import_react.createElement)("input", {
+        value: query,
+        onChange: (event) => {
+          setQuery(event.target.value);
+        },
+        placeholder: t("promptSearch"),
+        style: {
+          flex: 1,
+          padding: "6px 10px",
+          fontSize: 12.5,
+          boxSizing: "border-box",
+          background: "var(--dsw-alias-bg-layer-1, #0f141d)",
+          border: "1px solid var(--dsw-alias-border-l2, #1e2836)",
+          borderRadius: 8,
+          color: "var(--dsw-alias-label-primary, #d8e0ea)",
+          outline: "none"
+        }
+      }),
+      note === null ? null : (0, import_react.createElement)("span", { style: { ...ssid.muted, alignSelf: "center" } }, note)
+    ),
+    formOpen ? (0, import_react.createElement)(
+      "div",
+      { style: ssid.card },
+      (0, import_react.createElement)(
+        "div",
+        { style: { display: "flex", flexDirection: "column", gap: 6 } },
+        field("name", t("promptFormName")),
+        field("dimension", t("promptFormDimension")),
+        field("difficulty", t("promptFormDifficulty")),
+        field("tags", t("promptFormTags")),
+        field("content", t("promptFormContent"), true),
+        field("fallback", t("promptFormFallback"), true),
+        (0, import_react.createElement)(
+          "div",
+          { style: { display: "flex", gap: 6, justifyContent: "flex-end" } },
+          (0, import_react.createElement)("button", { type: "button", style: ssid.btn, onClick: () => {
+            setFormOpen(false);
+            setForm({});
+          } }, t("promptFormCancel")),
+          (0, import_react.createElement)("button", { type: "button", style: { ...ssid.btn, color: ssid.accent, borderColor: ssid.accent }, onClick: () => {
+            void submitForm();
+          } }, t("promptFormSubmit"))
+        )
+      )
+    ) : null,
+    filtered.length === 0 ? (0, import_react.createElement)("div", { style: ssid.empty }, t("promptEmpty")) : filtered.map((item) => {
+      const key = String(item.id ?? item.name);
+      const open = expanded === key;
+      return (0, import_react.createElement)(
+        "div",
+        { key, style: ssid.card },
+        (0, import_react.createElement)(
+          "div",
+          { style: { cursor: "pointer", display: "flex", flexDirection: "column", gap: 4 }, onClick: () => {
+            void openPrompt(item);
+          } },
+          (0, import_react.createElement)(
+            "div",
+            { style: { display: "flex", alignItems: "baseline", gap: 6 } },
+            (0, import_react.createElement)("span", { style: { ...ssid.text, fontWeight: 600 } }, String(item.name ?? "")),
+            item.source === "agent" ? (0, import_react.createElement)("span", { style: { fontSize: 10, color: "#f7c94f", fontWeight: 600 } }, t("promptAgent")) : null,
+            (0, import_react.createElement)(
+              "span",
+              { style: { ...ssid.muted, fontSize: 10.5 } },
+              [String(item.dimension ?? ""), String(item.difficulty ?? "")].filter((part) => part !== "").join(" \xB7 ")
+            )
+          ),
+          (item.tags ?? []).length > 0 ? (0, import_react.createElement)(
+            "div",
+            { style: { display: "flex", gap: 4, flexWrap: "wrap" } },
+            item.tags.slice(0, 6).map((tag) => (0, import_react.createElement)("span", { key: tag, style: { fontSize: 10, padding: "1px 6px", borderRadius: 999, border: "1px solid var(--dsw-alias-border-l2, #1e2836)", color: "var(--dsw-alias-label-secondary, #67748a)" } }, tag))
+          ) : null,
+          (0, import_react.createElement)("span", { style: ssid.muted }, String(item.summary ?? "").slice(0, 120))
+        ),
+        open ? (0, import_react.createElement)(
+          "div",
+          { style: { marginTop: 6 } },
+          detail === null ? (0, import_react.createElement)("div", { style: ssid.muted }, "\u2026") : (0, import_react.createElement)("pre", { style: { ...ssid.muted, whiteSpace: "pre-wrap", margin: 0, fontSize: 12, maxHeight: 180, overflowY: "auto" } }, String(detail.body ?? "")),
+          (0, import_react.createElement)(
+            "div",
+            { style: { display: "flex", gap: 6, marginTop: 6, justifyContent: "flex-end" } },
+            (0, import_react.createElement)("button", { type: "button", style: { ...ssid.btn, color: ssid.accent, borderColor: ssid.accent }, onClick: () => {
+              insert(item);
+            } }, t("promptInsert")),
+            (0, import_react.createElement)("button", { type: "button", style: { ...ssid.btn, color: "#f76f4f", borderColor: "#f76f4f" }, onClick: () => {
+              void remove(item);
+            } }, t("promptDelete"))
+          )
+        ) : null
+      );
+    })
+  );
+}
 var DAY_MS = 864e5;
 var COLD_DAYS = 30;
 function fmtDate(ms) {
@@ -312,6 +583,7 @@ function isCold(usedAt, now = Date.now()) {
 }
 function MemoryView(props) {
   const t = useT();
+  const [mode, setMode] = (0, import_react.useState)("mem");
   const [records, setRecords] = (0, import_react.useState)([]);
   const [query, setQuery] = (0, import_react.useState)("");
   const [namespace, setNamespace] = (0, import_react.useState)(null);
@@ -409,9 +681,32 @@ function MemoryView(props) {
     { key: "ondemand", label: t("groupOnDemand"), items: filtered.filter((record) => record.status === "approved" && !record.injected) },
     { key: "injected", label: t("groupInjected"), items: filtered.filter((record) => record.status === "approved" && record.injected) }
   ].filter((group) => group.items.length > 0);
+  const modeTabs = (0, import_react.createElement)(
+    "div",
+    { style: { display: "flex", gap: 4 } },
+    ["mem", "prompt"].map(
+      (m) => (0, import_react.createElement)("button", {
+        key: m,
+        type: "button",
+        onClick: () => {
+          setMode(m);
+        },
+        style: { flex: 1, ...ssid.btn, ...mode === m ? { color: ssid.accent, borderColor: ssid.accent } : {} }
+      }, m === "mem" ? t("tabMemory") : t("tabPrompt"))
+    )
+  );
+  if (mode === "prompt") {
+    return (0, import_react.createElement)(
+      "div",
+      { style: ssid.wrap },
+      modeTabs,
+      (0, import_react.createElement)(PromptView, { visible: props.visible, cwd: props.cwd, ctx: props.ctx })
+    );
+  }
   return (0, import_react.createElement)(
     "div",
     { style: ssid.wrap },
+    modeTabs,
     (0, import_react.createElement)(
       "div",
       { style: ssid.header },

package/dist/engine.d.ts

@@ -5,6 +5,7 @@
  * is always created `suggested` and becomes effective only through `setStatus`.
  */
 import { Service } from '@deepseek-ai/cordis';
+import { type PromptFile } from './prompt-files.ts';
 declare const memoryIdBrand: unique symbol;
 /** Opaque identity of one stored memory record. */
 export type MemoryId = string & {
@@ -18,6 +19,27 @@ export type MemoryNamespace = 'global' | 'project';
  * 审核通过。注入与否由独立维度 `injected` 控制（见 MemoryRecord）。
  */
 export type MemoryStatus = 'suggested' | 'approved';
+/**
+ * 记录类别（0.6.0 模板库）：'fact' = 常规记忆（缺省，旧数据即此）；
+ * 'prompt' = 提示词模板索引记录（文件是事实源，见 prompt-files.ts）。
+ */
+export type MemoryKind = 'fact' | 'prompt';
+/** prompt 索引记录的附加元数据（与 md 文件 frontmatter 对齐，工具/UI 直接取用）。 */
+export interface PromptMetaIndex {
+    seq?: number;
+    name: string;
+    dimension?: string;
+    difficulty?: string;
+    tags: string[];
+    /** 索引摘要（正文前 200 字）。 */
+    summary: string;
+    /** md 文件绝对路径（引擎内部使用；工具输出不暴露）。 */
+    path: string;
+    /** 索引时的文件 mtime（惰性刷新比对）。 */
+    mtime: number;
+    /** user=用户创建；agent=模型新增（UI 角标）。 */
+    source: 'user' | 'agent';
+}
 export interface MemoryRecord {
     id: MemoryId;
     namespace: MemoryNamespace;
@@ -30,6 +52,10 @@ export interface MemoryRecord {
     updatedAt: number;
     /** 最近一次被 memory_search 命中的时间（0.5.3 冷热追踪）；无则未命中过。 */
     lastUsedAt?: number;
+    /** 记录类别（缺省 'fact'）。 */
+    kind?: MemoryKind;
+    /** prompt 记录元数据（仅 kind==='prompt'）。 */
+    meta?: PromptMetaIndex;
 }
 export interface MemoryWrite {
     content: string;
@@ -40,6 +66,8 @@ export interface MemoryFilter {
     namespace?: MemoryNamespace;
     status?: MemoryStatus;
     injected?: boolean;
+    /** 记录类别过滤（0.6.0）；缺省不过滤（工具层显式传 kind='fact' 保持旧行为）。 */
+    kind?: MemoryKind;
 }
 export interface MemoryHit {
     record: MemoryRecord;
@@ -99,6 +127,9 @@ export interface MemoryConfig {
     embeddings?: MemoryEmbeddings;
     /** 语义侧参与融合的 topK（0.5.2）；默认 5。 */
     semanticTopK?: number;
+    /** 全局提示词模板根目录（0.6.0）；默认 `$DSH_HOME/prompt-library`。
+     *  project 模板随工作区（`<workspace>/.dsh/prompt-library`，与记忆同构）。 */
+    promptGlobalRoot?: string;
 }
 /**
  * Cross-session plaintext memory over the storage hub, split by namespace:
@@ -184,5 +215,42 @@ export declare class MemoryEngine extends Service {
     private recordsOf;
     private tableFor;
     private requireTable;
+    /** 全局模板根（默认 `$DSH_HOME/prompt-library`，可配置覆盖）。 */
+    private promptGlobalDir;
+    /** project 模板根（随工作区 `<workspace>/.dsh/prompt-library`，与记忆同构）。 */
+    private promptProjectDir;
+    /** 稳定索引 id（按路径 hash；文件删除后随刷新清理）。 */
+    private promptIdOf;
+    /**
+     * 扫描模板目录并同步索引（mtime 惰性：未变条目零写；目录缺失 = 空库）。
+     * @returns 统计（扫描数/变更数/清理数 + 坏文件警告）。
+     */
+    refreshPromptIndex(projectCwd?: string): Promise<{
+        scan: number;
+        changed: number;
+        removed: number;
+        warnings: string[];
+    }>;
+    /**
+     * 取模板（id 或名称/路径片段定位），返回 md 全文（直读文件，忽略索引缓存）。
+     * @throws 未命中或文件解析失败（错误信息可读）。
+     */
+    promptGet(nameOrId: string, projectCwd?: string): Promise<PromptFile>;
+    /**
+     * 新增模板：写 md 文件（序号自动分配/文件名安全化/同名防覆盖）+ 刷新索引。
+     * 返回索引记录（模型新增 source='agent'，UI 角标提示）。
+     */
+    promptAdd(input: {
+        name: string;
+        dimension?: string;
+        difficulty?: string;
+        tags?: string[];
+        content: string;
+        fallback?: string;
+        source: 'user' | 'agent';
+        namespace?: MemoryNamespace;
+    }, projectCwd?: string): Promise<MemoryRecord>;
+    /** 删除模板：md 文件与索引一并删除；未命中返回 false。 */
+    promptRemove(idOrName: string, projectCwd?: string): Promise<boolean>;
 }
 export {};

package/dist/engine.js

@@ -13,6 +13,7 @@ import { z } from 'zod';
 import { defineDomain, domainTable, DomainFacility } from '@deepseek-ai/dsh-storage-domain';
 import { JsonStorageBackend } from '@deepseek-ai/dsh-storage-json';
 import { bm25FieldScores, cosineSimilarity, rrfFuse } from "./bm25.js";
+import { parsePromptFile, scanPromptDir, writePromptFile } from "./prompt-files.js";
 /** Brand a string as a {@link MemoryId} (compile-time only). */
 export function MemoryId(id) {
     return id;
@@ -27,6 +28,18 @@ const blockSchema = z.object({
     updatedAt: z.number(),
     lastUsedAt: z.number().optional(),
     vector: z.array(z.number()).optional(),
+    kind: z.enum(['fact', 'prompt']).optional(),
+    meta: z.object({
+        seq: z.number().optional(),
+        name: z.string(),
+        dimension: z.string().optional(),
+        difficulty: z.string().optional(),
+        tags: z.array(z.string()),
+        summary: z.string(),
+        path: z.string(),
+        mtime: z.number(),
+        source: z.enum(['user', 'agent']),
+    }).optional(),
 });
 /** Shared table shape; the two domains differ only by name and backend route. */
 function memorySpec(name) {
@@ -75,7 +88,7 @@ function normalizeBlock(block) {
     return { status: block.status, injected: block.injected ?? false };
 }
 function toRecord(id, block) {
-    return {
+    const base = {
         id: MemoryId(id),
         namespace: block.namespace,
         ...normalizeBlock(block),
@@ -85,6 +98,12 @@ function toRecord(id, block) {
         updatedAt: block.updatedAt,
         ...block.lastUsedAt === undefined ? {} : { lastUsedAt: block.lastUsedAt },
     };
+    // 0.6.0 模板库字段（缺省 fact；prompt 元数据透传）
+    return {
+        ...base,
+        ...block.kind === undefined ? {} : { kind: block.kind },
+        ...block.meta === undefined ? {} : { meta: block.meta },
+    };
 }
 /** Harness-home root for `global` memories. */
 function globalRoot() {
@@ -234,7 +253,8 @@ export class MemoryEngine extends Service {
     async list(filter, projectCwd) {
         const records = await this.allRecords(filter?.namespace, projectCwd);
         return records.filter(record => (filter?.status === undefined || record.status === filter.status)
-            && (filter?.injected === undefined || record.injected === filter.injected));
+            && (filter?.injected === undefined || record.injected === filter.injected)
+            && (filter?.kind === undefined || (record.kind ?? 'fact') === filter.kind));
     }
     async search(query, filter, projectCwd) {
         const records = await this.list(filter, projectCwd);
@@ -404,36 +424,35 @@ export class MemoryEngine extends Service {
      * 「常驻注入」开关调用（remote.setInjected）。
      */
     async setInjected(id, injected, projectCwd) {
-        const global = this.requireTable('global').get(id);
-        if (global !== undefined) {
-            const updated = {
-                ...global,
-                status: normalizeBlock(global).status,
-                injected,
-                updatedAt: Date.now(),
-            };
-            await this.requireTable('global').put(id, updated);
-            const record = toRecord(id, updated);
-            this.ctx.emit('memory/changed', { operation: 'injected', id, injected });
-            return record;
-        }
-        const project = await this.projectTableFor(projectCwd);
-        if (project !== undefined) {
-            const block = project.get(id);
-            if (block !== undefined) {
-                const updated = {
-                    ...block,
-                    status: normalizeBlock(block).status,
-                    injected,
-                    updatedAt: Date.now(),
-                };
-                await project.put(id, updated);
-                const record = toRecord(id, updated);
-                this.ctx.emit('memory/changed', { operation: 'injected', id, injected });
-                return record;
+        const locate = async () => {
+            const global = this.requireTable('global').get(id);
+            if (global !== undefined)
+                return { table: this.requireTable('global'), block: global };
+            const project = await this.projectTableFor(projectCwd);
+            if (project !== undefined) {
+                const block = project.get(id);
+                if (block !== undefined)
+                    return { table: project, block };
             }
+            return undefined;
+        };
+        const found = await locate();
+        if (found === undefined)
+            throw new Error(`cannot set injected of unknown memory '${id}'`);
+        // 模板永不注入（0.6.0）：prompt 记录拒绝开关（UI 对该类不展示开关，此处兜底）
+        if ((found.block.kind ?? 'fact') === 'prompt') {
+            throw new Error(`cannot set injected of prompt record '${id}': prompt templates are never injected`);
         }
-        throw new Error(`cannot set injected of unknown memory '${id}'`);
+        const updated = {
+            ...found.block,
+            status: normalizeBlock(found.block).status,
+            injected,
+            updatedAt: Date.now(),
+        };
+        await found.table.put(id, updated);
+        const record = toRecord(id, updated);
+        this.ctx.emit('memory/changed', { operation: 'injected', id, injected });
+        return record;
     }
     /**
      * 修改一条记忆的内容/关键词（0.3.1 整理记忆用）。内容被模型改动后
@@ -528,4 +547,151 @@ export class MemoryEngine extends Service {
             throw new Error('memory engine is not started yet');
         return table;
     }
+    // ── 提示词模板库（0.6.0）：md 文件是事实源，索引记录 kind='prompt' ──────
+    /** 全局模板根（默认 `$DSH_HOME/prompt-library`，可配置覆盖）。 */
+    promptGlobalDir() {
+        return this.config.promptGlobalRoot ?? join(process.env.DSH_HOME ?? join(homedir(), '.dsh'), 'prompt-library');
+    }
+    /** project 模板根（随工作区 `<workspace>/.dsh/prompt-library`，与记忆同构）。 */
+    promptProjectDir(projectCwd) {
+        if (projectCwd === undefined || projectCwd === '')
+            return '';
+        return join(projectCwd, '.dsh', 'prompt-library');
+    }
+    /** 稳定索引 id（按路径 hash；文件删除后随刷新清理）。 */
+    promptIdOf(path) {
+        let h = 5381;
+        const text = path.toLowerCase();
+        for (let i = 0; i < text.length; i++)
+            h = ((h << 5) + h + text.charCodeAt(i)) | 0;
+        return MemoryId(`prompt-${Math.abs(h).toString(36)}`);
+    }
+    /**
+     * 扫描模板目录并同步索引（mtime 惰性：未变条目零写；目录缺失 = 空库）。
+     * @returns 统计（扫描数/变更数/清理数 + 坏文件警告）。
+     */
+    async refreshPromptIndex(projectCwd) {
+        const globalDir = this.promptGlobalDir();
+        const projectDir = this.promptProjectDir(projectCwd);
+        const globalScan = scanPromptDir(globalDir);
+        const projectScan = scanPromptDir(projectDir);
+        const scanned = [...globalScan.files, ...projectScan.files];
+        const warnings = [...globalScan.warnings, ...projectScan.warnings];
+        const globalTable = this.requireTable('global');
+        const projectTable = projectCwd !== undefined && projectCwd !== ''
+            ? await this.projectTableFor(projectCwd)
+            : undefined;
+        const existing = await this.list({ kind: 'prompt' }, projectCwd);
+        const existingById = new Map(existing.map(record => [String(record.id), record]));
+        const seen = new Set();
+        let changed = 0;
+        let removed = 0;
+        const now = Date.now();
+        for (const file of scanned) {
+            const id = this.promptIdOf(file.path);
+            seen.add(String(id));
+            const isGlobal = file.path.startsWith(globalDir);
+            const table = isGlobal ? globalTable : projectTable;
+            if (table === undefined)
+                continue;
+            const prev = existingById.get(String(id));
+            if (prev?.meta !== undefined && prev.meta.mtime === file.mtime)
+                continue; // mtime 未变：零写
+            const keywords = [
+                file.meta.name,
+                ...(file.meta.dimension !== undefined ? [file.meta.dimension] : []),
+                ...(file.meta.difficulty !== undefined ? [file.meta.difficulty] : []),
+                ...file.meta.tags,
+            ].filter(keyword => keyword !== '').map(keyword => keyword.toLowerCase());
+            const block = {
+                namespace: isGlobal ? 'global' : 'project',
+                status: 'approved', // 文件存在即生效（设计文档 §三：模板不做审核流）
+                injected: false, // 模板永不注入
+                content: [file.meta.name, file.meta.dimension ?? '', file.meta.difficulty ?? '', file.meta.tags.join(' '), file.summary]
+                    .filter(part => part !== '').join(' '),
+                keywords,
+                createdAt: prev?.createdAt ?? now,
+                updatedAt: now,
+                kind: 'prompt',
+                meta: {
+                    seq: file.meta.seq,
+                    name: file.meta.name,
+                    dimension: file.meta.dimension,
+                    difficulty: file.meta.difficulty,
+                    tags: file.meta.tags,
+                    summary: file.summary,
+                    path: file.path,
+                    mtime: file.mtime,
+                    source: file.meta.source,
+                },
+            };
+            await table.put(id, block);
+            changed++;
+        }
+        for (const record of existing) {
+            if (seen.has(String(record.id)))
+                continue;
+            if (record.meta === undefined)
+                continue;
+            const isGlobal = record.meta.path.startsWith(globalDir);
+            const table = isGlobal ? globalTable : projectTable;
+            if (table !== undefined) {
+                await table.delete(record.id);
+                removed++;
+            }
+        }
+        return { scan: scanned.length, changed, removed, warnings };
+    }
+    /**
+     * 取模板（id 或名称/路径片段定位），返回 md 全文（直读文件，忽略索引缓存）。
+     * @throws 未命中或文件解析失败（错误信息可读）。
+     */
+    async promptGet(nameOrId, projectCwd) {
+        const records = await this.list({ kind: 'prompt' }, projectCwd);
+        const needle = nameOrId.trim();
+        const hit = records.find(record => {
+            if (record.meta === undefined)
+                return false;
+            const stem = (record.meta.path.split(/[\\/]/).pop() ?? '').replace(/\.md$/i, '');
+            const afterSeq = stem.replace(/^\d+_/, ''); // 去掉序号前缀：36_名称 → 名称
+            return String(record.id) === needle || afterSeq === needle || afterSeq.includes(needle);
+        });
+        if (hit === undefined || hit.meta === undefined) {
+            throw new Error(`prompt '${nameOrId}' not found（可用 prompt_list 查看全部）`);
+        }
+        const text = readFileSync(hit.meta.path, 'utf8');
+        const parsed = parsePromptFile(hit.meta.path, text);
+        if (!parsed.ok)
+            throw new Error(`prompt file ${hit.meta.path} parse failed: ${parsed.error}`);
+        return parsed.file;
+    }
+    /**
+     * 新增模板：写 md 文件（序号自动分配/文件名安全化/同名防覆盖）+ 刷新索引。
+     * 返回索引记录（模型新增 source='agent'，UI 角标提示）。
+     */
+    async promptAdd(input, projectCwd) {
+        const dir = input.namespace === 'project' ? this.promptProjectDir(projectCwd) : this.promptGlobalDir();
+        if (dir === '')
+            throw new Error('cannot write project prompt without a workspace cwd');
+        const path = writePromptFile(dir, input);
+        await this.refreshPromptIndex(projectCwd);
+        const found = (await this.list({ kind: 'prompt' }, projectCwd))
+            .find(record => String(record.id) === String(this.promptIdOf(path)));
+        if (found === undefined)
+            throw new Error('prompt written but index refresh failed');
+        return found;
+    }
+    /** 删除模板：md 文件与索引一并删除；未命中返回 false。 */
+    async promptRemove(idOrName, projectCwd) {
+        let file = null;
+        try {
+            file = await this.promptGet(idOrName, projectCwd);
+        }
+        catch {
+            return false;
+        }
+        rmSync(file.path, { force: true });
+        await this.refreshPromptIndex(projectCwd);
+        return true;
+    }
 }

package/dist/index.js

@@ -38,6 +38,21 @@ const HIT_SCHEMA = {
         score: { type: 'number', required: true },
     },
 };
+/** 模板记录（0.6.0）：不暴露本地文件路径（meta.path 引擎内部使用）。 */
+const PROMPT_RECORD_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        id: { type: 'string', required: true },
+        name: { type: 'string', required: true },
+        dimension: { type: 'string' },
+        difficulty: { type: 'string' },
+        tags: { type: 'array', items: { type: 'string' } },
+        summary: { type: 'string', required: true },
+        source: { type: 'string', enum: ['user', 'agent'], required: true },
+        namespace: { type: 'string', enum: ['global', 'project'], required: true },
+    },
+};
 function recordValue(record) {
     return {
         id: String(record.id),
@@ -54,6 +69,19 @@ function recordValue(record) {
 function hitValue(hit) {
     return { record: recordValue(hit.record), score: hit.score };
 }
+function promptValue(record) {
+    const meta = record.meta;
+    return {
+        id: String(record.id),
+        name: meta?.name ?? '',
+        ...meta?.dimension === undefined ? {} : { dimension: meta.dimension },
+        ...meta?.difficulty === undefined ? {} : { difficulty: meta.difficulty },
+        tags: meta?.tags ?? [],
+        summary: meta?.summary ?? record.content.slice(0, 200),
+        source: meta?.source ?? 'user',
+        namespace: record.namespace,
+    };
+}
 // 0.3.0：审核语义双语（host 侧 GUIDANCE 无法跟随 DSH locale 动态切换，
 // 采用中英双语都写、模型自取——设计文档「风险与注意」）。
 const GUIDANCE = 'Use memory tools for cross-session preferences, habits, and project conventions. '
@@ -192,6 +220,7 @@ export async function apply(ctx, config) {
             query: { type: 'string', required: true, description: 'Keyword query. 关键词查询.' },
             namespace: { type: 'string', enum: ['global', 'project'], description: 'Restrict to one namespace. 限定单个命名空间.' },
             status: { type: 'string', enum: ['suggested', 'approved'], description: 'Restrict to one review status. 限定审核状态.' },
+            kind: { type: 'string', enum: ['fact', 'prompt'], description: 'Restrict by record kind — fact (memories, default) or prompt (templates; use prompt_search instead). 按记录类别过滤：fact=记忆（默认）/ prompt=模板（模板请用 prompt_search）.' },
         },
         output: {
             schema: { type: 'array', items: HIT_SCHEMA },
@@ -201,10 +230,141 @@ export async function apply(ctx, config) {
             return memory.search(args.query, {
                 ...args.namespace === undefined ? {} : { namespace: args.namespace },
                 ...args.status === undefined ? {} : { status: args.status },
+                ...args.kind === undefined ? {} : { kind: args.kind },
             }, execProjectCwd(exec)).then(hits => hits.map(hitValue));
         },
         presentCall: args => present('Search memory', 'read', args.query),
     }));
+    ctx.tools.register(defineTool({
+        name: 'prompt_search',
+        description: 'Search prompt templates by keyword plus dimension/difficulty/tag filters. Returns matching summaries; call prompt_get for the full text. 按关键词+维度/难度/标签检索提示词模板，返回匹配摘要；取全文用 prompt_get。',
+        parameters: {
+            query: { type: 'string', required: true, description: 'Keyword query (name/tag/body). 关键词查询（名称/标签/正文）.' },
+            dimension: { type: 'string', description: 'Filter by dimension (前端/后端/…). 按维度过滤.' },
+            difficulty: { type: 'string', description: 'Filter by difficulty (L1-L5/LX). 按难度过滤.' },
+            tags: { type: 'array', items: { type: 'string' }, description: 'Filter by any of these tags. 按任一标签过滤.' },
+            namespace: { type: 'string', enum: ['global', 'project'], description: 'Restrict to one namespace. 限定单个命名空间.' },
+        },
+        output: {
+            schema: { type: 'array', items: PROMPT_RECORD_SCHEMA },
+            render: (_args, value) => renderJson(value),
+        },
+        execute(args, exec) {
+            return memory.refreshPromptIndex(execProjectCwd(exec)).then(async () => {
+                const all = await memory.list({ kind: 'prompt', ...args.namespace === undefined ? {} : { namespace: args.namespace } }, execProjectCwd(exec));
+                const filtered = all.filter(record => {
+                    const meta = record.meta;
+                    if (meta === undefined)
+                        return true;
+                    if (args.dimension !== undefined && args.dimension !== '' && meta.dimension !== args.dimension)
+                        return false;
+                    if (args.difficulty !== undefined && args.difficulty !== '' && meta.difficulty !== args.difficulty)
+                        return false;
+                    if (args.tags !== undefined && args.tags.length > 0 && !args.tags.some(tag => meta.tags.includes(tag)))
+                        return false;
+                    return true;
+                });
+                const quoted = JSON.stringify(args.query ?? '');
+                const hits = await memory.search(quoted, { kind: 'prompt', ...args.namespace === undefined ? {} : { namespace: args.namespace } }, execProjectCwd(exec));
+                const hitIds = new Set(hits.map(hit => String(hit.record.id)));
+                // 过滤器命中列表按检索分排序在前，未命中关键词的过滤命中排后（按名称）
+                const byQuery = filtered.filter(record => hitIds.has(String(record.id)));
+                const rest = filtered
+                    .filter(record => !hitIds.has(String(record.id)))
+                    .sort((a, b) => (a.meta?.name ?? '').localeCompare(b.meta?.name ?? ''));
+                return [...byQuery, ...rest].map(promptValue);
+            });
+        },
+        presentCall: args => present('Search prompt library', 'read', args.query),
+    }));
+    ctx.tools.register(defineTool({
+        name: 'prompt_get',
+        description: 'Fetch a prompt template full text by id or name (name matches the file stem without the seq prefix). 按 id 或名称取模板全文（名称 = 文件名去序号部分）。',
+        parameters: {
+            nameOrId: { type: 'string', required: true, description: 'Template id or name. 模板 id 或名称.' },
+        },
+        output: {
+            schema: { type: 'object', additionalProperties: false, properties: {
+                    name: { type: 'string', required: true },
+                    dimension: { type: 'string' },
+                    difficulty: { type: 'string' },
+                    tags: { type: 'array', items: { type: 'string' } },
+                    body: { type: 'string', required: true },
+                    fallback: { type: 'string' },
+                } },
+            render: (_args, value) => renderJson(value),
+        },
+        execute(args, exec) {
+            return memory.promptGet(args.nameOrId, execProjectCwd(exec)).then(file => ({
+                name: file.meta.name,
+                ...file.meta.dimension === undefined ? {} : { dimension: file.meta.dimension },
+                ...file.meta.difficulty === undefined ? {} : { difficulty: file.meta.difficulty },
+                tags: file.meta.tags,
+                body: file.body,
+                ...file.fallback === null ? {} : { fallback: file.fallback },
+            }));
+        },
+        presentCall: args => present('Get prompt template', 'read', args.nameOrId),
+    }));
+    ctx.tools.register(defineTool({
+        name: 'prompt_list',
+        description: 'List every prompt template index (no full text), optionally filtered by dimension/difficulty/tag. 列出全部模板索引（不含全文），可按维度/难度/标签过滤。',
+        parameters: {
+            dimension: { type: 'string', description: '按维度过滤.' },
+            difficulty: { type: 'string', description: '按难度过滤.' },
+            tags: { type: 'array', items: { type: 'string' }, description: '按任一标签过滤.' },
+            namespace: { type: 'string', enum: ['global', 'project'], description: '限定单个命名空间.' },
+        },
+        output: {
+            schema: { type: 'array', items: PROMPT_RECORD_SCHEMA },
+            render: (_args, value) => renderJson(value),
+        },
+        execute(args, exec) {
+            return memory.refreshPromptIndex(execProjectCwd(exec)).then(() => memory.list({ kind: 'prompt', ...args.namespace === undefined ? {} : { namespace: args.namespace } }, execProjectCwd(exec))).then(records => records.filter(record => {
+                const meta = record.meta;
+                if (meta === undefined)
+                    return false;
+                if (args.dimension !== undefined && args.dimension !== '' && meta.dimension !== args.dimension)
+                    return false;
+                if (args.difficulty !== undefined && args.difficulty !== '' && meta.difficulty !== args.difficulty)
+                    return false;
+                if (args.tags !== undefined && args.tags.length > 0 && !args.tags.some(tag => meta.tags.includes(tag)))
+                    return false;
+                return true;
+            }).sort((a, b) => (a.meta?.seq ?? 0) - (b.meta?.seq ?? 0)).map(promptValue));
+        },
+        presentCall: () => present('List prompt templates', 'read'),
+    }));
+    ctx.tools.register(defineTool({
+        name: 'prompt_add',
+        description: 'Add one prompt template to the library (writes a metadata-marked md file; source=agent is surfaced in the UI). 新增一条提示词模板（写元数据 md 文件；source=agent 在 UI 角标提示）。',
+        parameters: {
+            name: { type: 'string', required: true, description: 'Template name (also the file stem). 模板名称（也是文件名）.' },
+            content: { type: 'string', required: true, description: 'The prompt body. 提示词正文.' },
+            dimension: { type: 'string', description: '维度（前端/后端/…）.' },
+            difficulty: { type: 'string', description: '难度（L1-L5/LX）.' },
+            tags: { type: 'array', items: { type: 'string' }, description: '检索用标签.' },
+            fallback: { type: 'string', description: '可选备用提示词.' },
+            namespace: { type: 'string', enum: ['global', 'project'], description: '默认 global.' },
+        },
+        output: {
+            schema: PROMPT_RECORD_SCHEMA,
+            render: (_args, value) => renderJson(value),
+        },
+        execute(args, exec) {
+            return memory.promptAdd({
+                name: args.name,
+                content: args.content,
+                ...args.dimension === undefined ? {} : { dimension: args.dimension },
+                ...args.difficulty === undefined ? {} : { difficulty: args.difficulty },
+                ...args.tags === undefined ? {} : { tags: args.tags },
+                ...args.fallback === undefined ? {} : { fallback: args.fallback },
+                ...args.namespace === undefined ? {} : { namespace: args.namespace },
+                source: 'agent',
+            }, execProjectCwd(exec)).then(promptValue);
+        },
+        presentCall: args => present('Add prompt template', 'other', args.name),
+    }));
     ctx.tools.register(defineTool({
         name: 'memory_forget',
         description: 'Delete one stored memory by id. The human owner may remove any memory.',

package/dist/prompt-files.d.ts

@@ -0,0 +1,77 @@
+/**
+ * prompt-files.ts — 提示词模板 md 文件解析与目录扫描（纯 Node，零依赖可测）。
+ *
+ * 文件是模板的唯一事实源（设计文档 §2）：用户可直接放入/编辑/删除 md，
+ * 索引层按 mtime 惰性刷新。格式：
+ *
+ * ```md
+ * ---
+ * seq: 36
+ * name: "样例"          # 必填；缺 name 的文件跳过（坏文件不崩不索引）
+ * dimension: "前端"
+ * difficulty: "L3"
+ * tags: ["Three.js"]
+ * source: user          # user | agent（模型新增打 agent 角标）
+ * createdAt: 2026-08-26
+ * ---
+ * (主提示词全文)
+ * ---
+ * (备用提示词，可选)
+ * ```
+ * 解析失败/缺 name 的文件记 warnings，不影响整体扫描。
+ */
+export interface PromptMeta {
+    seq?: number;
+    name: string;
+    dimension?: string;
+    difficulty?: string;
+    tags: string[];
+    source: 'user' | 'agent';
+    createdAt?: number;
+}
+export interface PromptFile {
+    path: string;
+    mtime: number;
+    meta: PromptMeta;
+    /** 主提示词全文。 */
+    body: string;
+    /** 备用提示词（可选；md 中以独立 `---` 行与正文分隔）。 */
+    fallback: string | null;
+    /** 索引摘要（正文前 200 字，替换换行）。 */
+    summary: string;
+}
+/**
+ * 解析一份 md（frontmatter + 正文 + 可选备用段）。纯文本解析，不碰文件系统；
+ * mtime 由调用方传入（scan 从 stat 取；纯解析测试传 0）。
+ * @returns ok:true 带结构化结果；ok:false 带人读错误（跳过不索引）。
+ */
+export declare function parsePromptFile(path: string, text: string, mtime?: number): {
+    ok: true;
+    file: PromptFile;
+} | {
+    ok: false;
+    error: string;
+};
+/** 扫描一个目录的全部 *.md（目录不存在 = 空）。坏文件收集 warnings。 */
+export declare function scanPromptDir(dir: string): {
+    files: PromptFile[];
+    warnings: string[];
+};
+/** 文件名安全化（Windows 保留字符替换；保留中文与常用符号）。 */
+export declare function sanitizeFileName(name: string): string;
+/** 下一个可用序号（现有文件 `\d+_` 前缀 + 1；目录空 = 1）。 */
+export declare function nextSeq(dir: string): number;
+export interface PromptWriteInput {
+    name: string;
+    dimension?: string;
+    difficulty?: string;
+    tags?: string[];
+    content: string;
+    fallback?: string;
+    source: 'user' | 'agent';
+}
+/**
+ * 写一份模板 md（目录不存在自动创建；序号自动分配；同名防追加后缀）。
+ * @returns 写入路径。
+ */
+export declare function writePromptFile(dir: string, input: PromptWriteInput): string;

package/dist/prompt-files.js

@@ -0,0 +1,188 @@
+/**
+ * prompt-files.ts — 提示词模板 md 文件解析与目录扫描（纯 Node，零依赖可测）。
+ *
+ * 文件是模板的唯一事实源（设计文档 §2）：用户可直接放入/编辑/删除 md，
+ * 索引层按 mtime 惰性刷新。格式：
+ *
+ * ```md
+ * ---
+ * seq: 36
+ * name: "样例"          # 必填；缺 name 的文件跳过（坏文件不崩不索引）
+ * dimension: "前端"
+ * difficulty: "L3"
+ * tags: ["Three.js"]
+ * source: user          # user | agent（模型新增打 agent 角标）
+ * createdAt: 2026-08-26
+ * ---
+ * (主提示词全文)
+ * ---
+ * (备用提示词，可选)
+ * ```
+ * 解析失败/缺 name 的文件记 warnings，不影响整体扫描。
+ */
+import { readdirSync, readFileSync, statSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+const SUMMARY_CHARS = 200;
+/** 解析简单 frontmatter 值：字符串（含引号）/数字/布尔/数组。 */
+function parseFrontmatterValue(raw) {
+    const value = raw.trim();
+    if (value.startsWith('[') && value.endsWith(']')) {
+        return value
+            .slice(1, -1).split(',')
+            .map(part => part.trim().replace(/^["']|["']$/g, ''))
+            .filter(part => part !== '');
+    }
+    if (value.startsWith('"') && value.endsWith('"'))
+        return value.slice(1, -1);
+    if (value.startsWith("'") && value.endsWith("'"))
+        return value.slice(1, -1);
+    if (/^\d+$/.test(value))
+        return Number(value);
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    return value;
+}
+/**
+ * 解析一份 md（frontmatter + 正文 + 可选备用段）。纯文本解析，不碰文件系统；
+ * mtime 由调用方传入（scan 从 stat 取；纯解析测试传 0）。
+ * @returns ok:true 带结构化结果；ok:false 带人读错误（跳过不索引）。
+ */
+export function parsePromptFile(path, text, mtime = 0) {
+    const lines = text.split(/\r?\n/);
+    if (lines[0]?.trim() !== '---') {
+        return { ok: false, error: 'missing frontmatter fence (first line must be ---)' };
+    }
+    let fence = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === '---') {
+            fence = i;
+            break;
+        }
+    }
+    if (fence === -1)
+        return { ok: false, error: 'unclosed frontmatter fence' };
+    const meta = {};
+    for (const line of lines.slice(1, fence)) {
+        const m = /^([A-Za-z][A-Za-z0-9]*)\s*:\s*(.*)$/.exec(line);
+        if (m === null || m[2] === undefined)
+            continue;
+        meta[m[1]] = parseFrontmatterValue(m[2]);
+    }
+    const name = typeof meta.name === 'string' ? meta.name : '';
+    if (name === '')
+        return { ok: false, error: 'missing required frontmatter field "name"' };
+    const source = meta.source === 'agent' ? 'agent' : 'user';
+    // 正文：frontmatter 后到第一个独立 `---` 行为止（剩余为备用提示词）
+    const bodyLines = [];
+    const fallbackLines = [];
+    let inFallback = false;
+    for (const line of lines.slice(fence + 1)) {
+        if (!inFallback && line.trim() === '---') {
+            inFallback = true;
+            continue;
+        }
+        ;
+        (inFallback ? fallbackLines : bodyLines).push(line);
+    }
+    const body = bodyLines.join('\n').trim();
+    if (body === '')
+        return { ok: false, error: 'empty prompt body' };
+    // 备用段首行常为「备用提示词2」之类的标题行，跳过（约定：正文与备用用 --- 分隔）
+    const fallbackRaw = fallbackLines.join('\n').trim();
+    const fallback = fallbackRaw === '' ? null : fallbackRaw.replace(/^\s*(备用提示词\d*|fallback\d*)\s*\n?/i, '');
+    const file = {
+        path,
+        mtime,
+        meta: {
+            seq: typeof meta.seq === 'number' ? meta.seq : undefined,
+            name,
+            dimension: typeof meta.dimension === 'string' ? meta.dimension : undefined,
+            difficulty: typeof meta.difficulty === 'string' ? meta.difficulty : undefined,
+            tags: Array.isArray(meta.tags) ? meta.tags.filter((tag) => typeof tag === 'string') : [],
+            source,
+            createdAt: typeof meta.createdAt === 'number' ? meta.createdAt : undefined,
+        },
+        body,
+        fallback,
+        summary: body.replace(/\s+/g, ' ').trim().slice(0, SUMMARY_CHARS),
+    };
+    return { ok: true, file };
+}
+/** 扫描一个目录的全部 *.md（目录不存在 = 空）。坏文件收集 warnings。 */
+export function scanPromptDir(dir) {
+    const files = [];
+    const warnings = [];
+    let entries = [];
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return { files, warnings }; // 目录不存在：空库
+    }
+    for (const entry of entries) {
+        if (!entry.toLowerCase().endsWith('.md'))
+            continue;
+        const path = join(dir, entry);
+        let text;
+        try {
+            text = readFileSync(path, 'utf8');
+        }
+        catch (error) {
+            warnings.push(`${path}: read failed (${error instanceof Error ? error.message : String(error)})`);
+            continue;
+        }
+        const parsed = parsePromptFile(path, text, statSync(path).mtimeMs);
+        if (!parsed.ok) {
+            warnings.push(`${path}: ${parsed.error}`);
+            continue;
+        }
+        files.push(parsed.file);
+    }
+    return { files, warnings };
+}
+/** 文件名安全化（Windows 保留字符替换；保留中文与常用符号）。 */
+export function sanitizeFileName(name) {
+    const safe = name.replace(/[<>:"/\\|?*\u0000-\u001F]/g, '_').trim();
+    return (safe === '' ? 'untitled' : safe).slice(0, 80);
+}
+/** 下一个可用序号（现有文件 `\d+_` 前缀 + 1；目录空 = 1）。 */
+export function nextSeq(dir) {
+    let max = 0;
+    try {
+        for (const entry of readdirSync(dir)) {
+            const m = /^(\d+)_/.exec(entry);
+            if (m !== null)
+                max = Math.max(max, Number(m[1]));
+        }
+    }
+    catch { /* 目录不存在：从 1 开始 */ }
+    return max + 1;
+}
+/**
+ * 写一份模板 md（目录不存在自动创建；序号自动分配；同名防追加后缀）。
+ * @returns 写入路径。
+ */
+export function writePromptFile(dir, input) {
+    mkdirSync(dir, { recursive: true });
+    const seq = nextSeq(dir);
+    const base = sanitizeFileName(input.name);
+    let path = join(dir, `${seq}_${base}.md`);
+    let attempt = 0;
+    while (existsSync(path)) {
+        attempt += 1;
+        path = join(dir, `${seq}_${base}_${attempt}.md`);
+    }
+    const lines = ['---', `seq: ${seq}`, `name: ${JSON.stringify(input.name)}`, `source: ${input.source}`];
+    if (input.dimension !== undefined && input.dimension !== '')
+        lines.push(`dimension: ${JSON.stringify(input.dimension)}`);
+    if (input.difficulty !== undefined && input.difficulty !== '')
+        lines.push(`difficulty: ${JSON.stringify(input.difficulty)}`);
+    if (input.tags !== undefined && input.tags.length > 0)
+        lines.push(`tags: [${input.tags.map(tag => JSON.stringify(tag)).join(', ')}]`);
+    lines.push(`createdAt: ${new Date().toISOString().slice(0, 10)}`, '---');
+    const text = `${lines.join('\n')}\n\n${input.content.trim()}\n${input.fallback === undefined || input.fallback === '' ? '' : `\n---\n\n${input.fallback.trim()}\n`}`;
+    writeFileSync(path, text, 'utf8');
+    return path;
+}

package/dist/routes.js

@@ -98,6 +98,27 @@ function cwdOf(payload) {
     const value = payload?.cwd;
     return typeof value === 'string' && value !== '' ? value : undefined;
 }
+/** 取 memory 服务（未挂载 503 且明确失败）。 */
+function requireMemory(ctx) {
+    const memory = ctx.get('memory');
+    if (memory === undefined)
+        throw new MemoryApiError('service-unavailable', 'memory service unavailable', 503);
+    return memory;
+}
+/** 模板记录投影（0.6.0）：不暴露本地文件路径（meta.path 引擎内部使用）。 */
+function promptProjection(record) {
+    const meta = record.meta;
+    return {
+        id: String(record.id),
+        name: meta?.name ?? '',
+        ...meta?.dimension === undefined ? {} : { dimension: meta.dimension },
+        ...meta?.difficulty === undefined ? {} : { difficulty: meta.difficulty },
+        ...meta === undefined ? {} : { tags: meta.tags },
+        summary: meta?.summary ?? record.content.slice(0, 200),
+        source: meta?.source ?? 'user',
+        namespace: record.namespace,
+    };
+}
 /** 挂载 /memory/api 路由（apply 调用）。 */
 export function mountMemoryApi(ctx) {
     // webServer/webRuntime 由 index.ts 的 inject 声明（Context 类型未扩展，断言访问）
@@ -184,6 +205,63 @@ export function mountMemoryApi(ctx) {
             const summaryChars = typeof record?.summaryChars === 'number' && record.summaryChars > 0 ? record.summaryChars : DEFAULT_SUMMARY_CHARS;
             return { self: SELF_DESCRIPTION, ...renderInjection(memory.recallRecords(cwd), budget, summaryChars) };
         },
+        // ── 提示词模板库（0.6.0）──
+        'prompt.list': async (payload) => {
+            const memory = requireMemory(ctx);
+            const record = (payload ?? {});
+            const cwd = cwdOf(record);
+            await memory.refreshPromptIndex(cwd);
+            const namespace = record.namespace === 'project' || record.namespace === 'global' ? record.namespace : undefined;
+            const records = await memory.list({ kind: 'prompt', ...namespace === undefined ? {} : { namespace } }, cwd);
+            return records.map(promptProjection);
+        },
+        'prompt.get': (payload) => {
+            const memory = requireMemory(ctx);
+            const record = (payload ?? {});
+            const lookup = typeof record.name === 'string' ? record.name : typeof record.id === 'string' ? record.id : '';
+            if (lookup === '') {
+                throw new MemoryApiError('bad-request', 'missing or invalid "id"/"name"');
+            }
+            return memory.promptGet(lookup, cwdOf(record)).then(file => ({
+                name: file.meta.name,
+                ...file.meta.dimension === undefined ? {} : { dimension: file.meta.dimension },
+                ...file.meta.difficulty === undefined ? {} : { difficulty: file.meta.difficulty },
+                tags: file.meta.tags,
+                body: file.body,
+                ...file.fallback === null ? {} : { fallback: file.fallback },
+            }));
+        },
+        'prompt.add': (payload) => {
+            const memory = requireMemory(ctx);
+            const record = (payload ?? {});
+            if (typeof record.name !== 'string' || record.name === '')
+                throw new MemoryApiError('bad-request', 'missing or invalid "name"');
+            if (typeof record.content !== 'string' || record.content === '')
+                throw new MemoryApiError('bad-request', 'missing or invalid "content"');
+            return memory.promptAdd({
+                name: record.name,
+                content: record.content,
+                ...typeof record.dimension === 'string' ? { dimension: record.dimension } : {},
+                ...typeof record.difficulty === 'string' ? { difficulty: record.difficulty } : {},
+                ...Array.isArray(record.tags) ? { tags: record.tags.filter((tag) => typeof tag === 'string') } : {},
+                ...typeof record.fallback === 'string' ? { fallback: record.fallback } : {},
+                ...record.namespace === 'project' ? { namespace: 'project' } : {},
+                source: 'user',
+            }, cwdOf(record)).then(promptProjection);
+        },
+        'prompt.remove': (payload) => {
+            const memory = requireMemory(ctx);
+            const record = (payload ?? {});
+            const lookup = typeof record.name === 'string' ? record.name : typeof record.id === 'string' ? record.id : '';
+            if (lookup === '') {
+                throw new MemoryApiError('bad-request', 'missing or invalid "id"/"name"');
+            }
+            return memory.promptRemove(lookup, cwdOf(record));
+        },
+        'prompt.refresh': (payload) => {
+            const memory = requireMemory(ctx);
+            return memory.refreshPromptIndex(cwdOf((payload ?? {})));
+        },
     };
     const fence = (req) => isTrusted(req, webRuntime.trustedHosts);
     ctx.effect(() => webServer.register({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@max-null/dsh-memory",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "Cross-session plaintext memory plugin for the DeepSeek Harness — deterministic BM25 recall, human-owned, no embeddings",
   "license": "MIT",
   "publishConfig": {