Skip to content

Releases: Dictation354/paper-fetch-skill

v6.2.0

Choose a tag to compare

@github-actions github-actions released this 07 Sep 08:07

6.2.0 - 2026-09-07

新增——CLI 实时进度与协作式取消

  • 单篇和批量抓取新增 --progress auto|text|jsonl|none,在 stderr 输出进度,stdout 继续用于论文正文或 JSON。默认 auto 仅在终端显示文本;JSONL 按原始输入序号报告阶段、资产计数和终态 manifest record。
  • --progress jsonl --control-stdin 支持通过命令取消单个输入或整批任务。取消保留已完成结果和原始输入顺序;重复 DOI 共享的工作仅在全部依赖输入取消后停止。终态事件在产物提交和工作线程清理后发送,最终批量 JSONL 仍是一次性生成的输入有序结果文件。

修复——Oxford Academic 正文内图片

  • Oxford Academic HTML 现在在转换为 article model 前,将已下载的预览图链接改写为本地资产路径,保留图片在正文中的位置并避免重复图片。未下载图片保留远程链接,部分下载失败仍保留验收证据。

变更——论文技能触发与阅读指引

  • 技能描述现在覆盖全文获取和可用性探测,包括代理为回答问题搜索证据时发现的明确论文候选;现有五个预设均补充了选择条件。
  • 批量指引在身份解析前即执行每次最多 50 条的限制,保留原始 index,并在解析后跨块按规范 DOI 去重。完整阅读和比较任务复用合格本地正文,或沿用现有阅读预设逐篇获取;compact 结果和 bounded 截断片段不能视为已读全文。
  • 仅探测可用性的任务按逐项证据、错误和未调度状态报告,不要求全文 acceptance,也不自动升级为抓取。Fetch/cache 示例显式选择接口支持的引用参数,既有授权、cache scope、落盘和来源边界保持不变。

v6.1.6

Choose a tag to compare

@github-actions github-actions released this 07 Sep 04:17

6.1.6 - 2026-09-07

修复——Nature 扩展资产与 Wiley 图片获取

  • Nature Extended Data 表格和图片现在归入 supplementary scope:body 排除它们,all 通过现有图片下载路径获取。表格匹配不再假定展示编号等于页面 URL 序号;老版表图须匹配页面标题、论文回链、图片 DOI 和表格内容容器。表图保留 Markdown 引用,未取得的扩展资产保留来源和结构化失败证据,进入统一验收。
  • Wiley 公式位图现在接受大于零的自然宽高,并要求精确匹配目标图片 URL,避免替用页面中的其它图片。公式和正文 figure 图片导航改为等待导航 commit 与图片就绪,不再等待图片文档的 DOMContentLoaded
  • Wiley 正文 figure 现在优先获取出版社高清候选,页面导出与图片导航均要求实际加载的图片 URL 匹配当前目标。预览回退保留来源、尺寸和高清失败证据,并标记 download_tier=previewpreview_accepted=false,由统一 acceptance 报告质量降级。

v6.1.5

Choose a tag to compare

@github-actions github-actions released this 05 Sep 11:26

6.1.5 - 2026-09-05

不兼容变更——统一 MCP 探测入口

  • 删除独立 has_fulltext MCP 工具,不保留别名,工具总数从十个收敛为九个。单篇改用 batch_check(queries=[query]),从 results[0] 读取 probe_state、证据、警告和逐项错误;歧义候选现在位于逐项 error,不再使用旧单篇工具的顶层错误语义。
  • batch_check 仅接受默认的 mode="metadata",删除 article 抓取路径;保留 schema-v2 metadata 字段、输入顺序、规范 DOI 去重、逐项 context 隔离、共享 transport、provider lane 限流、取消与进度语义。底层 Python probe_has_fulltext 服务及 provider catalog resource 保持不变。
  • 正文检查改用 batch_fetch,以每项 acceptance 判断结果。无需落盘时显式使用 modes=["article"]detail="compact"save_markdown=falseno_download=trueprefer_cache=falseartifact_mode="none"strategy={"asset_profile":"none"},且不传 batch_results;不改变 batch_fetch 现有默认值。

