如何用claude-obsidian创建全新vault？先dry-run再确认应用的完整流程

如何用claude-obsidian创建全新vault先dry-run再确认应用的完整流程【免费下载链接】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是一个面向 Claude Code 的 Obsidian 第二大脑你丢入任意资料它会自动阅读、链接并归档成一个由纯 Markdown 组成的知识图谱。而创建一个新的vault知识库时它有一个非常贴心的设计——先 dry-run 预览计划确认无误后再 apply 应用。本文带你走完这套先预览、再确认的完整流程。为什么要先 dry-runclaude-obsidian 的哲学是每一个改变 vault 的操作都是一笔可回滚的事务。在claude_obsidian/cli.py中可以看到init命令默认不会写任何文件而是先输出一份 JSON 格式的初始化计划状态为dry-run列出将要创建的每一个路径并给出一份计划指纹approval_sha256。只有你拿着这个指纹回来执行--apply它才会真正动手。这带来三个好处️零意外你能提前看到将创建哪些目录和文件路径不对就直接终止️防篡改--apply时如果重新生成的事务与你审阅过的计划不一致会直接报PLAN_CHANGED错误绝不顺手写盘️可恢复apply 过程中失败会自动回滚不会留下半拉子状态。第一步获取项目git clone https://gitcode.com/GitHub_Trending/cl/claude-obsidian cd claude-obsidian⚠️ 注意这个 clone 下来的目录是产品源码不要直接把它当作你的知识库来用。你的 vault 应该是一个独立的目录。第二步运行 init 的 dry-run 预览export GENERATED_AT$(date -u %Y-%m-%dT%H:%M:%SZ) export OPERATION_IDinit-reviewed python3 scripts/claude-obsidian.py init $HOME/Documents/MyKnowledgeVault \ --generated-at $GENERATED_AT --operation-id $OPERATION_ID这条命令不会创建任何文件只打印一份 JSON 计划关键字段有字段含义statusdry-run预览/noop无事可做changed_paths将要写入的完整路径清单approval_sha256这份计划的唯一指纹apply 时要用请核对两点目标目录是否正确、changed_paths里的路径是否都符合预期。然后记下approved_plan_sha256的值。第三步带着指纹确认应用审阅通过后带上指纹执行同一命令并加上--applypython3 scripts/claude-obsidian.py init $HOME/Documents/MyKnowledgeVault \ --generated-at $GENERATED_AT --operation-id $OPERATION_ID \ --approved-plan-sha256 dry-run输出的sha256 --apply如果指纹对不上、或目录在预览后发生了变化命令会拒绝执行并提示PLAN_CHANGED——此时重新跑一次 dry-run 即可。 也有一行式兼容脚本bin/setup-vault.sh--dry-run默认预览、--apply --approved-plan-sha256 HASH应用适合老用户迁移习惯。新 vault 里有什么初始化完成后你会得到一套开箱即用的结构模板来源见templates/vault/inbox/—— 显性的资料收件箱所有来源从这里进入.raw/—— 不可变的原始资料副本保证总结之后还能溯源wiki/——index.md、log.md、overview.md、hot.md及生成的笔记⚙️.obsidian/—— 最小化、不破坏性的 Obsidian 默认配置.claude-obsidian.json—— 工作区身份与 vault 选择声明.gitignore—— 默认排除.vault-meta/等运行时状态隐私友好它不会帮你添加 Git 远程仓库或安装任何社区插件一切保持在你的掌控中。打开 vault开始让 AI 干活用 Obsidian 的 vault 选择器打开新目录然后在该目录下启动 Claude Codecd $HOME/Documents/MyKnowledgeVault claude --plugin-dir /绝对路径/claude-obsidian在对话里输入/claude-obsidian:wiki即可进入工作流把资料放进inbox/调用/claude-obsidian:wiki-ingest摄取想保存结论用/claude-obsidian:save提问用/claude-obsidian:wiki-query。各技能的契约都写在skills/wiki/SKILL.md里。已有 Obsidian 库用 adopt 而非重建如果你已经有一个 Obsidian 库别动它——adopt流程是非破坏性的只会补上缺失的产品元数据和基础文件同样先 dry-run 再 apply详见 安装指南python3 scripts/claude-obsidian.py adopt 现有vault路径 \ --generated-at $GENERATED_AT --operation-id adopt-reviewed对于更老版本的布局还有幂等的migrate命令补充溯源账本。常见问题速查Q忘了拿 sha256 还能 apply 吗不能这正是设计目的。重新执行一次 dry-run 拿到新指纹即可代价是几秒钟。Q预览时看到noop是什么情况说明目标目录已经具备全部初始化内容无需任何写入直接跳过。Q想换个目录结构PARA / Zettelkastenvault 建好后用wiki-mode技能切换归档约定即可见skills/wiki-mode/SKILL.md。总结dry-run → 核对 changed_paths → 记录 sha256 → --apply这四步就是 claude-obsidian 创建 vault 的核心仪式。它让你始终清楚 AI 将碰哪些文件也让本地优先、用户拥有不只是一句口号。【免费下载链接】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），仅供参考