dsh-simple-memory

把你自己维护的 Markdown 记忆目录（Obsidian 库、.memory 项目记忆）接入 DSH： 常驻一份索引（渲染出的文本不变就不重复注入），正文按需读取，插件只读不改。

从 pi-memory 移植。行为契约（frontmatter 的含义、按字节计的预算、整份来源排除、字面关键词提醒）保持不变，注入机制按 DSH 的 插件面重写。

它做什么

• 索引注入：把记忆的根层条目放进运行时上下文——每条给名称与 frontmatter 的 description 定位，仓库根路径只在「记忆仓库」段写一次，子文件夹只列名字。 defaultopen: true 的记忆带全文，其余只给摘要；更深层的记忆不进默认上下文。 渲染出的文本与上一条快照相同就什么都不做，改记忆、换工作目录或升级插件才会重发。
• 仓库契约：每段来源开头附一段「记忆仓库」，写明这个仓库的绝对路径、什么结论值得 写进来、写入方式与 frontmatter 各字段的作用。目录为空时同样给出，模型才知道往哪落 第一条。这段文字不占配置，改它要改 src/memory.ts。
• 关键词提醒：frontmatter keywords 里的字面短语命中用户输入或模型文本时， 在本步追加一条 user 快照消息，给出路径，让模型自己用 read 读取全文。 命中过一次的记忆在本轮不再重复提醒。
• 按需阅读：上层正文里的 [[路径]] 引用由模型自己判断，插件不解析、不校验。
• 只读：不写你的记忆目录，不写配置文件；缓存只在内存里。

与 pi-memory 的差异

	pi-memory	dsh-simple-memory
索引注入	Pi 系统提示词尾部	DSH runtime-context 快照里的 simple-memory 段
关键词提醒	系统提示词尾部（下一轮）	agent/pre-step 追加的 user 快照消息（本步生效）
配置	agent 目录下的 memory.json	profile 的 cordis.patch.yml（schemastery Config）
项目记忆信任门槛	需要 Pi 信任该项目	无（与 AGENTS.md 注入同一个信任边界）
命令	/memory set、/memory clear 会写配置	只读；配置改 YAML
落盘缓存	agent 目录 cache/pi-memory/	无（内存里按文件签名缓存）

安装

# 从 GitHub
dsh plugin --profile <profile> add github:liu-zhengdong/dsh-simple-memory

# 本地 checkout（开发用）
dsh plugin --profile <profile> add /abs/path/to/dsh-simple-memory

包声明了 dsh.bundle.patch，添加后包名会被追加进该 profile 的 dsh.profile.bundles。 验证层已挂上：

dsh --profile <profile> --dump-config | grep -B2 -A6 dsh-simple-memory

本包未发布到 npm，add dsh-simple-memory 会失败。 仓库直接带 lib/ 构建产物，安装时不跑构建脚本（pnpm 会拦下 git 包的 prepare，放行键还绑 commit hash，因此不采用那条路）。改源码后跑 npm run build 并把 lib/ 一起提交。

配置

字段	默认	说明
directory	""	全局记忆目录，绝对路径或 ~ 开头；留空表示不使用全局来源
projectSources	true	从工作目录向上到 git 根逐层发现 .memory
reminders	true	按 keywords 命中用户输入或模型文本时提醒
maxContextBytes	262144	单次注入的记忆文本上限（UTF-8 字节，1 KiB–16 MiB）

配置住在 profile 的 cordis.patch.yml 里。patch 整块替换 config，不做深合并， 所以覆盖时请写全你要的字段：

- id: simple-memory
  config:
    directory: ~/Obsidian/记忆
    projectSources: true
    reminders: true
    maxContextBytes: 262144

改这一行会触发插件热替换，不需要重启。

桌面端设置界面

桌面版不必手改 YAML，三个入口指向同一张表单：

• 设置 → 插件 → 记忆：一个独立标签页；
• 插件页 → dsh-simple-memory 的配置区；
• 插件列表里本插件那一行右侧的「配置」。

四个字段都能改，directory 旁边有「选择目录…」，点开就是系统目录选择框。保存后写进该 profile 的 cordis.patch.yml（也就是上面那段 YAML），立即生效。

为什么只有这四个字段：宿主设置服务只把 Config 里标成 volatile 的字段暴露出来，本插件 四个字段都标了。表单控件是按官方外观照抄的——官方明确禁止插件 require @deepseek-ai/dsh-client-*（那些包随时会变），所以客户端半侧只声明 slots 与 locale 两个服务，目录选择走官方给第三方的 ctx.uiWorkspace.pickDirectory()。

client/client.js 只在 DSH 启动时扫描一次（只认 dsh.client.platform 与 exports["./client"]），改这个文件要重启 DSH 才生效；改记忆目录本身不用重启。

记忆文件格式

---
description: 界面字体的选择，排版相关任务开工前先看（进索引）
defaultopen: true          # 可选：整篇正文进默认上下文（超过 8 KiB 会提示拆分）
keywords:                  # 可选：字面短语，命中就提醒
  - 字体
  - 字体栈
---

正文……

• 只有 .md 会被收录；点开头的文件、符号链接跳过。
• 每层来源只扫根目录的直接子项，子文件夹作为入口列出（示例见 examples/vault/）。
• 上面这些规则以「记忆仓库」那段文字随索引一起注入，模型据此决定往哪写、怎么写； 插件自己不写盘。
• 解析失败、frontmatter 超限、来源超预算都会出现在 /memory 的输出里，不会静默截断。

上限

项	值
单次注入文本	256 KiB（可配 1 KiB–16 MiB）
单篇 frontmatter	64 KiB
单篇 defaultopen 全文	8 KiB（照常注入，但提示拆分）
关键词索引	16 MiB / 100,000 条

超预算的整份来源会被排除并在 /memory 里给出原因，而不是截断正文。

命令

命令	作用
/memory	目录、来源数、注入 KiB、索引篇数、未注入来源与提醒
/memory preview	本轮的注入文本（索引）与未注入来源
/memory help	用法

命令只在有命令面的宿主里可用（headless 没有）。它是只读的——改配置请用桌面端设置界面， 或直接改 YAML。

开发

pnpm install
npm run check     # tsc --noEmit
npm test          # node --test（96 个用例，含假宿主、客户端接线与 volatile 配置契约测试）
npm run build     # tsc -p tsconfig.build.json → lib/

本地联调：dsh plugin --profile <profile> add .，然后用 dsh headless --json "……" 或桌面端发一条消息；调试日志用 DSH_SIMPLE_MEMORY_DEBUG=1 打开。

已知限制

• 只读、无写回：插件不替你整理记忆，也不从对话里自动提取。
• 字面匹配，不是语义检索：keywords 是大小写不敏感的英文子串匹配， 中文按原样匹配；不做正则、不做向量检索。
• [[路径]] 不解析：是否读取由模型决定。
• 注入文本会改写 {{：DSH 组装期会对 {{name}} 做变量插值，未注册的变量名会让 整轮请求报错，所以索引文本里的 {{ 会被拆成 {<零宽空格>{（提醒消息不需要， 它不走插值）。
• 不 import @deepseek-ai/* 类型：官方包只随 DSH 分发，npm 上的版本与宿主不一致； 插件用自己的最小结构化类型对接宿主。
• 客户端半侧也不 import 官方客户端包：client/client.js 只用 react 和 slots/ locale/configForms/uiWorkspace 四个服务，控件按 --dsw-* 主题变量照抄。