Repository navigation
Releases
fork v0.26 · 插件 0.6.17.1(基线官方 v0.6.17)
个人 fork,非官方发布渠道。基线 = 官方 v0.6.17;包内版本 0.6.17.1,本仓库 Release 号 v0.26(映射规则 v0.(10 + x))。
这一版取代 v0.25(插件 0.6.14.2)。 插件 ID 与包内 update_url 保持官方值,所以官方发布更高版本时 Zotero 自动更新会顶掉这个构建;要长期留在改版上请关闭自动更新。
安装
- 下载
jadense-in-zotero-v0.6.17.1.xpi(4,714,880 字节,SHA-2564274b50c1a740977d98d08a20bb86010a11cc7dc7b1c046250ba13f59617a572)。 - 校验:
sha256sum -c SHA256SUMS。 - Zotero「工具 → 插件 → 齿轮 → 从文件安装插件」。不要把 Source code 压缩包当安装包。
本版更新(0.6.17.1)
- 基线并入官方 v0.6.17(含 0.6.15、0.6.16 与 0.6.17 三个版本):
- 长文逐段解析完成后,即使最终汇总失败也保留完整分段笔记与可核对批注;批注不再固定上限 32 条,可在设置中填写整篇建议数量;Windows OCR 与 PDF 引擎准备流程能区分安装包损坏、系统依赖与模型缺失;停用独立全文提取入口(旧 Markdown 仍可阅读、复制)。
- 「重新解析」:卡住或未完成的任务可主动放弃继续,用当前模型创建全新请求;与「继续解析」明确区分,保留已有笔记与批注。
- 对话、解析与翻译按所选模型的上下文容量和输出预算规划输入;长消息与关联来源正文完整保存在本机;修复原生设置布局、滚动与重开;统一 Logo。
- 本 fork 功能保持不变:收藏夹快速解析、本机证据与单篇深读、译文自动保存与按文献标题命名、双栏译文防重复与不过页修复全部保留,逐轮记录见 CHANGELOG.md。
- 构建修复:品牌 SVG 统一为 LF 换行并写入
.gitattributes,Windows 检出下verify-release不再误报。
与官方 v0.6.17 的功能差异
官方版本没有下面这些能力;逐轮记录见 CHANGELOG.md。
- 收藏夹快速解析:独立窗口递归读取收藏夹,一次调用产出总览、逐篇要点、横向对比、趋势与空白;逐篇 0–100 评分(问题价值/方法创新/证据强度/可复现性/应用潜力各 20 分)。
- 附件取证:整篇读取(>80 页取首尾两半),文字层与 PDF 超链接注释双通道合并;「代码明确给出」只认仓库网址或明确的已开源表述。
- 本机版面统计与单篇深读:一级小节标题、图/表/参考文献数量与关键词命中只在本机统计,外发仅标题与计数;深读先切有界摘录(≤3 节、每节 400 字),弹窗报清发送范围后才派发单独一次请求。
- 本机证据与跳页:正文、附录小节与本地链接可点击跳转,跳页数据不进请求载荷、不进「复制全文」;「本机证据」折叠框与模型评价分开显示。
- 对照翻译增强:译文自动保存到指定目录(保存时按文献标题命名,不覆盖已有文件),目录缺失时提示并支持就地补存;发布新成稿后只保留当前与上一版快照,删除文献的成果延迟两轮确认后回收。
- 错误与恢复:失败提示只投影错误码/HTTP 状态/类名;模型 JSON 坏字符三阶段恢复,不再一处坏字符丢掉整篇综述。
刻意不变
- BYOK 非幂等契约:已产生输出或结果未确认的请求不会自动重发,只有在提供商后台核对后显式授权,才沿用同一会话 ID 重发一次。
- 计费目的地:快速解析与深读沿用「文献解析」功能模型,一次批量综述只有一次派发。
- 隐私围栏:外发只有题录、摘要、链接文本、附录一级标题与版面统计;PDF 正文一句不出机器(唯一例外是显式确认后的单篇深读摘录),扫描过程不打开任何链接。
- 插件 ID 与更新源保持官方值。
构建与验证
tsc --noEmit 与 eslint 无报错;vitest 153 文件 / 1729 项通过;PDF 适配器与 worker python -m unittest 56 项通过;scripts/build.mjs + scripts/verify-release.mjs 通过。本次未在 Zotero 内做真机安装回归;实测环境仍为 Windows / Zotero 10。
许可证不变:Jadense Non-Commercial License 1.0(个人非商业自用、免费再分发、保留声明、标注改动、下游同条件)。
fork v0.25 · 插件 0.6.14.2(基线官方 v0.6.14)
个人 fork,非官方发布渠道。基线 = 官方 v0.6.14;包内版本 0.6.14.2,本仓库 Release 号 v0.25(映射规则 v0.(10 + x))。
这一版取代 v0.23(插件 0.6.13.13)。 0.6.14.1 的自动保存与命名修复已并入本版,未单独发布。插件 ID 与包内 update_url 保持官方值,所以官方发布更高版本时 Zotero 自动更新会顶掉这个构建;要长期留在改版上请关闭自动更新。
安装
- 下载
jadense-in-zotero-v0.6.14.2.xpi(4,677,457 字节,SHA-2568529a6fe0b420c6ac103ccd706ebb809a83de3a87dec64fbbaca9b7de4bfe7bb)。 - 校验:
sha256sum -c SHA256SUMS。 - Zotero「工具 → 插件 → 齿轮 → 从文件安装插件」。不要把 Source code 压缩包当安装包。
本版更新(0.6.14.2)
- 双栏译文的重复段与 5.5pt 字号:模型偶尔把下一段并进上一段的译文(第 5 页「位姿。这种停顿…」整段在上一段末尾又出现一次),超长译文只能缩到原框的 0.65 倍,8.5pt 变 5.5pt。现在回填前逐页比对相邻段:只有后段译文已独立存在、且确实等于前段结尾时才裁掉重复结尾,再按正常字号排版。缓存译文直接复用,重排不消耗翻译请求。
- 译文留在本页,但可占用同页空栏:一段译文在原框内只能缩到 0.7 倍以下时,先向本页同栏下方(到最近段落/图之前)与右侧(到栏边)扩出空间,再从原字号 1.0 重算;扩完仍不够才退回原字号。不跨页、不跨栏搬动译文。
- 实测 20 页期刊:第 5 页重复串计数 0、正文回到 8.5pt;第 2 页原有的 5.5pt 重复一并消失;全篇越界 0 处,与旧输出相比没有新增文字重叠。图内小标签仍按中文 85% 缩放(放开会让第 16 页表格标签换行压行)。
- 没有「译文字号」设置项:阅读器里的「译文缩放」只改显示比例,不改生成 PDF 的内嵌字号;影响字号的只有中文 85% 规则和「原框放不下时按比例缩小」,本版让后者优先借用同页空白。
0.6.14.1 附带修复
- 自动保存目录被移动或删除时不再静默失败:完成翻译会提示「自动保存目录不存在」,选定新目录后立即补存并记住;同一缺失目录每次会话只提示一次。
- 「功能配置 → 对照翻译」恢复「自动保存对照译文」开关、当前目录、「选择保存目录」与「清除保存目录」;目录不可用时行内直接写明。
- 手动保存与自动保存都在保存时重新解析父条目标题,任务里仍存着占位名
PDF的文献也按文章标题命名;同名文件继续追加序号,不覆盖原 PDF。
与官方 v0.6.14 的功能差异
官方版本没有下面这些能力;逐轮记录见 CHANGELOG.md。
- 收藏夹快速解析:独立窗口递归读取收藏夹,一次调用产出总览、逐篇要点、横向对比、趋势与空白;逐篇 0–100 评分(问题价值/方法创新/证据强度/可复现性/应用潜力各 20 分)。
- 附件取证:整篇读取(>80 页取首尾两半),文字层与 PDF 超链接注释双通道合并;「代码明确给出」只认仓库网址或明确的已开源表述。
- 本机版面统计与单篇深读:一级小节标题、图/表/参考文献数量与关键词命中只在本机统计,外发仅标题与计数;深读先切有界摘录(≤3 节、每节 400 字),弹窗报清发送范围后才派发单独一次请求。
- 证据溯源与三步入门(官方 0.6.14 已有,本 fork 保留本地增强):行内引用可预览原句并跳转 PDF;本机证据折叠框与模型评价分开。
- 本机证据与跳页:正文、附录小节与本地链接可点击跳转,跳页数据不进请求载荷、不进「复制全文」。
- 错误与恢复:失败提示只投影错误码/HTTP 状态/类名;模型 JSON 坏字符三阶段恢复,不再一处坏字符丢掉整篇综述。
刻意不变
- BYOK 非幂等契约:已产生输出或结果未确认的请求不会自动重发,只有在提供商后台核对后显式授权,才沿用同一会话 ID 重发一次。
- 计费目的地:快速解析与深读沿用「文献解析」功能模型,一次批量综述只有一次派发。
- 隐私围栏:外发只有题录、摘要、链接文本、附录一级标题与版面统计;PDF 正文一句不出机器(唯一例外是显式确认后的单篇深读摘录),扫描过程不打开任何链接。
- 插件 ID 与更新源保持官方值。
构建与验证
npm run build = tsc --noEmit → scripts/build.mjs → scripts/verify-release.mjs,本机通过;npm test 142 文件 / 1658 项通过;eslint 无输出;PDF 适配器 python -m unittest test_batch_adapter 47 项通过。实测环境 Windows / Zotero 10;未实测 macOS、Linux、Zotero 8/9、真实付费 Provider。
许可证不变:Jadense Non-Commercial License 1.0(个人非商业自用、免费再分发、保留声明、标注改动、下游同条件)。
fork v0.23 · 插件 0.6.13.13(基线官方 v0.6.13)
个人 fork,非官方发布渠道。基线 = 官方 v0.6.13;包内版本 0.6.13.13,本仓库 Release 号 v0.23(映射规则 v0.(10 + x))。
这一版取代 v0.16(插件 0.6.13.6)。 插件 ID 与包内 update_url 保持官方值,所以官方发布更高版本时 Zotero 自动更新会顶掉这个构建;要长期留在改版上请关闭自动更新。
安装
- 下载
jadense-in-zotero-v0.6.13.13.xpi(4,648,227 字节,SHA-256e87cfd2c3de996bdf17c996bb7cb48163f6dc37bb21031cfccc6a23c261b2a5b)。 - 校验:
sha256sum -c SHA256SUMS。 - Zotero「工具 → 插件 → 齿轮 → 从文件安装插件」。不要把 Source code 压缩包当安装包。
与官方 v0.6.13 的功能差异
官方版本没有下面这些能力;它们都来自本分支的 0.6.13.1–0.6.13.13 十三轮改动,逐轮记录见 CHANGELOG.md。
新增:收藏夹快速解析窗口(官方无此功能)
- 收藏夹右键打开独立窗口,递归读取该收藏夹及子收藏夹(跳过附件、笔记与回收站),一次调用产出总览、逐篇要点、横向对比、趋势与空白,可复制全文、保留本机历史。
- 逐篇 0–100 评分:问题价值/方法创新/证据强度/可复现性/应用潜力各 20 分;写作、排版、图表、期刊、引用不计分。档位由分数折算(80+ 高、65–79 中、50–64 低),同批同一把尺;只有题录或摘要被截断时上限 45 分。
- 「代码明确给出」有硬定义:只有仓库网址(github/gitlab/huggingface/zenodo 等)或明确写「源代码已开源/已发布/可获取」才算
yes;项目主页、数据集网站、论文落地页、「将开源」「审稿后开源」都不算。模型无证据写yes时客户端降为「未见说明」。 - 附件取证整篇读取(>80 页取首尾两半,单文件 60 MB),文字层与 PDF 超链接注释双通道合并——本机 36 个 PDF 里 610 条链接注释有 572 条在文字层根本找不到。arXiv/DOI/OpenReview 落地页、检索站点、断行残串、参考文献里的仓库都不算发现。
- 附录只收一级标题;从
VII这类续编开始也能取到,编号与标题分行、小型大写碎片、行尾断词都能拼回;只有附录标记没有标题时标「有附录(未列小节)」,模型不得猜节数或标题。 - 本机版面统计:一级小节标题(≤12)、图/表/参考文献数量、消融/基线/人工评测关键词命中次数。只有标题与计数外发,提示词标明「本机数出,非模型判断」。
- 正文与附录小节可点击跳页(
Zotero.Reader.open(附件 itemID, { pageIndex }));本地链接经Zotero.launchURL打开,只接受 http/https。跳页数据只在本机流转,不进请求载荷、不进「复制全文」。 - 单篇按需深读:先在本机切有界摘录(≤3 节、每节 400 字、合计 1200 字),弹确认框逐条报清送出多少字、哪几节、节首还是节尾、在第几页,确认后才派发那单独一次计费请求。
- 卡片把「本机证据」折叠框与模型评价分成两块;模型 JSON 有中文标点或漏转义引号时三阶段恢复(原样 → 语法修复 → 逐字段恢复),不再一处坏字符丢掉整篇综述。
- 扫描失败不再伪装成「读过但什么都没有」:每篇带
scanOutcome,Zotero 10 的Items.get/getAttachments()异常改走getAsync+loadDataType('childItems')重试,读不出来就写「未能读取附件(重新生成会重试)」。
新增:对照翻译缓存回收与自动保存
- 发布新成稿后只保留当前与上一版快照,更早成稿与中断临时稿在下次打开对照翻译时后台回收;版面解析缓存同样只留两代。
- 已删除文献的成果与版面缓存在连续两次确认(间隔 ≥1 分钟)后清理,文献库未就绪时一律不删;
extensions.jadenseInZotero.removeOrphanTranslatedPDF = false可关闭。 - 译文 PDF 完成后自动保存到上次导出目录(
extensions.jadenseInZotero.autoSaveTranslatedPDF,默认开启),以文献标题命名,不覆盖原 PDF 或已有文件。
改动:错误提示
失败提示带类型前缀(如【上游服务错误 · 503】),只投影错误码、HTTP 状态与错误类名,不回显上游正文或密钥。
文档
README 重写为 fork 视角:删除第三方 API 中转站推广、赞助二维码、Star 增长图与网页端导流;未加入任何统计或回流地址。
刻意不变
- BYOK 非幂等契约:已产生输出或结果未确认的请求不会自动重发(防重复计费),只有在提供商后台核对后显式授权,才沿用同一会话 ID 重发一次。深读沿用同一契约。上游的重试与执行状态判定未被改动,并有回归测试钉住这条边界。
- 计费目的地:快速解析与深读沿用「文献解析」功能模型,不新增计费入口;一次批量综述只有一次派发。
- 隐私围栏:外发只有题录、摘要、抽到的链接文本、附录一级标题与版面统计;PDF 正文一句不出机器(唯一例外是显式确认后的单篇深读摘录),扫描过程不打开任何链接。
- 插件 ID 与更新源保持官方值。
构建与验证
npm run build = tsc --noEmit → scripts/build.mjs → scripts/verify-release.mjs,本机通过;pnpm test 全量通过。未实测:macOS、Linux、Zotero 8/9、真实付费 Provider。
许可证不变:Jadense Non-Commercial License 1.0(个人非商业自用、免费再分发、保留声明、标注改动、下游同条件)。