soia-pkm-bootstrap-vault-obsidianlisted

# soia-pkm-bootstrap-vault-obsidian 在 `soia-pkm-bootstrap-vault-base` 创建的本地 Markdown 知识库上配置 Obsidian 消费端。Obsidian 只提供编辑、浏览和数据库视图；Markdown、YAML frontmatter 和 Git（若启用）仍是内容真源。 ## 客户可读说明 ### 这个技能可以做什么 - 安装或检查 Obsidian 1.9+。 - 启用核心插件 **Bases**，用于书库、文章库等数据库视图。 - 检查 `.obsidian/` 与 `snippets/wide-page.css` 是否已由 base 脚本生成，并说明手动启用步骤。 - 提供 Tars、Terminal、Obsidian Git 等可选配置边界。 本 skill 不创建 PARA 骨架、不替代 base，也不把 Obsidian 数据反向写回其他云端知识库。 ### 客户如何使用 1. 先安装并运行 `soia-pkm-bootstrap-vault-base`，通用初始化使用 `--no-obsidian`；如果要让脚本同时生成 CSS snippet，则按下方命令不带该参数运行。 2. 提供已有 vault 路径，确认 Obsidian 是否已安装及版本。 3. 按本 skill 完成核心插件和可选插件配置。 4. 在 Obsidian 中打开目标 vault，确认规则、模板和文章能正常显示。 ### 依赖与安装 安装本 skill（hard dependency 会同时要求 base）： ```bash npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-bootstrap-vault-obsidian -y ``` 配置约定： ```text ~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-bootstrap-vault-obsidian/config.yml SOIA_PKM_BOOTSTRAP_VAULT_OBSIDIAN_CONFIG_FILE=<custom-config-path> ``` 外部安装入口： - Obsidian 下载：https://obsidian.md/download - 版本建议：1.9+，以当前官方版本和本机系统支持为准。 ### 日志与完成回执 回执至少说明：Obsidian 版本检查结果、vault 打开/检查结果、Bases 是否启用、`.obsidian`/CSS 是否存在、可选插件是否跳过，以及仍需用户在客户端手动完成的事项。不要把账号、token 或本机私有路径写入日志。 ## 配置流程 ### 1. 安装 Obsidian 从 [Obsidian 官方下载页](https://obsidian.md/download) 安装桌面客户端，并登录（若用户需要同步或社区插件等账号能力）。不需要为了打开本地 Markdown vault 而把账号凭据写入 vault 或 skill 配置。 ### 2. 运行通用初始化 通用层命令： ```bash python3 <path-to-base-skill>/scripts/init_vault.py <vault-path> --no-obsidian ``` 若希望沿用 base 默认