拍立叙摄影照片点评师

概述

这是什么

一个面向摄影人的轻量付费 Skill：你丢一张照片过来，它告诉你——

• 这张照片是什么题材（8 大类：人像/风景/建筑/纪实/生态/航拍/夜景/植物）
• 清不清晰（拉普拉斯方差评估，模糊/一般/清晰/锐利）
• 曝光正不正常（偏暗/正常/过曝）
• 怎么用（适不适合做早安视频背景、归到时光档案哪一类、要不要先校正）

为什么要它

普通人拍完照不知道「这张值不值得留、能不能做成片」。这个 Skill 把拍立叙沉淀的摄影理解能力，做成一次一评的轻服务，传图即得结论。

运行方式（重要）

本 Skill 是 Pay Skill（依赖后端服务）：沙箱壳只负责接收图片 + 转发请求，真实逻辑运行在拍立叙服务器（pailixu.com.cn），源码不随本包上传、照片不出端。

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

1. 首次调用返回 HTTP 402 + WeixinPay-Required 支付码；
2. 平台调用 weixinpay_pay 完成微信支付授权；
3. 支付成功后平台重试，注入 X-Out-Trade-No，后端查单履约后返回点评结果。

前置检查与异常处理

前置检查

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

• SkillHub 运行环境已安装 weixinpay_pay 插件/工具；
• 环境变量 PAILIXU_REVIEW_API 与 PAILIXU_REVIEW_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 review --image /path/to/photo.jpg

工具（tools）

• review：对单张照片做题材/清晰度/曝光/用法点评。参数 --image（图片路径，必填）。

参数

• image：待点评的图片文件（jpg/png，≤10MB）

输出示例

{
  "category": "风景",
  "confidence": 0.87,
  "sharpness": {"score": 142.3, "level": "清晰"},
  "exposure": {"level": "正常", "mean": 128.0},
  "recommendation": "画面清晰，适合直接用于早安视频背景。曝光正常，色彩观感稳。自然题材，暖调日出/海面更易出「很有感觉」的成片。归类建议：时光档案「风景」类。"
}

环境变量（沙箱壳配置）

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

隐私

照片仅用于本次点评，经 HTTPS 转发到拍立叙后端即时处理，不落盘、不留存、不用于训练。