下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-81ystkpy--anspire-doc-classify.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @org-81ystkpy/anspire-doc-classify。- 对 PDF、图片进行自定义类型分类。用户提供一组候选分类名称,接口返回文档最可能归属的分类。当用户要求把文档归类到预设类型(如身份证/合同/发票/简历/报表)
- 当用户提到文档分类、文档归类、文件分拣、票据类型识别、合同类型判断、自动归档
- 或需要批量整理异构文档到指定类目时使用。支持 pdf/jpg/png/tiff 格式。
阅读全文 （展开查看完整说明）
概述
文档分类
Description
对 PDF、图片进行自定义类型分类。用户提供一组候选分类名称,接口返回文档最可能归属的分类。当用户要求把文档归类到预设类型(如身份证/合同/发票/简历/报表);当用户提到文档分类、文档归类、文件分拣、票据类型识别、合同类型判断、自动归档;或需要批量整理异构文档到指定类目时使用。支持 pdf/jpg/png/tiff 格式。
When to Use
- 用户要求把文档归类到一组预设类型(如 ["身份证","合同","发票"])
- 用户提到:文档分类、文档归类、文件分拣、票据类型识别、合同类型判断、自动归档
- 场景:批量整理异构文档、自动路由到不同处理流程、归档前预分类
- 输入是 PDF/图片 的单页或多页文档
- 候选分类由用户自定义,接口不限定固定类目
安全与执行前检查
- 只有在用户允许将文件上传到 Anspire 服务时才调用 API。
- API Key 只从全局共享凭证文件读取,不接受命令行参数,不读取环境变量中的 Key 本身。
- 首次或更新 API Key:运行
python /path/to/skill/scripts/anspire_api.py configure(隐藏输入)。保存后只告知"认证配置已更新",不展示配置文件路径。 - 没有 API Key 时不要调用 API。引导用户打开 Anspire 控制台 API Key 设置页,完成注册、登录和 API Key 创建,然后通过
configure完成认证。 - API Key 返回 401 时,清除失效值并要求用户重新配置。
- 不要把 API Key 写入 Skill 包、日志或最终回复。
- 使用本 Skill 目录中的
scripts/anspire_api.py,不要假设当前工作目录是 Skill 根目录。 - 输入是身份证、护照、合同、财务票据等个人信息时,提醒用户文件会发送到第三方服务。
使用方法
文档分类
将文档归类到用户提供的候选分类中:
python /path/to/skill/scripts/anspire_api.py classify
--file /path/to/document.pdf
--categories '["身份证","合同","发票","简历"]'
--quiet规则:
--file与--url必须二选一。--categories与--categories-file必须二选一。categories必须是非空、不重复的字符串数组,每个分类名称不能为空。- 分类名称由用户自定义,接口不限定固定类目,数量通常 2-20 个。
- 用户只需要分类结果时增加
--result-only。 - 脚本 stdout 保留 JSON,供后续流程使用;最终回复不要直接倾倒完整原始 JSON。
- 最终回复使用下方展示模板,只展示分类结果和实际生成的输出文件路径。
- 不主动附加分类置信度分析、复核建议或多候选对比,除非用户明确要求。
文档分类展示模板
## 文档分类结果
| 项目 | 结果 |
|---|---|
| 文件 | document.pdf |
| 分类 | 发票 |
| 置信度 | 0.95 |
结果文件:`/path/to/result.json`展示要求:
- 分类名称必须如实展示 API 返回值,不得自行补值或改写。
- 置信度有值时展示,无值时省略该行,不要显示"未识别"。
null、空字符串必须如实展示为"—",不得推断。- 默认不展示
task_id、耗时、request ID 等技术元数据。
document-classify 端点详情
端点:POST /open-api/v1/document/classify
Content-Type:multipart/form-data
multipart 字段名:file
请求参数:
| 参数名 | 类型 | 必填 | 参数说明 | 示例 |
|---|---|---|---|---|
| file | file | 是 | 待分类的 PDF/图片 文件,支持 pdf/jpg/png/tiff | sample.pdf |
| categories | JSON string | 是 | 非空且不重复的分类名称数组 | ["身份证","合同","发票"] |
文件格式支持:pdf、jpg、png、tiff
响应字段(典型结构,以 API 实际返回为准):
| 字段 | 类型 | 说明 |
|---|---|---|
| status | string | success 表示成功 |
| result.category | string | 文档归属的分类名称 |
| result.confidence | number | 分类置信度(0-1) |
| result.scores | object | 各候选分类的得分(可选) |
| error | object | 错误信息(失败时) |
输出与错误处理
- 交互调用默认使用
--quiet,避免摘要和 JSON 重复展示。 - 需要管道处理时同时使用
--result-only。 - 成功时只展示识别结果和输出路径;不要把请求头、API Key 或完整调试日志放入最终回复。
- 失败时根据退出码说明原因(见下方退出码表)。
- 输出文件已存在时不要无提示覆盖;改用新的输出路径或先征得用户同意。
错误处理
根据退出码说明原因:
| 退出码 | 含义 | 处理建议 |
|---|---|---|
| 0 | 成功 | 解析响应 JSON |
| 1 | 参数/Schema/文件格式错误 | 检查参数和文件类型 |
| 2 | API Key 无效或缺失 | 按「安全与执行前检查」第 4 步引导用户 |
| 3 | 权限或配额不足 | 升级套餐或联系商务 |
| 4 | 限流重试后仍失败 | 稍后重试 |
| 5 | 服务端错误重试后仍失败 | 联系支持 |
| 6 | 网络或其他本地错误 | 检查网络和文件路径 |
参考
references/api_reference.md:完整 API 字段、请求响应示例、Schema 进阶用法、凭证管理细节、迁移说明、端点详情。
