Auto

auto — 付费解锁后获取主题最佳执行步骤

功能描述

输入一个「主题」，auto 返回该主题最优质的执行步骤提示。步骤来自 mcp.auto 已沉淀内容；当无沉淀时，按优先级从技能市场 / 社区 / 开源 / 搜索兜底检索最优质方案并逐步执行，解决后回写沉淀。

读取与回写均需 ¥9.9 付费解锁：未付费 → 服务端返回 HTTP 402，由调用方代理支付后携凭证重试解锁（详见「服务与定价」「付费与凭证」）。

主流程（决策树 · 绝对清晰）

0. 【付费前置检查】 确认当前 Agent 已具备微信支付能力（weixinpay）：未具备 → 提示「当前环境暂不支持付费能力」并终止，不进入后续流程。
1. 【解析主题】 以 theme 定位主题，调用 mcp.auto/theme（携带已付凭证；无则走付费）。
2. 【命中】 返回 list[] 非空且已付费 → 直接交付步骤，结束。
3. 【付费闸 · 价格确认】 未付费 → 先向用户展示服务名称「AUTO 主题步骤」与价格 ¥9.9/主题，用户确认后进入支付：服务端返回 HTTP 402（含 order_id + secret 凭证 + WeixinPay-Required 头）→ 代理支付 → 持久化凭证 → 携凭证重试 → 拿到步骤 → 交付（见「付费与凭证」）。⚠️ 支付成功后必须主动原样重试获取内容，不可假定已解锁。
4. 【兜底】 mcp.auto 无结果（空 / 错 / 不可达）→ 按优先级检索并逐步执行：技能市场 → 社区 → 开源 → 通用搜索（设合理检索轮次上限，避免无限迭代）。
5. 【回写】 任务解决后，把本次步骤按主题关联到 mcp.auto（写操作，同样需已付凭证；无/无效→402 拒绝不写）。
6. 【收尾】 向用户交付步骤与结论。

退款分支： 步骤 4【兜底】执行后，若已付费却仍未能交付任何有效步骤 → 触发「退款保障」自动原路退款 ¥9.9，无需用户申请（见下「退款保障」）。

服务与定价

• 命中主题检索意图后，先向用户展示服务名称与价格，由用户确认再进入付费流程。
• 当前无免费额度，全量付费（如后续开放免费/试用，以 amount=0 跳过支付为准）。

付费与凭证（接口约定）

• 无凭证 / 未付费：请求返回 HTTP 402，响应体同时回显 order_id + secret 凭证，并带 WeixinPay-Required 响应头。
• 处理流程：把 WeixinPay-Required 的值交 weixinpay_pay 代理支付；支付成功后将 order_id + secret 写入固定位置 ~/.agent/skill/auto/config.json 并提醒用户保存；下次同主题调用先读该文件，携凭证重试即解锁，无需重复付费。
• 原样重试（⚠️ 必须执行）：支付成功后必须重新发起请求获取付费内容。重试时请求业务字段（theme / steps）保持不变，订单凭证经请求头 X-Order-Id + X-Auto-Secret 传入（亦可兼容官方 A2M 规范的 X-Out-Trade-No 头，值 = WeixinPay-Required 的 payment_code；或放 order_id / secret 参数）。推荐走请求头，保持业务体纯净。
• 写操作：回写同样需已付凭证；无凭证 / 无效未付 → 返回 402 并拒绝写入。
• 错误脱敏：服务端返回的错误信息不含内部地址、日志或实现细节；失败仅回显状态与可操作提示。
• 完整字段与 402 结构见 references/auto-pay.json。

能力与边界

• 知识面（mcp.auto）：主题 → 步骤检索入口。
• 兜底面（检索 + 执行）：mcp.auto 无沉淀时主动去技能市场 / 社区 / 开源 / 搜索找最优质方案并落地。
• 沉淀面（回写）：兜底跑通后回写步骤，让同主题下次直接命中。
• 隐私：返回的步骤列表不含联系方式类字段（contact / phone / wechat 等），仅展示 content / price / images / 时间等非隐私信息。

退款保障

付费在前、交付在后，故退款触发收窄为「零价值」窄场景，避免无谓退款：

• 触发：已付费（持有效凭证） + 该主题 mcp.auto 无沉淀（空 / 不可达） + 【兜底】检索与执行整体失败 → 用户付费但未获得任何步骤 → 自动原路退款 ¥9.9。
• 无需用户申请：由 Agent 在流程中判定交付失败后，直接调 /auto/refund（带 order_id + secret）发起退款。
• 退款状态：order.status=2（已付费待交付）→ order.status=4（退款完成，微信退款回调确认后写入）。
• 退款失败兜底：若退款发起失败（返回 FULFILL_AND_REFUND_FAILED），向用户说明并建议联系客服，不要再次尝试支付或重新请求。
• 不退款的边界：只要【兜底】能产出哪怕一条可执行步骤，即视为已交付，不退。
• 完整契约（触发条件 / 退款字段 / 幂等 / 状态机）见 references/auto-pay.json 的 refund 段。

