用途：在用户本地目录搭建或检查一个面向长期知识与内容生产的 Obsidian 知识库，为 ray-writer 等内容生产流程准备本地知识库，也可对已有 vault 做增量适配。
主要能力：先确定知识库根目录，再审计、初始化和复核；已有库只做增量补齐。原始资料、长期知识、创作过程和发布成品分开保存，链接表达关系，目录表达职责。初始化只建立最小可用骨架，采集自动化、网页剪藏、X 数据和发布连接器需另行配置。
使用方式：按用户明确目录、.ray-obsidian.json 或兼容目录结构定位根目录，无法确定时只问知识库要建在哪个本地目录。检查命令：python3 <skill-base>/scripts/vault_setup.py check --vault <知识库目录>。预演：python3 <skill-base>/scripts/vault_setup.py init --vault <知识库目录> --name <知识库名称> --dry-run。执行：python3 <skill-base>/scripts/vault_setup.py init --vault <知识库目录> --name <知识库名称>。初始化后重新 check，并读取 HOME.md、知识工作台、创作工作台、内容成稿包和个人知识库工作流，确认状态为 ready 且无覆盖。
适用场景：新建知识库、检查已有库、为 ray-writer 准备本地知识库、对已有 Obsidian 库做兼容层增量初始化。
限制：不默认使用 rays-brain，不假设知识库位于 iCloud、用户主目录或当前项目；不覆盖同名文件，不自动移动、改名、删除或批量改 frontmatter；不修改 .obsidian/，不强制插件、同步服务、Git 或特定云盘；未知结构版本停止并报告；用户只要求检查时不得初始化。Obsidian 只是编辑器，普通 Markdown 工具同样可用。