《Gemini-Voyager 从入门到精通》(6) - 核心概念

# 第4章 核心概念 > 📖 《Gemini-Voyager 从入门到精通》系列连载 --- ## 4.1 内容脚本（Content Scripts）机制 内容脚本是浏览器扩展与网页交互的核心技术。Gemini-Voyager 的大部分功能都是通过内容脚本实现的。 ### 浏览器扩展架构 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 浏览器扩展架构 │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 后台脚本 (Background) │ │ │ │ • 处理浏览器事件 │ │ │ │ • 管理扩展状态 │ │ │ │ • 与内容脚本通信 │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 目标网页 (gemini.google.com) │ │ │ │ ┌───────────────────────────────────────────────────┐ │ │ │ │ │ 内容脚本 (Content Scripts) │ │ │ │ │ │ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │ │ │ │ │ │ │ folder │ │ export │ │timeline│ │ ... │ │ │ │ │ │ │ └────────┘ └────────┘ └────────┘ └────────┘ │ │ │ │ │ └───────────────────────────────────────────────────┘ │ │ │ │ ┌───────────────────────────────────────────────────┐ │ │ │ │ │ 页面 DOM │ │ │ │ │ └───────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ 弹出窗口 / 选项页面 (Popup/Options) │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` ### 工作原理 1. **静态声明** - 在 manifest.json 中配置匹配的 URL 和要注入的脚本 2. **自动加载** - 用户访问匹配页面时自动执行 3. **DOM 操作** - 通过操作页面 DOM 与 Gemini 界面交互 > 📝 Gemini-Voyager 包含 22 个独立的内容脚本模块，每个模块负责一个特定功能。 --- ## 4.2 存储服务架构 存储服务是 Gemini-Voyager 的数据中枢，负责管理所有用户数据的持久化存储。 ### 存储类型 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 存储服务架构 │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ ┌──────────────────┐ │ │ │ StorageService │ │ │ │ (统一入口) │ │ │ └────────┬─────────┘ │ │ │ │ │ ┌────────────────┼────────────────┐ │ │ ▼ ▼ ▼ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ chrome. │ │ chrome. │ │ chrome. │ │ │ │ storage. │ │ storage. │ │ storage. │ │ │ │ sync │ │ local │ │ session │ │ │ ├──────────────┤ ├──────────────┤ ├──────────────┤ │ │ │ • 跨设备同步 │ │ • 本地大容量 │ │ • 会话临时 │ │ │ │ • 容量: 100KB │ │ • 容量: 10MB │ │ • 页面关闭 │ │ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` **三种存储区域：** - **sync** - 自动同步到 Google 账户，容量 ~100KB - **local** - 本地存储，容量 ~10MB - **session** - 会话期间有效，关闭后清除 --- ## 4.3 云同步基础 云同步功能允许用户将数据同步到 Google Drive，实现跨设备数据共享。 ### 同步流程 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 云同步流程 │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ 用户操作 → 本地数据变更 → 同步服务 → OAuth 认证 │ │ ↑ │ │ │ │ ▼ │ │ 同步完成 Google Drive │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` **核心特性：** - OAuth 2.0 认证 - 增量同步（只传输变化数据） - 冲突处理（最后写入胜出） - 支持文件夹、提示词、收藏消息同步 --- > ⏳ 下一章将介绍文件夹管理系统