ClariRec 快捷指令与 URL Scheme
全局快捷键适合交互式捕获。若要把 ClariRec 嵌进更大的 Mac 工作流——快捷指令、shell 脚本或其他应用——请使用 App Intents 或 clarirec:// URL Scheme。
两条路径都遵循与手动使用相同的本地优先 / BYOK 规则，只处理你明确提供的剪贴板图片、图片文件或文本。
可以自动化什么
| 动作 | 快捷指令（App Intent） | URL Scheme |
|---|---|---|
| 识别剪贴板图片 | OCR Clipboard Image | clarirec://ocr 或 clarirec://ocr/clipboard |
| 识别图片文件 | OCR Image File | clarirec://ocr/file?... |
| 翻译文本 | Translate Text | clarirec://translate?text=... |
快捷指令动作会把文本返回给快捷指令。URL Scheme 的 OCR/翻译结果通常写入剪贴板；OCR 可通过参数选择是否打开结果窗口。
快捷指令 App
- 从 App Store 安装 ClariRec，并至少打开一次。
- 打开快捷指令应用。
- 添加操作，搜索 ClariRec（或下方意图名称）。
- 把返回的文本接到通知、拷贝到剪贴板、文件或其他应用。
意图说明
OCR Clipboard Image
识别当前剪贴板中的图片。无参数。返回字符串。
OCR Image File
参数：Image File（public.image）。返回识别文本字符串。
Translate Text
参数：Text（必填）、Target Language（可选）。使用你配置的翻译引擎（本地模型、可用时的 Apple Intelligence，或 BYOK）。返回译文。
ClariRec 注册的 Siri 短语包括 “OCR clipboard with ClariRec”、“Translate text with ClariRec” 等形式——是否出现取决于系统语言与快捷指令索引。
示例想法
- 系统截图进入剪贴板后 → OCR Clipboard Image → 追加到日记
- 在访达选中图片 → OCR Image File → 复制结果
- 把选中文本传入 Translate Text → 显示通知
clarirec:// URL Scheme
可从终端、Alfred、Raycast 或任何能打开 URL 的应用调用。需已安装 ClariRec。
剪贴板 OCR
clarirec://ocr
clarirec://ocr/clipboard
clarirec://ocr/clipboard?silent=true
clarirec://ocr?open=false
- 默认打开结果窗口（
open默认为 true） silent=true或open=false：不打开结果窗口（偏剪贴板流程）
文件 OCR
clarirec://ocr/file?url=file:///absolute/path/to/image.png
clarirec://ocr/file?path=/absolute/path/to/image.png&silent=true
文件参数可用：url、file 或 path（文件 URL 或文件系统路径）。
沙盒说明： 文件 OCR 仅适用于 ClariRec 在 macOS 沙盒下实际可访问的文件。优先使用用户选择的文件，或应用有权读取的路径。若访问失败，改用快捷指令的 OCR Image File，并在快捷指令中显式选择文件。
翻译文本
clarirec://translate?text=Hello%20world
clarirec://translate?text=Hello%20world&target=English
clarirec://translate?text=Hello%20world&language=Japanese©=false
| 参数 | 含义 |
|---|---|
text |
必填。待翻译文本（需 URL 编码） |
target 或 language |
可选目标语言 |
copy |
默认 true；设为 false 可跳过复制结果 |
布尔值接受 true / false、1 / 0、yes / no、on / off。
Shell 示例
open "clarirec://ocr?silent=true"
open "clarirec://translate?text=$(python3 -c 'import urllib.parse,sys; print(urllib.parse.quote(sys.argv[1]))' "Hello world")&target=Chinese"
引擎与 Pro 边界
自动化不会另造一套隐私模型：
- 默认系统 OCR 仍在本地
- 执行 BYOK 远程 OCR 仍需要 Pro（或老用户豁免）
- 翻译使用你当前选择的翻译引擎；BYOK 翻译仍可免费使用自有密钥
- macOS 系统翻译走 view 层，不会作为快捷指令 / URL Scheme 的翻译路径。自动化请优先使用本地模型、Apple Intelligence（可用时）或 BYOK
隐私
快捷指令与 URL 调用只处理你传入的输入。ClariRec 不运营接收这些图片或文本的服务器。详见 macOS 本地 OCR 与 隐私政策。
故障排查
快捷指令找不到 ClariRec 操作
安装或更新后先打开一次 ClariRec，再重启快捷指令。
文件 URL 没有反应
检查路径编码与沙盒访问。可改用带显式文件参数的快捷指令意图。
URL/快捷指令翻译在选用系统翻译时失败
把翻译引擎改为本地模型、Apple Intelligence 或 BYOK。
远程 OCR 报 Pro 错误
Provider 配置免费；通过自动化执行远程 OCR 仍受 Pro 门槛约束。
相关
