Plugin List Sync

一个 Obsidian 插件：把当前 vault 已安装的社区插件列表导出到库内的一个 JSON 文件，该文件随你的 S3 同步工具（或任意同步工具）带到另一台设备；在新设备上可以一键引导安装缺失的插件，也可以选择删除本机多出的插件，执行“统一方案”让两台设备的插件集合保持一致。

工作原理

1. 源设备：插件读取 .obsidian/plugins/*/manifest.json 和 .obsidian/community-plugins.json，把插件 id、名称、版本、作者、仓库等信息写入同步文件（默认 .obsidian/plugin-sync/plugins.json，路径可在设置中修改）。文件里还会带上设备 ID 和设备名称。
2. S3 同步：这个文件在 vault 内，会被你的 S3 同步工具当作普通文件同步过去。
3. 新设备：插件启动时对比本地与同步文件：
   • 同一设备（文件里的设备 ID 与本机相同）：以本地最新状态为准，旧文件会被自动覆盖，不会弹出“未安装”提示（例如你在本机删掉了几个插件，不会又被要求装回来）。
   • 其他设备：弹出提示，打开“插件同步方案”后展开列表，让你勾选要安装 / 更新 / 删除哪些插件，并给出“统一方案”摘要，执行后重新导出统一后的列表，两边即可收敛到同一套插件。

安装时从官方插件市场（obsidianmd/obsidian-releases）和对应插件的 GitHub Releases 下载 main.js / manifest.json / styles.css。

安装本插件（两台设备都要做）

1. 在 vault 的 .obsidian/plugins/ 下新建文件夹 plugin-list-sync，把本目录的 main.js、manifest.json、styles.css 放进去。
2. 打开 Obsidian → 设置 → 第三方插件 → 启用 “Plugin List Sync”。

使用步骤

源设备（A）

• 启用插件后会自动导出（可在设置里关闭）。
• 也可以随时用命令面板运行“导出插件列表到同步文件”。
• 之后增删插件时，插件会自动检测变化并重新导出（默认每 30 分钟检查一次，可在设置中调整）。

目标设备（B）

• 等 S3 把 vault 同步过来（包括插件列表文件）。
• 启用本插件后会自动检测：发现与其他设备的列表不一致时，弹窗提示并给出“查看统一方案”按钮。
• 打开“插件同步方案”后，列表分三组：需要安装（对方有、本机没有，默认勾选）、需要更新（两边版本不同，默认勾选）、本机多出（可删除，默认不勾选，避免误删）。
• 勾选完成后底部显示“统一方案：安装 X 个 · 更新 Y 个 · 删除 Z 个”，点“执行统一方案”即可；执行后插件会重新导出统一后的列表，另一台设备同步后会看到同样的方案，两边最终一致。

同设备场景

• 如果你在同一台设备上删除了插件，之前导出的旧列表不会再触发“未安装”提示——插件检测到同步文件来自本机后，会直接用本地最新状态覆盖它。
• 可以在设置里查看只读的“设备 ID”，用于区分是哪台设备。

注意事项

• 同步文件默认写在 .obsidian/plugin-sync/plugins.json。如果你的 S3 同步工具排除了 .obsidian 目录，请把“同步文件路径”改成 vault 根目录下的路径，例如 plugin-sync/plugins.json。
• “删除”会移除插件文件夹并把它从启用列表中移除（不会卸载本插件自身）。删除是危险操作，默认不勾选，请确认后再执行。
• 安装依赖 GitHub Releases，网络需要能访问 GitHub；GitHub API 未登录有频率限制（约 60 次/小时/IP），一次性安装大量插件时如果报 403，稍后再试或分批安装。
• 本插件不会把自己写入同步列表（因为它不在官方插件市场），两台设备都需要手动安装一次。
• 极少数插件发布时只提供 zip 压缩包而不是单独的 main.js / manifest.json，这类插件无法自动安装。