第17-19章 实战篇

> 📖 《Gemini-Voyager 从入门到精通》系列连载

---

第17章 云同步深度配置

Google Drive 授权管理

┌─────────────────────────────────────────────────────────────────┐
│                    Google 授权管理                               │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│   授权流程:                                                     │
│   1. 点击「启用云同步」                                        │
│   2. 弹出 OAuth 授权窗口                                        │
│   3. 登录 Google 账户                                           │
│   4. 确认授权                                                  │
│                                                                 │
│   权限范围: 仅访问扩展创建的数据文件                           │
│                                                                 │
│   撤销: Google 账户 → 安全 → 第三方应用访问 → 管理 → 撤销    │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

同步策略

• 同步频率: 手动 / 自动 / 定时
• 冲突处理: 最后写入胜出 / 保留本地 / 保留云端
• 带宽控制: 仅 WiFi 同步

第18章 性能优化与故障排除

性能优化

1. 功能模块管理 - 禁用不使用的功能 2. 浏览器资源优化 - 关闭不用的标签页 3. 网络优化 - 稳定的网络连接

常见问题解决

安装问题

• 扩展安装失败 → 检查浏览器版本
• 图标不显示 → 重启浏览器

• 同步失败 → 检查网络、重新授权
• 数据不同步 → 手动同步、检查设置

• 导出失败 → 检查网络、分批导出

第19章 贡献与开发

开发环境搭建

# 克隆项目
git clone https://github.com/Nagi-ovo/gemini-voyager.git
cd gemini-voyager

# 安装依赖
bun install

# 开发
bun run dev:chrome
bun run dev:firefox
bun run dev:safari

构建命令

bun run build:chrome   # Chrome 版本
bun run build:firefox  # Firefox 版本
bun run build:safari   # Safari 版本
bun run build:all      # 所有平台

代码检查

bun run lint         # ESLint
bun run typecheck    # TypeScript
bun run test         # 测试

---

附录

附录A 配置参考

附录B 术语表

• Content Script - 内容脚本，运行在网页上下文中
• Popup - 弹出窗口
• Options - 选项页面
• Storage Service - 存储服务
• Manifest V3 - Chrome 扩展清单规范 V3

附录C 参考资源

• 项目仓库: github.com/Nagi-ovo/gemini-voyager
• 文档站点: voyager.nagi.fun
• 问题反馈: GitHub Issues

> ✅ 《Gemini-Voyager 从入门到精通》系列连载完结