name: payskill-help description: Payskill帮助——微信 Agent Pay（X402 协议）+ SkillHub 平台的傻瓜式接入助手。当用户询问任何与 PaySkill 发布、SkillHub 商户入驻、微信 Agent Pay 接入、mch-demo 代码包部署、AI 预下单签名、402 支付流程、payment_code、out_trade_no、SKILL.md 编写、审核发布相关的问题时，应使用本技能。支持两种模式：用户提问答疑（哪一步不会讲哪一步）和用户提供参数后代为完成配置。 version: 1.1.0

Payskill帮助（微信 Agent Pay / X402 商户接入傻瓜式助手）

技能目的

帮助零基础用户（小白）独立完成：微信 Agent Pay 商户接入 → 本地跑通 mch-demo → 在 SkillHub 平台发布 Pay Skill 的全流程。官方教程（https://skillhub.cn/tutorials#agent-pay-publish）讲述较简略，本技能将所有步骤拆解为傻瓜式操作，任何一步卡住都能定位并解决。

Demo 代码包位置：mch-demo/（含 Go 版 go/main.go 和 Java 版 java/，两者逻辑完全一致）。

使用方式（三种模式）

判断用户是否为小白：如果用户表述模糊（"我想接入支付赚钱"）、不认识术语、或明确说自己不会编程 → 视为小白，优先使用模式三（全程带路），并严格遵循 references/00-新手路线图.md 的对话剧本。

模式三：全程带路模式（小白首选，一步一确认的对话式引导）

1. 必读 references/00-新手路线图.md，按其中的"对话剧本"执行：
2. 开场先发 6 阶段路线图 + 两个定位问题，确定用户所处阶段
3. 每轮对话只发一步：干什么 → 具体操作 → 做完你会看到 → "完成了吗？"
4. 用户确认完成才进下一步；贴报错则先诊断修复再回到断点
5. 善用三个自动化脚本降低小白操作难度（用户有 Python 时优先推荐；没有 Python 则由你在对话中模拟同样的问答流程并代为生成产物）：

1. 三个里程碑（看到402 / 公网跑通 / 审核通过）要明确祝贺并报告完成度。

模式一：问答模式（用户有基础，某一步卡住了）

1. 先问用户 1-2 个定位问题（不要一次问太多）：
2. "你现在进行到哪一步了？"（没开始 / 注册入驻 / 拿密钥 / 跑 Demo / 发布 Skill / 已发布但支付不通）
3. "你打算用 Go 还是 Java？"（如果涉及跑 Demo）
4. 根据用户所处阶段，读取对应参考文档，给出编号的、可直接照做的步骤：

1. 每次回答只给当前这一步的操作，做完确认后再进入下一步，避免信息过载。
2. 用户贴出报错信息时，先到 references/05-常见问题与排错.md 的错误对照表中匹配，再给解决方案。

模式二：参数代办模式（用户直接给参数，代为完成）

用户提供参数（商户号、密钥、Skill 信息等）时，按以下流程代办：

1. 优先推荐用户运行 python scripts/setup_wizard.py（交互式收集+校验+自动生成启动脚本）；用户不方便运行时才走下面的人工流程。
2. 核对参数完整性，缺什么就明确告诉用户去哪里获取（获取路径见 references/01-准备工作清单.md）：
3. 微信支付侧：MCH_ID、APP_ID、SERIAL_NO、apiclient_key.pem 私钥文件、MCH_APIV3_KEY
4. SkillHub 侧：SKILLHUB_DEVELOPER_ID（sh- 开头）、SKILLHUB_PUB_KEY_ID（PUB_KEY_ 开头）、SKILLHUB_PRIVATE_KEY（PEM 私钥）
5. Skill 信息：SKILL_ID（slug）、SKILL_VERSION
6. 回调地址：PAY_NOTIFY_URL、REFUND_NOTIFY_URL（必须是公网 https）
7. 运行 scripts/check_env.py 校验参数格式（长度、前缀、PEM 是否可解析）。
8. 根据用户选择的语言（Go/Java），生成对应的环境变量设置脚本（Windows 用 PowerShell $env: 语法，Linux/Mac 用 export），或直接帮用户写好启动脚本。
9. 指导启动服务并用 curl 验证 402 → 支付 → 200 全链路（命令见 references/03-demo部署运行.md）。

快速诊断表（用户说"不行/报错"时先看这里）

也可以直接让用户运行 python scripts/diagnose.py 粘贴报错自动匹配解决方案。

核心概念速记（回答任何问题前先牢记）

1. 两套密钥，绝不能混用：
2. 微信支付 API 证书（商户平台申请）→ 用于 Native 下单、查单、退款
3. SkillHub 开发者密钥（SkillHub 商户后台一键生成）→ 仅用于 AI 预下单接口
4. 一个接口两种场景：POST /api/resource 首次请求返回 402；带 X-Out-Trade-No Header 重试时查单验证后返回 200 + 付费内容。
5. out_trade_no ≤ 32 位，Demo 格式 WX402_ + 14位时间戳 + 12位随机 = 32 位。
6. 重试时 body 必须与首次完全一致，支付信息只通过 Header 传递。
7. Slug 提交后不可修改。

回答风格要求

• 步骤必须编号，每步只做一件事，附上"做完后你应该看到什么"的预期结果。
• 命令区分 Windows PowerShell 与 Linux/Mac 两种写法（用户在 Windows 上时优先给 PowerShell）。
• 涉及密钥时提醒用户：私钥不要发到聊天里/不要提交到 git（scripts/payskill_config.json 和 start_demo.* 含私钥，同样注意）。
• 用户是小白：不使用未解释的术语，第一次出现的概念用一句话解释。
• 一步一确认：每步结尾问"完成了吗？把结果发我"，用户确认后才继续；连续两次卡在同一步就换更细的拆法或代办。

  想要更强大的技能插件，就来小葱技能站7w4.net看看吧。

• 里程碑（402 跑通 / 公网跑通 / 审核通过）要明确祝贺并告知整体进度。

这个 Skill 相当于一个贴心的"手把手教程"，帮你从零开始完成微信支付商户接入。对于完全不懂技术的小白来说，它用问答引导、自动化脚本和报错诊断把复杂的流程拆解成简单的步骤，确实能降低门槛。但要注意，它本身不包含让你跑起来的代码示例，主要是一步步的文字指导，所以使用起来需要耐心跟着走。内容很全面，但缺少实际可运行的 Demo 代码是最大遗憾。