SwiftLib 1.3.0

SwiftLib 1.3.0

发布日期：2026-04-29

重点更新

• 新增 OCR Markdown 连续翻译：扫描版 PDF OCR 后，可通过现有 AI 助手窗口自动分批翻译整篇文档，并生成原文 + 小字译文的双语 Markdown。
• 新增可定制翻译 Prompt 和更宽容的译文解析器，能处理代码块 JSON、尾逗号、智能引号、标签式译文、纯文本译文和部分截断结果。
• 新增多源元数据管线：CrossRef、OpenAlex、Semantic Scholar、Open Library、Google Books、豆瓣读书、CNKI 与百度学术可按场景路由、并发抓取和字段级合并。
• 新增 JSON site adapter runtime，内置多个学术站点/API 适配器，并提供 adapter schema 与修复指南。

改进

• AI 助手现在会等待回复稳定后再抓取结果，减少“模型停顿一下就被当成结束”的误判。
• 待确认元数据窗口改为更平面的视觉样式，移除割裂的顶部条幅。
• OCR Markdown 渲染增强了 HTML 表格、上下标和论文片段的处理。
• Word 插件和本地服务的文档扫描、引用渲染、任务窗格交互更稳。
• 批量导入加入持久缓存、请求合并、限速和熔断，降低重复请求和上游失败影响。

修复

• 修复 DOI 末尾大写校验字符被强制小写的问题。
• 修复 AI 网页 selector 改版后可能无法注入、无法发送或无法抓回回复的问题。
• 修复 AI 返回 JSON 尚未完整时被提前解析导致“没有合法 JSON”的问题。

验证

• swift build
• swift test --filter ImporterAndMetadataTests
• 新增 OCR 翻译、AI 回复稳定性、site adapter、元数据验证和真实参考文献规则相关测试。

SwiftLib 1.2.1

SwiftLib 1.2.1

发布日期：2026-04-17

修复

• 修复 AI 助手在未登录、页面仍在加载、发送按钮不可用或页面脚本卡住时可能一直转圈的问题；现在会主动诊断页面状态并给出明确提示。
• 修复 AI 助手在页面加载失败或 Web 内容进程终止后缺少可见反馈的问题；现在窗口顶部会显示加载失败或操作失败状态。

验证

• 新增 AI 页面状态诊断测试，覆盖未登录、页面加载中、发送按钮不可用和未开始回复等关键场景。

v1.2.0

v1.2.0 — 2026-04-17

新增

• 新增 AI 助手独立窗口，支持 ChatGPT、豆包、Kimi、DeepSeek 多服务切换。
• 新增基于 DOM 选择器配置的 AI 输入注入与回复抓取能力，可直接从阅读器选区发起翻译或问答。
• 新增 PDF OCR 能力，支持通过 PaddleOCR 将扫描版 PDF 识别为 Markdown，并在阅读器中直接查看结果。
• 新增正式的设置窗口，集中管理通用选项、插件安装状态和 AI 服务配置。
• 新增 AI DOM 选择器远程配置服务，支持从 GitHub 拉取最新选择器定义并缓存到本地。

改进

• 重构文献列表加载链路，改为轻量行模型、总数观察和分页加载，降低大库场景下的内存与刷新成本。
• 优化 CNKI 页面解析与检查节奏，减少无效等待，并通过复用隐藏 WebView 降低解析开销。
• 为翻译后端预热启动、Word/WPS 插件服务、OCR 调用等路径补齐更清晰的运行时边界。
• 将 CLI、Word/WPS 插件和主应用的若干版本化发布入口整理为更一致的发布流程。

修复

• 修复数据库初始化失败后“提示可继续、实际后续崩溃”的问题；现在会明确降级到临时内存数据库会话。
• 修复文献列表分页在滚动触发时可能重复追加相同页面数据的问题。
• 修复翻译后端握手与关闭路径中的 Swift 并发告警，避免后续 Swift 6 模式下升级为硬错误。
• 修复 OCR Token 明文存储在 UserDefaults 的问题，改为迁移并存储到系统 Keychain。

安全

• 为 Word / WPS 本地 HTTP 服务增加 bearer token 鉴权，并收紧 CORS 允许范围。
• 为引用文档渲染接口增加结果缓存失效机制，降低重复请求时的暴露面与无效计算。

SwiftLib v1.1.1

v1.1.1 — 2026-04-13

修复

• 修复 CLI 工具安装到 /usr/local/bin 时因权限不足直接失败的问题；现在会在需要时自动弹出 macOS 管理员密码窗口完成安装
• 修复 CLI 工具卸载在提权安装后可能无法删除的问题；现在会在需要时同样请求管理员授权

兼容性

• 补齐缺失的 onboarding 兼容层，恢复当前工作区的可编译状态，避免热修复版本被无关残留代码阻塞

验证

• CLIInstallerTests：11/11 通过
• 当前工作区 swift build 通过

SwiftLib v1.1.0

v1.1.0 — 2026-04-12

新增

• 增加 WPS Office 插件安装器、资源打包与任务窗格支持
• 增加 Sparkle 自动更新接入、appcast 生成脚本和 GitHub Pages 发布流程
• 增加阅读器操作条自适应布局与对应测试

改进

• 重做 PDF / 网页阅读器的悬浮操作条布局与窗口默认尺寸
• 优化标注侧边栏和网页标注卡片的悬停交互、完整笔记预览与滚动稳定性
• 引用渲染支持按需跳过 bibliography，并降低 JSContext 池上限以控制内存

清理

• 移除尚未定稿的新手引导实现
• 删除旧的阅读器实现说明文档和 PROMO.md

WPS 插件修复

• 修复任务窗格冻结问题（原生 select 替换为自定义 HTML 菜单）
• 修复插入引文后上角标溢出
• 修复插入引文后焦点跳回搜索框
• 添加样式切换空操作防抖

服务器增强

• 新增 /api/wps/focus-bounce 焦点往返接口
• 新增 /api/perf-log 性能日志接口
• 新增 /wps/* 静态文件路由
• render-document 接口支持 includeBibliography 参数

详见 CHANGELOG.md

SwiftLib v1.0.0

SwiftLib v1.0.0 首次发布

下载

• SwiftLib-1.0.0-apple-silicon.dmg — macOS Apple Silicon (arm64)