用途：在通过 obsync CLI 同步的 Obsidian 仓库中安全地读写文件。核心原则是“读前同步、写后同步”：若 obsync watch 正在运行，仓库会自动保持同步，无需手动操作；若未运行 watch，则读取前先执行 obsync sync /path/to/vault 拉取最新内容，写入或修改后再执行同一命令推送改动。obsync sync 一次完成拉取与推送，两种情况都可安全使用。
主要能力：支持登录、列出仓库、初始化仓库、同步、单独拉取或推送、持续监听、查看状态、查看与恢复文件历史、运行诊断，以及用 --debug 查看 WebSocket 消息。watch 模式保持长连接实时拉取，并每 30 秒扫描本地改动，断线自动重连，Ctrl+C 停止。每个仓库同时只能运行一个 obsync 进程（.obsync/obsync.lock 文件锁），watch 运行时再执行 sync 会报锁错误，属预期行为。
使用方式：一次性设置依次执行 obsync login、obsync vaults、obsync init <vault-id> /path/to/vault；之后命令可在仓库目录内运行，或把目录作为最后一个参数传入。同步日志写入 .obsync/sync.log，同步状态存于 .obsync/state.db（SQLite），可据此排查文件未上传、未下载、删除未传播等问题，也可重置 synchash 强制重新同步或回滚 last_version 重放遗漏的服务器变更。
同步范围：仓库内所有扩展名的文件与文件夹元数据；排除点文件与点目录（.git/、.obsidian/、.obsync/）、workspace.json、workspace-mobile.json 以及约 199 MB 以上的文件。.obsidian/ 配置由服务器以推送通知方式同步。冲突处理：Markdown 用三方合并，.obsidian/ 内 JSON 做浅合并（服务器键优先，保留本地独有键），其他类型本地版本优先，合并前会保存备份。
限制：资料未提供 obsync 的安装方式、平台支持、收费与价格信息。