课件、论文、教材里的印刷公式很难手打。ClariRec Pro 可以把公式截图转成可预览、可复制的 LaTeX——既可以用本地 GLM-OCR 引擎在本机完成，也可以用你配置的 BYOK 云端服务。
这是由你主动触发的 Pro 功能，不会自动跑。普通文字识别仍走默认系统 OCR（除非你另选引擎）。
两种路径：本地或云端
| 本地（GLM-OCR） | 云端（BYOK） | |
|---|---|---|
| 需要 API Key？ | 不需要 | 需要 |
| 能离线用？ | 下载模型后可以 | 不能 |
| 模型下载 | 约 1.34GB，一次性 | 无 |
| 设备要求 | Apple 芯片 + 16GB 内存 | 任何运行 ClariRec 的 Mac |
| 引擎 | 内置 GLM-OCR | Custom Vision API 或通义千问 |
| 速度（典型值） | 约 2 秒 | 取决于服务商 |
| 需要 Pro？ | 是 | 是 |
两条路径的 LaTeX 均在本地用 KaTeX 预览。如果你的 Mac 满足本地引擎要求，且未配置云端公式引擎，本地引擎会自动成为默认选项——不需要 API Key，不走网络。
本地引擎：GLM-OCR
它是什么
- 设备端公式识别：截图 → LaTeX，完全在你的 Mac 上运行
- 基于 GLM-OCR（Q8_0 量化，模型权重 MIT 许可），两个文件合计约 1.34GB
- 下载后即可离线使用——不需要 API Key，不需要云账号
- 空闲 5 分钟后自动卸载；系统内存紧张时提前卸载
要求
- Apple 芯片 Mac（M1 及以上），内存 ≥ 16GB
- ClariRec Pro（一次性购买）
- 不满足硬件条件的 Mac 不会显示本地引擎选项——请使用 BYOK 云端服务
这是硬门槛，不是建议。不满足条件的机器，每次识别需要 14 秒以上（仅 CPU），下载 1.34GB 后体验反而更差。
下载与配置
- 打开 设置 → Providers / 引擎 → 公式识别。
- 在引擎列表中选择 本地（GLM-OCR）。
- 点击 下载模型。界面单列两个文件的进度。
- 等待下载完成。支持断点续传；下载完后做 SHA-256 校验。
- 下载完成后本地引擎即可使用。将其设为当前公式引擎。
模型可随时从同一面板删除。
中国大陆用户：下载自动走 ModelScope（魔搭）镜像以获得更好的速度，镜像失败时回退 Hugging Face。
如何识别公式（本地）
- 用
⌥S截取公式（尽量紧贴公式框选）。 - 在结果窗口点击公式操作。
- 本地引擎在你的 Mac 上处理图像——不产生网络请求。
- 预览渲染结果（本地 KaTeX）。
- 复制 LaTeX 源码。
云端引擎：BYOK
它是什么
- 通过你配置的视觉语言模型实现截图 → LaTeX
- BYOK：你自带服务商，按该服务商计费
- 支持两个引擎：Custom Vision API / Custom API 和 通义千问（Qwen）
要求
- macOS 14+ 上的 ClariRec
- ClariRec Pro（一次性购买）
- 已配置支持公式的 BYOK 引擎和有效 API Key
- 模型需支持图片输入，并能稳定返回结构化公式结果
Mistral AI 在 ClariRec 里可用于 OCR 与翻译，但不能用于公式识别。
配置步骤
- 打开 设置 → Providers / 引擎 → 公式识别。
- 配置 Custom API 或 Qwen（API Key；按需填写基础 URL / 模型）。
- 在面板中运行 测试公式，确认能返回可用 LaTeX。
- 如有需要，购买或恢复 ClariRec Pro。
- 将该引擎设为当前公式引擎。
字段说明见 API Key 教程。
如何识别公式（云端）
- 用
⌥S截取公式。 - 在结果窗口点击公式操作。
- 等待服务商返回。
- 预览渲染结果（本地 KaTeX，渲染不产生网络请求）。
- 复制 LaTeX 源码到笔记、论文或编辑器。
只有该次操作对应的截图会发送到你配置的 VLM 端点。ClariRec 不通过自营服务器中转。
提高 LaTeX 质量的技巧
- 框选尽量紧，避免同一选区里混入大段正文
- 优先使用清晰、对比度高的印刷公式，而不是模糊手机照片
- 预览不对时，调整选区后重新识别
- 以 LaTeX 源码为准——预览用于核对，不是在 ClariRec 里逐符号手改
隐私与费用
| 项目 | 本地（GLM-OCR） | 云端（BYOK） |
|---|---|---|
| 何时离开本机 | 永远不会（模型下载后） | 点击公式识别时 |
| 发往何处 | 不发往任何地方 | 你配置的 Custom API 或 Qwen 端点 |
| 渲染 | 本地 KaTeX | 本地 KaTeX |
| ClariRec 服务器 | 不接收 | 不接收 |
| API 费用 | 无 | 由服务商计费 |
Pro 解锁的是应用内功能，不包含服务商额度。
故障排查
看不到本地引擎选项 你的 Mac 需要 Apple 芯片 + 16GB 内存。不满足条件时该选项不会出现——请使用云端引擎。
模型下载卡住或失败 检查网络连接。下载支持断点续传，进度不会丢失。中国大陆用户应会自动走 ModelScope 镜像；如果两个源都失败，请稍后重试。
找不到或无法使用公式引擎 确认已在「公式识别」分段配置 Custom API 或 Qwen，并且 Pro 已解锁。
测试公式失败 检查 API Key、端点、模型名称，以及模型是否接受图片。同时核对服务商额度与地区限制。
LaTeX 不完整或不对 重新截取更紧的选区。本地引擎对大图（超过约 2560×1440）会自动缩放以控制 token 数。云端引擎可在 Custom API 上换一个更擅长公式的视觉模型。
其实只需要普通文字 使用普通 OCR 即可。公式识别是可选的独立能力。
相关
本地公式识别 · API Key · 截图 OCR · FAQ · 本地 OCR · 离线清单
