LaTeXSnipper Final Stable：稳定版本

LaTeXSnipper Final Stable 发布日志

Code signing / 代码签名

Windows release binaries for LaTeXSnipper are code-signed with support from the SignPath Foundation for code signing.

LaTeXSnipper 的 Windows 发布文件使用 SignPath Foundation 提供的代码签名支持。

https://signpath.org/

LaTeXSnipper 走到 Final Stable，已经不再只是一个“截图公式转 LaTeX”的小工具。它现在更像是一个围绕数学内容的桌面工作台：从截图、图片、PDF、手写输入中识别数学内容，再继续编辑、计算、排版、导出，最终服务于学习、科研、写作和资料整理。

这个项目最开始只是为了解决我自己在学习和写作中反复遇到的公式输入问题。后来它一点点长出了更多能力：截图框选识别、图片识别、PDF 识别、外部模型接入、系统托盘、多屏幕适配、深浅色主题，以及更完整的结果编辑和导出体验。很多功能并不是一开始就规划好的，而是在真实使用、反复测试和不断修 bug 的过程中逐渐补上的。

由于接下来我要准备考研，LaTeXSnipper 将停止常规功能更新和版本迭代。也就是说，我不会再像之前一样持续添加新功能、频繁调整架构或推进新的大版本。但这并不代表项目被彻底放下：如果后续出现影响正常使用的 bug、兼容性问题，或者有明确、可复现、确实重要的 issue，我仍会在能力范围内继续修复。

感谢所有使用、测试、反馈和关注这个免费开源软件的朋友。你们在真实场景中遇到的问题和提出的建议，推动了它从一个简单工具变成现在这个更完整的数学内容工作台。希望 LaTeXSnipper 在之后仍然能继续帮到需要整理公式、识别文档、书写数学内容的人。

如果这是一个阶段性的告别，那我希望它停在一个稳定、完整、能继续被使用的位置。

愿每一份坚持都有回响，每一次深耕都有收获，也愿LaTeXSnipper，能继续成为你学术与学习路上的得力伙伴。

---

目前该软件已经重构，使用内置模型MathCraft OCR，具体效果看 https://github.com/SakuraMathcraft/MathCraft-Models 。

软件完整部署需要的最小磁盘空间为2GB，LaTeXSnipperOffline.exe为离线版，即内置了MathCraft模型，打开即用；LaTeXSnipper.exe为轻量包版本，首次打开软件需要联网预热模型。

更新日志

• 2026/4/27：补上cuda/cudnn的诊断日志
• 2026/4/28：更新器体验优化
• 2026/5/1：截图功能增强

LaTeXSnipper v2.3.2：预热修复/拓展屏识别

LaTeXSnipper v2.3.2 发布日志

修复

• 修复新版 Qt/PyQt6 组合下 Fluent 下拉框出现玻璃容器效果、圆角与弹出层表现不稳定的问题。
• 修复日志 GUI 在部分环境中无法打开、日志文件被占用时初始化失败的问题，并增加备用日志路径。
• 修复 torch 初始化失败时错误提示过度归因为 VC++ 运行库的问题，区分未安装、二进制依赖加载失败和版本/轮子不匹配等场景。
• 修复系统托盘菜单左侧预留空间过宽、悬停反馈不明显和二级菜单指示样式不协调的问题。
• 修复无历史记录时左侧历史区域被底部长按钮文案撑宽，导致右侧编辑区被挤压的问题。
• 修复扩展屏截图识别区域错位的问题：框选坐标改为使用鼠标全局坐标，再映射到目标屏幕截图区域。#77 #76 #1 (comment)

优化