变更——技能工作流指引

  • 在本地/cache 检查前确定任务意图和请求参数,临时阅读不要求选择缓存目录。保留五个预设,沿用用户明确选择和已有授权,避免重复确认。
  • 按任务选择需要阅读的参考章节和验收报告细节,明确 runtime 准备与访问边界;获得已核验文本后继续完成用户要求的总结、比较、翻译或提取。

v6.1.4

Choose a tag to compare

@github-actions github-actions released this 05 Sep 09:54

6.1.4 - 2026-09-05

修复——出版社浏览器与资产获取

  • AIP 直接使用正常 HTML attempt,取消媒体拦截及 Adzerk/Crossmark 空脚本响应,保留现有非持久会话和正文 readiness 检查。
  • IEEE 原图恢复现在复用浏览器会话中匹配的文章链接:图片通过站内查看器获取,表格图片链接通过临时浏览器标签获取。恢复过程验证原始响应字节,保留逐资产失败报告和预览降级。
  • Springer/Nature 优先下载已知原图候选,仅在需要时请求图页;延后发现仍在同一次资产解析和预算内完成,保留表格页面补齐和预览降级来源。
  • Science 最终页面现在采用当前候选中 URL、DOI 匹配的最新已完成主框架导航响应,避免初始拒绝响应覆盖随后成功加载的文章;iframe 和无关响应不能替换文章状态。
  • PNAS 仅拦截精确匹配的侧栏统计接口,并记录 blocked_sidebar_metrics_count。三组冷会话对照未证明稳定提速,浏览器页面处理仍是性能限制;文档记录的 PMC 无浏览器实验尚未接入获取流程。

v6.1.3

Choose a tag to compare

@github-actions github-actions released this 04 Sep 10:25

6.1.3 - 2026-09-04

变更——provider 与 browser 所有权

  • 文章来源 provenance 现在读取 catalog 中各 route 显式声明的 source:优先按精确 route name 选择,并兼容只携带 route kind 的 PDF recovery payload。ACS、Science、PNAS 的通用 source 与 Wiley 共用的 browser source 保持不变。
  • Browser landing page、provider 与资产 URL 检查统一复用 catalog hostname matcher,同时保留 provider domain、route host、候选构造集合及 MDPI/Frontiers 精确网络边界的不同语义。
  • 删除 AMS/MDPI HTML compatibility facade、Springer 专用引用再导出、15 个无人消费的 browser-workflow 根私有导出、旧 Playwright 命名 PDF alias,以及两个未使用的 fast-browser wrapper。保留的 Springer facade 现在是静态兼容导出,调用时不再改写 canonical extraction 模块。
  • 删除未使用的即时 browser_runtime.save_storage_state facade 及其 backend/path 转发链。Browser fetch 与 preflight 仍会先暂存 provider 范围内的状态,并且只在验收通过后原子提交。

变更——schema 与仓库维护

  • MCP request schema 现在让 fetch、batch、cache 与 browser-preflight 路径字段复用同一个精确 optional-string 规范化 helper;路径值仍只去除首尾空白。同时删除 article-source rendering 中返回值相同的无效分支。
  • 删除 240 个已跟踪的一次性 live 调查产物。维护者 live 验证改写到被忽略的 failures/ scope;长期仓外保留只需 JUnit 与 live-acceptance.json,IEEE 受保护资产专项再保留 asset-hashes.json

v6.1.2

Choose a tag to compare

@github-actions github-actions released this 03 Sep 11:32

6.1.2 - 2026-09-03

修复——资产完整性与 provider 分页

  • 普通 provider 抓取不再默认限制最多 128 个资产;单文件、累计字节、像素和 worker 上限继续生效,arXiv source archive 仍保留独立的 128 个 regular member 遍历门禁。显式有限文件预算继续执行;致命预算终止现在会为每个已准入但未完成的资产返回带 timing 的失败;普通流式图片只有在载荷实际为 EPS 或 TIFF 时才预留转换输出名额。
  • IEEE references 现在可以继续抓取超过 20 页,并在达到已声明数量、遇到空页、短页、重复页或总 wall-clock deadline 时停止;landing page 声明存在 references 但未给出数量时也会抓取。
  • Taylor & Francis 动态 CSV 表格和同页内嵌表格现在按每批 24 张持续 hydration,直到处理完全部已发现表格或页面 deadline 到期。deadline 截断会报告未完成表格数,离线 replay 也会恢复全部符合边界的同页表格 payload。
  • 异步 MCP 抓取在成功、provider 失败和协作取消路径中,都会由 owner worker 线程关闭各自的 Camoufox manager。
  • 文章渲染现在会把带 HTML 强调标记的 metadata 标题与 Markdown 强调形式的开头标题识别为等价,避免重复文章标题。
  • 离线包验证的 DOI smoke test 现在使用受支持的 paper-fetch fetch 子命令。

