One-line description of what this script does.
### 项目简介(What this script does)
这是一个用于 **自动遍历 Gemini 聊天历史** 的浏览器用户脚本,主要面向需要**系统性回看、加载或触发历史对话内容**的用户。
脚本在 Gemini 页面中会执行以下操作:
* 自动向下滚动左侧聊天列表,直到所有可加载的历史对话都被展开
* **逐个打开每一条聊天记录**(排除 *Gems* 区域中的内容)
* 打开聊天后,自动将对话内容滚动到顶部
* 如果页面自动弹出了 canvas / artifact / side panel,则会自动关闭
* 在每个聊天中停留约 1 秒,确保内容完成加载后再进入下一条
整个过程模拟的是**正常的人类浏览行为**,不会跳过 UI 层、也不会直接请求内部接口。
---
### 它不会做的事情(Non-goals)
* 不收集、上传或共享任何个人数据(No tracking / No analytics)
* 不会读取或导出聊天内容
* 不会修改、删除或发送任何对话
* 不会绕过访问控制、权限校验或付费机制
* 不会自动执行可能造成不可逆后果的操作(如下单、发布、提交等)
---
### 权限说明(@grant)
脚本仅申请了实现功能所需的**最小权限集**:
* `GM_registerMenuCommand`
用于在脚本管理器菜单中提供「Start / Stop」入口,所有行为均由用户主动触发
* (如使用)`GM_addStyle`
仅用于注入极少量样式,不影响站点原有布局
脚本 **不包含远程代码加载**,所有逻辑均在本地运行。
---
### 使用方式(Usage)
1. 安装 Tampermonkey(Chrome / Edge)或 Violentmonkey(Firefox)
2. 打开 [https://gemini.google.com/](https://gemini.google.com/)
3. 确保左侧聊天栏已展开
4. 点击浏览器中的脚本管理器图标,选择 **Start Gemini Walker**
脚本运行过程中,你可以随时通过 **Stop Gemini Walker** 中断。
---
### 兼容性与稳定性说明
* Gemini 是高度动态的单页应用(SPA),页面结构可能会随官方更新发生变化
* 本脚本基于当前可见的 DOM 结构实现,如遇失效属于预期风险
* 当页面结构发生重大调整时,脚本可能需要更新才能继续工作
---
### 反馈与维护
如果你遇到脚本失效或异常行为,欢迎反馈 issue。
请尽量提供以下信息以便快速定位:
* 浏览器类型与版本
* 使用的脚本管理器(Tampermonkey / Violentmonkey)
* 简要的复现步骤或异常描述
本项目以 **可读性、可维护性和最小侵入性** 为设计原则,后续更新会尽量保持行为稳定、版本可控。