• 优化程序的启动速度，更早显示splash进度窗口。
• 优化启动 splash 生命周期：静默复核依赖时保持显示，只有目录选择、依赖向导或安装进度窗口真正出现前才隐藏。
• 优化未固定识别结果窗口在下一次截图识别时需要手动关闭的问题，现在会在新识别开始时自动隐藏，并在识别完成后显示新结果。
• 优化历史公式右键菜单顺序为“编辑、复制、收藏、导出为、重命名、删除”，更贴近常用操作路径。
• 优化历史公式列表，每条记录右侧只保留“复制”按钮，收藏和删除移入右键菜单，减少横向拥挤。#1 (comment)
• 优化GPU层的依赖安装顺序。
• 优化依赖向导验证逻辑，CORE 层增加 pix2text CPU/ONNX 可用性复核，安装成功与预热成功之间的风险提示更明确。
• 优化安装包体积，绿色/可移植。
• 优化多屏截图识别模式，托盘菜单会根据当前屏幕列表刷新，支持扩展屏选择。
• 优化固定屏幕截图模式的反馈：框选屏幕与托盘所选屏幕不一致时，在主窗口提示应选择的屏幕；移除冗余的“记住上次使用的屏幕”开关。
• 优化主窗口文件拖拽体验：支持拖入图片直接识别，拖入 PDF 直接进入 PDF 识别流程并提示切换到混合模式。

升级建议

• 建议 v2.3.x 用户升级到 v2.3.2，尤其是遇到模型预热失败、启动速度缓慢、torch 错误提示不准确和拓展屏识别错位的用户。
• 如果升级后依赖状态异常，可从设置页重新进入依赖向导执行强制校验；程序会重新复核已安装功能层并提示需要修复的层。

LaTeXSnipper v2.3.1：双语阅读/安装包瘦身

LaTeXSnipper v2.3.1 发布说明

本版重点：双语阅读

• 主窗口新增 双语阅读 入口
• 补充在线翻译接口切换能力
  • 新增 Azure Translator
  • 新增 Google Cloud Translation
  • 新增 DeepL API Free

自动排版窗口补强

• 自动排版窗口新增源码搜索条
  • 支持 Alt+F 打开搜索
  • 支持 F3 / Shift+F3 前后跳转
• 编译策略优化
  • 编译错误不再直接阻断 PDF 预览
  • 有新 PDF 就更新，没有新 PDF 就保留上一版
  • 错误与警告单独在日志区展示

小优化 / 错误修复

• 更新窗口改为尽量使用原生 Fluent / Qt 主题，仅保留日志 HTML 最小样式
• 预热失败现在有更详细的报错日志，修复pix2text返回空对象#83
• 全局截图热键在存在模态 / 阻塞窗口时会直接返回，并轻提示先关闭对话框，避免误触导致界面卡死，彻底解决 #51

LaTeXSnipper v2.3：自动排版手写文档（不推荐）

LaTeXSnipper v2.3 发布说明

发布日期：2026-04-05

本版重点：自动排版编译 PDF

• 自动排版窗口支持稳定的 PDF 编译预览
  • 源码区（TeX）编辑后可直接编译并刷新右侧 PDF
  • 编译状态、失败提示、导出流程
• 源码与 PDF 双向联动增强
  • PDF 位置可反向定位到源码行（SyncTeX edit）
  • 源码行可正向跳转到 PDF 对应位置（SyncTeX view）
• 跳转高亮反馈可视化
  • 源码跳 PDF 后，目标位置显示蓝色高亮带

视觉/性能优化

• Poppler 预览性能优化
• 放大镜渲染链路优化（Poppler/Fitz）
• 主窗口实时预览公式增大1.4倍，显示更清晰
• 依赖管理页面适配原生Fluent深/浅主题
• 跟随系统模式下可实时切换主题
• 优化paflatex/xelatex渲染性能 #64
• latex渲染引擎改为异步加载，不再阻塞主线程UI

修复了什么

• 修复/优化了用户反馈 #64
• stabilize preview/render pipeline and 清理不必要的引擎切换下拉框，同步infobar提示内容
• 放大镜交互稳定性修复
• PDF 跳转infobar反馈，高亮带位移修复

LaTeXSnipper v2.2.1：优化手写识别（不推荐）

LaTeXSnipper v2.2.1 更新日志

发布日期：2026-04-03

本版重点

1. 手写识别体验优化

• 重构手写画布交互模型：
  • 左键只在安全书写区内工作
  • 缓冲区禁止左键书写
  • 右键负责主动拖动画布
