用Obsidian為Codex搭建長期記憶

作者:傑森的效率工坊
日期:2026年5月31日 下午2:37
來源:WeChat 原文

整理版優先睇

速讀 5 個重點 高亮

ObsidianCodex長期記憶,掌握記憶主權

整理版摘要

呢篇文章改編自Reddit博主ShilpaMitra嘅思路,佢提出用Obsidian做Codex長期記憶嘅載體。作者實踐後修正咗原貼嘅少量錯誤,認為呢個方法雖然同主流「外接長期記憶引擎」方式冇太大分別,但引入Obsidian令記憶權掌控喺自己手中,仲可以跨工具共享,更適合做長期知識資產。

先講Codex自身嘅記憶系統:第一層係AGENTS.md固定規則,第二層係Native MemoriesCodex自動總結,第三層係Hooks例如啟動時讀取goals.md等。呢啲方法有限制,所以需要外掛記憶庫。

文章介紹咗兩種方案:第一種係Basic Memory + MCP,用Basic Memory搭建Markdown記憶庫,Codex透過MCP讀寫,Obsidian打開同一個文件夾瀏覽編輯。第二種係純粹用Obsidian知識庫,由AGENTS.md告訴Codex點樣使用,所有內容喺你嘅Markdown文件度,控制權最高。兩種方案都可以避免被單一工具鎖死。

  • Obsidian做記憶載體,本質係Markdown文件,可跨工具共享,唔會被單一工具鎖死。
  • 兩種方案Basic Memory + MCP(配置簡單,適合多工具共享)同純Obsidian知識庫(控制權最高,適合重度Obsidian用家)。
  • Basic Memory方案需要喺CodexMCP配置,同埋俾規則話俾Codex知乜嘢值得保存。
  • Obsidian方案靠AGENTS.md寫穩定規則,例如啟動前讀取邊啲文件、命名規範等,目錄結構可以自訂。
  • 重點係記憶主權喺自己手,可以用Git做版本管理,用Obsidian編輯同搜索,建立長期知識資產。
值得記低
連結 github.com

Basic Memory GitHub 倉庫

用嚟搭建 Markdown 記憶庫嘅工具,配合 MCP 俾 Codex 讀寫。

整理重點

背景:Codex 記憶系統嘅侷限

Codex 本身有三層記憶AGENTS.md(固定規則)、Native Memories(自動總結,需喺 config.toml 開啓 memories = true)、Hooks(例如啟動時讀取 goals.md、active-context.md 等)。

呢啲方式有限制Native Memories 唔夠結構化,Hooks 只係靜態讀取,好難做長期知識管理。所以需要外掛記憶庫,而 Obsidian 係好嘅選擇。

整理重點

點解揀 Obsidian?

Obsidian 本質上係 Markdown 文件,文件喺你磁盤,可以直接閲讀、編輯、搜索,可以用 Git 做版本管理,用同步工具跨設備同步,仲可以用 雙鏈和圖譜 組織知識。

更重要係可以 跨工具共享:同一套記憶可以俾 CodexClaude CodeOpenCode、Hermes 等工具用,唔會被單一工具鎖死。

整理重點

方案一:Basic Memory + MCP

Basic MemoryGitHub:basicmachines-co/basic-memory)搭建 Markdown 記憶庫,Codex 透過 MCP 讀寫佢,Obsidian 打開同一個文件夾進行瀏覽同編輯。

  1. 1 CodexMCP 設定加入 Basic Memory
  2. 2 Obsidian 打開 Basic MemoryMarkdown 文件夾。
  3. 3 俾 Codex 規則,例如用呢啲句式:「Save to memory: <info>」、「Load from memory: <query>」等,Basic Memory 唔會自動判斷邊啲信息值得保存。

呢個方法嘅優點係配置簡單、適合多個 AI 工具共享記憶、筆記係 Markdown 可用 Obsidian 管理、可以搜索,比 Codex 原生 Memories 更適合做長期知識資產。缺點係需要藉助外部工具 Basic Memory。

整理重點

方案二:純 Obsidian 知識庫

完全用 Obsidian 做記憶庫,由 AGENTS.md 話俾 Codex 點樣使用。AGENTS.md 用來寫穩定規則,例如啟動前讀取邊啲文件、筆記放喺邊、命名規範、邊啲目錄唔可以改、輸出風格等。唔好寫成長篇百科,只寫簡短高效嘅規則。

推薦目錄架構例如:memories/ 放長期記憶,projects/ 放專案相關,inbox/ 放未整理筆記。仲可以配合 Hooks 例如 session-start.sh 喺 Codex 啟動時自動讀取關鍵文件。

整理重點

兩個方案點樣揀?

如果係輕度用家、想快速上手,揀 Basic Memory + MCP;如果係重度 Obsidian 用家、追求最高控制權,揀 純 Obsidian 知識庫。

無論揀邊個,重點都係「記憶主權喺自己手」,呢個係呢篇文章最值得吸收嘅核心。

 

用Obsidian做Codex長期記憶嘅工具

呢個諗法嚟自Reddit博主ShilpaMitra,雖然本質上同主流嘅【外接長期記憶引擎】方式冇乜大分別,但佢引入Obsidian,將記憶掌控權攞返喺自己手嘅諗法仍然令我信服。而且仲可以做到跨工具共享,更適合做長期知識資產
經過深入實踐之後,我對英文原貼入面嘅少量錯誤進行咗修正,而家同大家詳細講解。

先睇嚇整體架構圖:

圖片

