配置指南
个性化您的 Bookmark UniSync 设置，优化同步体验
🚀 配置功能概述
配置功能让您可以根据个人需求调整扩展行为：
- 🔄 同步模式 - 在实时推送和手动同步之间选择
- ⚡ 实时推送 - 改动发生即推送到其他在线设备
- 🛠️ 开发者模式 - 查看详细的上传历史记录
📍 功能位置
- 点击浏览器右上角的 Bookmark UniSync 扩展图标
- 在主界面中找到 "配置" 选项
- 点击进入配置页面
📋 配置选项详解
🔄 同步模式设置
手动同步模式
| 特点 | 说明 | 适用场景 |
|---|---|---|
| 🎯 精确控制 | 只在需要时手动触发同步 | 网络不稳定或数据流量有限 |
| 💾 节省资源 | 减少不必要的网络请求 | 移动设备或低性能电脑 |
| 🔒 数据安全 | 避免意外同步 | 处理敏感书签数据时 |
实时推送模式
| 特点 | 说明 | 适用场景 |
|---|---|---|
| ⚡ 即时送达 | 一台设备上的书签改动会立即推送到其他设备 | 多设备频繁切换使用 |
| 🔄 无需手动干预 | 两端在线且已登录时，不需要任何额外操作 | 日常书签管理 |
| 📊 数据完整 | 每次改动都会记录为一个历史版本 | 重要书签数据保护 |
| 📡 长连接 | WebSocket 连接保持在线，断线后自动重连 | 确保多设备数据一致性 |
同步模式只有两种
Bookmark UniSync 只有手动同步和实时推送两种模式，没有定时同步。早年的"设置一个间隔、 到点自动从云端同步一次"已经取消，所以不存在倒计时，也不需要在后台按时间轮询。
哪种模式免费
手动同步免费。实时推送属于付费功能，带免费试用期，可以先体验"改动即同步"再决定。当前方案见价格页。
⚡ 实时推送是怎么工作的
🔄 推送机制
实时推送生效后，扩展会与服务端保持一条长连接：
- 📡 长连接 - 浏览器运行期间扩展保持连接
- ⚡ 服务端推送 - 一台设备上传改动后，服务端立即推送给其他在线设备
- 🔄 自动重连 - 网络中断后连接会自动恢复
- 📊 状态可见 - 界面显示同步状态和进度
⚠️ 设备不在线时会怎样
实时推送只能送达当前在线的设备。如果设备关机、断网，或者扩展没有运行，它就不在推送通道上：
| 状态 | 行为说明 | 用户操作 |
|---|---|---|
| 🟢 在线 | 改动发生时立即送达 | 无需操作 |
| 🔴 离线 / 浏览器已关闭 | 不会在后台拉取任何数据——没有定时同步 | 设备恢复后手动同步一次 |
| 🔄 重连中 | 连接会自动重新建立 | 等待；若迟迟不动就手动同步一次 |
| ❌ 推送失败 | 界面显示错误 | 检查网络或手动触发一次同步 |
实际使用中的含义
- 两端都在线：你完全不用碰同步按钮
- 设备关了一段时间：回来后点一次同步即可，没有任何机制替你自动补齐
- 网络较差：切换成手动同步，避免推送反复失败
🛠️ 开发者模式
功能说明
开发者模式主要用于调试和监控同步行为：
| 功能 | 作用 | 适用对象 |
|---|---|---|
| 📊 历史记录显示 - 显示详细的上传历史 | 开发者和高级用户 | 开发者和高级用户 |
| 🔍 上传状态监控 - 检查上传是否正常生效 | 故障排查 | 故障排查 |
| 📱 本地数据查看 - 查看本地上传记录（不发送到服务器） | 性能分析 | 性能分析 |
开发者模式中会记录的操作
以下操作会被记录（在开发者模式下可见）：
| 操作类型 | 触发条件 |
|---|---|
| 📝 修改书签 | 编辑标题、URL或描述 |
| 🔄 重命名书签 | 更改书签名称 |
| 📁 移动书签 | 调整书签位置或所属文件夹 |
| ➕ 新增书签 | 添加新书签或文件夹 |
| 🗑️ 删除书签 | 删除书签或文件夹 |
开启开发者模式
-
📍 进入配置页面
- 选择"配置"选项
-
🛠️ 启用开发者模式
- 找到"开发者模式"选项
- 勾选启用开关
-
📊 查看历史记录
- 返回主界面查看详细的上传历史
- 记录包含时间戳和操作类型
-
🔍 分析同步行为
- 检查上传是否正常触发
- 验证实时推送能否把改动送达其他在线设备
数据安全说明
开发者模式中的历史记录仅存储在本地，不会上传到服务器，主要用于调试目的。
🔄 配置切换指南
从实时推送切换到手动同步
- ⚙️ 进入配置页面
- 🔄 选择手动同步模式
- ✅ 确认设置
- 📤 手动同步测试 - 点击同步按钮验证功能
从手动同步切换到实时推送
- ⚙️ 进入配置页面
- 🔄 选择实时推送模式
- ✅ 保存设置
- 📊 验证实时推送 - 在一台设备上改动书签，确认另一台设备能看到
❓ 常见问题解答
| 问题 | 解决方案 |
|---|---|
| 🔄 改动没有出现在其他设备上 | 确认两端都在线、登录的是同一账号、扩展都在运行 |
| 📴 设备离线了一段时间 | 没有定时同步，需要在离线过的设备上手动同步一次 |
| 🛠️ 开发者模式无数据 | 执行书签操作（修改、移动等）触发记录 |
| 📱 多设备同步不一致 | 检查各设备的登录状态和同步模式 |
| 💾 手动同步按钮无响应 | 刷新页面或重启浏览器扩展 |
| 🔄 切换模式后数据丢失 | 模式切换不会影响已有数据，仅改变同步方式 |
| 📡 推送连接反复重连 | 检查网络稳定性；网络不可靠时切换成手动同步 |
🎉 配置最佳实践
📊 日常使用建议
- 🏠 家庭/办公网络：保持实时推送开启，改动发生即同步
- 📱 移动设备：使用手动同步，节省数据流量
- 🔄 多设备协作：保持两台设备在线且都已登录，改动会实时送达
- 🛠️ 故障排查：临时开启开发者模式查看详细记录
🔒 数据安全建议
- 📋 重要变更前：手动同步一次确保数据安全
- 🔄 网络不稳定时：切换到手动同步模式
- 💾 定期检查：开启开发者模式验证同步正常工作
- 📱 设备更换时：确认配置设置与原设备一致
🔗 相关链接
专业提示
合理配置同步设置可以显著提升使用体验。建议根据您的网络环境和使用习惯选择最适合的配置方案。