前言¶
报销、对账、归档时，发票往往混在 PDF 与拍照图片里，手工录入字段既慢又容易错。通用大模型能读图，但很难稳定覆盖增值税专票、火车票、行程单等几十类版式，也未必对接得上合规的第三方 OCR 服务。下面介绍 SkillHub 上的社区技能「发票识别（翔云开放平台）」：在 Agent 里按目录批量处理发票文件，并把识别工作交给翔云 OCR API。
这是什么¶
「发票识别（翔云开放平台）」是面向办公效率（office-efficiency）的 Agent Skill，坐标为 @user_6b190ef3/invoice-ocr-xy，当前版本 2.0.1，来源为社区（community），由发布者 user_6b190ef3 维护；SkillHub 页面作者显示为妮妮。
一句话定位：扫描指定文件夹中的发票文件（PDF / 图片），调用翔云 OCR API 抽取发票结构化信息。技能标记为 requires_api_key=true，使用前必须配置翔云开放平台凭证。
核心功能¶
以下能力均来自 SkillHub 官方简介，未在资料中出现的接口或字段不作延伸说明。
- 目录级批量处理：面向文件夹内的发票素材，而非单张临时上传的交互式演示。
- 格式：支持 PDF 与常见图片格式作为输入。
- 发票类型：宣称支持 40+ 种，资料中列举的类型包括增值税发票、火车票、出租车票、机票行程单、定额发票、机动车销售发票、过路过桥费发票等。
- 后端服务：识别请求走 翔云 OCR API（开放平台），不是本地离线模型。
- 凭证管理：首次使用须配置
netocr_key与netocr_secret；Agent 应主动向用户索取这两项，或引导用户通过技能的--config自行写入配置。
安装与启用¶
通过 SkillHub CLI 安装¶
若本机尚未安装 skillhub，可先按 SkillHub 安装说明 检查或安装 CLI，再将技能装到当前 Agent 实际读取的 skills 目录（装错目录会导致技能不被加载）：
command -v skillhub && skillhub --version
skillhub install user_6b190ef3/invoice-ocr-xy --dir <skills 目录>
常见客户端的 skills 路径（摘自官方安装文档，以你本机环境为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可让 AI 按 SkillHub 页面提示，阅读 https://skillhub.cn/install/skillhub.md 后安装 @user_6b190ef3/invoice-ocr-xy。
配置翔云凭证¶
在调用识别能力之前完成凭证配置，否则 API 无法鉴权：
- 向用户确认或收集
netocr_key、netocr_secret（翔云开放平台颁发）。 - 或指导用户运行技能提供的
--config流程，自行写入上述两项。
具体配置文件路径与交互形式以技能包内 SKILL.md 为准；安装成功后可在对应 skills 目录下查看该文件。
典型用法¶
资料未给出独立 shell 脚本的完整示例，典型工作流可按技能设计理解如下：
- 将待处理发票 PDF / 图片放入同一文件夹。
- 在对话中说明需要发票识别、批量处理发票，或明确使用翔云 OCR 识别发票——这与官方列出的触发场景一致。
- Agent 加载本 Skill 后，按技能说明扫描该目录并调用翔云 OCR，返回各张票据的结构化字段。
首次会话务必先完成上一节的凭证配置，再发起批量识别。
适用场景与注意¶
适合谁
- 需要在 Agent 会话里处理一批发票文件，而不是在单一网页里点选上传。
- 已具备或愿意申请翔云开放平台 API 密钥的团队。
- 票据类型落在技能支持的 40+ 类范围内（含资料中列举的增值税、交通、定额等常见票种）。
限制与注意
- 强依赖外网 API：识别质量、配额与可用性由翔云开放平台决定；技能本身不承诺离线识别。
- 密钥安全：
netocr_key/netocr_secret属于敏感信息，应通过--config或环境约定的方式存放，避免写进公开仓库或聊天记录。 - 版本与元数据：以 SkillHub 页面为准（当前 v2.0.1）；页面展示的评分、下载量会随时间变化，写作时请以你打开页面时看到的数字为准。
结尾¶
「发票识别（翔云开放平台）」把「扫目录 + 多票种 OCR + 翔云 API」封装成可安装的 Agent Skill，适合在 Cursor 等支持 Skill 的环境里做批量发票结构化。安装与优先源说明见 SkillHub 安装文档；技能主页：
- API 入口：https://api.skillhub.cn/user_6b190ef3/invoice-ocr-xy
- SkillHub 展示页：https://www.skillhub.cn/skills/user_6b190ef3/invoice-ocr-xy
