PaperPilot 0.7.0

PaperPilot 0.7.0

本版重点是标得更准、标得更全：长论文的方法和实验不再被截掉，引用匹配能容忍 PDF 排版差异和模型的个别改词，每个类别可以标出更多原文。增强批注 PDF 不再需要 Python。

安装

1. 从本 Release 下载 paperpilot-0.7.0.xpi。
2. Zotero → 工具 → 插件/附加组件 → 齿轮 → Install Add-on From File，选择 XPI 后重启。
3. 设置 → PaperPilot → 点“获取密钥”，在 CCG API 控制台创建令牌并粘贴，点“测试连接”。端点和模型已预设。

0.6.x 需要手动安装这一次；从 0.7.0 起，Zotero 可以通过本仓库 Release 中的 updates.json 自动更新。

改进

• 默认接入 CCG API 中转站：端点默认为 https://ccg-cli.online/v1/chat/completions，模型默认 gpt-6.1-sol，设置页提供推荐模型下拉框：性价比 gpt-6-luna、中文撰写 qwen3.8-flash、最高强度 claude-opus-5.5，学生只需填密钥。设置页新增“获取密钥”（打开控制台）、“获取可用模型”（按当前密钥列出可选模型）和“恢复默认”。旧版中从未填过密钥、仍是 OpenAI 默认值的配置会自动切到中转站；已经配置了密钥的不受影响。仍可填写其他 OpenAI 兼容接口。
• 长论文按章节压缩：超出字数上限时，先略去参考文献、致谢和附录，再按章节重要性分配字数（摘要、方法、实验、局限、结论优先），每节保留开头。旧版只保留全文开头 60% 和结尾 40%，中间的方法和实验经常被整段丢掉。识别不到章节结构时仍退回首尾截断。
• 默认上限提高：正文上限默认从 3 万字符提高到 10 万，超时默认从 60 秒提高到 600 秒（实测 3 万 token 左右的论文，部分模型需要 2–3 分钟）。仍是旧默认值的设置会自动升级，手动改过的值保留。
• 引用匹配更稳：校验和坐标定位共用同一套规范化规则，忽略行末连字符断词、连字（fi/fl）、弯引号与直引号、空白和大小写差异。模型改了个别字词时，相似度 ≥ 90% 的引用会被替换为原文片段并标注“已按原文校正”；低于阈值或跨页的引用仍然跳过，不强行标注。
• 📍 跳转改用逐字坐标定位：与高亮使用同一套定位，直接滚动到原句所在的行。旧版把整句（最多 160 字）交给阅读器搜索，遇到换行断词、公式符号、跨页句子时常常搜不到。坐标定位失败时，才退回跳页并搜索原句开头的一小段。
• 坐标定位更宽容：已知页码时，允许页内小差异的模糊匹配（例如公式下标顺序不同）；同一页出现两次的句子取第一处；跨页的句子高亮其中一页上的部分，不再整条跳过。校正后的引用会还原换行断词（“meth- od”→“method”）。
• 关注点条数可自动判断（新默认）：按发送正文的长度给模型一个范围（短论文 3–5 条、中等 5–8 条、长论文 7–12 条），由模型按贡献点和实验数量决定。实测 15 页论文给出 8 条，26 页和 100 页论文各 9 条。仍是旧默认值 6 的设置会改为自动。
• 每个类别可标更多原文：研究问题、方法、结果、局限各可附 0–2 条补充证据，同样经过原文校验、按类别颜色高亮，并显示在面板、导读索引、导读笔记和 Markdown 中。
• 增强批注 PDF 不再需要 Python：改为在插件内部用 pdf-lib 写入高亮、下划线、中文批注、阅读指引、书签和导图附页。设置中的 Python 路径已移除。原 PDF、原书签、旋转和裁切框都保留。
• 自动更新：update_url 指向 GitHub 最新 Release 的 updates.json，打包时自动生成并校验。

修复

• 缓存键加入模型、输出语言和提示词版本：切换模型或语言后会重新分析，不再返回旧结果。
• 首次返回非 JSON 时，重试请求有独立的完整超时，不再继承第一次已经消耗的时间。
• 支持 response_format: json_object 的服务会直接返回 JSON；不支持的服务明确拒绝该参数时自动去掉参数重发，并在本次运行中记住。其他 400 错误（如上游内容审核）不重发，避免重复扣费。
• PDF 文字层中错误映射的字形会变成控制字符（如 LoRA 论文中的“≪”变成 \x1c），模型逐字照抄后导致 JSON 解析失败。现在提取文字和解析 JSON 时都会清除。
• 任务说明改放在 user 消息中，并去掉角色设定：实测部分中转渠道会忽略或替换 system 消息。
• 改用流式输出：中转链路在 90 秒没有数据时会断开连接，推理模型（如 gpt-6.1-sol）分析整篇论文时必然超过这个时长。流式输出让连接持续有数据，面板同时显示“正在接收模型输出（N 字）”。
• 常见错误附带说明：内容审核拒绝、密钥无效、余额不足、分组无该模型、上游不可用。
• 某一页读不到文字坐标（如插图页）时，不再导致整篇所有引用都定位失败。
• 关注点条数的兜底值与默认设置统一为 6（旧代码中一处兜底为 3）。

