claude-obsidian doctor命令使用指南：快速诊断vault就绪问题

claude-obsidian doctor命令使用指南快速诊断vault就绪问题【免费下载链接】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.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidianclaude-obsidian是一个为 Obsidian Claude Code 打造的自组织 AI 第二大脑你丢入任何资料Claude 会自动阅读、建立链接并把知识归档成一张纯 Markdown 的连通知识图谱。在开始使用前先用doctor 命令对 vault知识库做一次体检几秒钟就能确认它是否就绪。本指南带你从 0 跑通诊断全流程。一、doctor 命令能帮你查什么vault 未就绪时后续的写入、检索、lint 都可能失败。doctor命令会在不修改任何文件的前提下输出 JSON 报告逐项检查 6 个关键状态检查项含义不通过说明什么vault_existsvault 目录存在路径写错或 vault 未初始化obsidian_config.obsidian配置目录存在该目录不是有效的 Obsidian 库wikiwiki/知识库目录存在未完成init/adopt流程raw.raw/原始资料目录存在缺少内容寻址的原始来源存储meta_writablevault 可写权限不足写入操作会被拒绝mutation_lock_held是否有进程持有写锁仅为提示不影响整体 ok 判定前 5 项全部为true时报告的ok字段即为true命令以退出码0结束否则退出码为1——这让它可以直接嵌入脚本做自动化检查。二、一键运行 doctor 诊断先获取产品代码产品仓库和你的知识库是两个独立目录git clone https://gitcode.com/GitHub_Trending/cl/claude-obsidian cd claude-obsidian然后对目标 vault 执行诊断完整说明见 docs/install-guide.mdpython3 scripts/claude-obsidian.py doctor --vault ~/MyKnowledgeVault--vault省略时命令按以下优先级自动选择 vault--vault path显式指定环境变量CLAUDE_OBSIDIAN_VAULT当前目录最近的.claude-obsidian.json当前目录附近唯一已初始化的 vault若选择失败命令会直接退出而不会改动任何文件。三、读懂诊断报告报告会打印如下结构的 JSONschema 为claude-obsidian.doctor.v1{ schema: claude-obsidian.doctor.v1, version: 2.0.0, vault_root: /Users/you/MyKnowledgeVault, selection_source: --vault, legacy_layout: false, checks: { vault_exists: true, obsidian_config: true, wiki: true, raw: true, meta_writable: true, mutation_lock_held: false }, ok: true }新手只需盯住三个字段ok整体是否就绪绿色通过就是truevault_root确认诊断的确实是目标 vault而不是产品仓库本身产品根目录会被显式拒绝作为 vaultlegacy_layout为true时说明这是旧版布局建议运行migrate补齐元数据实现逻辑很直观可以对照源码理解每一项检查command_doctor()。四、常见问题与快速修复❓wiki: false或raw: falsevault 目录缺少核心结构。全新目录请先走init流程已有 Obsidian 库则用非破坏性的adopt流程补上元数据详见 install-guide。❓meta_writable: false当前用户对 vault 没有写权限。检查目录权限或换一个可写路径。❓mutation_lock_held: true另一个进程正在写入 vault。稍等片刻重跑即可它只是提示不会导致ok: false。❓ 提示找不到 vault检查--vault路径拼写或确认当前目录附近是否存在.claude-obsidian.json。也可以查看 bin/setup-vault.sh它是doctor的官方封装入口。五、进阶doctor 通过后做什么ok: true表示基础结构就绪。想做更深入的能力体检可以紧接着运行契约验证检查各项可选能力检索、扩展等是否真正可用python3 scripts/claude-obsidian.py contracts --verify --vault ~/MyKnowledgeVault两条命令组合使用就是 docs/compound-vault-guide.md 推荐的就绪双检。诊断通过后你可以把资料放进inbox/启动 Claude Code 的wiki-ingest技能让知识开始自动沉淀。最终效果大致长这样——一张由笔记与来源彼此连通的图谱六、相关资源速查命令总览表README.mdOperator reference 章节安装与 vault 选择优先级docs/install-guide.md诊断报告的结构化测试用例tests/test_setup_vault.py可选检索/模式扩展脚本scripts/示例 vault 结构参考examples/sample-vault/掌握doctor这一条命令你就拥有了随时确认我的第二大脑是否健康的能力——建议把它作为每次大改动前的固定仪式。【免费下载链接】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.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidian创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考