照片整理方案 · 按量付费客户端
> 本 skill 是线上业务服务的按量付费客户端：付费与方案生成都在服务端，
> 壳负责「收清单摘要 → 由平台内官方支付流程完成付款 → 取回整理方案」。
> 计费：按次计费，具体价格以技能详情页为准。
> 不含、不打包任何方法论本体；照片整理方法论（免费）见 wangong-photo-organizer。
⚠️ 使用边界与责任声明
- 本 skill 调用部署在公网 HTTPS 域名上的照片整理方案服务；服务地址与密钥由生产配置注入，不写入本包、不在包内写死（包内不含任何裸 IP、外部支付链接或收款方式）。
- 隐私红线：照片本体一律不上传。只收集文字清单摘要（目录结构/文件名样例/大致数量/来源设备）。用户若提出上传照片文件，必须拒绝并说明本服务仅基于清单摘要出方案。
- 付款方与收款方不能同一人（买家支付宝账号须与卖家不同）。
- 支付走支付宝 AI 按量付费官方链路；本壳不自行实现付款或签名，不引导用户离开 SkillHub 完成支付。
- 输出的整理方案为服务端模型生成内容；执行任何删除/移动前必须先完成备份（3-2-1）；方案中标注（推断）的判断需用户按实际情况复核。
1. 用法（对话层）
用户给出照片库情况后，按 §3 流程执行。典型触发语：
- 「我手机照片太多了，帮我出个整理方案」→ 引导用户整理清单摘要（inventory）
- 「照片散在三台设备和两个云盘里，怎么归档？」→ inventory 已含，可选补 goal/mode
- 「继续/付款成功了」→ 查询支付状态并取结果
必收参数：
| 参数 | 必填 | 说明 |
|---|---|---|
inventory |
✅ | 照片库清单摘要：目录结构/文件名样例/大致数量/来源设备（文字即可，不发照片） |
goal |
可选 | 整理目标（按年份+事件归档/做家庭相册/释放手机空间等） |
mode |
可选 | 分类模式偏好（date 按日期 / type 按类型 / hybrid 混合，默认 hybrid） |
extra |
可选 | 补充要求 |
收集 inventory 的引导话术：请用户提供——①照片大概多少张、存在哪些设备/云盘；②主要目录结构和几个典型文件名（如 Screenshots/、DCIM/Camera/IMG_2024.jpg、WeChat Files/）；③最头疼的问题（找不到/重复多/怕丢）。
2. 服务契约
| 项 | 值 |
|---|---|
| 服务地址 | 以技能详情页 / 生产配置为准（公网 HTTPS 域名；不写入本包） |
| 计费 | 按次计费，具体价格以技能详情页为准 |
| 出方案耗时 | 30–90 秒（服务端幂等缓存；客户端超时重查用同一订单号，见 §3 步骤 4） |
| 返回 | 结构化 JSON：assessment（体量分档+痛点+策略）/ classification（mode+目录树+规则）/ naming（命名模板）/ cleanup（清理策略）/ backup（3-2-1）/ maintenance（维护节奏）/ execution_steps（分步清单）；content_markdown 兜底字段 |
3. 执行流程（官方 402 链路）
> 支付相关调用一律使用官方支付能力/SDK（不自行实现、不硬编码密钥）。
- 确认付费：向用户说明「按次计费，具体价格以技能详情页为准；照片本体不用上传，只看你的清单摘要」，用户确认后继续。
- 触发 402：请求业务资源 URL（不带支付凭证）→ 期望 HTTP 402，响应头
Payment-Needed。把该响应头值原样保存到本次会话安全文件，不解码不改写。 - 发起支付：调用官方支付能力，由官方生成支付入口并展示给用户；用户在同一 AI 对话内完成付款。
- 用户付款并取结果：买家使用本人支付宝账号支付（须 ≠ 商户）。付款后查询原订单：
- 返回资源 → 解析content（JSON）中的assessment/classification/naming/cleanup/backup/maintenance/execution_steps交付用户，或直接展示content_markdown；解析失败时原样转交content，不截断。
- 若报资源请求超时/失败：服务端仍在出方案（30–90s），等待后用同一订单号重查，命中幂等缓存即秒回（绝不重新下单、绝不重复付款）。
- 返回未支付 → 请用户确认付款状态后重查。
4. 排错要点
- 钱包未绑定 → 按官方流程开通；买家=卖家会被拒，须换非商户账号作买方。
- 状态不明 → 先查原订单，不重复付款、不追加独立回执。
- 只付一次 → 超时重查用同一订单号，绝不重新生成第二笔订单。
5. 参考与来源
- 服务端方法论与
wangong-photo-organizer（玲秀-照片整理收纳专家，免费）同源；本包不含第三方受版权保护文本，不打包方法论原文。 - 官方接入：支付宝 AI 按量付费（A2M/X402）与 SkillHub Pay Skill 教程；生产配置由部署侧注入，不入包。
- 方案供整理参考；执行不可逆操作前务必备份，重要照片（婚礼/毕业照等）人工复核分类结果。