输出验收（好步骤的判定）

返回 / 交付的步骤应满足：

• 可执行：每条是明确动作 / 命令 / 结论，而非空泛描述。
• 有序：按 order 或数组顺序形成可逐步跟随的流程。
• 非隐私：仅含 content / price / images / 时间等，不含联系方式类字段。
• 可溯源：经兜底检索得到的，附出来源（技能市场 / 社区 / 开源 / 搜索）便于复核。
• 交付格式：统一以 list[] 返回，每条含 content（必填）/ type / order / price / images，并附 total 与 unlocked 状态。

使用骨架

主题检索：

POST /auto/theme  { theme: "火锅探店" }
→ 已付费      { errCode:0, unlocked:true, list:[...], total:N }
→ 未付费 402  { order_id, secret, WeixinPay-Required } → 展示价格+确认 → 代理支付 → 持久化 → 重试

步骤回写（写操作，需已付凭证）：

POST /auto/save  { theme: "火锅探店", steps:[...], order_id, secret }
→ 已付 { errCode:0, saved:N, order_id, secret }
→ 无凭证 402 → 拒绝不写

Examples

例 1：主题已沉淀（直接命中）

POST /auto/theme { theme:"周末露营" } + 凭证
→ { errCode:0, unlocked:true, list:[...执行步骤], total:N }

例 2：主题无沉淀 → 价格确认 → 付费闸 → 代理支付 → 重试

POST /auto/theme { theme:"周末露营" }
→ 402 + WeixinPay-Required + body.order_id + body.secret
→ 展示「AUTO 主题步骤 ¥9.9」请用户确认 → weixinpay_pay 代理支付 → 写 ~/.agent/skill/auto/config.json
→ 再 POST /auto/theme { theme:"周末露营" } + X-Order-Id + X-Auto-Secret
→ { errCode:0, unlocked:true, list:[...], total:N }

例 3：mcp.auto 无结果 → 兜底检索 + 回写

用户：「火锅探店主题怎么落地」（已持该主题已付凭证）
→ mcp.auto/theme 空 / 不可达 → 兜底：技能市场/社区/开源检索最优质探店清单 → 逐步执行
→ 解决后 POST /auto/save { theme, steps, order_id, secret }
→ { errCode:0, saved:N, order_id, secret }

前置依赖

• mcp.auto 服务端可达（https://mcp.fore.vip）。
• 微信支付能力（weixinpay）：用于付费闸代理支付。调用前须确认已安装，未安装则按【付费前置检查】终止。

错误处理

References

Changelog

1.4.2

• 上架前最后一版收敛（仅文档/契约层面，后端实现不变）：修正 SKILL.md 凭证持久化路径笔误（~/.agents/skills → ~/.agent/skill）；清除 auto-writeback.json 中「需服务端上线后生效」的过时说明（/auto/save 已实现并随 auto 云对象上线）；统一全包版本号（mcp.json 旧 1.3.0 → 1.4.2，其余 1.4.1 → 1.4.2）。保持前端视角、不暴露后端。

1.4.1

• 对照官方 X402 商户 Skill 示例补齐：新增独立「功能描述」标题；主流程补回「退款分支」指针；重试加「必须执行」强调并兼容官方 A2M 规范的 X-Out-Trade-No 重试头；错误表补 NOT_PAID 与 FULFILL_AND_REFUND_FAILED 两行、退款保障补「退款失败兜底」（服务异常且退款失败时建议联系客服）。文档保持前端视角。

1.4.0

• 新增「退款保障」：若付费后未能交付有效步骤（主题暂无沉淀且兜底检索也失败），系统将自动原路退款 ¥9.9，无需用户申请；并在文档中补充了退款说明与状态说明。

1.3.0

• 对照智绘图片生成（同类付费 API 技能）拉齐付费体验：新增「付费前置检查」（确认 weixinpay 能力，未装优雅终止）、「服务与定价」（¥9.9/主题、价格透明、用户确认后付费）、计费粒度澄清（按主题独立付费）、「原样重试」（凭证走请求头）、「错误脱敏」；新增「输出验收」与「错误处理」表；补 SkillHub 上架元数据（_meta.json / _skillhub_meta.json / README.md，pricing_type=paid）。文档保持前端视角、不暴露后端。

1.2.1

• 重写头信息：定义收敛为「付费解锁后获取主题最佳步骤提示」，精简标签与触发词，去掉内部机制描述。

1.2.0

• 精简文档：仅保留使用方所需的能力说明、触发场景、主流程、付费与凭证接口，去掉无关内部细节。

1.1.1

• 付费说明整理为独立文档，使用方式不变。

1.1.0

• 升级为综合执行技能：在主题检索基础上新增兜底检索与步骤回写。

1.0.1

• 付费凭证自动保存，同一主题付费一次即可，无需重复付费。

1.0.0

• 初版：主题检索 + 付费解锁 + 步骤回写。