拍立叙照片云端分类（付费）

概述

拍立叙照片云端分类（付费 Pay Skill）

把一张照片自动归入 8 大摄影题材（人像 / 风景 / 建筑 / 纪实 / 生态 / 航拍 / 夜景 / 植物）。本 Skill 是调用壳：接收用户图片 → 校验 → 转发到拍立叙后端 API → 返回分类与置信度。核心分类逻辑运行在拍立叙自有服务器，不随本 Skill 包上传（照片不出机、源码不外泄）。

触发场景

• 用户说「把这张照片按题材分类」「识别这张图属于哪类摄影题材」「批量归类我的照片」。
• 输入：一张图片的本地路径（或对话中给出的图片）。
• 输出：分类类别 + 置信度 + 8 类评分明细（JSON）。

支付声明（X402 / WeixinPay-Required）

本 Skill 为 Pay Skill，已按 SkillHub 微信 Agent Pay（X402 协议）完成改造：

1. 首次调用 skill_cli.py classify --image xxx 时，后端返回 HTTP 402 与 WeixinPay-Required 支付码；
2. SkillHub 平台将 WeixinPay-Required 作为 paymentCode 交给 weixinpay_pay 向用户申请微信支付授权；
3. 用户支付成功后，平台再次调用本壳并注入 X-Out-Trade-No 订单号；
4. 后端查单验证通过后执行真实分类，返回结果。

价格由商家在 SkillHub 后台设定（建议 0.1 元/张 或 9.9 元/100 张）。

注：pay: true / pay_price 为支付能力声明字段；SkillHub 后台「简易改造教程」若有正式字段名，以后台为准。

前置检查与异常处理

前置检查

本 Skill 为 Pay Skill，首次调用依赖 SkillHub 平台识别 HTTP 402 响应并自动调用 weixinpay_pay 插件完成微信支付授权。运行前请确保：

• SkillHub 运行环境已安装 weixinpay_pay 插件/工具；
• 环境变量 PAILIXU_CLASSIFY_API 与 PAILIXU_CLASSIFY_TOKEN 已正确配置；
• 后端服务 https://pailixu.com.cn 可正常访问。

若 weixinpay_pay 不可用，首次调用将无法完成支付授权，本 Skill 不会执行后续分类逻辑。

异常处理

• 未支付/支付失败：用户拒绝支付、支付超时或微信支付失败时，平台不会向本 Skill 注入 X-Out-Trade-No，本 Skill 不调用后端分类接口，直接返回当前错误提示，不扣次数、不返回分类结果。
• 支付后查单未支付：重试时后端若发现订单仍未支付，返回「订单未支付，请完成支付后重试」，不执行分类。
• 退款政策：本 Skill 提供的是一次性调用服务，支付成功后即视为消费完成，不支持退款。
• 网络/后端超时：后端不可达时返回可理解的错误信息；后端短暂异常时，本 Skill 不缓存、不重复提交。

运行方式（沙箱壳）

SkillHub 云端沙箱执行入口为 skill_cli.py（遵循平台 python skill_cli.py <tool> --args 约定）：

python3 skill_cli.py classify --image /path/to/photo.jpg

脚本行为：

1. 读取图片，做大小/格式基础校验；
2. 携带 Bearer 令牌（环境变量 PAILIXU_CLASSIFY_TOKEN）POST 到后端 PAILIXU_CLASSIFY_API；
3. 首次调用时后端返回 402 + WeixinPay-Required + X-Out-Trade-No，由平台完成微信支付；
4. 支付成功后重试，本壳透传 X-Out-Trade-No Header，后端查单履约后返回分类结果（category / confidence / scores）。

工具（tools）

• classify：对单张图片做 8 大类题材分类。参数 --image（图片路径，必填）。

环境变量（沙箱壳配置）

• PAILIXU_CLASSIFY_API：拍立叙后端对外网关地址（商家在 SkillHub 后台填入，例如 https://pailixu.com.cn）
• PAILIXU_CLASSIFY_TOKEN：后端网关 Bearer 令牌（商家注入，沙箱壳不落地明文）
• X_OUT_TRADE_NO（可选）：SkillHub 平台在支付后重试时注入的 X402 订单号，本壳会自动透传给后端

隐私与合规

• 照片仅在分类请求期间经 HTTPS 传输到商家后端，分类完成即丢弃，不留存、不训练。
• 后端默认走离线启发式分类（PIL，零外部调用）；高级语义引擎不可用时自动回退，永不 5xx。
• 本 Skill 不含任何服务器 IP、账号密码等敏感信息。

依赖

• Python 3.10+，httpx（运行时由沙箱环境提供）