# 侧边栏 Gems 列表

Gemini 2026 改版把 Gems 折腾到了"设置 → Gems"再回到 sidebar 顶部，但它只是一个跳转入口，点一下就把你扔到 `/gems/view` 整页里。

Voyager 让 Gemini 原生的 Gems 入口"长出"一个最近用过的 gems 子列表，直接在侧边栏里点开就用。

## 它是怎么工作的

- **挂在原生 Gems 入口下方**：视觉上就像 Gemini 自带的 Gems 项展开了。同列缩进、同字号，不抢戏。
- **箭头按钮可折叠**：原生 Gems 入口右侧多出一个朝下的 `›` 箭头，点击切展开/收起。展开/收起状态会跨标签页同步、跨浏览器会话保留。
- **零网络开销**：列表数据来自你最近一次访问 `https://gemini.google.com/gems/view` 时本地缓存。不调任何 API、不轮询、不抓后台。

## 怎么用

1. 打开 Voyager 设置面板（浏览器右上角插件图标）。
2. 找到 **侧栏中显示的最近 Gems** 滑块。
3. 拖到你想显示的数量（1–10）。**0 即隐藏整段**——如果你不需要这个功能就关掉。

::: tip 首次启用
首次启用后如果你**没看见任何 gem**，那是因为本地缓存是空的。访问一次 `gemini.google.com/gems/view`，Voyager 会自动把你的 gems 列表缓存下来。之后回到任意 Gemini 页面就能看到了。
:::

## 数据何时更新

Voyager 只在你**主动访问 `/gems/view`** 时刷新缓存：

- 进入页面、重排、改名、新建、删除 gem——这些操作都会被实时同步到缓存。
- 不在 `/gems/view` 页面时不会做任何抓取。

也就是说：如果你在别的设备上新增了 gem，Voyager 不会"魔法地"知道。回到这台机器上访问一次 `/gems/view` 即可同步。

## 关于隐私

- 数据**只存在本地** (`chrome.storage.local`)，不上传任何服务器。
- 不读取也不缓存 gem 的对话内容——只是名字、描述、跳转链接和首字母。
- 关掉功能（数量调到 0），缓存也仍然留在本地，再开启时无需重新加载。

## 平台

仅支持 **Google Gemini**（`gemini.google.com`）。AI Studio 的 Gems 入口结构不同，不在适用范围内。