Obsidian Config Sync

项目简介

Obsidian Config Sync 是一款基于 Wails 3、Go 和 Svelte 5 构建的桌面工具，专门用于解决 Obsidian 用户长期面临的多仓库配置同步难题。当用户在本地硬盘上维护多个 Obsidian 文档库时，每个库都有独立的 .obsidian 配置目录，手动保持配置一致既耗时又容易出错，这款工具正是为了自动化这一过程而诞生。

核心功能

• 多库识别：扫描指定目录及其子目录（最多两层），自动识别包含 .obsidian 的 Obsidian 库
• 主从库模式：设置一个主库作为配置来源，同步到 N 个目标库，支持一键批量同步
• 精细化同步范围：可按需选择同步配置文件、主题、CSS 片段和社区插件，不强制全量同步
• 同步预览：执行前展示新增与覆盖内容计划，确认无误后再写入，避免误覆盖
• 插件同步：不仅复制插件程序文件，还保留目标库原有启用列表，追加并启用新选插件
• 完全本地运行：所有操作在本地离线执行，不上传任何 Vault 数据，隐私安全有保障
• 跨平台支持：提供 Windows、Linux 和 macOS 三平台安装包

技术实现

项目采用 Wails 3 作为桌面框架，结合 Go 后端处理文件操作和 Svelte 5 构建前端界面。整体架构充分利用了 Wails 的系统集成能力，文件操作由 Go 原生处理保证了性能，前端响应式 UI 则由 Svelte 5 负责渲染。同步逻辑采用递归目录覆盖策略，但不会删除目标库中额外存在的文件，确保安全性。插件同步部分采用追加模式而非替换模式，最大程度保护目标库原有配置。

快速上手

第一步：下载安装

打开 GitHub Releases 页面，下载对应平台的安装包。Windows 用户下载 obsidian-config-sync-v{x}-windows-x64.exe，Linux 用户下载 tar.gz 包并解压，macOS 用户下载 zip 包并解压。

第二步：关闭 Obsidian

建议在同步前关闭正在使用相关 Vault 的 Obsidian 窗口，避免 Obsidian 与本工具同时修改配置造成冲突。

第三步：选择库

运行程序后，选择包含 Obsidian Vault 的目录。程序会自动扫描并列出所有发现的 Vault，从候选列表中移除不参与本次同步的库。

第四步：设置主库和目标库

选择一个主库（配置来源）和至少一个目标库。同步方向固定为主库 → 目标库，目标库中的同名配置可能被覆盖，请仔细确认选择。

第五步：配置同步范围并执行

选择需要同步的配置项和社区插件，可恢复默认全选或使用「全不选」后重新选择。确认同步计划后执行，同步完成后程序会显示每个目标库的新增成功、覆盖成功和失败项。

适用人群

• 在多台设备上使用 Obsidian 的用户
• 同时维护多个 Obsidian 文档库的研究者和写作者
• 需要在不同项目库间保持统一配置的开发者和知识管理者
• 注重隐私、不希望将 Vault 数据上传到云端的高隐私需求用户

注意事项

当前版本处于 Beta 阶段，已完成基本功能并经过个人使用测试，但仍可能存在未发现的问题。首次使用前务必备份各个 Vault 的 .obsidian 目录，或使用 Git 对文档仓库进行版本控制后再操作。

开源协议

项目基于 MIT 协议开源，可自由使用、修改和分发。