验证

• npm run release：8 个测试阶段全部通过（56 项纯函数、14 项集成冒烟、24 项导图/笔记、51 项修复回归、8 项 PDF 写入，以及回归脚本），XPI 打包与 updates.json 校验通过。

• 导出的 PDF 已用 PDF.js（Zotero 阅读器使用的引擎）解析验证：高亮/下划线的中文批注、颜色、外观流、原书签与新书签、导图附页均可正确读取。

• 2026-10-11 通过 CCG API 中转站，用三篇 arXiv 论文跑了真实分析流程（文字提取 → 按章节压缩 → 模型 → 原文校验 → 逐页定位），流式输出：

  模型	Transformer（15 页）	LoRA（26 页）	GPT-4 技术报告（100 页，压缩到 10 万字符）
  gpt-6.1-sol（默认）	15/17，118 秒	16/17，126 秒	16/17，125 秒
  gpt-6-luna（性价比）	16/16，41 秒	13/14，17 秒	13/14，20 秒
  qwen3.8-flash（中文撰写）	16/16，127 秒	16/16，190 秒	上游内容审核拦截
  claude-opus-5.5（最高强度）	17/17，49 秒	18/18，56 秒	17/17，64 秒

  数字为“通过原文校验的引用 / 引用总数”；通过校验的引用均能唯一确定页码。gpt-6-luna 的 LoRA、GPT-4 报告两项及 claude-opus-5.5 的后两项来自非流式测试，结果不受影响。非流式时 gpt-6.1-sol 在 91 秒处被中转链路断开（504），改为流式后正常。GPT-4 技术报告含红队测试的有害示例，被 qwen 上游的内容审核拦截。

• 桌面端：测试版 rc1 已在 Zotero 中试用，反馈的引用跳转问题在 rc2（即本版）中修复；rc2 的跳转改动以自动化测试和真实论文的定位测试为准。其他 Zotero 版本请按 README 第 9 节清单自行验收。

依赖：esbuild 0.28.2、TypeScript 7.0.2、pdf-lib 1.17.1。

已知限制

尚未实现段落自动分框、关键词级下划线、中英译文语义对齐、扫描件 OCR。章节识别依赖常见标题写法。导图来自 AI 总结，未展示补充证据。index.js 因打包 pdf-lib 增大到约 930 KB（XPI 约 245 KB）。

XPI SHA256：81c6870bbcc7936f4b9522e92999921d2553cbe444c43ae277dacc578dcab20c。

PaperPilot 0.6.1

PaperPilot 0.6.1

选中论文，在 PaperPilot 面板生成总结后点击 导出增强批注 PDF（含导图），即可生成一个独立 PDF 附件：句子高亮、建议片段下划线、中文分析批注、阅读说明、分类书签和导图附页。原始 PDF 保留。

安装

1. 从本 Release 下载 paperpilot-0.6.1.xpi。
2. Zotero → 工具 → 插件/附加组件 → 齿轮 → Install Add-on From File，选择 XPI 后重启。
3. 在 PaperPilot 设置中填写模型端点、密钥和模型。
4. 如需增强 PDF，安装 Python 依赖 python -m pip install pypdf==6.18.1 reportlab==5.0.1，在设置里填写该 Python 的完整路径。普通导出和独立导图无需 Python。

修复

• 修复插件启动时 rootURI 未定义及 XPI 内 Python 脚本读取失败。
• Python 改用 Unicode 异步调用，支持中文路径，并提供超时、错误报告和临时文件清理。
• 修复 PDF 颜色、透明度和小数坐标；逐行标注避免跨栏涂满，新增中文分析批注和明确外观流。
• 增强 PDF 以新附件保存，保留原文、已有文库批注和原书签；导图追加到末页，原文页码不变。
• 修复 XPI 打包与验证；Python 回归测试加入完整测试流程。

验证

• 2026-10-09 重新运行 npm test：8 个阶段全部通过，105 项具名测试及回归脚本通过，0 失败。
• XPI 资源、版本及源码/编译文件一致性校验通过。
• 2026-09-15 已在 Zotero 10.0.2 内验证增强导出：14 页原文 + 1 页导图，新增 3 处句子高亮、5 处建议片段下划线，2 条未可靠定位引用跳过；原文哈希不变。

依赖：esbuild 0.28.2、TypeScript 7.0.2、pypdf 6.18.1、reportlab 5.0.1。

已知限制

尚未实现段落自动分框、关键词级下划线、中英译文语义对齐、扫描件 OCR。导图来自 AI 总结；未可靠定位的引用会跳过。实际桌面验收基于 Zotero 10.0.2，其他版本需自行验证。

当前使用手动 XPI 更新，尚无自动更新服务。

XPI SHA256：6649ae4d8b35e606593fee9c2d0cc0eaa68b03a29f0f6ca6384cdb557bd072b0。