前言¶
在 Agent 工作流里，截图、扫描件、照片里的文字常常需要进笔记、进代码或进检索。走云端 OCR 往往要配 API Key、考虑出网和计费；纯手写脚本又要在环境里反复装引擎、调语言包。下面介绍 SkillHub 上的 OCR-Local-1.0（坐标 @user_8353d908/ocr-rlocal）：用 Tesseract.js 在本地做 OCR，官方说明为 100% local、无需 API Key，并支持简体中文、繁体中文与英文。
这是什么¶
OCR-Local-1.0 是社区来源（community）的 Agent Skill，当前版本 1.0.0，发布者为 user_8353d908，在 SkillHub 分类为 office-efficiency（办公效率）。Skill 标签标明 requires_api_key=false，与「纯本地、不依赖密钥」的定位一致。
一句话定位：让支持 Skills 的 AI 客户端在识别图片文字时，按 Skill 指引使用 Tesseract.js 在本地提取文本，而不是调用需要密钥的在线 OCR 服务。
核心功能¶
依据 SkillHub 页面与抓取资料，可核实的能力如下：
- 图片转文字：从图像中提取文本（基于 Tesseract.js OCR）。
- 完全本地：处理在本地完成，不需要 API Key。
- 多语言：支持简体中文、繁体中文与 English。
未在官方页面展开的实现细节（例如具体 Node 版本、预置语言包路径、批处理接口）本文不展开，避免与 SKILL 正文不一致。
安装与启用¶
SkillHub 给出的安装方式是：参照 SkillHub 安装与优先源配置，安装坐标 @user_8353d908/ocr-rlocal。也可把下面提示词发给已具备 SkillHub 能力的 AI，由它按文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_8353d908/ocr-rlocal`。
安装 SkillHub CLI（若尚未安装）¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，官方提供完整安装（CLI + 默认 Skill）或仅 CLI：
# 完整安装（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
安装本 Skill 到当前 Agent 目录¶
安装技能时必须用 --dir 指向当前 Agent 实际使用的 skills 目录；否则默认会装到 ./skills/，客户端可能识别不到。官方文档列出的常见路径包括：
| 客户端 | Skills 目录（示例） |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或项目下的 .windsurf/skills/ |
在对应目录已确认的前提下，执行（将 <skills 目录> 换成你的路径）：
skillhub install @user_8353d908/ocr-rlocal --dir <skills 目录>
也可先搜索再安装：
skillhub search ocr-rlocal
skillhub install @user_8353d908/ocr-rlocal --dir <skills 目录>
经过上面的步骤后，按你所用客户端的要求重启或刷新 Skills 列表，使 OCR-Local-1.0 生效。
典型用法¶
官方 SkillHub 页面未单独给出可复制的一键 OCR 命令行示例；典型用法符合通用 Skill 模式：
- 确认 OCR-Local-1.0 已装入当前 Agent 的 skills 目录并已启用。
- 在对话中提供待识别图片（附件或工作区内的图片路径，以客户端能力为准）。
- 用自然语言说明需求，例如：从这张截图提取全部文字、只提取中文段落、或输出为 Markdown 列表。
Agent 会按 Skill 内嵌的 SKILL.md 指引调用 Tesseract.js 在本地跑识别。具体依赖安装、语言包选择与错误处理以 Skill 正文为准；若识别失败，可在同一会话中让 Agent 根据 Skill 说明检查本地环境与图像质量。
适用场景与注意¶
适合谁
- 需要把截图、证件照、简单扫描页里的字变成可编辑文本，且希望不出网、不配 OCR API 的开发者或办公场景。
- 已在 Cursor、Claude Code、Codex 等支持 SkillHub 安装路径的环境中工作，愿意用一条
skillhub install统一装 Skill 的用户。
限制与注意
- 本地算力与依赖：Tesseract.js 在本地运行，大图、低质量图或复杂版式可能慢或误识率高；语言包与运行时需满足 Skill 要求（细节见安装后的 SKILL 说明）。
- 语言范围：官方仅声明简中、繁中与 English；其他语种是否可用取决于 Tesseract 语言包是否由 Skill 支持，未声明的不应默认可用。
- 隐私与合规：文本留在本机处理，适合对出网敏感的材料；仍应注意图片本身在磁盘与对话日志中的留存策略。
- 商店数据：SkillHub 页面显示评分 100000、下载 1152、安装 31（以页面展示为准，会随时间变化）。
结尾¶
OCR-Local-1.0 把「图片 → 文本」收进 Agent Skill：Tesseract.js、本地执行、无需 API Key，并覆盖中英（含简繁）。若你正在 SkillHub 上找办公效率类、免密钥的 OCR 能力，可从官方条目入手安装与试用。
- SkillHub 页面：https://www.skillhub.cn/skills/user_8353d908/ocr-rlocal
- 坐标：
@user_8353d908/ocr-rlocal - 版本：1.0.0
