ClariRec 内置设备端公式识别引擎(基于 GLM-OCR;合格设备每个自然月免费 20 次,Pro 不限次数),可将截图中的印刷数学公式转换为标准 LaTeX 源码,全程在 Mac 本机离线运行。无需 API Key、无需账号、不消耗云端额度。
本页聚焦于本地离线引擎的配置与使用。识别后的校正、复制为 Word 公式、导出片段与 PNG,以及本地与云端引擎的对比,请参阅 Mac 截图转 LaTeX 教程。
工作流程(从截图到可用的公式)
- 按下
⌥S,紧贴印刷公式框选屏幕区域。 - 在结果窗口点击识别公式。
- GLM-OCR 通过 Metal 在你的 Mac GPU 上完成识别(约 2 秒,零网络请求)。
- 核对 KaTeX 预览。哪个符号不对,点击显示公式编辑器直接改 LaTeX 源码,预览随输入实时更新。
- 打开复制或导出公式:要进 Word 选复制为 Word 公式;Overleaf 与 Markdown 笔记用原始 LaTeX 或
$…$/$$…$$;也可以导出.tex/ Markdown 片段或透明 PNG。
截图、识别、校正、复制、导出,整条链路留在本机。只有识别本身计入每月额度。
GLM-OCR 是什么
GLM-OCR 是 ClariRec 内置的设备端公式识别引擎:
- 模型:GLM-OCR,Q8_0 量化;模型权重 MIT 许可
- 大小:两个文件,合计约 1.34 GB(一次性下载)
- 离线:下载后不需要网络——不需要 API Key,不需要云账号
- 渲染:LaTeX 在本地用 KaTeX 预览;渲染本身不走网络
- 内存管理:空闲 5 分钟后自动卸载;系统内存紧张时提前卸载
硬件要求
| 要求 | 说明 |
|---|---|
| 芯片 | Apple 芯片(M1 及以上) |
| 内存 | 16 GB 及以上 |
| macOS | 14 及以上 |
| 购买 | 不需要——每月免费 20 次,Pro 不限次数 |
为什么需要 Apple 芯片 + 16 GB
本地引擎通过 Metal 跑在 Apple 芯片的 GPU 上。在 Intel Mac 或内存不足 16 GB 的机器上,识别只能走 CPU,每次约需 15 秒(Apple 芯片上约 2 秒),模型还可能在识别中途因内存不足被系统回收。在这些 Mac 上,本地引擎面板会说明是哪一条要求不满足,并禁用下载。
这类 Mac 仍可通过 BYOK 云端引擎 使用公式识别——任何运行 ClariRec Pro 的 Mac 配上有效 API Key 即可。
下载与配置
- 打开 设置 → 引擎,选择公式识别分段。
- 点击列表中的本地公式引擎。
- 点击下载模型。两个文件分别显示进度。
- 等待下载完成。支持断点续传,下载后做 SHA-256 校验。
- 两个文件都就绪后,本地引擎即可离线使用。
自动模式下,只要本地模型已下载就优先使用它;想改用云端引擎,在公式识别引擎里选中即可。模型可在同一面板删除。
中国大陆 App Store 账号下载时自动走 ModelScope(魔搭)镜像,速度更快;镜像失败时回退 Hugging Face。
想先看看识别结果长什么样?设置 → 引擎 → 公式识别 → 公式示例,任何 Mac 都能打开 5 个内置公式。
隐私边界
| 项目 | 本地(GLM-OCR) |
|---|---|
| 何时离开本机 | 永远不会(模型下载后) |
| 发往何处 | 不发往任何地方 |
| LaTeX 渲染、编辑、复制与导出 | 在本机完成,不走网络 |
| ClariRec 服务器 | 不接收——ClariRec 不运营接收截图或文本的服务器 |
| API 费用 | 无 |
截图不离开设备。每月额度记在本机钥匙串里,只有月份和次数,不含图像、公式或设备标识。无遥测,无分析 SDK。完整隐私 / 联网边界表见 macOS 本地 OCR。
切换到云端引擎
如果你想试其他模型,或者设备不满足硬件要求,可以切换到 BYOK 云端引擎:
- 支持的引擎:Custom Vision API / Custom API、通义千问(Qwen)
- 会变的:截图发送到你配置的端点,由该服务商计费;需要 Pro
- 不变的:预览、校正、复制与导出仍在本机完成;ClariRec 仍不通过自营服务器中转
在 设置 → 引擎 → 公式识别 的公式识别引擎里选择。详见 截图转 LaTeX — 云端引擎。
提高识别质量的技巧
- 框选尽量紧——避免同一选区里混入大段正文
- 优先使用清晰、对比度高的印刷公式,而非模糊手机照片
- 大图(超过约 2560×1440)会自动缩放
- 小错直接在公式编辑器里改;错得离谱就调整选区重新识别
故障排查
本地引擎下载不了 面板里会写明原因:需要 Apple 芯片 + 16 GB 内存。其他 Mac 请使用 BYOK 云端引擎。
模型下载卡住或失败 检查网络连接。下载会从中断处继续。中国大陆 App Store 账号应会自动走 ModelScope 镜像;如果两个源都失败,请稍后重试。
识别速度慢 Apple 芯片上正常速度约 2 秒。刚启动 App、或模型空闲卸载后,第一次识别要先加载模型,会多等几秒。
LaTeX 不完整或不对 小错在公式编辑器里改。偏差很大时,重新截取更紧的选区,或用 BYOK 云端引擎对比。
额度用完了 每个自然月(按 UTC)开始时恢复 20 次。已经识别出的公式照样能改、能导出;Pro 不限次数。
其实只需要普通文字 公式识别是独立的操作,不影响默认的系统 OCR(免费且本地)。
相关
截图转 LaTeX(完整教程) · 本地 OCR · 离线清单 · API Key · FAQ