前言¶
财务、报销和进销存相关开发里，常见需求是：从扫描件或 PDF 里抽出发票字段，再对接税务侧的验真接口。自己接 OCR 与查验 API，要处理鉴权、票种差异和批量目录等细节，对话式 Agent 也很难稳定选对能力。下面介绍 SkillHub 上的社区 Skill「发票识别-发票查验-发票OCR（翔云开放平台）」：在用户用自然语言描述发票相关任务时触发，由 Skill 引导调用翔云开放平台侧能力（页面标注与 netocr、翔云发票相关）。
这是什么¶
一句话定位：面向 Agent 的翔云发票识别与查验 Skill，通过关键词触发，覆盖识别、验真及台账类表述。
- 坐标：
@user_6b190ef3/xiangyun-invoice-ocr - 当前版本：1.0.5（来源：community，分类：professional）
- 发布者：user_6b190ef3
- 官方页面：SkillHub 技能页、api.skillhub.cn 条目
Skill 标签标明 requires_api_key=true，使用前需准备翔云开放平台相关 API 密钥；具体环境变量名与配置步骤以 Skill 包内 SKILL.md 及翔云文档为准，本文不展开未在公开页面列出的字段。
核心功能¶
以下能力均来自 Skill 官方简介中的触发说明，Agent 在用户表述匹配时会选用本 Skill。
识别与读取¶
- 发票识别、发票 OCR、识别发票
- 扫描发票、读取发票信息、提取发票数据
- 增值税发票识别、电子发票识别、数电票识别
- 批量发票处理、发票文件夹识别
- netocr 发票、翔云发票（与翔云 / NetOCR 产品线对应）
查验¶
- 发票查验、发票验真、发票核验、核查发票真伪
财务侧导出与表样（由 Skill 引导的场景表述）¶
- 发票导出、发票台账、发票入账表、发票勾选抵扣
- 旅客运输抵扣表、货物明细表
安装与启用¶
方式一：让 AI 按 SkillHub 安装说明执行¶
将下面提示词发给当前使用的 AI Agent（Cursor、Claude Code 等），由其读取安装文档并完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_6b190ef3/xiangyun-invoice-ocr`。
方式二：使用 skillhub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 文档执行完整安装（含默认 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 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。Cursor 常用路径为 ~/.cursor/skills/；Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/。以你当前环境为准，示例：
skillhub install user_6b190ef3/xiangyun-invoice-ocr --dir ~/.cursor/skills/
也可先搜索再安装：
skillhub search xiangyun-invoice-ocr
安装后按各客户端要求重启或刷新 Skill 列表。因 requires_api_key=true，在 Skill 说明中配置翔云 API Key 后再做识别或查验。
典型用法¶
公开页面未提供独立代码示例；用法以自然语言触发为主。启用 Skill 并配置 API Key 后，可直接在对话中描述任务，例如：
- 「识别这张增值税电子发票的图片，提取金额、税额、销方名称。」
- 「对以下发票代码和号码做验真。」
- 「扫描这个文件夹里的发票，批量提取并整理成台账。」
Agent 在匹配简介中的关键词（如「发票 OCR」「发票验真」「数电票识别」「发票文件夹识别」）时应加载本 Skill，再按 SKILL.md 中的流程调用翔云接口。具体请求参数、票种限制以 Skill 包内文档为准。
适用场景与注意¶
适合谁
- 已在或计划使用翔云开放平台发票能力的团队，希望把 OCR、验真和台账类话术收敛到 Agent 工作流。
- 需要处理增值税票、电子发票、数电票及批量目录的场景（能力范围以 Skill 简介为准）。
注意
- 社区来源（community），集成前请自行评估合规与数据出境要求；发票影像涉及敏感信息，注意密钥与传输安全。
- 依赖外部 API，需有效 API Key；未配置时 Skill 无法完成真实调用。
- SkillHub 页面统计（截至资料抓取）：评分 100000，下载 1040，安装 1；数据会随时间变化，以 技能页 为准。
- 本文未核实 Cursor / Codex CLI / Claude Code 在「发票 Skill」上的行为差异，除 skills 目录路径外，均以各客户端通用 Skill 机制为准。
结尾¶
「发票识别-发票查验-发票OCR（翔云开放平台）」把发票识别、验真及台账相关自然语言意图绑到同一 Skill 上，减少手写对接与反复说明票种。安装坐标为 @user_6b190ef3/xiangyun-invoice-ocr，版本 1.0.5。详情与安装入口：https://www.skillhub.cn/skills/user_6b190ef3/xiangyun-invoice-ocr。