Codex自身嘅記憶系統
先嚟睇嚇當前Codex嘅記憶系統嘅實現方式:
第一層:AGENTS.md,固定規則層。
第二層:Native Memories,由Codex自動總結,喺 ~/.codex/config.toml裏面開啓:memories = true
第三層:Hooks,例如喺啓動時讀取 memories/ 下的 goals.mdactive-context.mdindex.md等。

然後,就係通用嘅「外掛記憶庫」方式喇。

引入Obsidian
Obsidian 好適合做 Codex 嘅長期記憶工具,原因好簡單:本質上就係 Markdown 檔案,檔案喺你嘅磁碟上面,你可以直接閲讀、編輯、搜尋,可以用 Git 做版本管理,可以用同步工具跨裝置同步,可以用雙向連結同圖譜組織知識,可以被 Codex、MCP、腳本、命令行工具讀取。

而且仲可以做到跨工具共享。同一套記憶可以俾 Codex、Claude Code、OpenCode、Hermes 等工具使用。

Basic Memory + MCP

用 Basic Memory(GitHub倉庫地址:basicmachines-co/basic-memory)搭建 Markdown 記憶庫,Codex 透過 MCP 讀寫佢,Obsidian 打開同一個檔案夾進行瀏覽同編輯。

系統架構:
圖片

配置步驟:
1. 喺Codex入面加MCP
圖片

2. 同Obsidian建立連線:Basic Memory 本質上係 Markdown 檔案夾。你只需用 Obsidian 打開呢個檔案夾。

3. 俾Codex嘅規則:Basic Memory唔會自動幫你判斷所有資訊值唔值得保存,你仍然需要俾 Codex 規則,例如:
圖片

同Codex原生memories嘅分別

圖片

呢個方法嘅優點係:配置相對簡單,適合多個 AI 工具共享記憶,筆記係 Markdown,可以用 Obsidian 管理,比 Codex 原生 Memories 更適合做長期知識資產,可以搜尋,唔只係靜態讀取,唔容易被單一工具鎖死。

當然缺點係需要藉助一個外部工具 Basic Memory,而原帖俾出嘅另一種方案,就係完全使用Obsidian知識庫。由AGENTS.md話俾Codex知點樣用呢個庫。

AGENTS.md 用嚟寫穩定規則,例如啓動前讀取邊啲檔案、筆記放喺邊度、命名規範係咩、邊啲目錄唔可以改、輸出風格係咩。唔好將佢寫成長篇百科,只寫簡短高效嘅規則。

推薦目錄架構:

圖片

Hook 示例:
圖片

session-start.sh 示例:

圖片

呢個方案最適合重度 Obsidian 用戶。佢唔依賴第三方記憶服務,所有內容都喺你嘅 Markdown 檔案入面,控制權最高。

 


 

用Obsidian作為Codex長期記憶的載體

這個思路來自Reddit博主ShilpaMitra,雖然本質上和主流的【外接長期記憶引擎】方式沒太大區別,但他引入Obsidian、讓記憶權掌控在我們自己手中的思路還是讓我很信服。並且還能實現跨工具共享,更適合做長期知識資產
在深入實踐後,我對英文原貼中的少量錯誤進行了修正,現在為大家做詳細講解。

先看一下整體架構圖:

圖片

Codex自身的記憶系統
先來看一下當前Codex的記憶系統的實現方式:
第一層:AGENTS.md,固定規則層。
第二層:Native Memories,由Codex自動總結,在 ~/.codex/config.toml裏開啓:memories = true
第三層:Hooks,比如在啓動時讀取 memories/ 下的 goals.mdactive-context.mdindex.md等。

然後,就是通用的“外掛記憶庫”方式了。

引入Obsidian
Obsidian 很適合做 Codex 的長期記憶載體,原因很簡單:本質上就是 Markdown 文件,文件在你的磁盤上,你可以直接閲讀、編輯、搜索,可以用 Git 做版本管理,可以用同步工具跨設備同步,可以用雙鏈和圖譜組織知識,可以被 Codex、MCP、腳本、命令行工具讀取。

並且還能實現跨工具共享。同一套記憶可以給 Codex、Claude Code、OpenCode、Hermes 等工具使用。

Basic Memory + MCP

用 Basic Memory(GitHub倉庫地址:basicmachines-co/basic-memory) 搭建 Markdown 記憶庫,Codex 通過 MCP 讀寫它,Obsidian 打開同一個文件夾進行瀏覽和編輯。

系統架構:
圖片

配置步驟:
1. 在Codex中添加MCP
圖片

2. 和Obsidian建立連接:Basic Memory 本質上是 Markdown 文件夾。你只需用 Obsidian 打開這個文件夾。

3. 給Codex的規則:Basic Memory不會自動替你判斷所有信息是否值得保存,你仍然需要給 Codex 規則,比如:
圖片

與Codex原生memories的區別

圖片

這個方法的優點就是:配置相對簡單,適合多個 AI 工具共享記憶,筆記是 Markdown,可以用 Obsidian 管理,比 Codex 原生 Memories 更適合做長期知識資產,可以搜索,不只是靜態讀取,不容易被單一工具鎖死。

當然缺點就是需要藉助一個外部工具 Basic Memory,而原帖給出的另外一種方案,則是完全使用Obsidian知識庫。由AGENTS.md告訴Codex如何使用這個庫。

AGENTS.md 用來寫穩定規則,例如啓動前讀取哪些文件、筆記放在哪裏、命名規範是什麼、哪些目錄不能改、輸出風格是什麼。不要把它寫成長篇百科,只寫簡短高效的規則。

推薦目錄架構:

圖片

Hook 示例:
圖片

session-start.sh 示例:

圖片

這個方案最適合重度 Obsidian 用戶。它不依賴第三方記憶服務,所有內容都在你的 Markdown 文件裏,控制權最高。