VOXCAT: ChatGPT 提示词链与图片 Eagle 归档插件

📌 工具简介

对于 AI 视觉创作者而言，在 ChatGPT 中生图最痛苦的往往是：“图存下来了，但不知道当时是用哪句 Prompt 甚至哪次修改迭代出来的”。

VOXCAT Exporter 并不是简单的图片下载脚本，它的核心价值是：完整记录“这张图是怎么一步一步生成出来的”全流程。系统化解析用户提示词、修改演变、生成图与参考图的因果关系，并一键无损同步到 Eagle 素材库或打包为本地结构化归档。

---

✨ 核心功能与亮点

1. 独创 Prompt Parser v2（因果关系优先绑定）

   • 绝对因果绑定：严格以 AI 实际生图为锚点逆向追溯用户指令，绝不误判闲聊（如“背景不对”、“增加prompt功能”等词汇不会被当成生图提示词）。
   • 防后向污染（时间单向冻结）：后发的 Prompt B 绝不会倒灌污染在此之前生成的 Image A。
   • 修改链累积（Creative Chain）：自动识别母版【Base Prompt】与后续的【Revision】（如“人物不变换成夜景”），生成图可完整继承所有前置演变。

2. 三元图片类型分类

   • 自动甄别 Generated（全新生成）、Edited（垫图/修改结果）与 Reference（用户上传的参考图/截图）。
   • 默认仅保存 AI 产出，避免素材库被用户自己的截图塞满；亦支持一键开启同时归档参考图。

3. Eagle 深度工业级集成

   • 直连本机 Eagle 客户端 API（localhost:41595）。
   • 自动注入结构化元数据：来源网址、多维标签（ChatGPT、Generated、Edited、Project:xxx）。
   • 富文本注释：在 Eagle 注释栏排版写入完整的 Base Prompt、各步 Revision 及引用的参考图信息。
   • 分批推送（Chunk=20）与防卡死保护，大量图片导入依然流畅。

4. 增量去重账本（Sync Ledger）

   • 本地与 Eagle 独立维护同步历史；
   • 只导出新增（推荐）：通过会话 ID + 消息 ID + 资产 ID 复合键，精准识别并跳过已同步的图片，避免重复入库；
   • 严格去重：支持基于图片字节的 SHA-256 指纹去重。

5. 三大入口与防风控限速

   • 支持当前对话、已打开多标签页以及近 30 天近期对话批量扫描导出。
   • 零自动嗅探：所有搜索均需手动点击确认，绝不在后台静默发包。
   • 具备请求限速（标准/慢速）、HTTP 429 智能退避与断点续传机制。

---

🛠️ 安装与使用指南

1. 下载/克隆代码： 从 GitHub 仓库下载 ZIP 源码包或运行： git clone https://github.com/TideKnight/voxcat-chatgpt-prompt-eagle-exporter.git
2. 在 Chrome 中加载：
   • 打开 Chrome 浏览器，访问 chrome://extensions/；
   • 开启右上角 “开发者模式”；
   • 点击左上角 “加载已解压的扩展程序”，选择解压后的项目文件夹即可。
3. 日常使用：
   • 确保本地 Eagle 已打开；
   • 在任一 ChatGPT 生图对话页，点击插件图标 -> 点击 【搜索当前对话】 -> 核对识别结果 -> 点击 【发送到 Eagle】。

---

⚠️ 能力边界与说明

• 接口说明：完整模式依赖 ChatGPT 网页内部会话数据，若官方界面重大改版可能需同步更新（插件内置了快速 DOM 模式作为永久保底）；
• 图片库范围：本版本（v0.4.2-beta1）专门归档会话链路中的图片，暂未接入 chatgpt.com/images/ 全局历史漏图的主动抓取；
• 纯本地隐私：代码 100% 运行于本地浏览器，无任何外部云端服务器收集用户隐私或图片。