如何跑 claude-obsidian 測試套件make test 完整詳解【免費(fèi)下載鏈接】claude-obsidianSelf-organizing AI second brain for Obsidian Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathys LLM Wiki pattern.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidianclaude-obsidian 是一個(gè)為 Obsidian Claude Code 打造的自組織 AI 第二大腦你丟入任何資料它會(huì)閱讀、鏈接并歸檔成一張純 Markdown 知識圖譜。那么它的代碼質(zhì)量如何保證答案就在一條命令里make test。本文將帶你完整理解 claude-obsidian 的測試套件怎么跑、每個(gè)子目標(biāo)在驗(yàn)證什么以及遇到問題時(shí)如何單獨(dú)調(diào)試?？焖偕鲜忠绘I運(yùn)行完整測試開始之前確認(rèn)你的環(huán)境滿足兩個(gè)條件Python 3.11 或更新版本Makefile 中默認(rèn)PYTHON ? python3Bashshell 測試套件依賴它獲取代碼并運(yùn)行g(shù)it clone https://gitcode.com/GitHub_Trending/cl/claude-obsidian cd claude-obsidian make test全部通過后終端會(huì)打印All hermetic tests and executable contracts passed. hermetic密封式是本項(xiàng)目的測試設(shè)計(jì)原則所有測試在臨時(shí)目錄中自建數(shù)據(jù)、不依賴網(wǎng)絡(luò)、不污染你的真實(shí) vault可放心重復(fù)執(zhí)行。make test 到底跑了什么make test并不是一個(gè)單一測試而是按固定順序串聯(lián)了 4 個(gè)子目標(biāo)見 Makefile子目標(biāo)運(yùn)行內(nèi)容驗(yàn)證對象test-python逐個(gè)隔離執(zhí)行tests/test_*.pyPython 核心邏輯claude_obsidian/test-shell逐個(gè)隔離執(zhí)行tests/test_*.sh腳本工具scripts/test-contractscontracts --check-onlycontracts --verify產(chǎn)品與能力契約聲明test-packagepackage validate技能、鉤子、清單元數(shù)據(jù)其中逐個(gè)隔離執(zhí)行是刻意為之每個(gè)測試文件獨(dú)立啟動(dòng) Python 解釋器任何一個(gè)文件失敗都會(huì)立刻中止并暴露而不是被后續(xù)輸出淹沒。test-python30 個(gè) Python 測試文件遍歷tests/目錄下所有test_*.py文件并逐一運(yùn)行。它們覆蓋的核心模塊包括路徑與邊界test_paths.py、test_vault_root_separation.py —— vault 根目錄選擇、插件樹隔離事務(wù)系統(tǒng)test_transaction.py、test_checkpoint.py —— 可恢復(fù)寫事務(wù)鎖定機(jī)制test_legacy_lock.py、test_concurrent_write.sh —— 并發(fā)寫保護(hù)檢索與索引test_retrieve.py、test_bm25_index.py安裝流程test_setup_vault.py、test_distribution_vaults.py測試數(shù)據(jù)來自 tests/fixtures/ 下的夾具目錄capture、contracts、lint、migration 等保證測試可重復(fù)。test-contracts最claude-obsidian的一步這是理解本項(xiàng)目特色的關(guān)鍵。項(xiàng)目用 JSON 契約文件誠實(shí)地聲明自己的能力邊界config/product-contract.json —— 產(chǎn)品承諾了什么promise、明確不做什么non_promisesconfig/capabilities.json —— 每項(xiàng)能力的讀取/寫入范圍、實(shí)現(xiàn)路徑make test-contracts會(huì)執(zhí)行兩輪校驗(yàn)python3 scripts/claude-obsidian.py contracts --check-only # 靜態(tài)檢查契約一致性 python3 scripts/claude-obsidian.py contracts --verify # 執(zhí)行能力就緒驗(yàn)證它確保聲明的能力與實(shí)際存在實(shí)現(xiàn)嚴(yán)格一致——沒有的適配器會(huì)明確降級而不是被模擬。test-package打包元數(shù)據(jù)體檢執(zhí)行python3 scripts/claude-obsidian.py package validate校驗(yàn) 15 個(gè)技能skills/、鉤子hooks/hooks.json與清單文件的一致性保證分發(fā)的便攜技能包元數(shù)據(jù)完整。輔助目標(biāo)按需組合運(yùn)行命令用途make help打印所有開發(fā)者目標(biāo)說明make validate只跑契約 打包校驗(yàn)跳過測試套件快速檢查make test-python只跑 Python 測試make test-shell只跑 shell 測試make clean-test-state清理.vault-meta/中的運(yùn)行時(shí)鎖、緩存與生成狀態(tài) 小技巧如果某次運(yùn)行卡在鎖文件上先執(zhí)行make clean-test-state再重跑make test。如何單獨(dú)運(yùn)行一個(gè)測試文件每個(gè)測試文件都是可獨(dú)立執(zhí)行的腳本調(diào)試時(shí)不必跑全量# Python 測試直接運(yùn)行該文件 python3 tests/test_paths.py # Shell 測試直接用 bash 運(yùn)行 bash tests/test_wiki_lock.sh這正是make test-python/make test-shell底層的做法——對每個(gè)測試文件獨(dú)立啟動(dòng)見 Makefile。常見問題FAQQ提示 Python 版本過低A本項(xiàng)目核心要求 Python 3.11。升級后重試或指定解釋器make test PYTHONpython3.12。Q測試會(huì)改動(dòng)我的 vault 嗎A不會(huì)。測試嚴(yán)格使用tempfile臨時(shí)目錄自建一次性 vault如 test_paths.py 中可見從不觸碰真實(shí)數(shù)據(jù)。QWindows 能直接跑嗎A建議用 WSL原生 Windows 與 Git Bash 不在當(dāng)前兼容保證內(nèi)CI 在 Linux 和 macOS 上驗(yàn)證見 README.md Requirements 一節(jié)。Q改了代碼后應(yīng)該跑什么A按照 AGENTS.md 的驗(yàn)證要求行為變更之后運(yùn)行完整make test。小結(jié)claude-obsidian 的測試體系設(shè)計(jì)得非常清晰一條make test覆蓋邏輯測試 → 腳本測試 → 契約校驗(yàn) → 打包校驗(yàn)四層防線全部自包含、可隨時(shí)重復(fù)。理解了 4 個(gè)子目標(biāo)各自的分工后你既能一鍵驗(yàn)證整個(gè)項(xiàng)目也能精準(zhǔn)定位到單個(gè)測試文件進(jìn)行調(diào)試。更多開發(fā)細(xì)節(jié)可參考 CONTRIBUTING.md 與安裝指南 docs/install-guide.md?！久赓M(fèi)下載鏈接】claude-obsidianSelf-organizing AI second brain for Obsidian Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathys LLM Wiki pattern.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidian創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考