Voyager 五分钟上手：从安装到建立属于你的 Gemini 对话工作流

• AI 应用
• 前端

恭喜，你的工作流刚刚升舱。Voyager 不只是一款浏览器扩展，更是一套围绕 Gemini、AI Studio、Claude 与 ChatGPT 构建的工作流习惯——它用时间轴导航、文件夹归档、提示词库三大核心能力，把"和 AI 对话"从随机的碎片聊天，升级为可持续积累的数字资产。本指南以最快的路径带你走完配置、时间轴、组织与沉淀四个步骤，5 分钟内即可完成从安装到高效使用的全部转变。

1. 就位：安装并激活 Voyager

如果尚未安装，请先前往安装指南选择适合你的路径。官方支持三种安装方式：

• 商店安装（推荐）：Chrome / Edge / Brave / Opera / Vivaldi 通过 Chrome Web Store 安装，Firefox 通过 Firefox Add-ons 安装，更新自动完成；
• 手动安装（抢先体验）：从 Releases 下载voyager-chrome-vX.Y.Z.zip解压后，在chrome://extensions开启开发者模式并"加载已解压的扩展程序"；Firefox 用户则直接拖入voyager-firefox-vX.Y.Z.xpi（由 Mozilla 官方签名，可永久安装）；
• Safari（macOS）：下载预签名Voyager.app（.dmg），安装后在Safari 设置 > 扩展中启用。

安装完成后，刷新你的 Gemini 标签页——效果立竿见影。需要说明的是，Voyager 的提示词管理器是目前唯一支持 Gemini™ for Enterprise 的功能；时间轴与文件夹等特性则面向 Gemini 常规版本与 AI Studio。

想自行构建或参与开发？仓库根目录的 Voyager.xcodeproj（Safari 原生扩展工程）与 package.json（浏览器扩展构建脚本）展示了完整的工程组织方式。

2. 穿梭：时间轴——对话的导航图

开一场长对话吧。聊印刷术的历史，或者黑洞的物理。然后看向屏幕右侧——那一串点，就是你的导航图，它把漫长对话映射成一张可以瞬时跳转的地图，结束了无休止的滚动。

时间轴的核心交互只有三个动作：

• 悬停（Hover）：瞥一眼该消息点的内容，无需移动；
• 点击（Click）：瞬间传送（Teleport）到对应消息；
• 长按（约 0.5 秒）加星（Star）：给大脑打一个书签，高亮标记值得回味的时刻，之后可在时间轴头部的星标图标打开Starred History（已加星历史）面板集中查看。

在这张地图上，"思维有多快，你就走多快"。从源码结构看，时间轴加星的数据持久化由 src/features/savedLibrary/model.ts 统一管理：它以starred:${conversationId}:${turnId}作为稳定标识，将加星消息与高亮（highlight）归入同一套"已保存内容"模型，支持按all | starred | highlights过滤，并按保存时间排序——这解释了为什么星标能在不同对话间集中呈现。

更快：键盘即 Vim 模式

不想用鼠标？时间轴内置键盘导航，默认快捷键定义在 src/core/services/KeyboardShortcutService.ts（其中key: 'k'、key: 'j'对应上下节点跳转）：

所有快捷键均可自定义：打开扩展设置，点击快捷键输入框，按下任意按键或组合（n/p、,/.都可以）。键盘监听采用window.addEventListener('keydown', handler, { capture: true })捕获阶段挂载，避免与页面自身按键冲突。

进阶能力

• 层级（Levels，实验性）：右键节点可设置 1–3 级层级或折叠子节点，适合理清分支对话的结构；
• 宽度调节：拖动时间轴内边缘调整宽度；
• Flow / Jump 两种模式：Flow 模式让连续快速按键平滑排队，Jump 模式则即时响应、追求极限速度。

时间轴的价值在超过 10 轮的长对话中尤其突出：研究型会话（30+ 轮后跳回关键洞见）、代码调试（方案出现在第 47 轮，加星后一键找回）、分步学习、头脑风暴复盘与团队交接都是典型场景。它目前是 Gemini 专属特性（AI Studio 对话较短，未提供），在 Chrome、Edge、Firefox、Safari、Opera、Brave 上行为一致；启用云同步后，星标还能跨设备同步。

3. 归档：文件夹——给思绪一个文件系统

再看左侧的聊天列表，有什么新东西？文件夹来了。Voyager 为你混乱的聊天记录搭建了一个"思想的文件系统"：

