轻量、干净、无广告的书签同步工具，通过 WebDAV 协议将书签同步到你的私有云盘。 本仓库是 原项目 的维护版：保留原项目的全部功能， 并补上手机端支持、双向增量增删，以及一批跨端同步的一致性修复。
安装包与变更记录见 Releases 页；扩展设置页的「检查更新」也指向那里。
- 🔄 多模式同步 — 支持上传、下载、合并三种同步策略
- ⏰ 自动定时同步 — 可设置 5~1440 分钟自动同步间隔
- ☁️ WebDAV 协议 — 兼容坚果云、Nextcloud、群晖等主流网盘
- 🔒 数据安全 — 书签数据直连你的云盘，不经过第三方服务器
- 🛡️ 本地备份 — 破坏性导入前校验备份写入；同步失败恢复仅作用于所选同步文件夹
- 🧹 无广告无追踪 — 干净纯粹，没有任何多余功能
- 💾 书签备份管理 — 支持创建、浏览、导入历史备份
- 📱 隐私保护 — 完整的隐私政策
- 📱 手机端也能用 — 另外提供 Gecko 引擎浏览器（可拓 / 雨见等）的 MV2 安装包，手机与电脑可以互相同步
- ⏰ 自动同步真能用 — 「重启就丢定时器」的手机浏览器上，每次启动自动重建定时器、并把错过的一轮补跑掉，不再默默不工作
- ⚡ 手机不卡 — 顺序没变化时不再逐个重排书签（245 条书签实测每轮 288 次写入 → 0 次）
- 🔁 双向增量增删 — 任一端删掉的书签，其他端下次同步跟着删；上传、下载、合并三条路径都生效
- 📂 单同步桶 — 只同步一个文件夹（自动识别，设置页可改）；失败回滚不清空其他收藏夹
- 📍 下载写入位置可选 — 像 floccus 一样，在设置里整树任选一个文件夹接收云端内容
- 🧹 「下载重建」更安全 — 清空只作用于同步文件夹，不再动同步文件夹之外的书签
- 💾 配置导出 / 导入 — 换浏览器时导出配置文件再导入，不必重填 WebDAV
- ✅ 同步结果更诚实 — 书签写入或手机桥接失败时报告失败/部分完成，不把主文件成功当作全部成功
- 🩺 后台诊断 — 设置页一键输出诊断报告并一键复制，连「这轮动了几个书签」都看得见
- ⬆️ 检查更新 — 设置页检查最新版并下载当前扩展变体的安装包；安装由宿主浏览器确认，取决于其支持与签名要求
 配置页面 |
 主页 |
 新增页面 |
