下载的是可直接加载的 Manifest V3 源码包。不需要 npm、不需要后端、不需要 API Key，也不需要先注册账号。
把 zip 解压到一个以后不会随手移动、也不会随手删掉的目录。浏览器会长期记住这个路径，路径一改名扩展就失效。
Gray Hole
chrome://extensions打开页面右上角的「开发者模式」开关。这一步必须开，否则看不到加载入口。
选中解压出来的 extension 目录——也就是直接包含 manifest.json 的那一层，不是最外层。
装完必须刷新网页。扩展在页面加载时注入，安装之前就已经打开的聊天页需要手动刷新一次，才会出现「加入 Gray Hole」浮条。
装好后点浏览器工具栏的拼图图标，把 Gray Hole 固定出来——平时用侧栏，整理时从侧栏顶部进宽屏收藏库。
在 ChatGPT、DeepSeek 或者任意网页上，选中一段你想留住的文字。
浮条出现后点主按钮，一次点击进收件箱。浮条上的 ⌄ 可以直接选收藏夹。
不打断阅读，先都丢进收件箱。攒够了再一起整理，比存一条理一条快得多。
打开收藏库，用「整理收件箱」逐条归到主题。也可以直接搜索、筛选、批量处理。
| 操作 | 方式 |
|---|---|
| 收藏选中的文字 | 右键选文 →「加入 Gray Hole：选中文字」 |
| 收藏一张图片 | 右键图片 →「加入 Gray Hole：这张图片」 |
| 收藏当前选区 | Alt + Shift + S |
| 打开侧栏 | Alt + Shift + T |
| 打开收藏库 | 右键工具栏图标 →「打开 Gray Hole 收藏库」 |
| 聚焦搜索框 | / |
| 关闭详情 / 菜单 | Esc |
快捷键被系统或其他扩展占用时，到 chrome://extensions/shortcuts 重新指定。
不要用「卸载 → 重新安装」的方式更新。卸载有可能连着本地收藏一起清掉。
正确做法：下载新版 zip，覆盖解压目录里的文件，回到 chrome://extensions 点一下 Gray Hole 卡片上的刷新按钮，然后刷新网页。
更新之前，顺手在收藏库里导出一份 JSON 备份。移动加载目录、切换浏览器配置之前也一样。
图标没跟着换的话，重启一次浏览器——Chrome 会缓存扩展图标。
先刷新页面。扩展只在页面加载时注入，安装前就开着的标签页收不到。刷新还不行，检查 chrome://extensions 里 Gray Hole 是不是被停用了，以及这个页面是不是 chrome:// 开头的浏览器内部页面——内部页面不允许扩展注入。
目录选错了。要选的是包含 manifest.json 的 extension 目录，不是解压出来的最外层目录。
图片服务器不允许跨域读取，或者链接已经过期。Gray Hole 会先尝试取原文件（不带你的登录 Cookie），失败再取浏览器允许读到的页面显示副本；都拿不到时会明确标成「仅链接」或「未备份」，不会假装存好了。需要图片本体的话，回原网页重试一次。
在旧机器的收藏库里导出 JSON（只有 JSON 导出是完整备份，包含回收站记录和本地图片），在新机器上导入。或者注册一个账号，用云同步在多台设备之间对齐——云同步是可选项，不开也能正常用。
当前是正式发布前的阶段。上架流程需要处理开发者账号与审核，还没走完——所以现在先用这种直接加载源码包的方式分发。功能上没有任何删减。
不行。Gray Hole 不是开源项目，源码随包提供是为了让你能自己核实它的行为，不等于授权再分发。自己改着用没问题；把修改版发出去、拿去做付费服务，或者以任何形式公开分发，都需要事先取得书面许可。完整约定见 服务条款 第三节，包内也附了 LICENSE。
账号与云同步的数据库在美国西部（俄勒冈）。也就是说启用云同步会把邮箱和摘录镜像传到美国的服务器。如果你不想让数据出境，不要注册账号——不注册时全部功能都在你本机完成。详见 隐私政策 第二节。