数据变图表图片(一次付费 7 天不限次)
把一列数据变成能直接放进报告里的图。
本 Skill 分两段:先用第 0 步判断该用什么图,再取授权产出图表(在你本机完成,数据不出本机)。
> 为什么需要授权:产出图表需要一份由服务方签发的凭证。
> 授权在你本机离线校验,但没有有效授权就不产出图表——这是服务的一部分,不是限制。
第 0 步 · 前置检查(必做,先判值不值得用)
| 检查项 | 判定 |
|---|---|
| 数据形态 | 支持 CSV / JSON。一列一含义、有表头最省事;合并单元格的 Excel 请先另存为 CSV |
| 该用什么图 | 分类比大小 → 柱状图;随时间变化 → 折线图;占比 → 饼图/环图;两变量关系 → 散点图。这一步不花授权费,想清楚再往下走 |
| 期望 | 它只画图,不做数据清洗。缺值、单位混在一列(「1.2万」)这些先处理好——它不会猜 |
| 输出格式 | SVG:可嵌网页、可转 PDF、放进文档不失真。要 PNG 请用户自己转 |
第 1 步 · 请求授权(未付费会返回 402)
POST https://skills-gate.airpriv.com/api/plot-forge-license
Content-Type: application/json
{"machine_fp":"<本机指纹串,8–128 位,可省略>"}
首次调用一定拿到 402 Payment Required(设计如此)。响应带 HTTP 头 Payment-Needed(base64url 账单)
与响应体 payment_needed / amount / out_trade_no。
本机指纹:python scripts/license_check.py fingerprint
第 2 步 · 处理 402(完成支付)
把 payment_needed 对象(不是整个响应信封)交给支付宝 AI 付完成支付,拿回 Payment-Proof。
不要自己伪造 —— 服务端会拿它去支付宝网关做真实校验。
第 3 步 · 携凭证重试(拿到授权凭证)
同一请求加上头 Payment-Proof: <凭证> 重发,成功返回 200,
content.data.license = 授权凭证(存成 license.json)。
一次付费 = 一份授权 = 7 天有效,期间反复出图不需要再付费。
第 4 步 · 校验授权并执行出图(离线)
python scripts/license_check.py check license.json --fingerprint "<与第 2 步相同的值>"
echo $? # 0 = 放行;非 0 = 拒绝,不要执行
退出码:0 通过 · 4 签名不通过 · 5 已过期 · 6 产品不匹配 · 7 指纹不匹配 · 2 路径问题。
退出码 0 才允许执行:
python scripts/run_paid.py <数据.csv|json> -o <图表.svg> --type bar
# --type: bar 柱 / hbar 横条 / line 折线 / area 面积 / pie 饼 / donut 环 / scatter 散点
交付时把图表文件 + 「这条轴为什么这么取」的说明一起给用户。
交付给用户的说法(照这个口径,别夸大)
- 刻度被吸附到好看的数,所以轴上不会是 437.2 这种读不出数的值。
- 柱状图的基线一定是 0——这样柱子高度的比例才是真的。
- 折线图如果截断了纵轴,图上会标出来,不会让人误读。
- 标签太多会自动抽稀,宁可少标几个也不叠成一团黑。
- 数据里有什么就画什么,它不做清洗、不填补缺失值。
诚实边界(用户问到时照实说)
- 授权是「付费门」,不是版权保护。它防「没付钱就用」,不防「付一次之后自行延长使用」。出图必须在你自己的机器上跑——架构上不可兼得。
- 出图全程在本机完成:数据不上传、产物不出本机。授权服务只收一个可选的机器指纹。
- 它是零依赖实现(不装绘图库),代价是图表样式朴素——要品牌配色请自行在 SVG 里改色值。
<!-- skillhub-payblock -->
付费链路自检(与平台五项自查一一对应)
本 Skill 的付费链路由服务端承担验付、资源交付与商家履约确认;Skill 只负责
发起请求、调用官方支付能力并展示结果。逐条对应平台自查项如下:
| 平台自查项 | 本 Skill 的实现 |
|---|---|
| 402 账单 | 未付款时请求 POST https://skills-gate.airpriv.com/api/plot-forge-license 返回 HTTP 402 Payment Required;响应头 Payment-Needed 携带账单,响应体含 payment_needed / amount / out_trade_no。 |
| 凭证重试 | 支付后携带请求头 Payment-Proof: <凭证> 重发同一个请求(URL、请求方法、请求体与原请求保持一致),服务端校验通过后返回 200,结果在 content.data 内。 |
| 服务端验付 | 服务端调用支付宝 AI 按量付费凭证校验接口 alipay.aipay.agent.payment.verify 验签并核对订单、金额与服务标识;凭证无效或已过期时不交付任何资源,只回 402 账单让用户重新支付。 |
| 商家履约 | 资源交付后由服务端调用 alipay.aipay.agent.fulfillment.confirm 上报履约确认;上报失败可对同一订单重试,重试幂等,不会产生第二次扣费。 |
| 订单与幂等 | 每笔订单以唯一 out_trade_no 持久化于服务端订单库,状态可恢复;同一订单重复请求只履约一次、不重复扣费;本机授权凭证可离线校验(python scripts/license_check.py check license.json),有效期内重复使用不再计费。 |
> 支付能力由支付宝 AI 按量付费官方链路承担,本 Skill 不接触支付密钥、不自行实现付款或签名。
<!-- /skillhub-payblock -->