PDF可视化分割工具技能
功能概述
本技能提供直观的PDF页面分割功能，用户可以在PDF页面上添加分割线标记，程序自动识别并切割页面。
核心特性
- ✅ 可视化分割标记编辑器 - 在PDF页面上直观添加分割线
- ✅ 水平/垂直分割线 - 支持任意方向的分割
- ✅ 单页分割模式 - 只切割当前选中页面
- ✅ 多页分割模式 - 批量切割所有页面
- ✅ 分割线位置调整 - 拖拽调整分割线位置
- ✅ 预览功能 - 实时预览分割效果
- ✅ 批量处理 - 支持同时处理多个PDF文件
触发指令
基础用法：
- "分割这个PDF页面"
- "PDF页面切割"
- "把PDF分成多个小页面"
高级用法：
- "在 [页码] 页添加水平分割线，位置在 [距离顶部比例]"
- "对PDF所有页面进行 [水平/垂直] 分割，分割成 [行数]x[列数]"
- "打开PDF分割编辑器"
工作流程
1. 文件加载
- 接收用户上传的PDF文件
- 解析PDF页面信息（页数、尺寸、方向）
- 显示页面缩略图列表
2. 分割模式选择
| 模式 | 说明 | 适用场景 |
|---|---|---|
| 单页分割 | 只分割当前选中的页面 | 只对特定页面进行分割 |
| 多页分割 | 对所有页面应用相同分割规则 | 批量处理相同布局的页面 |
| 自定义模式 | 每页独立设置分割线 | 页面布局不统一时使用 |
3. 分割线设置
分割线类型
- 水平分割线：将页面上下分割
- 垂直分割线：将页面左右分割
- 网格分割：同时添加水平和垂直分割线
分割线参数
| 参数 | 说明 | 取值范围 |
|---|---|---|
| 位置 | 分割线距离页面边缘的百分比 | 0% - 100% |
| 数量 | 同方向分割线的条数 | 1 - 10 |
| 等分 | 自动均匀分布分割线 | 2 - 10 等分 |
| 偏移量 | 分割线位置的微调 | -10% - +10% |
4. 可视化编辑器操作
添加分割线
- 在页面预览区域点击，弹出分割线添加菜单
- 选择"添加水平分割线"或"添加垂直分割线"
- 分割线会以虚线形式显示在页面上
- 拖拽分割线调整到精确位置
操作方式
- 拖拽移动：点击分割线并拖动调整位置
- 双击删除：双击分割线可删除
- 右键菜单：显示更多操作选项
- 键盘快捷键：支持精确数值输入
显示设置
- 分割线颜色：红色（默认），可自定义
- 分割线样式：虚线（默认），可切换为实线
- 显示坐标：实时显示分割线位置百分比
5. 分割执行
分割算法
支付宝付费改造契约（PAYSKILL）
本技能为付费技能（PAYSKILL）。调用遵循支付宝 AI 生意画像契约，由平台调度层执行 probe → pay → complete → ack 流程：
- probe（探测）：平台调用前先探测是否已持有本技能的支付宝有效订阅 / 付费凭证。已付费则直接放行。
- 402 Payment-Needed：未付费时，脚本向标准输出返回 HTTP 状态
402与Payment-Needed标记，提示用户通过支付宝完成付费（pay），平台据此唤起付费页。 - complete（扣费确认）：用户在支付宝完成扣费后，平台下发
Payment-Proof（付费凭证）。 - ack（验签放行）：平台携带
Payment-Proof重试本次调用；scripts/payment_gate.py验签该凭证，确认有效后放行主流程。
订阅持久化与幂等：
- 付费状态缓存在本地
.pay_cache/state.json，避免每次调用重复付费（订阅持久化）。 - 同一
Payment-Proof在 24h 幂等窗口内仅生效一次，避免重复扣费。
现金流改造后的调用套路：
用户调用 → 平台 probe →
未付费：下发 402 Payment-Needed → 支付宝 pay → complete → 下发 Payment-Proof
已付费/携带 Proof：脚本 ack 验签 → 放行主流程
> 本契约由 SkillHUB 平台调度层解析，脚本本地仅处理 402 / 验签 / 持久化 三环节；付费本体交给支付宝。
支付宝 AI 按量付费（Machine Pay / A2M）改造说明
本 Skill 已按支付宝官方 A2M 协议改造为 Pay Skill，付费闸口位于 scripts/payment_gate.py，统一调用云端计费服务 https://pay.pembroli.cn/api/resource。
付费流程
- 未付费调用时，服务端返回 HTTP 402 +
Payment-Needed头，携带金额、商户、订单号及 RSA2 签名。 - 买家侧
payment_gate.py收到 402 后引导用户完成支付，平台回传Payment-Proof。 - 客户端携带
Payment-Proof重试资源端点。
验付调用
服务端收到 Payment-Proof 后，调用支付宝验付接口（alipay.aipay.agent.payment.verify）核验凭证有效性（trade_no、out_trade_no、active 状态），验证失败返回 400，验证通过才进入资源发放。
履约确认
资源发放成功后，服务端异步调用履约确认接口（alipay.aipay.agent.fulfillment.confirm，trade_no）回执，标记本笔订单已履约；并按 out_trade_no 做幂等，重复请求直接返回已缓存结果，杜绝重复收费。
幂等与缓存
买家侧按 slug 本地缓存 Payment-Proof（24h TTL），有效期内免重复支付；服务端按订单号幂等，保证同一笔订单只履约一次。
