MIT、零執行期相依的本地優先記憶系統(Node ≥ 22,內建 `node:sqlite` FTS5),以 stdio MCP server 的形式接入 DeepSeek Harness,把歷史工作階段中的決策與經驗沉澱成無法改寫的追加式真相層,並可用 `as-of` 回查任一時點。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-15
授權條款
MIT
01它能幫你完成什麼?
讓 DeepSeek Harness、Codex CLI 與 Claude Code 讀寫同一份記憶,跨工作階段不再遺失脈絡
`~/.memo/items/<scope>.jsonl` 裡只追加的真相層,用 `memory_search` 以 BM25 加選用語意通道 RRF 融合檢索,並可 `as-of` 回查任一時點
每次開新工作階段都要把專案事實、決策與經驗重講一遍的 DSH 使用者
治理不斷累積的記憶,避免重複、衝突與過時資訊持續敗壞
去重掃描、去重叢集裁決、新舊取代與墓碑刪除,外加待裁決叢集與 30 天趨勢的衛生頁
長期本地使用、近似重複或彼此矛盾的筆記已經多到沒人敢信任記憶的團隊與個人
在不動資料的前提下看清 Agent 當天到底記住了什麼
http://127.0.0.1:7788 的九頁記憶中心:今日、圖譜、搜尋、衛生等,預設唯讀,只有以 `--write` 啟動才可編輯
在真實專案裡依賴這份記憶之前,想先自己核對一遍的人
02如何將外掛接入 DeepSeek Harness?
先決條件
- Node ≥ 22 —— sedimem 零執行期相依,靠 Node 內建的 `node:sqlite` FTS5。
- 一份倉庫本機副本(`git clone https://github.com/Old-Friends-Gathering/sedimem`)。
- 一個可以編輯 `~/.dsh/profiles/<profile>/cordis.patch.yml` 的 DSH profile。
安裝步驟
- 01
複製後照 README 的 30 秒快速上手跑一遍:`git clone https://github.com/Old-Friends-Gathering/sedimem && cd sedimem`,再依序執行其中的 `memo.js write --kind fact`、`memo.js search`、`memo.js serve --port 7788` 三行,Node 用 `command -v node` 的結果、版本目錄用 `V=versions/$(cat versions/CURRENT)`。
$ git clone https://github.com/Old-Friends-Gathering/sedimem && cd sedimem
- 02
把 DSH 設定區塊插進 `~/.dsh/profiles/<profile>/cordis.patch.yml`:`id: memory-sedimem`、`name: '@deepseek-ai/dsh-mcp-client'`、`config.serverName: memo`、`transport: stdio`、`command: node`、`args: ['/ABS/PATH/versions/v1.1/src/mcp/server.js']`、`env: { MEMO_HOME: '$HOME/.memo' }`。
- 03
首次讀寫前在 DSH 呼叫一次 `memory_scope` 對齊分庫——DSH 是常駐程序。
- 04
選用:把 Codex CLI(`~/.codex/config.toml` 的 `[mcp_servers.memo]`)與 Claude Code(`claude mcp add --scope user memo ...`)指向同一個 `server.js` 與 `MEMO_HOME`。
驗證整合成功
- 執行 `bash versions/v1.1/configs/verify-three-clients.sh`,README 說預期輸出 `PASS`。
- 確認工具面:10 個 `memory_*` 加 5 個 `memory_session_*`,三個用戶端完全一致。
- 兩個免安裝的唯讀檢查指令:`memo doctor` 與 `memo stats`。
03DSH 整合程度與能力邊界
Native DSH MCP mount: one `@deepseek-ai/dsh-mcp-client` block inserted into `~/.dsh/profiles/<profile>/cordis.patch.yml` (serverName memo, stdio, `node .../versions/v1.1/src/mcp/server.js`, `MEMO_HOME=$HOME/.memo`)
只追加的真相層 + 寫入四道關卡
透過 `memory_write` 或 `memo write` 寫入的一筆事實 / 決策 / 經驗→往 `~/.memo/items/<scope>.jsonl` 追加新版本,舊版本仍可用 `as-of` 讀回
金鑰、內網網域、私有路徑在落盤前被去識別化成 `[REDACTED:x]`同一個 slot 的不同值不會覆蓋舊事實,而是標成 superseded 或 disputed詞法 + 語意雙路檢索
`memory_search` 的查詢字串→以 RRF(k=60)融合的結果,附帶 basis;語意通道不可用時明確標示 `degraded`
唯讀記憶中心(九頁)
`memo serve --port 7788`→http://127.0.0.1:7788 上的今日 / 圖譜 / 搜尋 / 衛生 / 編輯 / 匯入 / 任務 / 交接 / 設定 九頁
預設唯讀,編輯需 `--write` 加上 token 與 If-Match任務庫(`session:` scope)
`memo session start / checkpoint / status / close / sweep`→只有 decision / gotcha 會帶 `from-session:<id>` 標籤晉升主庫,並產生六段交接文件 `docs/handoffs/<id>.md`
`session:*` 分庫禁止寫入 fact未晉升的內容隨暫存庫一併廢棄選用 LLM 派生層
`memo derive` / `memo llm`,指向 OpenAI 相容端點→標題、摘要、標籤寫入旁路 `derived/<scopeKey>.jsonl`
開啟後標題 / 摘要 / 標籤的生成請求會送往你設定的 provider,原始記憶文字仍只留在本機
04適合誰?何時不該用?
適合
- 每次開新工作階段都要把專案事實、決策與經驗重講一遍的 DSH 使用者
- 長期本地使用、近似重複或彼此矛盾的筆記已經多到沒人敢信任記憶的團隊與個人
- 在真實專案裡依賴這份記憶之前,想先自己核對一遍的人
不適合
- 必須 Node ≥ 22:sedimem 零執行期相依,靠 Node 內建的 `node:sqlite` FTS5,較舊的 Node 無法執行。
- scope 是分類而非權限邊界;多人共用同一份記憶需要獨立部署與驗證機制,這是專案刻意不做的。
05相容性、維護與安全提醒
- 必須 Node ≥ 22:sedimem 零執行期相依,靠 Node 內建的 `node:sqlite` FTS5,較舊的 Node 無法執行。
- 預設本地優先,但開啟選用 LLM 層後,標題 / 摘要 / 標籤的生成請求會送往你設定的 provider;真相層本身不參與這些請求。
- scope 是分類而非權限邊界;多人共用同一份記憶需要獨立部署與驗證機制,這是專案刻意不做的。
- 刻意不做雲端同步、不做多人權限;資料全在 `~/.memo/`,刪除目錄是唯一的清除方式,也沒有備份。
MIT · no published release · last push 2026-11-13
06常見問題
在 DeepSeek Harness 裡要怎麼接入 sedimem?
在 `~/.dsh/profiles/<profile>/cordis.patch.yml` 插入一條設定:`id: memory-sedimem`、`name: '@deepseek-ai/dsh-mcp-client'`、`serverName: memo`、`transport: stdio`、`command: node`、`args: ['/ABS/PATH/versions/v1.1/src/mcp/server.js']`、`env: { MEMO_HOME: '$HOME/.memo' }`。DSH 是常駐程序,第一次讀寫前先用 `memory_scope` 對齊分庫。
DSH、Codex CLI、Claude Code 可以共用同一份記憶嗎?
可以。三個用戶端各配一條 stdio MCP,指向同一個 `server.js` 與同一個 `MEMO_HOME`;工具面完全一致,共 10 個 `memory_*` 加 5 個 `memory_session_*`。自我檢查請執行 `bash versions/v1.1/configs/verify-three-clients.sh`,預期輸出 `PASS`。
在 DSH 裡使用 sedimem 一定要接 LLM 嗎?
不用。預設 `provider=none`,整個 LLM 層不存在,檢索、簡報、衛生與圖譜全部零 LLM 成本;開啟後標題、摘要、標籤只寫進旁路 sidecar,真相層位元組不變。
記憶資料放在哪,想清空該怎麼做?
全部在 `~/.memo/`,真相層是 `~/.memo/items/<scope>.jsonl`,只追加、永不原地修改,因此歷史狀態都能 `as-of` 回查;刪掉這個目錄就徹底清除,沒有雲端元件也沒有遙測。
兩筆記憶互相衝突時會怎麼處理?
寫入會依序通過四道關卡,同一個 slot 的不同值不會覆蓋舊記錄,而是標成 `superseded` 或 `disputed`,可交給 Agent 以 `memory_curate` 裁決;`memory_forget` 預設寫入墓碑刪除。
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 / Codex CLI / Claude Code 连同一个 stdio MCP server、同一个分库
# DSH:~/.dsh/profiles/<profile>/cordis.patch.yml - insert: - id: memory-sedimem name: '@deepseek-ai/dsh-mcp-cl…
serverName: memo transport: stdio command: node args: ['/ABS/PATH/versions/v1.1/src/mcp/server.j…
三端各配一条 stdio MCP,指向同一个 `server.js` 和同一个 `MEMO_HOME`。常驻进程(DSH)记得先 `memory_scope` 对齐分库。
工具面:10 个 `memory_*` + 5 个 `memory_session_*`,三端完全一致。
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-15。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
