PaperSearch 0.5.12

本版加快 DOI 核对并支持一次核对多个 DOI，新增 BMJ 系期刊的补充材料下载，Skill 写明对应的 PaperSearch 版本。

• 安装与配置
  • 新增：Skill 写明对应的 PaperSearch 版本；AI 在新对话开头自检时，发现命令行程序比 Skill 旧，会告诉用户并询问是否更新。
  • 修复：较旧的命令行程序不再用自带的旧版 Skill 覆盖已安装的新版 Skill；改为提示更新命令行程序，每天最多提示一次，doctor 中同样标明。
• 检索与核对
  • 改进：核对 DOI（get_paper_by_doi）默认先查 Crossref，它没有的 DOI 才问其他来源，每个 DOI 由约 7 秒缩短到 1 至 2 秒；platform=all 仍查询全部来源。
  • 新增：一次核对多个 DOI（dois，最多 100 个）。
  • 调整：核对结果统一放在 data.papers，并列出没有找到的 DOI（not_found）和没能核对的 DOI（lookup_failed）；单个来源出错只记入 warnings，不再使整次调用失败。
  • 修复：来源请求出错时不再向错误输出打印错误详情，Windows PowerShell 中把错误输出视为失败的脚本不会因此中断。
• 学校订阅下载
  • 新增：BMJ 系期刊（BMJ、BMJ Open、BJSM、RMD Open 等）的补充材料下载。
  • 调整：还没有补充材料规则的网站不再记为失败，也不再生成诊断文件；结束卡片和失败列表中写明“网站暂不支持自动下载附录”，可点击打开文章页手动下载。
• 下载结果
  • 调整：同时下载补充材料时，只有取到了补充材料的论文才单独建文件夹，其余论文的 PDF 直接存放在本次的下载文件夹中。
  • 修复：只补下载补充材料时，浏览器保存的页面快照会留在下载文件夹中；现在与其他诊断文件一起存放在运行记录目录。
• 文档：改进：Skill 写明判断批量下载是否卡住的方法：以运行记录最后一行的时间为准。
• 升级：运行 npm install -g papersearch@latest。已在 macOS 上使用 Google Chrome 157.0.8103.39 和 Patchright 1.64.4 测试，DOI 核对另在 Windows 上测试。

PaperSearch 0.5.11

本版下载文件夹只存放论文，并新增卸载命令。

• 安装与配置：新增：paper-search uninstall：先列出要删除的内容（学校订阅下载及登录状态、运行记录、配置与 API key、各 AI 工具中的 Skill），确认后一次删除；下载的论文保留；--dry-run 只列出不删除。
• 下载结果
  • 改进：只下载正文时，PDF 直接存放在本次的下载文件夹中；下载补充材料时，每篇论文一个文件夹；不再有 papers/ 一层。
  • 改进：运行记录与诊断文件改存在 PaperSearch 自己的目录中，30 天后自动清理；下载文件夹中不再有 runs/。
• 升级：运行 npm install -g papersearch@latest。已在 macOS 上使用 Google Chrome 157.0.8103.39 和 Patchright 1.64.4 测试。

PaperSearch 0.5.10

本版在设置窗口中加入联系邮箱并按用途重排 API key，支持按主题分文件夹下载，并修复爱思唯尔学校登录中的一处问题。

• 安装与配置
  • 新增：设置窗口加入 Unpaywall 和 Crossref 联系邮箱：填写常用邮箱即可，无需注册，均可点击“测试”在线核验；未填写 Unpaywall 邮箱时，开放下载会跳过 Unpaywall。paper-search config test 同样支持测试这两个邮箱。
  • 改进：设置窗口的 API key 页按用途分组，推荐填写的 EasyScholar、Semantic Scholar 和 Unpaywall 邮箱置于最上方；列表最高为半个屏幕，在标题下方滚动。
• 学校订阅下载：修复：爱思唯尔显示仅接受邮箱的 “Enter your organizational email” 页面时，自动转到按学校名称搜索，不再将学校名称填入邮箱栏。
• 进度窗口
  • 新增：下载过程中，“失败”列表在正文未下载的论文之后，另列正文已保存但补充材料未下全的论文，并按原因分组。
  • 新增：“剩余”列表中的论文可以点击，在浏览器中打开其文章页面。
