v0.2.7 · 修复应用更新 HTTP 504

PaperLoom v0.2.7 · 修复应用更新 HTTP 504

修复检查更新成功后，下载校验文件或安装包时遇到 GitHub HTTP 504 而无法继续更新的问题。

• 下载遇到 HTTP 502、503 或 504 时，自动尝试同一发布附件的 GitHub 官方资产 API；每个请求最多尝试两次。
• 检查版本遇到上述临时服务错误时，自动重试一次。
• 更新提示区分检查版本、下载校验文件和下载安装包的失败阶段。
• 继续核对安装包大小和 SHA-256；取消下载或传输中断后清理临时文件，保留手动重试入口。
• 构建依赖通过官方资产 API 获取，固定版本 Typst 使用已核验的资产 ID、大小和哈希；API 的临时网关错误最多尝试三次。Electron 和打包工具保留原有完整性校验。

本机已通过桌面测试、发布工具回归和实际打包工具下载验证。原下载地址返回 504 时，修复后的更新器已通过官方 API 完成 Windows 安装包下载及 SHA-256 校验。正式产物由完整测试及三平台安装验证门禁生成。

旧版本更新器若仍遇到 504，请手动下载对应安装包并安装一次，以获得新的下载逻辑。

提供 Windows x64 安装版与便携版、macOS Apple Silicon DMG、Linux amd64 DEB。桌面包未签名，macOS 未公证。

Docker 正式镜像：

ghcr.io/luffysolution-svg/paperloom-app:v0.2.7
ghcr.io/luffysolution-svg/paperloom-web:v0.2.7

正式 Docker 镜像沿用 linux/amd64。附件包含完整对应源码、匹配的 PyMuPDF 1.26.5 源码、对应源码说明及 SHA-256 校验和。许可为 AGPL-3.0-only，原有 MIT 和第三方许可随包保留。

v0.2.5 · Docker 镜像对应源码

PaperLoom v0.2.5 ? Docker app/web ???????????? tag ????????????? PyMuPDF 1.26.5 ??? SHA-256 ????

?????????????????????????

Docker ???ghcr.io/luffysolution-svg/paperloom-app:v0.2.5?ghcr.io/luffysolution-svg/paperloom-web:v0.2.5?

v0.2.3 · 精简 AI 接入与翻译配置修复

本次补丁精简问答接入，恢复原有运行时配置和 OpenAI 兼容调用方式，同时保留独立的多协议翻译与已验证的对话改进。

• 移除通用 BYOA／ACP 连接中心、Agent 预设、适配器准备、认证及权限交互，以及问答侧新增的原生协议和图片输入。
• 翻译继续支持 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages，服务、模型、凭据和任务配置保持独立。
• 修复阅读器未提供模型 Key 时仍用翻译地址覆盖后端模型配置而导致的 401；Responses／Anthropic 翻译配置也不会误作问答凭据。
• 保留多轮会话、文献范围约束、原文核实、引用跳转、工具进度、用量、停止后保留部分回答、对话搜索和 Markdown 导出。原有 PDF 文档操作能力继续保留。
• 修复翻译协议选择框过窄和窄屏字段跨列裁切，保留续段误报截断及正常保留原文误报接口故障的修复。

本机已完成真实论文问答、引用跳转、流式取消，以及三种协议的实际翻译和 PDF 渲染验收。各协议分别翻译论文前 2 页，最终 PDF 保留原论文 15 页，未解决项与死信数均为零。详见验收记录。完整 CI 与三平台安装包验证门禁均已通过。

提供 Windows x64 安装版与便携版、macOS Apple Silicon DMG、Linux amd64 DEB。桌面包未签名，macOS 未公证。

Docker 正式镜像：

ghcr.io/luffysolution-svg/paperloom-app:v0.2.3
ghcr.io/luffysolution-svg/paperloom-web:v0.2.3

