English · 简体中文

概述

Patchouli 在 DeepSeek Harness 内提供统一的 update、retrieve、subscribe 服务。连接器负责提供可信的运行时数据， 记忆和知识插件负责各自的算法，独立的 Rust 后端负责持久化事务存储。

DeepSeek Harness 是目前首个受支持的集成，数据库后端本身不依赖任何 Harness。

核心能力

• 提供插件过滤器、用户路由策略和来源标记统一的 Memory Service。
• 在消费端完成聚合，保留各知识插件的原生结果，并可选用独立模型筛选证据。
• 支持带背压的增量检索流，并以最终 complete 汇总结束。
• 通过可配置 Hook 和模型 Tool 接入 Agent Loop。
• 支持本地或远程记忆与知识实现。
• 将图片和工作区文件摄取为类型化 Artifact。
• 提供持久化订阅，以及支持 SQLite 和远程 Provider 的事务化 Rust 后端。

安装、接入 DSH、开发 MemoryPlugin、扩展存储或后端，以及排查问题前，请先加载 use-dsh-patchouli。

插件兼容情况

Official（官方兼容）表示上游插件直接注册 patchouli service；Patch （补丁兼容）表示 GOOJFC 通过 dsh-harmony 适配一个精确版本。 下表区分上游直接集成与绑定特定版本的补丁兼容。

| 插件 | 已验证包 | 兼容方式 | Patchouli DB | | --- | --- | --- | --- | | MemoraX Code | @memorax-code/[email protected]（源码） | Official | 否（插件自管） | | OpenViking | @openviking/[email protected] | Patch | 否（插件自管） | | Hindsight | @vectorize-io/[email protected] | Patch | 否（插件自管） | | MemOS | @memtensor/[email protected] | Patch | 否（插件自管） | | Mneme | @modusensus/[email protected] | Patch | 否（插件自管） | | Mnemon | [email protected] | Patch | 否（插件自管） | | Memory Gate | [email protected] | Patch | 否（插件自管） | | 灵枢记忆 | @furongjun1999/[email protected] | Patch | 否（插件自管） | | Graph Memory | [email protected] | Patch | 否（插件自管） | | Engramory | [email protected] | Patch | 否（插件自管） | | Memory Evolve | [email protected] | Patch | 否（插件自管） |

正在开发 DSH 插件，或想探索现有插件的兼容方式？欢迎尝试 dsh-harmony，无需长期维护上游 fork，也能检查并适配插件行为。

Engramory 兼容补丁会保留其索引保护，同时设置上游公开的 registerSkill: false 选项。适配器启用时，Patchouli 是唯一的自动召回路径。

安装与使用

需要 Node.js ^22.19.0 || >=24、pnpm 11，以及兼容 0.1.0-rc.6 的 DeepSeek Harness：

dsh plugin --profile web add dsh-patchouli
dsh --profile web --dump-config

插件依赖独立的 patchouli-db npm 包。首次使用时，它会从同版本的 GitHub Release 下载并校验当前平台的守护进程二进制，同时初始化默认的本地数据库目录。 随附的 DSH Profile 默认启用存储客户端，它会连接本地守护进程，并在需要时自动启动。 最后一个命令应列出 patchouli、patchouli-storage 及各连接器插件。 Patchouli 需要至少注册一个兼容的记忆或知识插件，才能实际处理路由后的 update、retrieve 和 subscribe 调用。

配置和各平台的详细说明参见 快速开始。

这个插件的名字是什么意思？？？

名称直接来自 Patchouli Knowledge，同时致敬广为人知的 Minecraft 模组 Patchouli。

DSH compatibility (2026-09-19)

Host、Agent Loop 和 Native Context 保留旧版兼容，并通过 DSH 0.1.5-rc.2 / 0.1.6-alpha.2 类型检查。历史读取适配只读持久化句柄并保证关闭；会话开始检索兼容两种生命周期，避免重复注入。可选 Fleet 归档适配器只在相应服务出现后启用。完整检查 174 项通过、1 项跳过；两版启用 Native Context 的隔离 Web 启动和 7 个 Harmony 补丁均通过。这不包含独立 Memory UI、真实浏览器操作或模型调用。