• 安全书写区与缓冲区改为基于当前可见视口动态计算
• 缓冲区增加可视化提示，并随窗口大小、缩放、滚动和分栏比例动态刷新
• Ctrl + 滚轮 改为以鼠标指针为锚点缩放，提升局部放大/缩小定位体验
• 自动聚焦与右键拖动画布不再冲突：
  • 可先手动拖到合适位置书写
  • 停笔稳定后再自动回到内容重心
• 自动聚焦触发时机延后，避免连续书写过程中抢视图
• 手写窗口“插入”后不再关闭窗口，当前内容会保留，便于继续修改

2. 手写结果展示优化

• 手写结果预览支持多行混合内容渲染
• 文本行与数学行按启发式规则分块显示
• latex 模式下按行去除多余的外层 $$ / \[ \] / \(...\) 包裹
• 预览区改为文档流布局，长内容可滚动查看

3. 识别结果与历史记录体验优化

本优化建议来自 #62

• 识别结果窗口新增直接导出入口，不必回主窗口再操作
• 识别结果窗口新增别针功能，可以固定为置顶悬浮小窗
• 历史记录新增顺序切换：
  • 最新在前
  • 最早在前

LaTeXSnipper v2.2：接入外部大模型

LaTeXSnipper v2.2 发布说明

发布日期：2026-04-01

主要细节

1. 外部模型全链路接入

• 图片 / 截图识别支持 external_model
• PDF 识别支持外部模型分流，包含进度、取消、结果聚合
• 手写识别支持外部模型分流

2. 文档解析能力扩展

• 新增文档聚合管线 document_pipeline
• PDF 外部模型流程固定为整份文档解析
• PDF 入口支持导出格式选择与 DPI 滑动条调节
• PDF 导出模板重写，Markdown 保留结构层级，LaTeX 模板补齐 ctex、图表和 tikz / tikz-cd 支持

3. 协议与配置能力

• 支持 Ollama、OpenAI-compatible、MinerU
• 设置页支持协议化配置、推荐预设、测试连接、教程说明
• GLM-OCR 预设默认按 Ollama + http://127.0.0.1:11434 配置，默认输出偏好为 latex

关键优化与修复

（ 已修复#51 ）

LaTeXSnipper v2.1：新增手写识别功能（不推荐）

LaTeXSnipper v2.1 更新说明

发布日期：2026-03-30

主要更新

优化主题 #27

1. 独立手写识别窗口

• 新增独立的“手写识别”窗口，可从主窗口直接打开。
• 手写识别窗口与主窗口解耦，可独立存在、单独最小化，不依附主窗口关闭。
• 识别结果可直接插回主编辑器，也可单独复制 LaTeX。

2. 手写画布与工具链落地

• 新增书写、橡皮、圈选修正、清空、撤销、重做等基础工具。
• 支持鼠标与触控笔输入，书写工具、橡皮工具已适配对应光标。
• 当前工具状态提供明确高亮，深色/浅色主题均可识别。

3. 画布交互显著增强

• 画布支持自动延展，并改为滚动画布模型，不局限于固定首屏区域。
• 支持 Ctrl + 滚轮 缩放画布视图。
• 支持关闭自动聚焦后使用鼠标右键拖动画布。
• 修复缩放后继续书写导致画布逻辑尺寸异常、露白的问题。

4. 手写识别结果联动预览

• 停笔后自动调用现有识别引擎。
• 右侧提供 LaTeX 结果 与 实时预览 双区域。

5. 主界面入口与布局整理

• 主工具栏调整为更合理的识别入口顺序：图片识别、PDF 识别、手写识别。
• 移除低频的顶栏收藏入口，收紧主界面按钮布局。
• 主窗口版本号与打包资源已同步更新到 v2.1。

LaTeXSnipper v2.0：进入桌面数学工作台阶段（不推荐）

LaTeXSnipper v2.0 发布正式版本

发布日期：2026-03-25

主要更新

1. 数学工作台正式引入

• 新增独立的“数学工作台”窗口，不再把公式编辑强行塞回主界面。
• 工作台支持单独打开、关闭、拖动和主题切换，不依附主窗口布局。
• 识别结果可一键载入工作台，编辑完成后再写回主编辑器。

2. MathLive 公式编辑器接入