• 下载结果：改进：每篇论文都指定了各自的文件夹时（例如按主题分开），论文保存在指定位置，本批的运行记录放在它们共同的上级文件夹；进度窗口的成功列表可打开这些论文所在的文件夹。
• 文档：改进：README 的 API key 一节按设置窗口的分组重排，并加入两个联系邮箱。
• 升级：运行 npm install -g papersearch@latest。已在 macOS 上使用 Google Chrome 157.0.8103.39 和 Patchright 1.64.4 测试。

PaperSearch 0.5.9

本版每次下载单独存放在一个文件夹中，并修复 Windows 上的若干问题。

• 安装与配置：修复：Windows PowerShell 写出的带 BOM 的文件可用于 --json-args @文件；参数不是有效 JSON 时，提示改用文件传参。
• 学校订阅下载：修复：paper-search carsi status 显示当前设置的学校，安装后再设置学校时不再提示“还没有配置学校”。
• 下载结果：新增：每次下载在下载文件夹中新建 年月日-时分秒_PaperSearchDownload 文件夹，本次下载的论文和运行记录均保存在其中；进度窗口的“打开文件夹”指向本次的文件夹。
• 文档：改进：README 与 Skill 改用 /paper-search 引用 Skill，并注明 Windows 上安装 Skill 需要 Git；更新 README 中的安装演示、结果示意图和总览图。
• 升级：运行 npm install -g papersearch@latest。已在 macOS 上使用 Google Chrome 157.0.8103.39 和 Patchright 1.64.4 测试。

PaperSearch 0.5.8

本版改为先安装 Skill，并在设置窗口中标明推荐配置的 API key。

• 安装与配置
  • 调整：改为先安装 Skill，第一次使用时由 AI 征得同意后安装命令行程序；Skill 的说明和回复更简洁。
  • 改进：设置窗口的 API key 页标明“推荐配置”和“非必须”，EasyScholar 增加申请教程。
  • 调整：Node.js 要求提高到 22 及以上。
• 文档：改进：README 快速开始改为先安装 Skill。
• 升级：运行 npm install -g papersearch@latest。已在 macOS 上使用 Google Chrome 157.0.8103.39 和 Patchright 1.64.4 测试。

PaperSearch 0.5.7

本版让开放下载和学校订阅下载同时进行，进度胶囊可以查看每篇论文，并新增系统通知检查。

• 学校订阅下载
  • 改进：批量下载时开放下载与学校订阅下载同时进行：开放渠道没有找到的论文立即转入学校订阅下载，浏览器仍一次下载一篇；需要登录学校时，批量开始后数秒内即提醒。
  • 修复：出版社验证占用学校登录等待时间、PDF 以下载文件形式到达时被丢弃、操作恰好到时被误判为浏览器卡死等问题。
• 进度窗口
  • 改进：显示开放下载和学校订阅下载各自下载的篇数；结束卡片按“开放下载”“机构下载”汇总，出版社 API、Sci-Hub、预印本列在括号内。
  • 新增：点击“成功”“失败”“剩余”可查看具体论文：成功的按来源分组，点击打开所在文件夹；失败的按原因分组，点击在浏览器中打开文章页；剩余的按正在下载、排队等机构下载、开放下载还没查分组。
  • 改进：macOS 上拖动时窗口由系统直接跟随鼠标，系统繁忙时不再落后，拖到屏幕边缘可正确吸附；靠下放置的卡片收起时，胶囊保持在卡片下沿。
  • 新增：设置页的系统通知检查：开启通知时检查系统是否允许 PaperSearch 弹出通知，可发送测试通知；未允许时说明需修改的位置，并可直接打开系统通知设置。
  • 改进：卡片背景改为不透明。
  • 移除：旧版进度窗口。
• 下载结果：调整：下载失败的论文，诊断记录和截图存放在该论文文件夹的 diagnostics/ 中；下载成功的论文不再生成该文件夹，记录保存在下载文件夹的 runs/ 中。
• 升级：运行 npm install -g papersearch@latest。已在 macOS 上使用 Google Chrome 157.0.8103.39 和 Patchright 1.64.4 测试。

PaperSearch 0.5.6

本版调整随包 Skill 中填写 API key 的方式，使其通过 AI 工具的 Skill 安全审查，并精简部分说明。