到 Releases 页下载对应安装包 （商店里在架的仍是原项目的旧版本，不含本版修复，建议用下面的旁加载包）：
| 你在用什么 | 装哪个 |
|---|---|
| 桌面 Edge / Chrome | chromium-sideload.zip — 解压后在 edge://extensions（Chrome 是 chrome://extensions）打开「开发人员模式」，点「加载已解压的扩展程序」选该文件夹 |
| 手机 可拓 / 雨见等 | gecko-mv2-persistent.xpi — 地址栏显示 moz-extension:// 的就是 Gecko 引擎浏览器 |
| 手机 Firefox | gecko-mv2.xpi — 构建产物未签名；能否安装取决于宿主的签名与安装信任要求，普通 Firefox 不应视为可直接安装 |
- 点击扩展图标打开弹窗
- 进入设置页面
- 填写 WebDAV 服务器信息：
| 配置项 | 说明 | 示例 |
|---|---|---|
| 服务器地址 | WebDAV 服务地址 | https://dav.jianguoyun.com/dav/ |
| 用户名 | 网盘账号或应用专用密码用户名 | your@email.com |
| 密码 | 应用专用密码（非登录密码） | xxxxxxxxxxxx |
| 书签路径 | 云端存储文件夹；文件名由扩展配置决定 | /书签同步 |
配置完成后，点击「合并」即可完成首次同步。
- 首次同步建议用「合并」：两端内容会合到一起，不会互相覆盖
- 同步文件夹默认自动识别，可在设置页改；「下载写入位置」可选云端内容落到本机哪个文件夹
- 三种模式都会带上删除记录，任一端删掉的书签下次同步会跟着删
| 服务 | 推荐度 | 备注 |
|---|---|---|
| 坚果云 | ⭐⭐⭐ | 国内最常用，免费额度足够 |
| Nextcloud | ⭐⭐⭐ | 开源自建，完全可控 |
| 群晖 NAS | ⭐⭐⭐ | WebDAV Server 套件 |
| Teracloud | ⭐⭐ | 免费提供 WebDAV |
| 其他 WebDAV | ⭐ | 仅支持 RFC 4918 不足以保证兼容；并发写入保护取决于下述能力 |
写入共用一份文件时，客户端按服务器实际提供的能力分层选择并发校验，从强到弱：
- 强 ETag →
If-Match（原子、精确；本地已有的文件首选这一档） - 只有弱 ETag 或只有
Last-Modified→If-Unmodified-Since（仍是服务端原子比较，秒级粒度）。 弱 ETag 不会被当成强 ETag 送去If-Match（RFC 7232 要求强比较，那样只会拿到必然的 412） - 两者都没有 → 仍然写入，但同步结果里会明说本次没有并发保护，不会假装安全
新文件使用 If-None-Match: *，只允许创建，避免覆盖同名既有文件。降档时弹窗的同步结果会带上说明。
上述分层并发校验尚未在本仓库完成生产 WebDAV 厂商验证：具体服务实际返回哪些头、是否真正执行
If-Unmodified-Since，仍待你在真实服务上确认。本仓库的自动化测试用模拟服务器覆盖了这三种能力档位。
💡 坚果云用户：需要在第三方应用管理中创建应用密码，不能使用登录密码。
| 模式 | 说明 | 适用场景 |
|---|---|---|
| 合并 | 两端书签增量增删，各自的新增与删除都在云端收敛 | 日常使用（默认） |
| 上传 | 以本机为准覆盖云端；云端删掉的会先从本机删掉，删除记录随文件带上云 | 以本机为准时使用 |
| 下载 | 云端新增的导入本机，云端删掉的也从本机删掉；本机独有的书签保留 | 以云端为准时使用 |
删除记录用于向离线设备传播删除。有效记录不会仅凭三天 TTL 和当前两份书签视图被回收； 尚无所有设备确认删除的协议，因此旧记录可能长期保留。用户明确重新添加的节点仍按重新添加规则处理。 切换 WebDAV 账户、云端文件或本地同步文件夹时，同步状态按关系隔离，不继承旧目标的删除基线。
- Chrome Extension Manifest V3（Chromium 系）/ MV2（Gecko 系宿主）
- 原生 JavaScript（无框架依赖；扩展安装包不包含 npm 运行时依赖）
- WebDAV 协议通信
- Chrome Storage API 本地存储
开发测试使用的 Vitest 1.6.1 存在已知安全公告，本版未升级；该工具及其依赖树不随扩展分发。镜像来源的传递依赖公告覆盖不完整，不代表完整依赖树已排除漏洞。
同一份源码出两种宿主形态，差异只在 manifest：Chromium 系用 background.service_worker，
Gecko 系用 background.scripts（Gecko 会直接拒绝 MV3 的 service worker，那种宿主上 MV3 包的后台从不运行）。
出包（脚本都在 tools/，产物写进 dist/）：
python tools/build_packages.py # 一次产出 crx / chromium zip / mv2 xpi / mv2 常驻 xpi，并回读核验
python tools/stage_edge_unpacked.py # 生成桌面「加载解压缩的扩展」用的 dist/edge-unpacked
签名私钥不入库，默认取 build/minibm-signing.pem（可用 --key 或环境变量 MINIBM_PEM 指定）；
没有私钥时 crx 会跳过，zip 与 xpi 照常产出。
Mini-bookmark-sync/
├── manifest.json # 扩展配置
├── background.js # 后台（同步引擎）
├── popup.html / popup.js # 弹窗界面
├── options.html / options.js # 设置页面
├── adapters/ # 手机端桥接（Berry / Via / Aira）
├── core/ # 上传 / 下载 / 合并三条同步路径
├── lib/ model/ # 合并引擎、XBEL、删除记录
├── icons/ images/ # 扩展图标与界面图标
├── test/ # vitest 测试
├── tools/ # 出包与暂存脚本
└── docs/ # 仓库文档资源（README 截图等，不进安装包）
书签数据直连你自己的云盘、不经过第三方服务器，WebDAV 凭据只保存在本机浏览器里。 发现安全问题请用 GitHub 仓库「Security → Report a vulnerability」私下报告，不要在公开 Issue 里贴出可利用细节； 一般使用问题走 问题反馈。
本项目的原始版本由 jagshen 开发并开源：
极简书签同步的核心设计（单文件 WebDAV 直连、干净无广告的体验）都来自原项目， 本仓库只是在其基础上的维护分支。如果你觉得这个工具好用，欢迎去原项目点一个 ⭐。 原项目以 MIT 许可证开源，本分支沿用同一许可证，见 LICENSE。
MIT License