前言¶
用 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、幻方無官方從屬關係。