• 工作台内嵌 MathLive math-field，提供结构化数学输入体验。
• 支持内置 Math Virtual Keyboard，适合鼠标点击录入和公式模板编辑。
• LaTeX 输入、实时渲染、MathJSON 展示已经联通。

3. 常用计算动作可用

• 支持 计算
• 支持 化简
• 支持 数值化
• 支持 展开
• 支持 因式分解
• 支持 求解
• 支持 积分
• 支持 极限
• 支持 级数

LaTeXSnipper v1.06：优化启动速度

LaTeXSnipper v1.06 更新说明

发布日期：2026-03-25

主要更新

1. 启动性能优化

• 启动阶段的模型预热调整为后台异步执行，主窗口可更快进入可用状态。
• 启动提示窗口文案改为反映真实流程，避免“正在初始化模型”这类过时提示。
• 优化状态栏模型状态展示，区分“预热中”“已加载”“未就绪”等阶段。

2. 主题切换与深色模式适配

• 补齐主窗口内部分提示文案、公式标签提示文字的深浅色适配。
• 检查更新窗口增加主题切换支持，深色模式下背景、正文、链接和提示文字可正常阅读。
• 依赖环境选择窗口适配深色模式，并统一按钮、复选框高亮色到主窗口主题体系。
• 多处原先固定浅色样式的界面元素已改为跟随当前主题动态切换。

3. 交互体验优化

• 快捷键设置窗口改为独立非阻塞窗口，交互方式与设置窗口保持一致。
• 快捷键设置成功、格式错误、历史记录为空、收藏夹为空等提示统一改为 InfoBar，减少阻塞式弹窗打断。

LaTeXSnipper Tauri Client v0.1.0（rust重构版本，不推荐）

LaTeXSnipper Tauri Client v0.1.0

Release Date: 2026-02-25

Summary

This release provides the first installable Tauri client for LaTeXSnipper, backed by the local Python daemon RPC pipeline.

Highlights

• Migrated UI shell to Tauri client with Acrylic/Mica visual modes.
• Added compact window mode with:
  • reduced footprint,
  • always-on-top behavior,
  • live recognition preview area under the title.
• Added global hotkey capture flow and image recognition task polling.
• Added PDF task flow with page limit, DPI control, and Markdown/LaTeX export.
• Added environment page for dependency-layer installation tasks:
  • BASIC, CORE, HEAVY_CPU, HEAVY_GPU,
  • progress polling and cancellation.
• Added task/result feedback pills and improved non-blocking task interactions.
• Added auto-copy behavior for image recognition LaTeX output on success.

Notes

• DPI is active and passed into PDF rasterization.
• Document template selection is active at export/wrapping stage.
• Build currently validated on Windows host.

Build Commands

Use native builds on each target OS (recommended).
Working directory below assumes:

cd E:\LaTexSnipper\apps\tauri-client\src-tauri

1) Build release executable only (no installer)

cargo tauri build --no-bundle

Output:

• target\release\latexsnipper-tauri-client.exe

2) Windows installers

MSI:

cargo tauri build --bundles msi

NSIS:

cargo tauri build --bundles nsis

Both:

cargo tauri build --bundles msi,nsis

Outputs:

• target\release\bundle\msi\...
• target\release\bundle\nsis\...

3) macOS (run on macOS host)

Apple Silicon:

cargo tauri build --target aarch64-apple-darwin

Intel:

cargo tauri build --target x86_64-apple-darwin

Universal:

cargo tauri build --target universal-apple-darwin

4) Linux (run on Linux host)

cargo tauri build

Optional bundle selection (depends on distro toolchain availability):

cargo tauri build --bundles appimage,deb,rpm

Prerequisites Checklist

• Rust + Cargo
• cargo-tauri CLI
• Node.js (if frontend rebuild is needed before packaging)
• Platform-specific packaging toolchains:
  • Windows: WiX/NSIS (auto-downloaded by Tauri unless pre-cached)
  • macOS: Xcode command line tools
  • Linux: distro packaging dependencies for deb/rpm/appimage

Known Constraints

• Some runtime features (global hotkey/capture behaviors) are currently optimized for Windows path first.
• Cross-platform feature parity should be verified per OS before public release.