v6.1.1

Choose a tag to compare

@github-actions github-actions released this 02 Sep 08:04

6.1.1 - 2026-09-02

修复——ACS 资产与 AIP 浏览器稳定性

  • ACS HTML 提取现在会在资产发现前从原始 Silverchair 正文恢复出版社的图片下载链接,并按资产身份去重;清理后的正文省略这些链接时仍可保留官方图片 rendition。
  • AIP 浏览器尝试现在只对精确匹配的 Adzerk 与 Crossmark widget 脚本 URL 返回空 JavaScript;其它 URL 和资源类型继续正常加载,fulfill 失败时安全放行,避免第三方 TLS 间歇停滞阻塞正文就绪或产生 insufficient_body

v6.1.0

Choose a tag to compare

@github-actions github-actions released this 02 Sep 03:41

6.1.0 - 2026-09-02

修复——审计一致性

  • 批量 MCP 抓取现在与单篇抓取一致地规范化可选字符串;仅含空白的共享 Markdown 文件名视为未指定,manifest 记录的也是规范化后的请求。
  • 异步内联图片抓取只在复现所请求图片确有需要时把已有 article 字段保留到内部缓存;旧的不完整 sidecar 会安全 miss,公开 structured content 仍隐藏未请求的 article。
  • Provider 资源 hook 对正文的更新现在会一致传播到 article 构建、workflow 落盘、acquisition 和 provider 返回正文。
  • 删除未使用的 KaTeX 运行时依赖及安装检查;打包的 Node workspace 只保留 MathML→LaTeX 转换器及其传递依赖,同时维持 KaTeX 兼容的规范化目标。
  • 使 CLI、MCP、浏览器、cache、provider、部署、macOS 与提取文档重新符合仍然存在的能力和契约。

破坏性变更——命令、MCP、批处理与 manifest 接口

  • CLI 现在只支持子命令形式:请使用 paper-fetch fetch ...。删除根级 fetch 参数兼容层、CLI --no-download、持久化 --run-manifest / --resume 以及 manifest audit|reconcile 命令;不保留 provider artifact 与资产时改用 --artifact-mode none
  • CLI 与 MCP 批处理可以写入一份最终 batch-results.jsonl;只有全部输入取得终态后,才按输入顺序组装并原子提交。删除 append-only attempt、run summary、audit/reconcile 与 resume 语义,同时保留单批次内按 canonical DOI fan-out。目标结果文件已存在且内容不同时,仍需显式传入 --overwrite / overwrite=true
  • Schema-v2 manifest record 现在只公开当前 record_statusacceptanceoutput_artifacts 契约。删除旧顶层 statusoutput_pathsaved_markdown_path projection 以及旧 acceptance/cache 迁移 shim;旧版、未知或不完整记录不再猜测或升级,而是 fail closed。
  • 删除 summarize_paperverify_citation_list MCP prompt 模板。Fetch、resolve、check、cache tools,静态 provider-catalog resource 以及 schema-v2 payload 契约均保持不变。

变更——浏览器与 transport 运行时

  • Camoufox 现在是唯一 browser backend。删除 backend selector、通用 Chrome/CDP runtime 路径、浏览器自动安装/修复/更新,以及 CLI/MCP/环境中的 browser_auto_prepare 控制。Fetch、auth 与 preflight 只使用已经准备好的 runtime;需要安装时显式运行 python -m camoufox fetch
  • Browser preflight 不再向后续 fetch 发布短期 HTML 或 route hint。每次 fetch 都独立导航,并重新执行 identity、access boundary、正文与资产验收;storage state 仍是有意保留的可复用浏览器能力。
  • 删除基于 download_dir 的 HTTP 文本磁盘缓存、条件式磁盘 revalidation、cache stat/timing collector 及其环境变量。HTTP GET 现在只在当前进程内有界复用,request safety、redirect 检查、retry policy 与资产限制继续执行。