正式 Docker 镜像沿用 linux/amd64。附件包含完整对应源码、匹配的 PyMuPDF 1.26.5 源码、对应源码说明及 SHA-256 校验和。许可为 AGPL-3.0-only，原有 MIT 和第三方许可随包保留。

发布核验已完成：9 个附件的 GitHub 内容摘要与构建校验清单一致，公开资产下载接口已核对；完整对应源码中的 5386 个文件与发布提交逐文件一致。app/web 镜像已匿名拉取并验证就绪、同源 API、真实模型流式问答、PDF 上传下载及容器重建后的数据持久化，版本标签与 latest 指向相同内容。Web 的 edge/current 镜像也已更新，提供 linux/amd64 与 linux/arm64。

桌面构建与安装验证 · Docker 发布 · 完整变更

PaperLoom v0.2.2

PaperLoom v0.2.2 完善了 AI 对话的流式反馈、ACP 会话复用和中断恢复。

AI 对话

• 首页与阅读器统一展示按顺序到达的正文、公开思考内容、执行计划、工具调用和用量；工具输入、结果及原图可展开查看。
• ACP 进程与会话可复用，减少后续提问的初始化等待；补全授权进度、取消授权、待确认操作与刷新恢复。
• 流式更新批量渲染，上滑阅读时保持位置；停止或失败后保留已生成内容，并可重新生成。
• 支持图片上传、粘贴、拖入和历史图片追问，兼容 Chat Completions、Responses、Anthropic Messages。
• 新增对话内容查找、Markdown 导出、上下文压缩和按会话保存文献范围，改善窄屏布局。
• 修正图表读取误选公式截图的问题，图表回答可展示实际原图并回查引用。

验证

已完成配置中真实模型的 ACP/API 调用，覆盖文献阅读、原图理解、图片连续追问、停止后刷新、授权确认恢复、文献范围保留和上下文压缩。完整 CI 已通过，包括 1,982 项前端测试、394 项 AI 服务测试、Rust 工作区与离线流水线回归。

Windows、Linux、macOS 实包均通过安装后启动、AI 服务、导出及备份恢复测试。公开 Docker 镜像已完成匿名拉取、就绪检查、同源 API、真实模型流式调用和容器重建后的数据恢复验证。发布附件校验和、对应源码及最终公开历史密钥扫描均通过。

下载与部署

• Windows：x64 安装包与便携版；Linux：amd64 DEB；macOS：Apple Silicon DMG。
• Docker：ghcr.io/luffysolution-svg/paperloom-app:v0.2.2 与 ghcr.io/luffysolution-svg/paperloom-web:v0.2.2，本次提供 linux/amd64。
• Docker 连接宿主机模型网关时，需要配置容器可达且已授权的地址；仅开放回环访问的网关需另行转发，代理软件的 fake-IP 解析也需正确配置。
• 桌面包未进行代码签名；macOS 未公证。
• 附件包含完整 PaperLoom 对应源码、精确匹配的 PyMuPDF 1.26.5 源码、CORRESPONDING_SOURCE.md 和 SHA256SUMS.txt。许可为 AGPL-3.0-only，原有 MIT 及第三方许可随包保留。

完整变更

v0.2.0

PaperLoom 0.2.0

可以在首页和阅读器里使用自己已经登录的本机 Agent，也可以连接自己的模型 API。对话输入框提供统一的服务／模型菜单，历史回答保留生成时的服务和模型。

新功能

• BYOA 提供与 Agentero 对齐的 16 个 Agent 预设及自定义 ACP。Codex、Claude Code、Pi 等连接组件可在应用内准备，复用用户 CLI 的登录与配置。
• BYOK 支持 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages，覆盖问答、工具调用、流式回答和翻译。
• 设置页按品牌、安装和连接状态组织服务，常用字段优先，协议、地址和启动参数放在高级设置中。
• 每个对话独立选择服务、模型和 Agent 配置；发送时固定配置，支持取消、重试、分支及历史恢复。
• ACP 文档工具保留原文引用；多轮追问复用证据时，引用继续指向对应文档和页码。

