basic-memory：從 README 拆解可用範圍
真正記住的人工智慧對話。永遠不要再向人工智慧重新解釋你的專案。加入我們的不和諧：.
秒懂
- 它是什麼？
- AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord:. 聚焦本專案的實際功能、技術入口、部署條件、資料流、版本變化與授權邊界，並依官方 README 所列能力判斷適用工作情境和不適合的替代用途。
- 適合誰用？
- Cloud 方案提供跨裝置同步、快照、備份與手機存取，local 方案則保留 air-gapped 能力與磁碟控製。這不是只有介面差異：Cloud 使用託管資料庫與同步服務，local 需要自行處理 Git、Syncthing 或其他同步及備份。
- 可以商用嗎？
- 可以，但條件嚴格。AGPL-3.0 是網路 copyleft 授權：如果別人透過網路使用你修改過的版本（例如作為託管服務），你必須以同一授權向他們提供原始碼。
- 還在維護嗎？
- 有在維護。儲存庫在最近一天內有新的提交。
- 用什麼語言寫的？
- 主要是 Python（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月15日）與我們的分析，不構成法律意見。
開源專案深度解析
basicmachines-co-basic-memory-deep-analysis｜面向AI助手的Markdown記憶層
basicmachines-co-basic-memory-deep-analysis｜面向AI助手的Markdown記憶層 的專案脈絡：Basic Memory 是一個Python專案，將AI可存取的知識以純文字Markdown檔案形式儲存在磁碟上。README將其描述為一種讓AI助手在工作階段之間記住上下文的方式，使用者與AI都讀寫同一組檔案。它使用模型上下文協定（MCP）連線到Claude、Codex、Cursor和ChatGPT等用戶端。專案自稱本地優先，具有雙向同步、由wikilinks和觀察構建的知識圖譜以及語意搜尋。倉庫中繼資料顯示有3,584顆星和248個分支，但README沒有提供使用統計資料。
basicmachines-co-basic-memory-deep-analysis｜面向AI助手的Markdown記憶層：README提供了兩種執行Basic Memory的方式。雲版本是託管服務，可在瀏覽器中使用，包含跨裝置同步、備份和快照，價格為每月15美元，提供7天免費試用。本機安裝根據AGPL-3.0授權免費，完全在磁碟上執行，需要透過uv安裝Python。兩種路徑使用相同的Markdown檔案和相同的MCP工具。README指出雲是選用的，你可以在兩者之間切換。它沒有具體說明雲服務的任何限製，除了定價細節。
basicmachines-co-basic-memory-deep-analysis｜面向AI助手的Markdown記憶層：Basic Memory定義了知識檔案的簡單語法。每個檔案是一個實體，frontmatter包含標題、型別、permalink和選用標籤。正文包含觀察（帶有選用類別、標籤或上下文的事實）和關係（指向其他實體的wiki風格連結）。README給出了一個關於咖啡沖煮方法的筆記範例，展示了AI如何從對話中建立結構化檔案。關係使用單一權杖型別或帶引號的多詞型別，裸連結被索引為links_to。根據README，這就是完整的語法。
basicmachines-co-basic-memory-deep-analysis｜面向AI助手的Markdown記憶層：Basic Memory向任何MCP用戶端公開一組MCP工具。README列出了內容（寫入、讀取、編輯、移動、刪除）、搜尋與探索、知識圖譜上下文構建、專案管理、模式操作和相容性
basicmachines-co-basic-memory-deep-analysis｜安裝入口與執行條件
basicmachines-co-basic-memory-deep-analysis｜安裝入口與執行條件 的專案脈絡：診斷的工具。每個工具都帶有行為提示，如唯讀、破壞性、冪等和開放世界，README稱這幫助代理無需試誤即可選擇正確的工具。README還包含了Claude Desktop、Claude Code、Codex CLI、Cursor、VS Code和ChatGPT的設定片段，並指出Obsidian無需任何設定即可直接讀取相同的Markdown。
basicmachines-co-basic-memory-deep-analysis｜安裝入口與執行條件：對於本機使用，README建議透過uv安裝，指令為 `uv tool install basic-memory`。對於使用Milvus儲存語意向量的Postgres部署，有一個選用附加套件：`uv tool install "basic-memory[milvus]"`。安裝後，你透過新增一個執行 `uvx basic-memory mcp` 的伺服器條目來設定MCP用戶端。README展示了Claude Desktop、Claude Code、Cursor、VS Code和Codex的JSON或TOML片段。它還指出筆記預設儲存在 `~/basic-memory` 中。README沒有指定最低硬體要求或支援的作業係統，除了提到Claude Desktop支援macOS、Windows和Linux。
basicmachines-co-basic-memory-deep-analysis｜安裝入口與執行條件：README重點介紹了幾個最近的補充。自動更新每24小時檢查一次uv tool和Homebrew安裝，並提供手動 `bm update` 指令。語意向量搜尋可用，支援混合全文加向量排序，使用FastEmbed嵌入，基於SQLite或Postgres。可選的交叉編碼器重新排序器可以重新評分候選，預設停用以避免延遲和模型下載。模式係統提供 `schema_infer`、`schema_validate` 和 `schema_diff` 工
basicmachines-co-basic-memory-deep-analysis｜資料流與設定鍵
basicmachines-co-basic-memory-deep-analysis｜資料流與設定鍵 的專案脈絡：具。CLI已透過 `--json` 輸出和專案儀表板進行了徹底改造。README連結了v0.18到v0.20的變更記錄。
basicmachines-co-basic-memory-deep-analysis｜資料流與設定鍵：根據README，Basic Memory收集最小的匿名事件以了解從CLI到雲的轉化漏斗。它明確不收集檔案內容、筆記標題、知識庫資料、個人身份資訊、IP地址或逐指令追蹤。事件在背景執行緒傳送到Umami Cloud執行個體，可透過環境變數 `BASIC_MEMORY_NO_PROMOS=1` 停用。該專案根據AGPL-3.0授權，授權摘錄說明它要求網路伺服器營運商向使用者提供修改版本的原始碼。README不包含任何保證或安全承諾，授權文字宣告該工作不提供任何保證。
basicmachines-co-basic-memory-deep-analysis｜資料流與設定鍵：basicmachines-co/basic-memory 將 AI 對話記憶落到 Markdown、wikilinks 與知識圖譜，並透過 MCP 連接 Claude、Codex、Cursor、ChatGPT 或支援 MCP 的 IDE。Local 路徑以 uv tool install basic-memory --prerelease=allow 安裝，README 說明 Basic Memory 0.23 需要 FastMCP 4 預發行相依套件；Milvus 部署則使用 basic-memory[milvus] extra。
basicmachines-co-basic-memory-deep-analysis｜資料流與設定鍵：Cloud 方案提供跨裝置同步、快照、備份與手機存取，local 方案則保留 air-gapped 能力與磁碟控製。這不是只有介面差異：Cloud 使用託管資料庫與同步服務，local 需要自行處理 Git、Syncthing 或其他同步及備份。評估時應讓 MCP client 寫入一份帶 wikilink 的 Markdown，再用語意搜尋找回，檢
basicmachines-co-basic-memory-deep-analysis｜團隊流程中的實際取捨
basicmachines-co-basic-memory-deep-analysis｜團隊流程中的實際取捨 的專案脈絡：查檔案內容與同步衝突是否符合預期。
basicmachines-co-basic-memory-deep-analysis｜團隊流程中的實際取捨：第1次檢查 basicmachines-co/basic-memory：應對照 README 的指令、設定鍵、輸入輸出與版本記錄，確認這項能力在目前環境能重現，並把錯誤訊息和資源限製一併記下。
basicmachines-co-basic-memory-deep-analysis｜團隊流程中的實際取捨：第2次檢查 basicmachines-co/basic-memory：應對照 README 的指令、設定鍵、輸入輸出與版本記錄，確認這項能力在目前環境能重現，並把錯誤訊息和資源限製一併記下。
basicmachines-co-basic-memory-deep-analysis｜團隊流程中的實際取捨：第3次檢查 basicmachines-co/basic-memory：應對照 README 的指令、設定鍵、輸入輸出與版本記錄，確認這項能力在目前環境能重現，並把錯誤訊息和資源限製一併記下。
basicmachines-co-basic-memory-deep-analysis｜團隊流程中的實際取捨：第4次檢查 basicmachines-co/basic-memory：應對照 README 的指令、設定鍵、輸入輸出與版本記錄，確認這項能力在目前環境能重現，並把錯誤訊息和資源限製一併記下。
basicmachines-co-basic-memory-deep-analysis｜團隊流程中的實際取捨：第5次檢查 basicmachines-co/basic-memory：應對照 README 的指令、設定鍵、輸入輸出與版本記錄，確認這項能力在目前環境能重現，並把錯誤訊息和資源限製一併記下。
basicmachines-co-basic-memory-deep-analysis｜團隊流程中的實際取捨：第6次檢查 basicmachines-co/basic-memory：應對照 README 的指令、設定鍵、輸入輸出與版本記錄，確認這項能力在目前環境能重現，並把錯誤訊息和資源限製一併記下。
basicmachines-co-basic-memory-deep-analysis｜團隊流程中的實際取捨：第7次檢查 basicmachines-co/basic-memory：應對照 README 的指令、設定鍵、輸入輸出與版本記錄，確認這項能力在目前環境能重現，並把錯誤訊息和資源限製一併記下。
basicmachines-co-basic-memory-deep-analysis｜團隊流程中的實際取捨：第8次檢查 basicmachines-co/basic-memory：應對照 RE
basicmachines-co-basic-memory-deep-analysis｜採用前的專案化檢查
basicmachines-co-basic-memory-deep-analysis｜採用前的專案化檢查 的專案脈絡：ADME 的指令、設定鍵、輸入輸出與版本記錄，確認這項能力在目前環境能重現，並把錯誤訊息和資源限製一併記下。
basicmachines-co-basic-memory-deep-analysis｜採用前的專案化檢查：第9次檢查 basicmachines-co/basic-memory：應對照 README 的指令、設定鍵、輸入輸出與版本記錄，確認這項能力在目前環境能重現，並把錯誤訊息和資源限製一併記下。
basicmachines-co-basic-memory-deep-analysis｜採用前的專案化檢查：第10次檢查 basicmachines-co/basic-memory：應對照 README 的指令、設定鍵、輸入輸出與版本記錄，確認這項能力在目前環境能重現，並把錯誤訊息和資源限製一併記下。
basicmachines-co-basic-memory-deep-analysis｜採用前的專案化檢查：第11次檢查 basicmachines-co/basic-memory：應對照 README 的指令、設定鍵、輸入輸出與版本記錄，確認這項能力在目前環境能重現，並把錯誤訊息和資源限製一併記下。
basicmachines-co-basic-memory-deep-analysis｜採用前的專案化檢查：第12次檢查 basicmachines-co/basic-memory：應對照 README 的指令、設定鍵、輸入輸出與版本記錄，確認這項能力在目前環境能重現，並把錯誤訊息和資源限製一併記下。
basicmachines-co-basic-memory-deep-analysis｜採用前的專案化檢查：第13次檢查 basicmachines-co/basic-memory：應對照 README 的指令、設定鍵、輸入輸出與版本記錄，確認這項能力在目前環境能重現，並把錯誤訊息和資源限製一併記下。
basicmachines-co-basic-memory-deep-analysis｜採用前的專案化檢查：第14次檢查 basicmachines-co/basic-memory：應對照 README 的指令、設定鍵、輸入輸出與版本記錄，確認這項能力在目前環境能重現，並把錯誤訊息和資源限製一併記下。
basicmachines-co-basic-memory-deep-analysis｜採用前的專案化檢查：第15次檢查 basicmachines-co/basic-memory：應對照 README 的指令、設定鍵、輸入輸出與版本記錄，確認這項能力在目前環境能重現，並把錯誤訊息和資源限製一併記下。
編輯結論
Cloud 方案提供跨裝置同步、快照、備份與手機存取，local 方案則保留 air-gapped 能力與磁碟控製。這不是只有介面差異：Cloud 使用託管資料庫與同步服務，local 需要自行處理 Git、Syncthing 或其他同步及備份。評估時應讓 MCP client 寫入一份帶 wikilink 的 Markdown，再用語意搜尋找回，檢查檔案內容與同步衝突是否符合預期。
社群筆記