如何安装 BirdSafe？
本指南用于帮助你在 5 分钟内完成安装、认证和首次同步配置。若你用于团队协作，请同步阅读隐私政策、服务条款与安全审计说明。
开始前准备
请先确认你的浏览器版本与账号状态满足以下条件，这会显著减少首次同步失败率。
- Chrome 或基于 Chromium 的浏览器，建议使用近 3 个稳定版本。
- 可正常访问 Twitter/X 并保持登录态。
- 首次同步阶段请保持页面与网络稳定，避免中途关闭浏览器。
01
02
步骤 2：账户认证
安装后点击浏览器工具栏中的 BirdSafe 图标，完成账号认证。认证成功后，系统会初始化本地数据库和权限策略，默认不上传正文数据。
03
步骤 3：首次同步
登录成功后，BirdSafe 会执行握手并激活同步引擎。状态变为可用后，你可以开始书签或喜欢内容的增量/全量同步。
功能使用指南
增量同步 vs 全量同步：日常推荐增量同步，仅处理新增和变更内容；当你长期未同步或需要补齐历史数据时，再执行全量扫描。
搜索与筛选：你可以按关键词、作者、时间维度快速定位内容。建议先用关键词缩小范围，再按时间排序做二次筛查。
视图切换：画廊模式适合图片与灵感回顾，多维视图适合整理与批量处理；两者共用同一份本地数据。
Notion 同步：同步用于把数据发送到 Notion 侧查看和协作。请注意它不是本地恢复通道，不能从 Notion 反向写回本地。
导出与迁移指南
导出格式说明：JSON 适合开发处理与长期归档，CSV/Excel 适合表格分析和团队协作。
Free 用户迁移：可通过导出/导入完成迁移，也可在新设备登录后按安全策略重新抓取历史推文。
Pro 用户迁移：登录后可通过云端同步自动写回本地，无需重新从平台抓取。
媒体能力说明：专业版支持本地原图与视频镜像；云端同步目前同步文本与原图，不包含 4K 视频内容。
设置与个性化
- 主题模式：支持深色模式切换，适配长时间阅读场景。
- 同步策略：根据使用习惯选择增量优先或周期性全量补齐。
- 媒体策略：按容量与网络环境选择是否启用更积极的媒体镜像。
- Notion 映射：按你的数据库字段结构配置同步字段，确保后续检索一致。
常见问题与排查
- 看不到同步按钮：刷新扩展页面并确认已完成登录；如仍不可见，检查浏览器扩展权限和站点访问授权。
- 同步速度异常慢：并发由后台智能调度，建议优先进行增量同步并保持网络稳定；中断后可从上次位点继续。
- 更换设备后数据如何恢复：Free 用户可导入导出或重新抓取；Pro 用户可通过云端同步自动写回本地。
- Notion 能否作为备份恢复：不能。Notion 用于查看和协作，不是本地恢复通道。
- 误删插件怎么办：卸载插件可能清除本地数据库，建议定期导出备份或启用 Pro 云端同步能力。