实测中修复的问题

• Windows 的扩展路径导致 Node/npm 连接组件安装或启动失败。
• 无参数工具的空 JSON 增量导致 Anthropic 对话中断。
• 默认用户目录和过短时限影响 Agent 的文献阅读；现在使用独立会话目录，并提供独立的 BYOA 时限。
• Pi 将启动信息混入回答、取消被误报为响应中断、跨轮引用缺少跳转锚点。
• 搜索短摘要不足以核实数字、连续引用编号无法点击，以及首次对话的服务选择互相影响。
• 翻译检查将拆分后的续段误判为截断，将按策略保留的作者等内容误报为接口故障。

验证范围

在 Windows 上使用本机 Zotero 的英文论文、中文综述和补充材料完成真实 OCR、问答与译文产物验证。真实 Agent 覆盖测试机器上可用的 Codex、Claude Code、OpenCode 和 Pi；其他预设需要自行安装和登录。三种 API 协议使用用户现有的真实 API／网关完成调用。

测试机器的 Paddle Token 未授权，OCR 使用有效的 MinerU；Claude 默认线路曾触及额度限制，后续选择其已配置的 Sonnet 完成验证。本机 Claude 插件的额外登录提示由该 CLI 配置产生。

详见 BYOA / BYOK 配置 和 真实测试记录。

PaperLoom 按 AGPL-3.0-only 发布。完整对应源码、所捆绑 PyMuPDF/MuPDF 的对应源码和 SHA-256 校验和随 Release 附带；见 CORRESPONDING_SOURCE.md 与 SHA256SUMS.txt。

产物与发布验证

• Windows 安装版和便携版、Linux DEB、macOS DMG，以及对应源码与校验和均附在本页。
• Docker 镜像（linux/amd64）：ghcr.io/luffysolution-svg/paperloom-app:v0.2.0、ghcr.io/luffysolution-svg/paperloom-web:v0.2.0。
• 完整测试门禁、三平台构建与安装启动验证、Docker 构建发布。
• 本机真实验收覆盖 3 份文献的完整 60 页 OCR；三种 API 协议分别翻译前 3 页并验证 15 页 PDF 输出。四个已安装 Agent 完成问答、追问、引用与取消测试。

v0.1.17 · API 配置管理与翻译模型切换

本版本完善 API 配置管理与翻译模型选择，上传 PDF 时可以单独选择 OCR 服务、翻译服务和模型。

• 上传窗口支持按任务选择 OCR 服务、翻译服务和模型；选择配置方案只为本次任务填入配置，不会改写默认方案或 AI Agent 配置。
• 支持从服务端拉取模型，拉取成功后自动展开完整列表，可直接选择模型，也可手动输入模型名称。
• 统一模型选择框、刷新按钮和手动输入的样式，修复原生候选框只显示当前匹配模型的问题。
• 翻译服务列表展示其他受支持但尚未配置的服务，并引导通过「管理接口」完成配置。
• 设置页将「保存设置」改为「更新当前方案」，区分更新当前方案与另存为新方案，并统一翻译、OCR、AI Agent 的保存按钮样式。
• 修复配置切换时草稿、凭据清除、检测结果和模型请求状态的处理，避免使用过期结果或串用其他服务的凭据。
• OCR 检测使用当前任务所选服务的凭据；切换翻译账户后，不再沿用默认账户的余额检查。
• 桌面端私有网络 API 访问开关支持即时应用。

提供 Windows x64 安装版与便携版、macOS Apple Silicon DMG、Linux amd64 DEB。Docker 正式版 app/web 镜像为 linux/amd64；当前 Web 的 edge/current 镜像为 linux/amd64 与 linux/arm64。