• 安装与配置
  • 调整：不使用学校订阅下载时，API key 由用户在终端运行 paper-search setup 填写（输入时不显示），AI 工具随后逐个测试；随包 Skill 不再引导用户在对话中发送 API key，以通过部分 AI 工具的 Skill 安全审查。使用学校订阅下载时仍在设置窗口中填写。
  • 改进：随包 Skill 中关于登录、测试下载、学校设置和 Google Scholar 使用范围的说明改为直接说明做法。
• 文档：改进：README 快速开始的填写方式与上述流程保持一致；快速开始演示压缩至约一半大小，设置窗口段落加快播放；学校登录演示改为直接从机构登录开始。
• 升级：运行 npm install -g papersearch@latest。学校订阅下载会在首次使用时自动更新，也可以运行 paper-search carsi update 手动更新。已在 macOS 上使用 Google Chrome 156.0.8078.81 和 Patchright 1.64.4 测试。

PaperSearch 0.5.5

本版固定“请开始配置”的配置流程，并支持在安装后的同一对话中直接开始配置。

• 安装与配置
  • 改进：安装完成后无需新开对话，用户需要配置时说“请开始配置”即可。
  • 改进：配置流程固定为逐项询问：先确认是否使用学校订阅下载；使用时安装学校订阅下载（缺少 Google Chrome 时一并安装），询问并设置学校，其余 API key、下载文件夹和等待时间在设置窗口中填写；不使用时列出缺少的 API key，再设置默认下载文件夹。
  • 改进：随包 Skill 的配置说明移至单独的参考文件 references/setup.md，减少日常使用时读取的内容。
• 文档：改进：README 快速开始按两条配置路线更新；配置演示增加询问学校的步骤。
• 升级：运行 npm install -g papersearch@latest。学校订阅下载会在首次使用时自动更新，也可以运行 paper-search carsi update 手动更新。已在 macOS 上使用 Google Chrome 156.0.8078.81 和 Patchright 1.64.4 测试。

PaperSearch 0.5.4

本版调整学校订阅下载的安装时机：改为在配置时征得用户同意后安装，并完善配置引导和演示。

• 安装与配置
  • 调整：首次安装时只安装命令和随包 Skill，不再自动安装学校订阅下载和 Google Chrome。
  • 改进：用户说“请开始配置”后，随包 Skill 先说明学校订阅下载的用途、所需的 Google Chrome 和约 0.5 GB 的下载量，征得同意后再安装；安装后询问用户的学校并完成设置。用户拒绝时记录下来，此后不再提示。
  • 修复：此前版本要求 AI 工具不经确认安装组件，部分工具的安全审查会因此拒绝安装随包 Skill；本版不再有此要求。
• 文档：改进：README 快速开始的配置方式改为设置窗口优先，配置口令改为可直接复制的样式；安装与配置演示按新流程重新录制。
• 升级：运行 npm install -g papersearch@latest。学校订阅下载会在首次使用时自动更新，也可以运行 paper-search carsi update 手动更新。已在 macOS 上使用 Google Chrome 156.0.8078.81 和 Patchright 1.64.4 测试。

PaperSearch 0.5.3

本版为正文片段补充完整出处，修复中文 Windows 上设置窗口测试 API key 无法结束的问题，并完善首次安装后的配置引导。

• 安装与配置
  • 修复：中文 Windows 上在设置窗口点击 API key 的“测试”后一直显示“正在测试…”；测试意外失败时显示原因。
  • 改进：首次安装 Skill 后，提示用户说“请开始配置”；随包 Skill 收到后依次检查可用功能、学校订阅下载、默认下载文件夹和 API key，电脑上直接打开设置窗口。
• 检索与核对
  • 改进：正文片段（search_semantic_snippets）的每条结果新增 DOI、PMID、年份和期刊，并给出一行出处 source；许可证统一写为 CC BY-NC-ND 等常见格式；论文信息查询失败时逐条标注。
  • 改进：随包 Skill 规定引用正文片段时原样引用英文原句，并在下一行附上出处；仅题名或摘要命中的结果标为线索。
• 文档：改进：README 与安装演示按新的配置引导更新。
• 升级：运行 npm install -g papersearch@latest。学校订阅下载会在首次使用时自动更新，也可以运行 paper-search carsi update 手动更新。已在 macOS 上使用 Google Chrome 156.0.8078.81 和 Patchright 1.64.4 测试。