文档交付体检 · 付费版
按次计费 0.10 元。必须完成支付才能出报告。
何时用
用户即将把 Excel / Word / PDF 发给客户、领导、投标方、审核方,或刚收到别人发来的文件要判断能不能直接用:
- 「这份表能不能直接发」
- 「为什么对方打开是 ### 或 1.23E+17」
- 「这 PDF 能不能复制文字」
- 「文档里是不是还留着修订痕迹和批注」
不适合:需要真正修改文件内容(本技能只读,不改文件)、需要 OCR 识别图片文字(只报告"无文字层",不做识别)。
前置
export PAYSKILL_BASE_URL=https://<你的后端域名>
python scripts/client.py --help
未配置时脚本直接报错退出,此时告知用户「付费通道未配置」,不要改成本地跑。
流程
1. 拿账单
python scripts/client.py bill --file "报告.xlsx"
支持 .xlsx .xlsm .docx .pdf,单文件 ≤ 20 MB。返回 402 与账单(金额、订单号、收款方、有效期)。
把账单原样给用户看,明确说:付款后再跑 deliver 才会出报告。
2. 用户付款
python scripts/client.py deliver --file "报告.xlsx" --proof '<Payment-Proof>' --trade-no '<可选>'
成功时脚本直接打印格式化报告:文件、结论、高/中/低计数、逐条问题(严重度、规则、位置、为什么、怎么改),并打印 [已验付]。
3. 结果解读(你的部分)
报告是按严重度排好序的。呈现时:
- 先给结论:
verdict一句话说清「能不能交付」 - 只讲需要动手的:高严重度逐条讲为什么致命、怎么改
- 中低风险合并讲:一笔带过,不要淹没重点
- 不要重排严重度,不要自己降级「高」项
失败处理
402→ 凭证无效/过期,重新bill拿新账单409→ 交易号已被别的订单用过,换新付款500/502→ 用同一个 Payment-Proof 重试一次,服务端幂等不重复扣费
覆盖的规则
| 严重度 | 规则 |
|---|---|
| 高 | 证件/手机/卡号被存成数值或科学计数法;缓存错误值;修订痕迹未接受 |
| 中 | 合并单元格;重复列名;空表头;公式硬编码数字;批注残留;疑似扫描件 |
| 低 | 文件名特殊字符;表头不在首行;标题样式跳级;超长段落;页面尺寸不一致 |
边界
- 只读:绝不修改用户文件,改法只给建议
- 不外传:文件只用于本次解析,服务端不落盘
- 不判断业务正确性(比如金额算得对不对),只查交付层面的技术缺陷
定价与计费
- 单价 0.10 元 / 次,一次 = 一个文件的完整体检报告
- 同一
Payment-Proof重试不重复扣费 - 账单有效期 30 分钟
文件
scripts/client.py— 付费接口客户端(bill / deliver)