前言¶
用 DeepSeek Harness（下称 DSH）做智能体开发，「一切皆插件」意味着记忆能力有很多选择，兼容表里的 Hindsight、MemOS、Graph Memory 都属此类。问题在于，每个记忆插件都自带存储和召回算法，接入方式互不相同；想在同一个环境里组合使用，就得逐个适配接口、分别维护数据，换一个实现就要动一遍接入层。
dsh-patchouli 针对的就是这件事：把「数据接入」和「算法实现」拆开，中间放一个统一的记忆与知识服务。下面介绍这个插件。
这是什么¶
memorax-ai/dsh-patchouli 的定位是 DeepSeek Harness 的本地记忆与知识中枢（A local memory and knowledge hub for DeepSeek Harness），当前版本 0.1.6，MIT 许可证。仓库托管在 memorax-ai 组织下，package.json 的 author 字段标注为 CH4ACKO3。
它对外只暴露一个统一的 update / retrieve / subscribe 服务，内部由几部分配合：Agent Loop 连接器提供可配置钩子与模型工具；记忆与知识实现可插拔，本地或远程均可；底层是支持 SQLite 与远程提供方的事务性 Rust 后端，负责持久化。
顺带一提，名字致敬《东方 Project》的 Patchouli Knowledge，也致敬 Minecraft 上广为人知的同名模组 Patchouli。
核心功能¶
按 README 的描述，能力集中在服务、检索、接入与存储几块：
- 通用记忆服务（Common Memory Service）：支持提供方过滤器、用户路由策略与来源溯源；
- 消费端聚合：保持原生插件结果不变，支持可选的专用模型证据选择；
- 增量检索流：带背压控制与最终的
complete聚合； - Agent Loop 连接器：提供可配置钩子与模型工具；
- 可插拔的本地或远程记忆与知识实现；
- 图像与工作区文件摄取，以类型化 Artifact 形式托管；
- 持久化订阅，以及支持 SQLite 与远程提供方的事务性 Rust 后端。
安装与启用¶
先确认运行要求：Node.js ^22.19.0 || >=24、pnpm 11，以及兼容 0.1.0-rc.6 的 DeepSeek Harness 运行时。之后按三步走：
1、执行安装命令：
dsh plugin --profile web add dsh-patchouli
2、用 dump-config 检查插件是否注册成功：
dsh --profile web --dump-config
输出应列出 patchouli、patchouli-storage 及连接器插件，看到这三类说明安装就位。
3、注册至少一个兼容的记忆或知识插件，由它处理路由过来的 update、retrieve、subscribe 调用。没有这一层，路由过来的调用就没有处理方。
首次运行会做什么¶
插件自带 patchouli-db 依赖。首次使用时，它会从同版本的 GitHub Release 下载经校验和验证的守护进程二进制，并初始化默认的本地数据库目录；捆绑的 DSH profile 默认启用存储客户端，按需连接并启动本地守护进程。
配置与平台相关细节，见入门指南：https://memorax-ai.github.io/dsh-patchouli/getting-started
兼容的记忆与知识插件¶
兼容分两类：Official 表示上游插件直接注册 patchouli 服务；Patch 表示由 GOOJFC 通过 dsh-harmony 适配某个固定精确版本。适配所用的 dsh-harmony 仓库见 https://github.com/memorax-ai/dsh-harmony ，插件仓库也标注了 Powered by dsh-harmony。
兼容表目前覆盖 11 个插件：MemoraX Code、OpenViking、Hindsight、MemOS、Mneme、Mnemon、Memory Gate、Lingshu Memory、Graph Memory、Engramory、Memory Evolve，各自对应固定的测试版本，具体以仓库中的兼容表为准。表中所有插件的 Patchouli DB 一栏均为 No — plugin-managed，即这些插件的数据库不由 Patchouli 接管。
一个值得注意的细节：Engramory 的兼容补丁保留了它的索引守卫，并按其文档设置 registerSkill: false 选项；适配器激活期间，Patchouli 是唯一的自动召回路径。
适用场景与注意事项¶
适合的场景：
1、同时使用多个记忆/知识插件，希望统一接入与路由的环境；
2、需要本地持久化（SQLite）或对接远程提供方的部署；
3、想接入自有记忆实现的开发者，按 update / retrieve / subscribe 这组调用对接即可。
用之前注意：
1、插件以当前 dsh 进程的权限运行，安装前应检查源码与许可证（本项目为 MIT）；
2、Patch 类兼容绑定固定插件版本，升级上游插件前先核对仓库的兼容表；
3、首次运行会从 GitHub Release 下载守护进程二进制（带校验和验证），离线环境需要留意这一步。
结尾¶
经过上面的步骤，Patchouli 在 DSH 里的角色是明确的：连接器接数据，记忆与知识插件做算法，Rust 后端管存储。对想组合多个记忆插件、或希望在不动接入层的前提下更换实现的环境来说，这是它最直接的价值。
- GitHub 仓库：https://github.com/memorax-ai/dsh-patchouli
- 社区目录页：https://www.skillhub.cn/plugins/memorax-ai/dsh-patchouli
补充说明：社区目录为独立站点，与 DeepSeek、幻方无官方从属关系。