变更——MCP cache 访问

  • 删除动态 cache index/entry resource、cache resource-list notification 与 batch_fetch cache resource_uri 字段。Cache 访问现在通过显式 download_dir scope 内的 list_cached / get_cached 完成;静态 provider catalog resource 继续保留。
  • 删除 cache refresh / rescan 模式与 loose-file discovery。Sidecar、Markdown 和资产在写入时增量注册;读取只信任当前 scoped index 以及当前 DOI、capability scope、stat 与 hash 证据,不再静默迁移旧版或损坏的 index。

变更——provider 与库契约

  • 内置 provider 现在从一份固定且经过验证的 bundle 列表加载。删除动态注册、依赖 import order 的优先级、identity overlap priority、route-union 编译以及生成式 provider catalog/route governance 层;运行时网络策略只从精确声明的 route 编译。
  • 删除仅用于兼容的 positional constructor、宽泛 keyword adapter、旧 urllib asset request 注入、通用 browser/PDF launch 参数、跨请求 singleflight 与其它私有 wrapper import。当前 typed request/options object 与单批次 DOI 去重仍是支持路径。

变更——维护工具与验证

  • 用更小的 docs/adding-a-provider.md 流程取代 manifest/review/scaffold onboarding tree:定义 runtime bundle,添加 provider-local test,并加入代表性 golden replay 证据。删除 provider governance/drift/canary generator、递归 onboarding 自动化、Markdown review sidecar、live benchmark tooling 与生成式 route 文档。
  • 删除仓库 coverage-focus、complexity-budget gate 与打包的 paper_fetch_devtools 质量层。确定性的 unit、integration、provider replay、package、platform 与 live-test 入口继续保留在各自范围内。
  • 将静态 Skill 完整性验证从 runtime package 移至 scripts/skill_integrity.py。离线 builder/installer 直接验证 bundle 与已安装的宿主副本;doctor 现在只报告 runtime/provider 健康状态,不再接受 --install-root 或输出 installation-provenance 状态。

变更——发布与依赖 CI

  • 删除可变的 dependency-latest 滚动发布、专用 token 路径和跨 revision release tooling overlay。稳定 v* 发布继续公开九个离线安装器与 SHA256SUMS,并保留冻结依赖证据、SBOM、secret scan 和 provenance attestation。
  • 删除不 gate 的 provider canary 状态机;经合法授权的显式检查继续保留在 tests/live
  • 锁定依赖审计现在导出全部 extras,并让每个 pip-audit finding 直接失败,不再保留空的例外框架。
  • Python 3.11 与 3.14 boundary job 现在每个 Python 版本只构建一次 wheel,并分别 smoke 隔离的 core/full 安装。
  • Python distribution verification 现在检查 archive safety、必需 package/Skill payload、metadata、entry point 与完整 wheel RECORD 覆盖,不再维护签入仓库的精确源码 inventory。删除仓库根目录的旧 Windows PowerShell bundle installer;受支持的 Windows release artifact 仍是原生 setup executable。

v6.0.4

Choose a tag to compare

@github-actions github-actions released this 29 Aug 07:11

6.0.4 - 2026-08-29

修复——发布质量门禁

  • 将 XML tail 空白处理从共用行内渲染器中提取,保持 6.0.3 行为不变,同时使渲染器回到仓库复杂度预算内;并对 JATS 回归测试应用规范格式。
  • 为 6.0.4 重新生成机器可读 provider catalog,使其 tool-version 快照与项目元数据一致,并恢复 provider governance 同步。

v6.0.3

Choose a tag to compare

@github-actions github-actions released this 29 Aug 06:42

6.0.3 - 2026-08-29

修复——XML 行内空白渲染

  • Elsevier/JATS 共用的行内转换器现在会在组装 Markdown 前折叠出版社 XML 中仅用于源码排版的空白。运算符和强调标记附近的源码折行不再造成错误强调或意外块级解析,同时显式换行元素与既有的分离斜体下标修复保持原有行为。
  • 含嵌入块的 JATS 段落同步应用相同空白规则。回归测试覆盖本次报告的 Elsevier =< 案例以及真实 Frontiers、Copernicus XML;PLOS 共用修复后的 JATS 转换路径。