diff --git a/README.md b/README.md index f1d57f37..09ec7d17 100644 --- a/README.md +++ b/README.md @@ -297,6 +297,11 @@ With these functionalities, the AI assistant can summarize key points within an LiberSonora LiberSonora, meaning "Voice of Freedom", is an AI-powered, robust, open-source audiobook toolkit that includes features like intelligent subtitle extraction, AI title generation, multilingual translation, with support for GPU acceleration and batch offline processing. + + Icon + ClariRec + ClariRec is a native macOS OCR and translation app. On-device Vision OCR for screenshots, clipboard, and files, plus BYOK translation with DeepSeek and other providers — no ClariRec account required. See setup guide. + Icon Bob diff --git a/README_cn.md b/README_cn.md index 0473f9e2..9d5ac2fd 100644 --- a/README_cn.md +++ b/README_cn.md @@ -241,6 +241,11 @@ LiberSonora LiberSonora，寓意"自由的声音"，是一个 AI 赋能的、强大的、开源有声书工具集，包含智能字幕提取、AI标题生成、多语言翻译等功能，支持 GPU 加速、批量离线处理 + + Icon + ClariRec + ClariRec 是一款原生 macOS OCR 与翻译工具。默认用系统 Vision 完成本地 OCR，并支持用 DeepSeek 等 BYOK 引擎翻译；无需注册 ClariRec 账号。详见 接入说明。 + Icon Bob diff --git a/docs/ClariRec/README.md b/docs/ClariRec/README.md new file mode 100644 index 00000000..dd2dca59 --- /dev/null +++ b/docs/ClariRec/README.md @@ -0,0 +1,48 @@ +ClariRec + +# [ClariRec](https://clarirec.com/) + +ClariRec is a native macOS OCR and translation app. It extracts text from screenshots, clipboard images, and files with on-device Vision OCR, then optionally translates with your own API key — including DeepSeek. + +## Features + +- Screenshot OCR (`⌥S`), clipboard OCR (`⌥V`), and file OCR +- On-device system OCR by default; no ClariRec account required +- BYOK translation with DeepSeek and other providers (API key stays on your Mac) +- Optional offline local translation model and macOS system translation +- Result window with copy/export, Smart Cleanup, and Markdown tables +- Shortcuts and `clarirec://` URL scheme automation + +## UI + +![ClariRec result window](assets/ui-result.png) + +![ClariRec DeepSeek provider settings](assets/ui-provider.png) + +## Integrate with DeepSeek API + +1. Get an API key from the [DeepSeek Open Platform](https://platform.deepseek.com/api_keys). +2. Open **ClariRec → Settings → Providers**. +3. Select **DeepSeek** in the provider list. +4. Paste your API key into **API Key**. +5. Click **Test Connection** to verify the key. +6. Set **DeepSeek** as the **Translation Engine** (in Providers or the result window). + +Built-in defaults (no endpoint setup required): + +- Endpoint: `https://api.deepseek.com/chat/completions` +- Default model: `deepseek-v4-flash` (the model name can be changed in the DeepSeek provider settings) + +Your key is stored in the macOS Keychain. ClariRec talks to DeepSeek’s official API directly — no proxy or intermediate server. + +## Use + +1. Capture text with screenshot OCR (`⌥S`), clipboard OCR (`⌥V`), or file OCR. +2. In the result window, run translation (or enable auto-translate). +3. Or translate selected text via macOS Services / clipboard hotkey (`⌥T`) when DeepSeek is the active translation engine. + +## Get it + +[Website](https://clarirec.com/) · [Mac App Store](https://apps.apple.com/cn/app/clarirec/id6757385283?mt=12) · macOS 14.0+ + +> ClariRec is not affiliated with, endorsed by, or sponsored by DeepSeek. “DeepSeek” is used only to identify a supported BYOK translation provider. diff --git a/docs/ClariRec/README_cn.md b/docs/ClariRec/README_cn.md new file mode 100644 index 00000000..7279a72d --- /dev/null +++ b/docs/ClariRec/README_cn.md @@ -0,0 +1,48 @@ +ClariRec + +# [ClariRec](https://clarirec.com/) + +ClariRec 是一款原生 macOS OCR 与翻译工具。默认用系统 Vision 在本地完成截图 / 剪贴板 / 文件 OCR，并可选用你自己的 API Key（含 DeepSeek）做翻译。 + +## 功能亮点 + +- 截图 OCR（`⌥S`）、剪贴板 OCR（`⌥V`）、文件 OCR +- 默认本地 OCR，无需注册 ClariRec 账号 +- BYOK 翻译支持 DeepSeek 等引擎（API Key 保存在本机） +- 可选本地离线翻译模型与 macOS 系统翻译 +- 结果窗口支持复制 / 导出、Smart Cleanup、Markdown 表格 +- 快捷指令与 `clarirec://` URL Scheme 自动化 + +## UI + +![ClariRec 结果窗口](assets/ui-result.png) + +![ClariRec DeepSeek 引擎配置](assets/ui-provider.png) + +## 接入 DeepSeek API + +1. 在 [DeepSeek 开放平台](https://platform.deepseek.com/api_keys) 创建 API Key。 +2. 打开 **ClariRec → 设置 → 引擎**。 +3. 在列表中选择 **DeepSeek**。 +4. 在 **API 密钥** 中粘贴你的 Key。 +5. 点击 **测试连接** 验证是否可用。 +6. 将 **翻译引擎** 设为 **DeepSeek**（在引擎页或结果窗口均可）。 + +内置默认（无需自行填写端点）： + +- 端点：`https://api.deepseek.com/chat/completions` +- 默认模型：`deepseek-v4-flash`（可在 DeepSeek 提供商设置中自定义模型名） + +API Key 保存在 macOS 钥匙串中。ClariRec 直连 DeepSeek 官方 API，不经过任何代理或中间服务器。 + +## 使用 + +1. 通过截图 OCR（`⌥S`）、剪贴板 OCR（`⌥V`）或文件 OCR 取得文本。 +2. 在结果窗口执行翻译（或开启自动翻译）。 +3. 也可在 DeepSeek 为当前翻译引擎时，通过 macOS 服务 / 剪贴板热键（`⌥T`）翻译文本。 + +## 获取 + +[官网](https://clarirec.com/) · [Mac App Store](https://apps.apple.com/cn/app/clarirec/id6757385283?mt=12) · 需要 macOS 14.0+ + +> ClariRec 与 DeepSeek 无关联、未获背书或赞助。「DeepSeek」仅用于标明支持的 BYOK 翻译引擎。 diff --git a/docs/ClariRec/assets/logo.png b/docs/ClariRec/assets/logo.png new file mode 100644 index 00000000..1b2714e1 Binary files /dev/null and b/docs/ClariRec/assets/logo.png differ diff --git a/docs/ClariRec/assets/ui-provider.png b/docs/ClariRec/assets/ui-provider.png new file mode 100644 index 00000000..2163f6fe Binary files /dev/null and b/docs/ClariRec/assets/ui-provider.png differ diff --git a/docs/ClariRec/assets/ui-result.png b/docs/ClariRec/assets/ui-result.png new file mode 100644 index 00000000..53fb70c9 Binary files /dev/null and b/docs/ClariRec/assets/ui-result.png differ