把 Gemini 从浏览器标签页里放出来。
一套 Electron，两个形态：完整 Gemini 客户端 + 随叫随到的桌面悬浮助手。
Gemini Float 是一个 Windows 优先、macOS 风格的非官方 Gemini 桌面客户端。它不会再逼你完成那套经典动作：切浏览器 → 找标签页 → 发现开了 47 个标签页 → 忘记自己要问什么。
点击屏幕边缘的 Gemini 悬浮球，就能直接提问、截图、语音输入、切换模型；需要完整体验时，再一键打开沙箱隔离的 Gemini 页面。
Gemini 在你的屏幕边缘租了一套 46px 的小房子。平时很安静，叫它才出来。
| 能力 | 它做了什么 |
|---|---|
| ✦ 桌面悬浮球 | 贴边停靠、固定位置、不乱跑；悬停时有高质量多色流动动画 |
| 💬 快捷提问 | 回答直接流式显示在本地聊天框，不再出现“Gemini 说”式套娃 |
| 🧠 思考状态 | 显示 Gemini 页面公开提供的思考摘要，默认折叠，需要时再展开 |
| ✂️ 截图与标注 | 整屏进入框选，可移动、八向缩放、画笔、圆圈、方框、文字、撤销、复制、保存和发送 |
| 🪄 模型切换 | 从当前 Gemini 账号读取可用模型，在悬浮菜单里直接切换 |
| 🖥️ 完整客户端 | 保留完整 Gemini 网页能力，同时与本地权限严格隔离 |
| 🔒 本地优先 | 不需要额外 API Key；登录会话、截图和设置保留在本机 Electron 用户目录 |
 功能菜单：别急，事情一件一件来。 |
 快捷提问：聊天框就是答案的最终落点。 |
- Windows 10/11（当前主要测试平台）
- Node.js 22+
- npm 10+
- 可正常访问并登录 Gemini
git clone https://github.com/ZhiYiTree/gemini-desktop-assistant.git
cd gemini-desktop-assistant
npm install
npm run check
npm start首次打开完整 Gemini 客户端时完成登录。之后悬浮助手会复用同一份本地会话，不需要 API Key，也不用把 Key 塞进某个神秘的 .env 然后祈祷自己没有提交它。
| 快捷键 | 动作 |
|---|---|
Ctrl / Cmd + Shift + G |
呼出快捷提问 |
Ctrl / Cmd + Shift + A |
进入截图提问 |
Esc |
关闭当前最上层界面 |
截图时 Ctrl / Cmd + Z |
撤销标注 |
截图时 Ctrl / Cmd + C |
复制截图 |
截图时 Ctrl / Cmd + S |
保存截图 |
应用按以下优先级选择代理：
- 当前进程的
HTTPS_PROXY - 当前进程的
HTTP_PROXY - 本地默认代理
http://127.0.0.1:7892
例如：
$env:HTTPS_PROXY = 'http://127.0.0.1:7892'
npm start它只影响当前应用进程，不会偷偷改 Windows 全局代理。我们写的是桌面助手，不是网络设置拆迁队。
flowchart LR
U["本地悬浮界面"] -->|"受限 IPC"| M["Electron 主进程"]
M --> C["截图 / 剪贴板 / 快捷键"]
M --> G["Gemini 页面会话"]
G -->|"公开回答与思考摘要"| M
M -->|"流式更新"| U
G --- S["sandbox: true<br/>Node: off<br/>无 preload"]
远程 Gemini 页面运行在独立的持久化 partition 中，并启用 sandbox、关闭 Node.js、不给 preload，也不能直接接触本地截图与 IPC。所有本地能力都由受控的主进程服务提供。
这是一个可以实际运行的桌面 Demo，也是一份仍在快速生长的工程。Gemini 网页 DOM 更新可能让模型读取或回答抓取短暂失效——Google 偶尔移动一个按钮，我们就要像考古队一样重新找到它。
接下来想做：
- Windows 安装包与自动更新
- macOS 原生打包与签名
- 更稳健的 Gemini DOM 适配层
- 多语言界面
- 可选的本地历史记录
Bug、想法和 PR 都欢迎。开始之前请看 CONTRIBUTING.md；安全问题请按 SECURITY.md 私下报告。
如果它让你少开了一个浏览器标签页，可以点个 Star。不是为了虚荣——是为了让这颗小星星知道自己没有白闪。✦
本项目为非官方开源客户端，与 Google 无隶属、授权或背书关系。Gemini、Google 及相关标识是其各自权利人的商标。使用前请确认你所在地区适用的 Gemini 服务条款。
MIT © 2026 ZhiYiTree