• 拖拽归档：拎起一个聊天，拖进文件夹，松手——就这么自然；
• 嵌套层级：项目下有子项目，文件夹里可以再建文件夹，按你的方式组织；
• 重命名与图标：双击文件夹即可重命名；Voyager 会自动识别聊天类型（编码、创意等）并分配对应图标，无需手动操作；
• 批量移动：长按一条对话进入多选模式，即可一次选中并移动多个聊天；
• 间距调节：可调整文件夹的垂直密度，从紧凑到宽敞（注意：Mac Safari 上调整可能不是实时的，刷新页面即可生效）。

Gemini 专属增强

• 隐藏已归档对话：在扩展弹窗 → Folder Options 中开启后，主列表只显示活跃对话，实现 AI 聊天的 inbox-zero；首次归档时会弹出一次性提示卡片。已归档对话永远不会被删除，仍可在文件夹内完整访问；
• 自定义颜色：点击文件夹图标，从 7 种默认颜色中选择或用取色器自定义；
• 账户隔离：开启 Hard Isolation 后，文件夹与云同步数据按 Google 账户彻底分离（对应 src/core/services/AccountIsolationService.ts）；
• AI 自动整理：点击弹窗文件夹区底部的AI Organize复制当前对话结构 → 粘贴给 Gemini 生成 JSON 文件夹方案 → 在文件夹面板菜单选择Import folders → Or paste JSON directly粘贴导入。默认采用 Merge 增量合并策略，只新增不破坏既有组织，且提示词会跟随你配置的语言；
• 文件夹即项目：受 Claude Projects 启发但更轻量——在弹窗中启用Folder as Project，右键文件夹设置指令，新对话通过输入框旁的文件夹选择器选定后，首次发送自动归档；指令仅注入首次发送，同文件夹内的对话互不共享上下文。

4. 珍藏：提示词库——构建你的数字资产保险库

你刚刚写出了一条完美的提示词？别让它消失在对话流里。点输入框旁的✨ 图标（Prompt Manager），它就此进入你的保险库。核心流程三步走：

1. 捕获（Capture）：写得好，就点击输入框附近的 Prompt Manager 悬浮图标保存；
2. 分类（Categorize）：添加#coding、#email、#research等标签，保持工具锋利且有序；
3. 部署（Deploy）：下次需要时打开管理器，按标签或关键词搜索，点击插入即可。

效率细节

• 紧凑列表与舒适视图：搜索栏右侧的≡ / ▦按钮切换。紧凑列表每行一条、约同时可见 10 条；舒适视图展示完整 Markdown 预览；
• 名称必填：新建/编辑提示词时 Name 字段为必填项；旧的无名称提示词仍可用，但下次编辑时必须补齐；
• 快速悬浮预览：紧凑模式下悬停任意行约 250ms 即弹出内容提示，替代浏览器原生title提示（后者往往要 1–3 秒才出现）；
• 斜杠快速插入：在聊天输入框输入/加提示词名称片段，列表即显示匹配的名称与标签；悬停预览全文后，按Tab或Enter选中，编辑器会以高亮 token 显示所选名称并发送完整提示词正文。

不止于 Gemini

提示词管理器可以在任意指定网站使用：点击浏览器工具栏的 Voyager 图标 → 滚动到Prompt Manager区 → 输入网站 URL（如chatgpt.com、claude.ai、copilot.microsoft.com、poe.com）→ 点击Add website授权 →刷新目标页面后即可看到悬浮按钮。本地地址同样支持，例如 DeepSeek Harness 运行在localhost:3080，直接按相同方式添加即可接入。需要留意：在自定义网站上仅激活提示词管理器，时间轴、文件夹等 Gemini 专属功能不会加载。

5. 起飞：五分钟后继续深潜

到这里，安装、导航、归档与沉淀四步已经全部就位——你已经不是在"聊天"，而是在构建属于自己的数字资产。想要继续深入每个功能，可以参考以下指南：

• 时间轴进阶（Timeline）
• 文件夹管理（Folders）
• 提示词工程（Prompts）
• 数据导出（Export）
• 云同步（Cloud Sync）

与此同时，仓库本身也是理解这些特性的最佳教材：时间轴与文件夹的实现集中在 src/pages/content 下的功能页面中，核心服务见 src/core/services（键盘快捷键、存储、云同步等），提示词库模型见 src/features/savedLibrary，而 src/features/plugins/verbs/turnNavigator 则展示了轮次跳转在插件体系中的落地方式。打开你的 Gemini，刷新页面，然后起飞。

• AI 应用
• 前端