《Gemini-Voyager 从入门到精通》(13) - 核心服务层

# 第14章 核心服务层 > 📖 《Gemini-Voyager 从入门到精通》系列连载 --- ## 14.1 StorageService（存储服务） 存储服务是数据中枢，遵循「单一数据源」原则。 ### 架构 ``` ┌─────────────────────────────────────────────────────────────────┐ │ StorageService 架构 │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ StorageService │ │ │ │ • get<T>(key): Promise<Result<T>> │ │ │ │ • set<T>(key, value): Promise<Result<void>> │ │ │ │ • remove(key): Promise<Result<void>> │ │ │ │ • clear(): Promise<Result<void>> │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ │ ┌───────────────────┼───────────────────┐ │ │ ▼ ▼ ▼ │ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │ │ Sync │ │ Local │ │ Session │ │ │ │ Storage │ │ Storage │ │ Storage │ │ │ └───────────┘ └───────────┘ └───────────┘ │ │ │ │ 附加功能: │ │ • 错误处理 (扩展上下文失效处理) │ │ • 数据迁移 (版本检测与转换) │ │ • 日志记录 (操作审计) │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## 14.2 GoogleDriveSyncService（云同步） 云同步服务使用 OAuth 2.0 + Google Drive API。 ### 数据组织 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 云同步服务数据流 │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ GoogleDriveSyncService │ │ │ │ │ │ │ │ │ ▼ ▼ ▼ │ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │ │ Folders │ │ Prompts │ │ Starred │ │ │ │ .json │ │ .json │ │ .json │ │ │ └───────────┘ └───────────┘ └───────────┘ │ │ │ │ │ │ │ └───────────────┴───────────────┘ │ │ ▼ │ │ Google Drive: /My Drive/Gemini Voyager Data/ │ │ │ │ 同步策略: │ │ • 增量同步 (只传输变化数据) │ │ • 冲突处理 (最后写入胜出) │ │ • 自动重试 (指数退避) │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## 14.3 DataBackupService（备份服务） 多层数据保护机制。 ### 备份模式 - **手动备份** - 用户主动触发 - **自动备份** - 变更检测触发 - **定时备份** - 定期执行 --- ## 14.4 KeyboardShortcutService（快捷键） 全局键盘快捷键管理。 - 标准格式: "Ctrl+Shift+F" - 冲突检测 - 作用域管理 --- > ⏳ 下一章将介绍特性模块设计