Stirling-PDF v2.0.1 hotfix for desktop application, web ui and various issues¶

为什么要使用Stirling-PDF¶

你是否曾被困在PDF的牢笼中？那些无法编辑的合同、杂乱无章的扫描件、急需合并却无从下手的报告……我们每天都在与这种“数字纸张”搏斗。你或许尝试过各种在线转换器，却在隐私泄露的担忧中迟疑；或者购买了昂贵的专业软件，却发现它笨重得如同恐龙。这就是我们共同的矛盾：在需要极致便捷与必须坚守数据安全之间，我们被迫做出选择，而往往两者皆失。

直到 Stirling-PDF 的出现，它打破了这令人疲惫的僵局。它并非另一个索求你文件或订阅费的服务，而是一把交到你手中的钥匙。将自由与掌控权彻底还给你，这正是你必须使用它的理由——你值得拥有一件完全受你支配、为你服务的工具，告别妥协，重新成为你数字文档的主人。

Stirling-PDF是什么¶

简单来说，Stirling-PDF 是一款功能强大的开源PDF工具包。你可以把它想象成一把数字瑞士军刀，但它不是装在口袋里，而是运行在你自己的电脑或服务器上。它提供了通过网页浏览器即可使用的友好界面，能完成PDF的合并、分割、转换、加密、解密、水印、OCR识别等数十种操作。因为它是自托管的，所以你的所有文件数据都无需离开你的设备，安全和隐私得到了根本保障。

入门示例¶

想象一下，你是一位独立开发者小林，正准备为客户交付项目文档。你手头有十多个独立的PDF章节、几张扫描的签名页和一份需要保护的合同。 deadline迫在眉睫。

传统炼狱： 你打开多个在线转换网站，逐个上传文件，焦急等待处理，担心客户信息泄露。合并顺序出错，又得重来。扫描件无法搜索，你还需要另一款OCR软件……时间一分一秒流逝在繁琐的操作与切换中。

Stirling-PDF之道： 小林在本地电脑上通过Docker快速部署了Stirling-PDF（只需一行命令：docker run -d -p 8080:8080 frooodle/s-pdf:latest）。随后，他打开浏览器访问 http://localhost:8080。

合并与整理： 在“合并PDF”页面，他将所有章节PDF拖入，通过直观的界面调整顺序，一键生成整齐的完整手册。
OCR识别： 在“OCR PDF”页面，上传扫描的签名页，片刻之后，扫描件变成了可复制、可搜索的文本。
安全保护： 最后，在“保护PDF”页面，为最终的合同文档添加了密码加密。所有操作都在本地网络瞬间完成，原始文件从未上传至未知的云端。小林不仅高效完成了工作，更赢得了客户对数据安全的绝对信任。这就是Stirling-PDF在真实世界赋予个体的力量与宁静。

Stirling-PDF v2.0.1 版本更新概要¶

此版本是一个热修复版本，主要解决了v2.0.0中发现的几个关键问题，旨在提升稳定性和用户体验。具体更新包括：恢复了传统单一JAR包的发行方式，便于部署；新增了不包含前端代码的 -Server.jar 包；修复了桌面安装版中的CORS错误及一系列连接与加载问题；调整了暗色模式下部分UI组件的样式；并修正了多处用户界面提示信息显示顺序错乱的问题。

更新日志¶

这是一个热修复版本，旨在解决我们在 v2.0.0 版本中发现的问题（关于v2.0.0的说明请查看此处）。

修复的主要问题包括：

将前端代码重新加入JAR包中，以恢复以往易于部署的单一JAR包模式。
新增了新的 -Server.jar 包，此JAR包不包含额外的前端代码。
修复了桌面安装程序中的CORS错误以及连接和加载/刷新方面的各种其他问题。
修复了暗色模式下某些UI组件的样式问题。
修正了多处UI提示信息显示顺序不正确的问题。

仍在处理中的问题：

某些SSO（单点登录）提供商在V2版本中无法正常工作。
V2版本对使用自定义URL子路径（例如 website.com/pdf）的用户尚未完全支持。
部分用户的旧版配置未能正确迁移。我们正在优先处理这三个问题，预计很快会发布相关修复版本。

次要功能增强¶

修复了桌面应用程序中的CORS问题。
在初始化引导界面隐藏了横幅提示。
构建了自定义JAR包。

Docker 更新¶

发布了GitHub Actions工作流。

其他更改¶

修复了使用默认凭证进行首次设置时的文本颜色问题。
将Posthog变量直接添加到了代码中。
修复了自托管桌面版上的登录循环问题。
重新生成了翻译文件。
进行了多项Cookie横幅提示的修复。

完整更新日志： v2.0.0...v2.0.1

总结¶

总而言之，本次v2.0.1热修复更新迅速响应了用户反馈，核心目标是**恢复简便的部署方式**并**解决桌面版与UI层的突出痛点**，如CORS错误、登录循环和界面显示错乱，确保了主版本升级后的基础体验稳定。同时，它也坦诚列出了单点登录、自定义路径支持等仍需优先攻克的遗留问题，展现了项目持续改进的清晰路径。