用途 在 soia-pkm-bootstrap-vault-base 创建的本地 Markdown 知识库上，安全合并 Obsidian 消费端配置。Markdown、YAML frontmatter 和 Git（若启用）仍是内容真源；base 不写 .obsidian，平台配置只在本技能执行。触发说法包括「配置 Obsidian vault」「启用 Obsidian Bases」「接入 Obsidian 消费端」。
主要能力 检查 Obsidian 客户端是否可用（版本以本机或官方当前信息为准）。dry-run 预览并结构化合并 core-plugins.json、appearance.json 与可选 app.json，兼容新版对象和旧版列表两种核心插件格式。保留未知核心插件、主题、snippet 和 JSON 键。为工作台、精选长期知识和工作台历史补充三个 create-only .base 视图，已有视图始终保留。apply 前备份将修改的现有文件，支持 --check 验收。
安装与使用 安装（hard dependency 会同时要求 base）： claude plugin marketplace add soia-team/soia-open-skills claude plugin install soia-pkm-vault@soia 只要这一个技能时可用 npx 路线；技能会落进共享真源 ~/.agents/skills，若同时装插件会出现两份索引且各自漂移，建议二选一： npx skills add soia-team/soia-open-pkm-vault-skills -g -a '*' -s soia-pkm-bootstrap-vault-obsidian -y 本技能不需要凭据或私有配置，目标通过 CLI 传入。先用 base 初始化或确认已有 Markdown vault，再提供 vault 路径，默认 dry-run；确认后加 --apply。示例： python3 scripts/configure_obsidian.py <vault-path> python3 scripts/configure_obsidian.py <vault-path> --apply python3 scripts/configure_obsidian.py <vault-path> --link-format relative --apply python3 scripts/configure_obsidian.py <vault-path> --check 脚本默认启用 Bases、三个 create-only .base 视图和 wide-page snippet。已有 CSS 与 bundled 版本不同会报告 drift 并跳过，只有客户看过 overwrite plan 并明确授权后才能使用 --force-managed --apply。
限制 不创建 PARA 骨架、不替代 base，也不把 Obsidian 数据反向写回其他云端知识库。备份位于 .obsidian/.soia-backups/<timestamp>/，只含本轮将修改的配置文件；回滚时先关闭 Obsidian 再精确恢复该批次文件，不要删除整个 .obsidian。日志只报告键/列表类别和数量，不打印完整私有 JSON 值。安装社区插件前需核对作者、权限和本机安全策略；WorkBuddy 需单独安装，见 docs/install/workbuddy.md。版本建议 Obsidian 1.9+，以官方当前版本和本机系统支持为准。
验证 先运行 --check，再在 Obsidian 中打开一篇 Markdown 与一个 .base 视图，检查 frontmatter、wikilink、Bases 和宽页样式，并确认未知插件、主题和设置仍保留。