返回目錄

dsh-memory-keeper

精選清單收錄維護狀態: 活躍

flywalker68/dsh-memory-keeper

DSH 長期記憶外掛:Qwen embedding + rerank 檢索,本地小模型兜底

前往 GitHub
$ git clone https://github.com/flywalker68/dsh-memory-keeper.git ~/.dsh/plugins/dsh-memory-keeper

19

星數

1

Fork

JavaScript

語言

MIT

授權條款

2026-11-05

建立於

2026-11-15

最近推送

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` 檔案,檔名與數量都不重要

安裝步驟

  1. 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

  2. 02

    先 `cd ~/.dsh/plugins/dsh-memory-keeper` 進入外掛目錄,然後執行 `npm install`

    $ npm install

  3. 03

    編輯 `~/.dsh/profiles/<你的 profile>/package.json` 這個檔案:在 `dependencies` 裡加上 `"dsh-memory-keeper": "link:<絕對路徑>"` 這一行,同時在 `dsh.profile.bundles` 裡加上 `"dsh-memory-keeper"` 這個名字

  4. 04

    先 `cd ~/.dsh/profiles/<你的 profile>` 進入 profile 目錄,然後執行 `pnpm install`

  5. 05

    重新啟動 DSH

  6. 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 整合程度與能力邊界

DSH 整合原生執行環境

以 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 版本上的樣子。作者也說明外掛是輕量化設計,記憶庫過大時的情況還沒最佳化。
2026-11-052026-11-15作者未說明

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,一變就重建。

08資料與來源

  • 作者聲明github.com56860da0d1ad…

    - 这是 **DSH(DeepSeek Harness)的 cordis 插件**,**不是把目录丢进 `.dev/` 就生效**

  • 作者聲明github.com56860da0d1ad…

    DSH 是通过 **profile 的 `package.json`** 加载插件的,光把目录放进去不会生效。

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-18。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。