前言¶
在 macOS 上從截圖、照片或掃描件裏摳文字，常見做法是裝第三方 OCR 工具，或把圖片丟到在線服務裏再複製結果。若你已經在 Cursor、Claude Code 等環境裏用 Agent Skill 擴展能力，更希望識別邏輯留在本機、且不必單獨申請 API Key，就需要一條能調用系統能力的 Skill。下面介紹 SkillHub 上的 MacOCR，它面向 macOS，依賴系統內置的 Vision OCR 框架完成識別。
這是什麼¶
MacOCR（座標 @user_9a66f56b/macos-ocr）是社區來源（community）的 Agent Skill，當前版本爲 1.0.0，分類爲 office-efficiency。發佈者爲 user_9a66f56b。
官方說明：使用 macOS 內置 Vision OCR 框架從圖片中提取文字；當用戶需要在 macOS 上識別圖片、截圖、照片或掃描文檔中的文字時使用。支持簡體中文、繁體中文和英文識別，僅適用於支持 Swift 的 macOS 系統。Skill 標籤標明 requires_api_key=false，無需配置外部 API Key。
核心功能¶
依據 SkillHub 頁面與抓取元數據，可覈實的能力如下：
- 本機 OCR：通過 macOS Vision 框架識別圖片中的文字，不依賴第三方 OCR 雲服務。
- 多語言：支持簡體中文、繁體中文、英文。
- 輸入形態：面向圖片、截圖、照片、掃描文檔等常見靜態圖像場景（具體調用方式由 Skill 內
SKILL.md指導 Agent 執行）。 - 平臺限制：僅適用於 macOS，且需爲支持 Swift 的環境。
安裝與啓用¶
安裝 SkillHub CLI¶
若尚未安裝 skillhub，可先檢查版本：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 官方安裝文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需要 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安裝 MacOCR¶
安裝技能時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別。官方頁面給出的安裝方式爲：參照 SkillHub 安裝說明，安裝 @user_9a66f56b/macos-ocr。
命令行示例（將 <skills 目錄> 換成你當前客戶端的路徑）：
skillhub install user_9a66f56b/macos-ocr --dir <skills 目錄>
常用客戶端 skills 目錄（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
也可在對話中讓 AI 按上述安裝文檔完成安裝。安裝後按你所用客戶端的要求刷新或重啓 Agent，使 Skill 被加載。
典型用法¶
公開頁面未單獨列出可複製的 OCR 命令行示例；用法由 Skill 包內的說明驅動 Agent：當你在 macOS 上提出「從這張圖/截圖裏提取文字」「識別掃描件裏的中文/英文」等需求時，Agent 在已啓用 MacOCR 的前提下，應走 Vision OCR 流程處理你提供的圖片路徑或附件。
可復現的驗證方式：
- 在 macOS 上完成 MacOCR 安裝並確認 Agent 已加載該 Skill。
- 提供一張含簡體中文、繁體中文或英文的圖片或截圖，並明確要求提取文字。
- 對照原圖檢查 Agent 返回的文本是否完整、語言是否匹配。
適用場景與注意¶
適合誰
- 主要在 macOS 上工作，需要把截圖、照片、掃描 PDF 頁等裏的文字交給 AI 繼續編輯、摘要或檢索。
- 希望利用 系統內置 Vision，避免爲 OCR 單獨配置 API Key（
requires_api_key=false）。 - 已使用 SkillHub 或願意按官方文檔安裝 CLI 的開發者。
限制與注意
- 非 macOS 不可用；Linux、Windows 環境不應安裝或依賴此 Skill。
- 識別質量取決於 Vision 框架與圖片清晰度，Skill 頁面未承諾額外後處理或版面分析能力。
- SkillHub 元數據爲社區來源，使用前可在 SkillHub 查看評分與安裝量；截至資料抓取時：評分 100000，下載 1048，安裝 62（以 SkillHub 頁面實時數據爲準）。
結尾¶
MacOCR 把 macOS 自帶的 Vision OCR 封裝成 Agent Skill，適合在本機處理截圖與文檔圖片中的簡繁中文、英文文字，且無需 API Key。安裝與座標以 SkillHub 爲準。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_9a66f56b/macos-ocr
- 官方地址（資料中的 API 入口）：https://api.skillhub.cn/user_9a66f56b/macos-ocr
- 安裝說明：https://skillhub.cn/install/skillhub.md
