🎉 arXiv Affiliation Highlighter (Debug & Progress & Stop Button)

作者： Zezhou Wang (zzw.cs@smail.nju.edu.cn)
版本： v1.4
说明： 在任意网页上自动识别并标注 arXiv 论文链接的作者机构，带缓存、日志面板、进度提示、停止按钮及 API Key 弹窗。（Dev 版本请前往https://github.com/LEON-gittech/arXiv-Affiliation-Highlighter.git查看并进行调试。）

---

🚀 功能亮点

• 🕵️‍♂️ 智能识别：扫描所有 arxiv.org/abs/ 与 arxiv.org/pdf/ 链接，自动下载并解析 PDF 第 1 页
• 🏷️ 标注机构：调用 OpenAI GPT 模型，按行提取、去重机构列表，显示在链接旁
• 💾 本地缓存：所有解析结果保留 365 天，避免重复请求
• 📝 调试面板：页面右下角实时打印详细日志与脚本进度
• 🛑 手动停止：一键点击 “Stop Script” 按钮即可立即终止脚本执行
• 🔑 弹窗输入 API Key：首次运行时弹出提示框，让你安全输入并存储 OpenAI API Key，告别硬编码

---

📦 安装步骤

1. 安装 Tampermonkey
   • 在 Chrome/Firefox/Edge 扩展市场搜索 “Tampermonkey” 并安装。
2. 安装脚本
   • 打开 Tampermonkey 仪表盘，切换到 “脚本市场” 选项卡（或“导入”旁边）。
   • 搜索 “arXiv Affiliation Highlighter”，点击 安装。
3. 授权域名与权限
   • 脚本已声明对 arxiv.org 与 api.openai.com 的跨域请求权限，无需额外配置。
4. 首次运行
   • 打开任意包含 arXiv 链接的页面，第一次会弹出输入框提示填写 OpenAI API Key。
   • 输入后脚本会自动缓存，后续页面将无需重复输入。

---

📖 使用说明

1. 页面加载
   • 脚本会立即扫描所有 arXiv 链接并开始串行处理
2. 查看日志
   • 右下角半透明黑底面板会显示：
     • 🔍 当前链接序号 / 总数
     • 📥 PDF 下载成功、字节数
     • 📝 文本长度
     • ✅ 解析完成或缓存命中
     • ❌ 错误原因
3. 停止脚本
   • 点击日志面板上方的 Stop Script 按钮，脚本将立即中止
4. 清理缓存
   • 在 Tampermonkey 菜单内（右上角扩展图标）选择 “🗑 清空 arXiv 机构缓存”

---

⚙️ 脚本结构

┌─────────────────────────────────────────┐
│ ==UserScript==                         │
│ @name   Affiliation Highlighter        │
│ @author Zezhou Wang                   │
│ …                                      │
└─────────────────────────────────────────┘
  ↓
1. API Key 读取与弹窗  
2. 配置：模型、缓存键、TTL  
3. 初始化 PDF.js worker & 全局状态  
4. 创建“Stop Script”按钮 & 调试面板  
5. 注册“清空缓存”命令  
6. 串行扫描并处理 arXiv 链接：  
   └─ fetchTitle → fetchAndAnnotate → annotate  
7. 辅助：gmFetchText/gmFetchPdf/parseTitle/gmOpenAIExtractAffs

---

🤔 常见问题

• Q：提示“脚本停止”是哪里出错？
  A：请打开浏览器控制台（F12）查看更详细的错误日志，或点击右下面板最后一条红色 ❌ 日志。
• Q：如何更换 GPT 模型？
  A：在脚本 const MODEL = 'gpt-4o-mini'; 修改为 gpt-3.5-turbo 或 gpt-4 即可。
• Q：缓存时间想改短？
  A：调整 CACHE_TTL 值（单位毫秒），例如一天则设为 1000*60*60*24

---

📬 反馈 & 贡献

欢迎提 Issue 或 PR，让这个工具更加强大、有趣！