MIT 授權的 cordis 外掛,讓手寫的 `.md` 記憶庫與匯出的對話紀錄在 DeepSeek Harness 裡可檢索:BM25 加本機 bge-small 向量按 RRF 融合,可選 Qwen embedding 與 rerank。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-18
授權條款
MIT
01它能幫你完成什麼?
讓手寫的 markdown 記憶庫在 DSH 對話裡能被搜到
`memory_search` 回傳「字面 BM25 + 向量」融合後的命中,並回原始檔案補整行與前後各一行脈絡
已經把人設、日記與專案筆記寫成純文字 `.md`、希望模型引用原話而不是轉述的使用者
按意思翻出以前說過的對話,而不是靠關鍵字
`chat_search` 直接讀匯出的對話紀錄,認得「三天前 / 上週 / 一個月前」這類說法
想回憶過去工作階段裡到底說過什麼、又不想先做匯入的使用者
跨工作階段維護記憶庫的健康度
每輪注入的狀態卡、`memory_check` 健康度報告,以及寫入前自動備份的 `persona_edit`
長期執行的個人設定:人設檔案與日記需要進度、容量與過期訊號
02如何將外掛接入 DeepSeek Harness?
先決條件
- Node 24+ 與 DSH 0.2.x —— README 明確寫了這兩條,並說明 Windows / macOS / Linux 都可以
- 一個 markdown 記憶庫:`~/.dsh/memory/`(預設 `memoryDir`)下放 `.md` 檔案,檔名與數量都不重要
安裝步驟
- 01
`git clone https://github.com/flywalker68/dsh-memory-keeper.git ~/.dsh/plugins/dsh-memory-keeper`
$ git clone https://github.com/flywalker68/dsh-memory-keeper.git ~/.dsh/plugins/dsh-memory-keeper
- 02
先 `cd ~/.dsh/plugins/dsh-memory-keeper` 進入外掛目錄,然後執行 `npm install`
$ npm install
- 03
編輯 `~/.dsh/profiles/<你的 profile>/package.json` 這個檔案:在 `dependencies` 裡加上 `"dsh-memory-keeper": "link:<絕對路徑>"` 這一行,同時在 `dsh.profile.bundles` 裡加上 `"dsh-memory-keeper"` 這個名字
- 04
先 `cd ~/.dsh/profiles/<你的 profile>` 進入 profile 目錄,然後執行 `pnpm install`
- 05
重新啟動 DSH
- 06
在 `~/.dsh/profiles/<profile>/cordis.patch.yml` 裡把 `workspace` 填成絕對路徑——留空會讓 `process.cwd()` 落在 profile 目錄,索引裡什麼都收不到
驗證整合成功
- DSH 啟動後,`~/.dsh/memory-keeper.log` 裡應該有一行 `INFO 已注册工具 memory_search`
- `memory_search` 的結果開頭帶 `(向量+词面)` 代表向量在工作;只剩一個 `3 条` 代表只跑了字面檢索
復原
- 把 `<workspace>/.tools/memory-index.json` 和 `<workspace>/.tools/memory-vectors.json` 刪掉,下次搜尋時會重新建一份乾淨的索引
- 把 `embeddingEnabled` 設成 `false` 可完全關掉向量檢索——零下載、零 API,只留字面檢索
03DSH 整合程度與能力邊界
以 cordis 外掛的形式透過 DSH profile 載入:把套件寫進 profile 的 `package.json`(`dependencies` 與 `dsh.profile.bundles`),執行 `pnpm install`、重新啟動 DSH,Host 端會註冊 `memory_search` 等工具,用戶端提供側邊欄記憶面板。
雙路記憶檢索
一條 query、`top=10` 與可選的 `beforeDate`→BM25 與向量候選按 RRF 融合,可選再用 Qwen 重排,命中後補整行與前後各一行脈絡
來源檔案的路徑、大小或 mtime 變動時,在 `<workspace>/.tools/` 下重建索引設定 Qwen key 時,檢索用的 query 與文字向量會送往百煉索引建置
`memoryDir` 下的 markdown 檔案→按行切塊,每塊存 `text`(截 300 字)、`date`、`file`、`line`
跳過標題行、引用行、分隔線、少於 6 個字的短行,以及已標「已被取代」的條目狀態卡與壓縮後補原文
組裝好的 system prompt 與 `compaction/summary` 事件→每輪一張狀態卡(認識多少天、日記進度、行程、半衰期候選、人設漂移),壓縮後補回最近 10 輪原話
每輪以及每次壓縮之後都會往 system prompt 加文字歷史匯入腳本
一個裝滿 `.jsonl` 的目錄,或單一 jsonl 檔案→每個輸入檔案一個 `.md`,每輪一行,行首帶日期,因此能參與時間視窗過濾
把新的 markdown 檔案寫進目標記憶目錄側邊欄記憶面板
本機記憶庫→在 DSH Web UI 裡看記憶庫全貌
README 說明這個面板還沒在別人的 DSH 版本上試過
04適合誰?何時不該用?
適合
- 已經把人設、日記與專案筆記寫成純文字 `.md`、希望模型引用原話而不是轉述的使用者
- 想回憶過去工作階段裡到底說過什麼、又不想先做匯入的使用者
- 長期執行的個人設定:人設檔案與日記需要進度、容量與過期訊號
不適合
- 它是檢索層,不是完整記憶系統:逐輪回放、增量擷取、摘要與遺忘都不在範圍內,外掛讀你已經在寫的東西,不替你寫。切塊、索引重建、雙路融合、時間視窗、狀態卡、壓縮後補原文由程式碼保證;什麼時候寫日記、要不要精簡,全靠模型按 `AGENTS.md` 自覺執行。
- 記憶資料始終留在本機,只有檢索用的 query 與文字向量會在設定 Qwen key 時送往百煉。沒設 key、呼叫失敗、逾時或連續失敗 3 次,都會回退到本機 bge-small 模型。
- `sharp` 必須真的裝起來:`npm install --ignore-scripts` 只留下原始碼沒有 libvips 二進位,而 `@xenova/transformers` 會 require 它,結果是向量檢索靜默掛掉、外掛卻照常啟動。
- README 自己列了未驗證項:是否一定得用 `pnpm install`、`link:` 在 Windows 反斜線下的表現、日誌路徑、關掉 `embeddingEnabled` 後的檢索品質,以及面板在別的 DSH 版本上的樣子。作者也說明外掛是輕量化設計,記憶庫過大時的情況還沒最佳化。
05相容性、維護與安全提醒
- 它是檢索層,不是完整記憶系統:逐輪回放、增量擷取、摘要與遺忘都不在範圍內,外掛讀你已經在寫的東西,不替你寫。切塊、索引重建、雙路融合、時間視窗、狀態卡、壓縮後補原文由程式碼保證;什麼時候寫日記、要不要精簡,全靠模型按 `AGENTS.md` 自覺執行。
- 記憶資料始終留在本機,只有檢索用的 query 與文字向量會在設定 Qwen key 時送往百煉。沒設 key、呼叫失敗、逾時或連續失敗 3 次,都會回退到本機 bge-small 模型。
- `sharp` 必須真的裝起來:`npm install --ignore-scripts` 只留下原始碼沒有 libvips 二進位,而 `@xenova/transformers` 會 require 它,結果是向量檢索靜默掛掉、外掛卻照常啟動。
- README 自己列了未驗證項:是否一定得用 `pnpm install`、`link:` 在 Windows 反斜線下的表現、日誌路徑、關掉 `embeddingEnabled` 後的檢索品質,以及面板在別的 DSH 版本上的樣子。作者也說明外掛是輕量化設計,記憶庫過大時的情況還沒最佳化。
MIT · README 分支 main(無 release)
06常見問題
裝好之後為什麼一條都搜不到?
幾乎都是 `workspace` 留空造成的。在 DSH 裡 `process.cwd()` 是 profile 目錄而不是工作區,外掛因此找不到日記,搜不到也不報錯。請在 `~/.dsh/profiles/<profile>/cordis.patch.yml` 裡把 `workspace` 填成絕對路徑——程式碼現在也會發出 WARN。
需要百煉的 API key 嗎?
不需要。沒有 key 時檢索走本機的 `Xenova/bge-small-zh-v1.5`(約 24 MB,int8,首次檢索經 hf-mirror 下載到外掛的 `models/`),離線可用。填了 key 就換成 `qwen3.7-text-embedding` 加 `qwen3.7-text-rerank`,一旦失敗、逾時或連續失敗 3 次就回退本機。
怎麼確認向量檢索真的在跑?
看 `memory_search` 的結果開頭:`3 条(向量+词面)` 代表兩路都跑了;只有一個 `3 条` 代表只剩字面檢索,多半是 `sharp` 沒裝好。補裝的辦法是先 `npm install --ignore-scripts`,再 `npm install-scripts approve sharp` 與 `npm rebuild sharp`。
它刻意不做什麼?
不逐輪回放、不做增量擷取、不寫摘要、不負責遺忘。切塊、索引重建、雙路檢索與融合、時間視窗、狀態卡、壓縮後補原文由程式碼保證;什麼時候寫日記、要不要記關係片段、怎麼精簡,全靠模型按 `AGENTS.md` 自覺執行,漏了那段記憶就真的沒有。
想重置索引怎麼辦?
刪掉 `<workspace>/.tools/memory-index.json` 與 `<workspace>/.tools/memory-vectors.json`,下次搜尋會自動重建。平時不需要這樣做:索引會比對每個來源檔案的路徑、大小與 mtime,一變就重建。
07相關的 DSH 工作流程
dsh-univer-office
作者 dream-num
在 DSH 內預覽、建立與編輯表格、文件和幻燈片,由 Univer 驅動
clearai-dsh
作者 clearailhc
ClearAI:以本體為綱的原生 DSH 外掛 —— 經證據核驗的研究長成可瀏覽的領域本體。 · ClearAI: an ontology-first DSH agent preset — evidence-checked research that grows into a domain ontology.
dsh-fish-memory
作者 yuuyuko-uu
🐋 DSH 魚的記憶:給會話一份會淡忘的長期記憶,每條都帶時間。名字裡的「魚」來自 DeepSeek 的鯨魚。
dsh-trading
作者 zhu1090093659
基於 DeepSeek Harness 的智慧體原生交易終端,三欄介面聚合幣圈、美股、A股與港股,內建 19+ 可熱插拔聯結器,預設模擬交易並需人工確認。
08資料與來源
- 这是 **DSH(DeepSeek Harness)的 cordis 插件**,**不是把目录丢进 `.dev/` 就生效**
DSH 是通过 **profile 的 `package.json`** 加载插件的,光把目录放进去不会生效。
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-18。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
