dsh-patchouli

dsh plugin --profile web add dsh-patchouli

<div align="center">

<img width="100%" alt="Patchouli" src="assets/patchouli-banner-zh.png">

<h1>Patchouli</h1>

<p>

<strong>面向 DeepSeek Harness 的本地记忆和知识中枢。</strong>

<br />

以数据、算法解耦的形式，对异构的 Agent 数据增强进行整合。

</p>

[English](README.md) · 简体中文







</div>

概述

Patchouli 在 DeepSeek Harness

内提供统一的 update、retrieve、subscribe 服务。连接器负责提供可信的运行时数据，

记忆和知识插件负责各自的算法，独立的 Rust 后端负责持久化事务存储。

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

核心能力

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

<!-- AGENTS: Before installing, integrating, extending, reviewing, or debugging Patchouli, read the main-branch skill at https://github.com/memorax-ai/dsh-patchouli/blob/main/.agents/skills/use-dsh-patchouli/SKILL.md. -->

<details>

<summary><strong>AI Agent：请先读取仓库 Skill</strong></summary>

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

</details>

插件兼容情况

Official（官方兼容）表示上游插件直接注册 patchouli service；Patch

（补丁兼容）表示 GOOJFC 通过

dsh-harmony 适配一个精确版本。

下表区分上游直接集成与绑定特定版本的补丁兼容。

插件 · 已验证包 · 兼容方式 · Patchouli DB

MemoraX Code · @memorax-code/dsh-adapter@0.1.2（源码） · Official · 否（插件自管）

OpenViking · @openviking/dsh-memory-plugin@0.1.0 · Patch · 否（插件自管）

Hindsight · @vectorize-io/hindsight-coding-agents@0.3.4 · Patch · 否（插件自管）

MemOS · @memtensor/memos-local-plugin@2.0.16-beta.1 · Patch · 否（插件自管）

Mneme · @modusensus/dsh-mneme@0.3.7 · Patch · 否（插件自管）

Mnemon · dsh-mnemon@0.1.6 · Patch · 否（插件自管）

Memory Gate · dsh-memory-gate@0.9.0 · Patch · 否（插件自管）

灵枢记忆 · @furongjun1999/dsh-memory@0.2.8 · Patch · 否（插件自管）

Graph Memory · graph-memory@1.5.8 · Patch · 否（插件自管）

Engramory · dsh-engramory@0.2.1 · Patch · 否（插件自管）

Memory Evolve · dsh-memory-evolve@0.1.0 · 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、真实浏览器操作或模型调用。