claude-obsidian：為 Claude Code 打造的本地優先 Obsidian 知識系統
Obsidian + Claude Code 的自組織 AI 第二大腦。放下任何原始程式碼，Claude 都會讀取、連結並將其歸檔到您擁有的純 Markdown 的連接知識圖中。 AI 筆記、個人知識管理 (PKM) 和開源 Notion 替代方案。基於 Karpathy 的 LLM Wiki 模式。
秒懂
- 它是什麼？
- 一個以 Python 為基礎的 Agent Skills 系統，將來源檔案整理為附引用的連結式 Markdown 筆記，存放在使用者自有的 vault 中。 本文聚焦其核心介面、部署邊界、版本訊號與實際核驗方式。
- 適合誰用？
- MIT 授權允許自由使用與修改，但軟體依現況提供且不含任何擔保；README 亦說明，移除外掛或主機連結永遠不會刪除 vault。 適合已能提供相容執行環境、願意依 AgriciDaniel/claude-obsidian README 逐項核對的人；不適合把文件摘要當成生產承諾的團隊。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 5 天前。
- 用什麼語言寫的？
- 主要是 Python（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月15日）與我們的分析，不構成法律意見。
開源專案深度解析
為 Claude Code 打造的本地優先知識系統
claude-obsidian 是一個面向 Claude Code 及相容 Agent Skills 主機的本地優先知識系統。README 描述其 vault 始終保持為普通的 Markdown、JSON 與原始檔目錄，不會隱藏在外掛快取中，也不會鎖定在雲端資料庫裡。該專案以 Python 撰寫，採用 MIT 授權，設計上遵循 Andrej Karpathy 的 LLM Wiki 模式，並以 kepano/obsidian-skills 作為 Obsidian Markdown、Bases 與 JSON Canvas 語法的參考基底。儲存庫元資料記錄了 10,406 顆星與 1,202 次 fork，但 README 並未說明這些數字對應多少實際部署；這仍是一個需要讀者自行查證的問題。
claude-obsidian 第 1 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 claude-obsidian、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 AgriciDaniel/claude-obsidian 第 1 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 AgriciDaniel/claude-obsidian 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agricidaniel-claude-obsidian-deep-analysis 第 1 節的具體核對點是 為 Claude Code 打造的本地優先知識系統。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
知識循環：從捕獲到再次使用
README 將產品組織為一個可重複的循環，而非一次性儲存。捕獲環節讓本地來源經過可見的收件匣，並在合成之前保留不可變、以內容定址的副本。grounding 環節維護來源與聲明帳本，記錄權威性、新鮮度、支持、矛盾、置信度與審查狀態。連結環節構建連結頁面、索引、內容地圖、方法論感知的結構以及 Obsidian Canvas 檢視。最後一步是再次使用 vault：查詢、研究、檢索、lint，並摺疊已知內容，而不是每次對話都從零開始。輸出在有無 agent 的情況下都應可用：純 Markdown 保證可攜性，Obsidian 提供導覽與視覺化探索。
claude-obsidian 第 2 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 claude-obsidian、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 AgriciDaniel/claude-obsidian 第 2 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 AgriciDaniel/claude-obsidian 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agricidaniel-claude-obsidian-deep-analysis 第 2 節的具體核對點是 知識循環：從捕獲到再次使用。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
十五個技能，一套共享系統
這些技能足夠小，可以直接呼叫，又足夠協調，可以共享同一套證據、vault 選擇與變更規則。建構與使用組包含 wiki、save、wiki-ingest、wiki-query 與 wiki-lint。擴充組加入 autoresearch、canvas、defuddle、wiki-fold、wiki-mode、wiki-retrieve 與 wiki-cli。三個參考技能涵蓋 obsidian-markdown、obsidian-bases 與 think。Claude Code 暴露命名空間呼叫，如 /claude-obsidian:wiki-lint；其他主機使用各自的原生 Agent Skills 呼叫方式。觸發短語與精確約定位於各自的 skills/<name>/SKILL.md 檔案中。README 徽章顯示版本為 v2.1.0，但未說明該版本的具體變更內容。
claude-obsidian 第 3 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 claude-obsidian、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 AgriciDaniel/claude-obsidian 第 3 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 AgriciDaniel/claude-obsidian 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agricidaniel-claude-obsidian-deep-analysis 第 3 節的具體核對點是 十五個技能，一套共享系統。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
交易與信任邊界
產品不會把原始碼檢出、外掛快取或貢獻者狀態當作預設 vault。vault 的選擇是顯式的：透過 CLAUDE_OBSIDIAN_VAULT 環境變數、最近的 .claude-obsidian.json，或唯一明確的已初始化祖先目錄。如果選擇不確定，命令會在不寫入的情況下退出。一次邏輯知識操作就是一次可復原的交易：讀取所有目標並記錄其預期的 SHA-256，讓平行工作程序只回傳草稿與證據，將完整變更合併為一個操作套件，檢查該套件後僅套用一次，然後報告操作 ID 與確切變更路徑。核心持有一個程序生命週期內的 vault 鎖，記錄備份日誌，使用原子替換，並在套用無法完成時復原先前狀態。目標變更被視為衝突，絕不會靜默覆寫。
claude-obsidian 第 4 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 claude-obsidian、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 AgriciDaniel/claude-obsidian 第 4 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 AgriciDaniel/claude-obsidian 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agricidaniel-claude-obsidian-deep-analysis 第 4 節的具體核對點是 交易與信任邊界。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
明確陳述的能力邊界
README 包含一張支援表，明確陳述哪些功能已實作、哪些沒有。本地檔案系統來源獲得有界、以內容定址的位元組捕獲。影像在可用時獲得元資料、雜湊、大小與有界尺寸。PDF 與 EPUB 獲得元資料、雜湊與大小，但沒有內建語意擷取。URL 與 YouTube 攝取需要經驗證的同意計畫以及設定好的外部執行器，OCR 亦然。BM25 檢索是本地且確定性的。上下文前綴或遠端模型是可選的，並且受顯式出口同意閘控。高風險的已接受聲明需要兩個獨立來源，不受支持或相互矛盾的證據保持可見。當嵌入或重排序階段不可信時，基於模型的檢索會回退到確定性 BM25。README 沒有說明這些外部執行器是什麼、來自哪裡；這對潛在使用者來說仍是一個需要查證的問題。
claude-obsidian 第 5 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 claude-obsidian、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 AgriciDaniel/claude-obsidian 第 5 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 AgriciDaniel/claude-obsidian 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agricidaniel-claude-obsidian-deep-analysis 第 5 節的具體核對點是 明確陳述的能力邊界。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
四種歸檔模式
wiki-mode 可以使用四種方法論來路由新筆記，而無需批次移動既有知識。Generic 模式使用來源、概念、實體與會話。LYT 模式使用內容地圖與連結的原子筆記。PARA 模式使用專案、領域、資源與檔案。Zettelkasten 模式使用穩定識別碼、原子筆記與密集連結。未設定模式時預設使用 Generic。切換模式只改變新筆記的路由方式，不會靜默重組舊筆記。README 指向 docs/methodology-modes-guide.md 以取得詳細說明。
claude-obsidian 第 6 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 claude-obsidian、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 AgriciDaniel/claude-obsidian 第 6 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 AgriciDaniel/claude-obsidian 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agricidaniel-claude-obsidian-deep-analysis 第 6 節的具體核對點是 四種歸檔模式。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
安裝、平台支援與授權
快速開始流程是複製儲存庫，用 python3 scripts/claude-obsidian.py init 初始化一個單獨的 vault，審查 JSON 計畫，然後用 --approved-plan-sha256 與 --apply 套用該計畫。adopt 工作流處理既有 Obsidian vault。需求包括 Python 3.11 或更高版本，Obsidian 用於視覺化 vault 體驗，Bash 用於安裝與可選擴充，Git 僅用於開發、發布或明確的知識檢查點。CI 涵蓋 Linux 與 macOS，外加一個原生 Windows 冒煙測試。在原生 Windows 上，唯讀檢查與 dry-run 命令可用，但 vault 寫入需要 WSL，否則會以 UNSUPPORTED_PLATFORM 錯誤關閉。MIT 授權授予使用、複製、修改、合併、發布、散布、再授權與出售軟體的權利，前提是包含版權聲明。該授權以現況提供軟體，不附帶任何形式的擔保，並且未提及安全態勢、支援承諾或維護計畫。README 亦說明，移除外掛或主機連結永遠不會刪除 vault。
claude-obsidian 第 7 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 claude-obsidian、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 AgriciDaniel/claude-obsidian 第 7 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 AgriciDaniel/claude-obsidian 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agricidaniel-claude-obsidian-deep-analysis 第 7 節的具體核對點是 安裝、平台支援與授權。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
編輯結論
MIT 授權允許自由使用與修改，但軟體依現況提供且不含任何擔保；README 亦說明，移除外掛或主機連結永遠不會刪除 vault。 適合已能提供相容執行環境、願意依 AgriciDaniel/claude-obsidian README 逐項核對的人；不適合把文件摘要當成生產承諾的團隊。先在隔離目錄依專案自己的入口跑最小案例，檢查 claude-obsidian 的實際輸出、錯誤訊息與設定檔，再決定是否接入正式流程。
社群筆記