ghcr.io/luffysolution-svg/paperloom-app:v0.1.17
ghcr.io/luffysolution-svg/paperloom-web:v0.1.17

前端、Rust 和 Python 全量回归均已通过。三个桌面平台完成安装后启动、AI 服务、批量导出、备份恢复和配置重载检查。Docker 正式镜像通过实际启动、同源 API、模型列表拉取、私有 API 开关即时生效、PDF 上传下载和重启持久化检查；镜像的匿名拉取权限、平台、版本和提交信息均已核对。

全部 9 个附件已下载，并分别核对 GitHub 记录的 SHA-256 与 SHA256SUMS.txt。源码包中的 5358 个文件与发布提交 76e191d11a21bb40a1535ca550b5a1928134e757 完全一致。

附件包含完整对应源码、PyMuPDF 1.26.5 对应源码和 SHA256SUMS.txt。PaperLoom 采用 AGPL-3.0-only；对应源码说明见 CORRESPONDING_SOURCE.md。

v0.1.16 · 设置交互、Markdown 预览与下载修复

修复设置与配置方案的交互反馈、OCR Markdown 预览和取消下载后的状态残留，并修正接口检测的凭据与地址处理。

• 上传弹窗的配置方案选择改为顶部横排；设置页名称输入框与操作按钮统一高度，窄窗口下自动换行。
• 保存 OCR、保存翻译 API、另存方案、重命名和删除方案增加执行中、成功与失败提示。
• 备份路径隐藏 Windows 内部长路径前缀，支持完整换行与文本选择。
• 五个文件下载图标显示悬停和键盘聚焦说明，修复提示被弹窗遮挡和切换滞留。
• 切换翻译服务后，空 Key 的检测不会再借用上一服务的 Key；修改 Token、地址或模型后，旧检测结果不会覆盖当前状态。
• 填写完整 /chat/completions 地址时，接口检测与实际翻译使用一致的地址处理。
• 从「文件 → OCR 与结构化 → Markdown → 查看」打开阅读器时，使用正确的 OCR Markdown 与图片地址。
• 取消保存对话框后关闭下载状态提示、停止读取响应并恢复下载按钮；术语表导出取消时也不再显示成功。

本版本提供 Windows 安装版与便携版、macOS DMG、Linux DEB，以及 Docker app / web 镜像。

平台范围与上一版一致：Windows x64、macOS Apple Silicon、Linux amd64；正式 Docker app/web 镜像为 linux/amd64，当前 Web 的 edge/current 镜像为 linux/amd64 与 linux/arm64。

ghcr.io/luffysolution-svg/paperloom-app:v0.1.16
ghcr.io/luffysolution-svg/paperloom-web:v0.1.16

主分支与发布标签对应的六个 GitHub Actions 工作流已全部通过。三个桌面平台均通过安装后启动、AI 服务、批量导出、备份恢复和配置重载检查。正式 Docker 镜像通过匿名访问、版本与提交身份、实际启动、同源 API、上传和重启持久化验证；当前 Web 双架构镜像的提交与界面版本均已核对。

全部 9 个附件已重新下载，并分别核对 GitHub 记录的 SHA-256 和 SHA256SUMS.txt。源码包中的 42 个变更文件与提交 b14942a9d2f1a870cc4fcbffd66b6bec36fbcade 完全一致。

附件包含完整对应源码、PyMuPDF 1.26.5 对应源码和 SHA-256 校验和。桌面包未签名，首次启动可能需要按操作系统提示允许运行。

PaperLoom 采用 AGPL-3.0-only；对应源码说明见 CORRESPONDING_SOURCE.md，文件完整性见 SHA256SUMS.txt。

v0.1.15 · OCR 凭据修复与配置方案

修复首次同时配置 MinerU、Paddle 与翻译 API 后，保存时丢失另一套 OCR Token 的问题，并增加可切换的服务配置方案。

