PDF智能处理工坊 (pdf-smart-processor)

中文名 / 英文名

PDF智能处理工坊 / pdf-smart-processor

取名理由 / 方式

• 英文名 pdf-smart-processor：pdf 指明处理对象，smart 体现"解析→增强→重构"的智能三阶段，processor 译为"工坊/处理器"。
• 中文名采用"对象 + 特性 + 品类"三段式命名，用户一眼即知用途与差异化（智能、一站式）。

上架文案（提交平台时填的文字介绍）

PDF智能处理工坊 —— 一个 Skill 搞定 PDF 的"读、懂、用"，丢个 PDF 进来，选阶段，一键处理。

> 什么时候用？
> - 论文/报告：抽取正文 + 参考文献 + 公式
> - 合同审查：结构化抽取条款
> - 发票/表单：识别字段，导出结构化数据
> - 电子书：拆分章节，转 Markdown
> - 档案数字化：批量 OCR 检测 + 元数据提取
>
> 怎么用？选阶段（解析 / 增强 / 重构），一键处理。纯本地运行保护隐私；线上 API 调用触发 402 支付（0.01 元/次），付款后返回资源并完成商家履约。

21 项功能（三阶段有序合力）

A · 结构解析层（解决"读懂"，7项）

B · 智能增强层（解决"读懂且理解"，7项）

| 8 | OCR退化检测 | 识别扫描件/模糊页 |
| 9 | 版面语义标注 | 标注标题/正文/列表/引用 |
| 10 | 章节自动分级 | 自动构建目录大纲 |
| 11 | 公式/代码块识别 | 区分公式、代码与普通文本 |
| 12 | 引用文献结构化 | 提取参考文献列表 |
| 13 | 关键词实体抽取 | 抽取人名/机构/术语 |
| 14 | 语言/编码判别 | 自动识别语种与编码 |

C · 重构输出层（解决"用好"，7项）

| 15 | 按章节拆分 | 按标题拆分为多个文件 |
| 16 | 合并拼接 | 多 PDF 按顺序合并 |
| 17 | 水印批注处理 | 识别/添加/去除水印与批注 |
| 18 | 表单域识别 | 提取可填写表单字段 |
| 19 | 加密权限适配 | 处理加密与权限限制 |
| 20 | 格式互转 | 转 Markdown/HTML/JSON/文本 |
| 21 | 增量差异比对 | 两版 PDF 内容差异高亮 |

有序合力：A(读懂) → B(理解) → C(用好)，顺序不可颠倒，形成闭环。

触发词

PDF处理、PDF转Markdown、PDF表格提取、论文PDF提取、合同审查、发票表单识别、PDF智能解析

输入标准化

• file_path (必填): PDF 文件路径
• stage (可选): parse | enhance | reconstruct | all（默认 all）
• output_format (可选): markdown | html | json | txt（默认 markdown）
• preserve_layout (可选): true / false

输出标准化

• status: success / fail / 402_payment_needed
• data: 处理结果（文本 / 结构化数据）
• payment_info: 若 402，返回 Payment-Needed 头与账单
• trace_report: 处理轨迹（量化报告）
• annotations: 关键修改批注

付费与 402 链路（符合 SkillHub 上架规范）

• 未付款请求：服务端返回 HTTP 402 + Payment-Needed 响应头
• 付款后：携 Payment-Proof 重试原请求，服务端验付 → 交付资源 → 商家履约确认
• 订单幂等：同订单重试不重新扣费，状态可恢复（SQLite 持久化）
• 依赖：买家侧 @alipay/agent-payment，服务端 @alipay/alipay-aipay
• 不自行实现付款/签名，调用官方 alipay-payment-skill
• 价格一致：支付宝登记价 = 服务端 402 账单 = SkillHub 展示价 = 0.01 元/次

技术特性

• ✅ 无敏感权限（permissions: []）
• ✅ 无外部 API 强依赖（external_api_dependencies: []，支付为可选官方 Skill 依赖）
• ✅ 可复用、可扩展（三阶段分层，各层可独立扩展）
• ✅ 命名规范（小写英文 + 中文名）

建议上架分类标签

• 一级分类：文档 (document)
• 二级分类：PDF 处理 (pdf-processing)

开发者

张郃 (yznocz / 张杨)

版本

1.0.0