文档 OCR 识别技能。扫描文件夹中的文档（PDF/图片），调用翔云 OCR API 识别文档信息。**重要：首次使用必须先配置翔云凭证，主动向用户索要 netocr_key 和 netocr_secret，或引导用户运行 --config 命令自行配置。**
文档 OCR 识别技能
功能概述
文档 OCR 识别技能是一项面向实际任务的技能，主要用于批量识别文档；⚠️ 首次使用必须配置凭证；
核心要点
- 此技能需要翔云 OCR 服务，使用前必须先配置凭证！
- 方式一：向用户提供凭证（推荐）；
- 主动询问用户：；
使用与执行
"使用此技能需要翔云 netocr_key 和 netocr_secret，请提供这两个凭证；获取方式：翔云个人中心"；然后运行：；方式二：引导用户自行配置；告诉用户：；"请先运行以下命令配置翔云凭证："；
结果检查与注意事项
简体中文（印刷）。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
文档 OCR 识别技能
批量识别文档。
⚠️ 首次使用必须配置凭证
此技能需要翔云 OCR 服务，使用前必须先配置凭证！
方式一：向用户提供凭证（推荐）
主动询问用户：
"使用此技能需要翔云 netocr_key 和 netocr_secret，请提供这两个凭证。
获取方式：翔云个人中心"
然后运行：
python scripts/recognize_doc.py --config
方式二：引导用户自行配置
告诉用户：
"请先运行以下命令配置翔云凭证："
python ~/.openclaw/skills/invoice-ocr/scripts/recognize_doc.py --config
特点
| 支持语言 | 代码 |
|---|---|
| 简体中文（印刷） | 0 |
| 简体中文（印刷+手写） | 3 |
| 繁体中文（印刷） | 1 |
| 繁体中文（印刷+手写） | 4 |
| 英文 | 2 |
| 阿拉伯 | 5 |
| 乌尔都 | 6 |
| 格鲁吉亚 | 7 |
| 西里尔文 | 8 |
| 法文 | 9 |
| 西班牙文 | 10 |
| 日文 | 11 |
| 韩文 | 12 |
| 葡萄牙文 | 13 |
| 越南 | 14 |
| 孟加拉 | 15 |
支持的文件格式
| 格式 | 扩展名 |
|---|---|
| OFD | .ofd |
| 图片 | .jpg, .jpeg, .png, .bmp , .tif, .tiff, .webp |
使用方法
识别文档
# 识别文件夹中的所有文档 python scripts/recognize_doc.py /path/to/doc # 识别单文档 python scripts/recognize_doc.py /path/to/doc/123.png
配置管理
# 设置翔云凭证 python scripts/recognize_doc.py --config # 查看当前配置 python scripts/recognize_doc.py --list-config
获取 netocr_key 和 netocr_secret
- 登录翔云
- 在个人中心获得
详细 API 说明见 翔云 OCR API 参考
工作流程
文档文件 → OCR识别 → 返回结果（输出原文不必翻译） ↓ ↓ PDF/图片 md结构
注意事项
- 图片需清晰，建议长宽 > 500px
- 单个文件不超过 10MB
- 翔云 OCR 按次计费，注意费用控制
- 配置文件保存在技能目录下的 config.json
相关专题
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
2026.10.22
0
11
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
2026.10.22
0
10
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
2026.10.22
0
15
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
2026.10.22
0
10
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
2026.10.22
0
25
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
2026.10.22
0
15
本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查，覆盖本地环境、Docker及多平台用法，帮助Go开发者快速上手。
2026.10.22
0
15
PHP2Shell漏洞是什么，哪些PHP版本和运行环境会受到影响，服务器应该如何检测与修复？本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤，以及修复验证、临时缓解和应急响应方案。
2026.10.22
0
12
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 133.9万人学习
共49课时 | 82.5万人学习
