前言¶
纸质单据、扫描件和导出 PDF 里的文字，往往要人工打开、复制或再录入表格。若希望 coding agent 在对话里直接处理「某个目录下的一批文档」，需要一条可重复的路径：本地扫描文件、调用稳定的 OCR 服务、把结果交给后续整理。下面介绍 SkillHub 上的社区 Skill「文档识别-表格识别（翔云开放平台）」——它把文件夹内的 PDF/图片交给翔云 OCR API，并在首次使用前要求配置翔云开放平台凭证。
这是什么¶
文档识别-表格识别（翔云开放平台）（坐标 @user_6b190ef3/doc-ocr-xy，当前版本 2.0.1）是 SkillHub 分类 office-efficiency 下的社区 Skill（来源 community，发布者 user_6b190ef3）。定位是文档 OCR：扫描指定文件夹中的 PDF 与图片，调用 翔云 OCR API 识别文档信息。Skill 标记 requires_api_key=true，依赖你在翔云侧申请的密钥，不能开箱即用。
核心功能¶
根据 SkillHub 与 API 页面上的说明，已核实的能力包括：
- 目录级扫描：面向文件夹中的 PDF、图片批量发起识别，而不是单文件手工上传。
- 翔云 OCR 对接：识别逻辑通过翔云开放平台 API 完成，凭证字段为 netocr_key 与 netocr_secret。
- 首次配置引导：Skill 要求 Agent 在首次使用时先完成凭证配置——向用户索取上述两项，或引导用户执行
--config自行写入配置。
名称中的「表格识别」体现 Skill 在办公场景下的侧重点；公开简介表述为「文档 OCR / 识别文档信息」，正文不展开未在官方文案中出现的接口参数或返回结构。
安装与启用¶
通过 SkillHub CLI 安装¶
官方页面建议 Agent 参照 SkillHub 安装说明 安装本 Skill。典型流程如下。
1、检查是否已安装 skillhub：
command -v skillhub && skillhub --version
2、若未安装，可按安装文档执行完整安装或仅安装 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
3、安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录（否则默认落在 ./skills/，Agent 可能无法加载）：
skillhub install user_6b190ef3/doc-ocr-xy --dir <skills 目录>
常用客户端 skills 目录示例（以安装文档为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后若 Agent 未立即识别新 Skill，可按你所用客户端的惯例重启或刷新 skills 加载。
配置翔云凭证¶
首次使用前必须配置翔云凭证。官方说明中的两种方式：
- Agent 向用户索取 netocr_key、netocr_secret 并完成配置；
- 或引导用户运行 Skill 提供的
--config命令自行配置。
凭证归属翔云开放平台，需在翔云侧自行申请；本文不写具体申请步骤，以免与官网变更不一致。
典型用法¶
在 Skill 已安装且凭证已配置的前提下，对话中的用法与 Skill 设计一致即可复现：
- 指定待识别的本地文件夹（内含 PDF 或图片）。
- 由 Agent 调用本 Skill 扫描目录并请求翔云 OCR API。
- 在对话中查看识别出的文档信息，再交给后续整理、入库或表格处理流程。
也可将官方安装提示直接发给 AI：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_6b190ef3/doc-ocr-xy。
适用场景与注意¶
适合谁：需要把一批扫描件、截图、PDF 交给 coding agent 做 OCR 的办公与数据录入场景；已具备或愿意申请翔云 netocr_key / netocr_secret 的团队。
限制与注意：
- 依赖外网 API 与有效密钥，费用、配额、合规以翔云开放平台为准。
- 社区 Skill（community），维护节奏以发布者 user_6b190ef3 与 SkillHub 页面为准。
- SkillHub 页面统计（截至资料抓取）：评分 100000，下载约 886 次，安装 8 次；与线索中的数字不一致时，以 SkillHub/API 页面为准。
结尾¶
「文档识别-表格识别（翔云开放平台）」把「扫文件夹 + 翔云 OCR + 凭证配置」封装成 Agent 可加载的 Skill，减少在对话里重复说明 API 与批处理步骤。安装与说明见 SkillHub：https://www.skillhub.cn/skills/user_6b190ef3/doc-ocr-xy；API 资料页：https://api.skillhub.cn/user_6b190ef3/doc-ocr-xy。
