软装旧改Skill

概述

旧房改造付费生图

原则

• 每次正式调用只生成 1 组结果，收费 1 元。
• 必须先获得至少 1 张用户原始空间图片；没有图片时只提供方案建议，不发起付费生图。
• 不在 Skill 内保存腾讯云、微信支付或 SkillHub 开发者私钥。
• 调用前确认 config.json 中的 paid_image_api_url 已替换为正式腾讯云函数域名；也可使用环境变量 PAID_IMAGE_API_URL 覆盖。
• 调用前检查当前 Agent 的可用工具名称中是否存在包含 weixinpay_ 的微信 AI 支付工具（例如 weixinpay_pay）；未发现时停止付费流程并明确提示用户。
• 不向用户承诺完全还原尺寸、材质或施工结果，输出定位为设计效果参考。

生图前确认

从用户现有信息中提取并补齐：

1. 空间类型。
2. 目标风格与色彩。
3. 必须保留的墙体、门窗、地面、吊顶和固定柜体。
4. 需要更换或移除的家具、灯具、窗帘、饰品。
5. 居住者、预算档位及特殊需求。

仅在缺少会明显改变结果的关键信息时追问一次。优先参考 references/diagnosis-framework.md、references/space-solutions.md 和 references/style-prompts.md 组织中文提示词。

付费调用流程

本 Skill 按 SkillHub 官方 Pay Skill（微信 Agent Pay X402）流程工作。服务端点为：

POST https://1453341305-b7xcg9k6m3.ap-guangzhou.tencentscf.com/api/resource

调用前必须确认当前 Agent 的可用工具名称中存在包含 weixinpay_ 的微信 AI 支付工具；未发现时停止流程并提示用户。通过检查后，再按下方流程将支付凭证交给 weixinpay_pay。

官方支付链路

1. Agent 先向上述服务端点发送包含 prompt、images、resolution、revise 和 request_id 的 JSON 请求。
2. 首次请求应返回 HTTP 402，并包含响应头 WeixinPay-Required 和 X-Out-Trade-No，Body 的 WeixinPay.WeixinPay-Required 与响应头支付凭证一致。
3. 将支付凭证的值作为 paymentCode 交给 weixinpay_pay，由 Agent 向用户发起授权支付；Skill 不自行伪造支付成功状态。
4. 支付成功后，使用完全相同的 JSON 请求体重试原端点，并原样携带 WeixinPay-Required 与 X-Out-Trade-No 两个请求头。
5. 收到 HTTP 200 和生成结果后再向用户交付；收到 NOT_PAID 时等待后用原订单重试，收到 REFUNDED 时停止重试并告知用户已退款。

第一步：准备完全固定的请求

使用 scripts/call_paid_image.py，为本次调用生成唯一 request_id。请求包含：

• prompt
• images：1–3 张 URL 或 Base64 图片
• resolution：默认 1024:1024
• revise：默认 1
• request_id

首次请求和支付后的重试必须使用完全相同的 JSON 内容及同一个 request_id。

第二步：处理 HTTP 402

首次请求返回 402 时，读取并保留：

• WeixinPay-Required
• X-Out-Trade-No

将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay 完成用户授权与支付。不要自行伪造“已支付”状态。

第三步：支付后重试

支付成功后，使用完全相同的请求 JSON 再次调用；请求头原样携带：

• WeixinPay-Required
• X-Out-Trade-No

若返回 PROCESSING，等待数秒后使用同一订单和同一 JSON 重试，不要创建新订单。

第四步：返回结果

• SUCCESS：展示 content.images 中的图片，并说明这是 AI 改造效果参考。
• NOT_PAID：提示支付仍在确认，稍后使用原订单重试。
• REFUNDED：明确告知本次服务失败且已发起退款，不再次扣费。
• FULFILL_AND_REFUND_FAILED：停止调用，提示用户联系商家处理。
• 内容安全拒绝：说明图片或文案未通过模型审核；以服务器退款结果为准。

输出说明

生成完成后简要说明：改造主题、主要保留项、主要替换项、色彩材质关系和落地提醒。不要虚构精确报价、真实品牌型号或施工尺寸。