• OCR、翻译 API 和 AI Agent 支持分别保存，底部「保存设置」统一保存当前设置。
• 配置方案支持自定义命名、另存为、更新、重命名和删除；更换 Key 后可以保留原方案。
• 翻译窗口和主页 AI 问答支持一键切换方案。
• 修复设置首开时重复回填覆盖输入的时序问题，并更新视觉回归检查。

本版本提供 Windows 安装版与便携版、macOS DMG、Linux DEB，以及 Docker app / web 镜像。桌面附件包含完整对应源码、PyMuPDF 1.26.5 对应源码与 SHA-256 校验和。

Docker：

ghcr.io/luffysolution-svg/paperloom-app:v0.1.15
ghcr.io/luffysolution-svg/paperloom-web:v0.1.15

本标签的 GitHub Actions 已全部通过。Windows、macOS、Linux 安装包均通过安装后启动、AI 服务、批量导出和备份恢复检查；发布的 Docker 镜像通过实际启动、API、上传导出、配置方案备份与重启持久化验证。全部 9 个附件已重新下载并核对 SHA-256，对应源码中的修复文件与发布标签一致。

桌面包未签名，首次启动可能需要按操作系统提示允许运行。

PaperLoom 采用 AGPL-3.0-only；对应源码说明见附件 CORRESPONDING_SOURCE.md，文件完整性见 SHA256SUMS.txt。

v0.1.14 · 完整密钥备份、WebDAV 同步与批量导出

v0.1.14 · 完整密钥备份、WebDAV 同步与批量导出

• 修复勾选“包含模型密钥与 Agent 配置”时，OCR 和翻译接口密钥未随迁移包恢复的问题；同时保留多模型配置。
• 新增将 WebDAV 远端备份同步到本地备份列表的操作。
• 备份打包、导入、上传、下载和校验显示当前状态与进度。
• 文献库支持批量导出：仅译文 PDF、对照 PDF、原文 PDF、OCR Markdown、Obsidian 笔记包。
• 每篇文献使用独立目录和附件名称，避免同名文献、图片和 Obsidian 链接相互覆盖；部分文献导出失败时保留成功结果并提供清单。
• Windows、macOS、Linux 发布流程增加最终安装包启动、AI 服务、批量原文导出及备份导入重启后的密钥恢复验收。

旧备份如果没有保存 OCR/翻译密钥，无法从该旧文件补回；请在原设备使用新版重新导出一次。

Windows 提供安装版和便携版，macOS 提供 DMG，Linux 提供 DEB，同时发布 Docker app/web 镜像。

PaperLoom 使用 AGPL-3.0-only 许可。随附完整对应源码、PyMuPDF/MuPDF 对应源码、许可说明与 SHA256SUMS.txt。

v0.1.13 · WebDAV 修复与备份管理

修复坚果云 WebDAV 能连接却无法上传备份的问题。填写 https://dav.jianguoyun.com/dav 后，应用会使用并按需创建 PaperLoom 备份文件夹；自定义文件夹地址继续保留。

• 本地与云端备份均可删除，删除前需再次确认，分别保留另一位置的副本。
• 桌面版可打开备份文件夹、定位指定 ZIP、打开恢复前保留的数据目录。
• 显示实际云端位置，可复制文件夹及单个备份的地址。
• 上传失败时刷新并保留本地迁移包，明确提示权限、空间、文件大小和限流等错误。

已使用真实 Windows 桌面版与坚果云完成 182.5 MiB 完整资料库备份，重新下载的 SHA-256 与本地一致；云端恢复、重启后恢复、删除与取消删除均通过验证。原有备份与 PDF 保持不变。

Windows x64 安装版/便携版、Linux x64 DEB、macOS ARM64 DMG 和 Docker 发布由 GitHub Actions 验收。完整对应源码和 PyMuPDF/MuPDF 对应源码随版本提供；安装包校验见 SHA256SUMS.txt，许可证与源码说明见 CORRESPONDING_SOURCE.md。