Voyager 时间轴Timeline实战指南把 Gemini 长对话变成一张可导航的地图【免费下载链接】voyagerEnhancement suite for Gemini, AI Studio, Claude ChatGPT — plus a prompt manager for any websites, DeepSeek Harness included. / 面向 Gemini、AI Studio、Claude 与 ChatGPT 的增强套件其中的提示词管理器可用于任意网站如 DeepSeek Harness。项目地址: https://gitcode.com/gh_mirrors/ge/voyager导读Voyager 的 Timeline时间轴是面向 Google Gemini 的可视化对话导航系统它将对话中的每一条消息映射为屏幕右侧的一个交互节点把冗长、难以下手的 AI 对话转化为可以瞬间跳转的对话地图。本文基于 docs/ar/guide/timeline.md 与仓库源码完整讲解 Timeline 的悬停预览、点击瞬移、上下文高亮、宽度调节、长按加星Stars与星标历史面板以及j/k、gg/GG等 Vim 风格键盘导航与自定义方法并深入到底层实现原理与适用场景。为什么要用时间轴长对话是灾难AI 对话一旦变长问题会迅速累积上下翻找慢、CmdF不实用、来回滚动中丢失上下文。Voyager Timeline 的解法是——看屏幕右侧或左侧那里就是对话的时间轴。每个节点代表一次对话轮次你的提问 Gemini™ 的回复一屏之内就能看清整段对话的节奏与脉搏。从源码结构看这套能力由 src/pages/content/timeline/ 目录下的一组模块共同承担职责划分非常清晰见 README.md模块职责TimelineTurns.ts识别对话轮次、生成稳定 ID、提取用户消息与回复摘要TimelineState.ts管理星标、层级、折叠等状态与持久化TimelineNavigation.ts节点点击/预览/快捷键导航、当前轮次高亮、滚动与取消TimelineView.ts时间轴轨道几何布局、虚拟节点渲染、拖动与宽度调节TimelinePreviewPanel.ts预览面板列表、搜索、固定与紧凑悬停桥接TimelineTooltip.ts悬停延迟、提示框内容布局与显隐TimelineMarkerInteractions.ts节点点击、长按与层级菜单TimelineTimestamps.ts时间戳可选启用与历史匹配manager.ts负责组合它监听 Gemini 的 DOM 变化并将实时滚动视口重新绑定到时间轴详见 manager.ts 与 TimelineNavigation.ts。核心交互从看一眼到瞬移原文档把时间轴的核心交互归纳为四点这里逐一展开悬停Hover把鼠标放到任意节点上无需点击、无需滚动即可看到该轮次讨论内容的即时预览。实现上悬停提示由TimelineTooltip.ts负责源码中对应悬停延迟 150ms、提示框内容布局与显隐逻辑预览面板则由TimelinePreviewPanel.ts承载。点击单击节点立即跳到对应消息实现瞬移式导航。上下文高亮滚动过程中与当前视口位置对应的节点会同步亮起active状态让你始终知道自己在地图的什么位置。调节宽度拖动时间轴内侧边缘即可改变其宽度适应不同屏幕与个人偏好。加星Stars给灵感钉一颗钉子长对话里藏着金子Voyager 用星标帮你把它们钉住。怎么用在时间轴任意节点上长按约 0.5 秒节点会亮起该消息即被加星。实现上TimelineMarkerInteractions.ts处理长按手势而星标状态由TimelineState.ts统一管理starred集合、跨会话持久化。再次长按可取消星标。已加星的节点会保持高亮一眼就能找到。点击时间轴顶部的星标图标可打开**星标历史Starred History**面板集中查看所有标记过的消息该面板由TimelinePreviewPanel.ts提供列表、搜索与固定能力。可以把加星想象成在对话中插旗——灵感迸发的瞬间、完美的回答、或者下次要从这里继续的位置。TimelineState.ts中星标数据与对话 ID绑定并通过 StarredMessagesService.ts 持久化。::: tip 小贴士 开启云同步后星标会跨设备同步仓库中 TimelineState.ts 也监听了chrome.storage.onChanged同一浏览器内跨标签页的星标变更同样会即时生效。 :::层级实验性让分支对话一目了然在时间轴节点上右键可以设置不同层级13 级或折叠子节点让深度分支的对话结构一目了然。从源码结构看这部分由TimelineState.ts中的markerLevels与collapsedMarkers状态、hierarchyStorage.ts 的层级存储与TimelineMarkerInteractions.ts的右键菜单共同实现属于实验性能力。键盘导航在 Gemini 里开启Vim Mode不想用鼠标时间轴内置了 Vim 风格键盘导航默认快捷键如下快捷键作用k跳到上一个节点j跳到下一个节点gg跳到第一轮GG跳到最后一轮自定义打开扩展设置点击快捷键输入框按下你想用的键即可任意键、任意组合都支持比如n/p、,/.。键盘快捷键的注册与解析由 KeyboardShortcutService.ts 负责并在 KeyboardShortcutService.test.ts 中有对应测试。两种响应模式流动模式Flow mode连续按键会排队播放动画滚动平滑不卡顿跳跃模式Jump mode立即响应速度拉满。从 TurnNavigator.ts 的实现细节可以印证点击/快捷键触发的导航会在目标轮次挂载mounted时精确滚动到节点中心若目标轮次因虚拟化virtualization被卸载则通过二分探测 定时微调的归航循环逐步逼近对应homePendingNavigation与PENDING_NAVIGATION_HOP_MS 200等常量确保任何位置都能到达。时间轴的两种形态点状与紧凑源码中TimelineView支持两种渲染风格TimelineStyle dots | compact定义见 common.ts点状dots每个轮次一个圆点悬停出现摘要提示框tooltip长按加星紧凑compact节点以固定间距的刻度tick呈现间距为 10px、轨道两端预留 16px 内边距当对话过长时自动压缩刻度间距此时提示框自动隐藏、轨道标记为aria-hidden交互主要通过预览面板完成。切换紧凑视图的引导coachmark由 timelineStyleCoachmark.ts 提供并且在 artifact 面板打开等场景下会主动让位yieldWhenSelector避免遮挡正在进行的操作。底层原理内容哈希、虚拟化与跨站点复用时间轴之所以能在 Gemini 的超长对话中稳定工作依赖三个关键设计内容哈希做稳定 ID每个轮次的消息摘要经过哈希得到稳定 IDc-hash无论 DOM 如何重排、刷新标记都不会丢失或错乱。这在 Claude/DeepSeek 等会虚拟化长对话的站点上尤其重要——节点标记按内容哈希累积grow-only跨刷新拼接到有序列表中。导航引擎可参数化复用TurnNavigator.ts 是时间轴轨道的通用引擎通过TurnNavigatorConfigturnSelector、conversationIdPattern、position: left | right、yieldWhenSelector等参数化可适配不同站点——这也是仓库中 Claude 时间轴等同类能力复用的基础。滚动目标自动探测默认通过向上遍历 DOM 寻找overflow-y: auto/scroll的滚动容器找不到则回退到window保证在 Gemini 的多层滚动布局中也能正确绑定视口。什么场景最适合用时间轴原文档给出了清晰的判断标准当对话超过 10 轮、手动滚动开始变得低效时时间轴价值最大。典型场景包括研究式长对话让 Gemini 分 30 轮探索某个主题用时间轴直接跳回关键洞见无需重读全文代码调试解决方案出现在第 47 轮加星之后一键找回循序渐进的学习/辅导用层级功能折叠已经掌握的部分头脑风暴回顾用星标圈出值得保留的最佳想法团队交接把加了星的对话分享给同事让对方直接跳到相关轮次。时间轴 vs 手动滚动能力无时间轴使用 Voyager Timeline找到特定消息反复上下滚动点击节点或按j/k标记关键时刻复制粘贴到外部笔记长按加星并可云同步查看对话结构顺序通读可视化地图一眼看清全貌键盘导航Gemini 原生不支持Vim 风格j/k、gg/GG完全可自定义浏览 100 条消息需要数分钟滚动任意位置瞬时跳转整理超长线程无内置工具层级1-3 级与折叠子节点兼容性与适用边界时间轴在Chrome、Edge、Firefox、Safari、Opera、Brave等浏览器的 Gemini 中均可用键盘快捷键、加星与层级在全部平台行为一致。开启云同步后星标可跨设备同步。Timeline 是 Gemini 专属功能不适用于 AI Studio——因为 AI Studio 中的对话通常更短收益有限。小结Voyager Timeline 把一堵纯文本的对话之墙变成一张结构化的知识地图悬停偷看、点击瞬移、滚动高亮、长按加星、右键分层、键盘疾行配合可自定义的宽度与快捷键让长对话真正找得着北。其底层以内容哈希保证节点稳定、以可参数化的导航引擎实现跨站点复用是一套既直观又扎实的对话导航方案。安装与更多设置项可参考 docs/ar/guide/getting-started.md 与 docs/ar/guide/settings.md。【免费下载链接】voyagerEnhancement suite for Gemini, AI Studio, Claude ChatGPT — plus a prompt manager for any websites, DeepSeek Harness included. / 面向 Gemini、AI Studio、Claude 与 ChatGPT 的增强套件其中的提示词管理器可用于任意网站如 DeepSeek Harness。项目地址: https://gitcode.com/gh_mirrors/ge/voyager创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考