返回目錄

sedimem

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

old-friends-gathering/sedimem

sedimem · 本地跨會話「自我迭代」記憶層:DSH / Codex CLI / Claude Code 共用一份只追加的真相層,重點治冗餘·重複·衝突·過時(MCP + 四道寫入衛生 + Agent 裁決閉環)

前往 GitHub專案首頁
$ git clone https://github.com/Old-Friends-Gathering/sedimem && cd sedimem

101

星數

5

Fork

JavaScript

語言

MIT

授權條款

2026-11-02

建立於

2026-11-19

最近推送

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。

安裝步驟

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

  2. 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' }`。

  3. 03

    首次讀寫前在 DSH 呼叫一次 `memory_scope` 對齊分庫——DSH 是常駐程序。

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

DSH 整合原生執行環境

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/`,刪除目錄是唯一的清除方式,也沒有備份。
2026-11-022026-11-13作者未說明

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` 預設寫入墓碑刪除。

08資料與來源

  • 作者聲明github.come91890018323…

    - 🔌 **三端共用一个记忆**:DSH / Codex CLI / Claude Code 连同一个 stdio MCP server、同一个分库

  • 作者聲明github.come91890018323…

    # DSH:~/.dsh/profiles/<profile>/cordis.patch.yml - insert: - id: memory-sedimem name: '@deepseek-ai/dsh-mcp-cl…

  • 作者聲明github.come91890018323…

    serverName: memo transport: stdio command: node args: ['/ABS/PATH/versions/v1.1/src/mcp/server.j…

  • 作者聲明github.come91890018323…

    三端各配一条 stdio MCP,指向同一个 `server.js` 和同一个 `MEMO_HOME`。常驻进程(DSH)记得先 `memory_scope` 对齐分库。

  • 作者聲明github.come91890018323…

    工具面:10 个 `memory_*` + 5 个 `memory_session_*`,三端完全一致。

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

🏆

最佳 DeepSeek Harness 外掛

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

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

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