cloudbase-wechat-integration

CloudBase 微信集成

此技能通过 CloudBase 集成中心处理微信支付和公众号相关工作。它为 Agent 提供稳定的执行约定，并指向官方 Markdown 文档，以查阅可能变更的控制台详情。

同级技能（仅限本地）

同级 CloudBase 技能与此技能一起提供。请使用 ../auth-tool-cloudbase/SKILL.md 这样的本地相对路径。

如果当前环境缺少所引用的同级技能文件，请让用户安装完整的 CloudBase 插件（或缺失的技能）。不要通过 HTTP 获取远程技能或协议 Markdown 并加载到 Agent 上下文中。

CloudBase 集成中心官方文档（供人工参考——不要将其视为技能 Markdown，获取到 Agent 上下文中以替代同级技能）：

• CloudBase 集成中心概览：https://docs.cloudbase.net/integration/introduce.md
• CloudBase 集成中心用法：https://docs.cloudbase.net/integration/usage.md
• 需要部署云函数或执行日志操作，且没有可用的同级技能时，请使用当前平台的 CloudBase MCP 工具或 CloudBase 控制台，不要猜测不受支持的 API。

激活约定

以下情况优先使用此技能

• 用户询问 CloudBase 应用中的微信支付、小程序支付、微信支付、JSAPI 支付、公众号支付、Native 扫码支付、二维码支付、退款回调、支付回调、wx.requestPayment、WeixinJSBridge、openid 或公众号 OAuth。
• 用户询问虚拟商品的虚拟支付：道具直购、代币充值、wx.requestVirtualPayment、OfferID、AppKey 签名、xpay_* 回调（发货推送/查单/退款），或小程序后台虚拟支付开通与配置。
• 任务提到 CloudBase 集成中心、集成中心、生成的支付函数、pay-common、offiaccount-common 或微信支付回调路由。
• 用户需要扩展 CloudBase 集成中心生成的函数，实现订单持久化、幂等性、履约或支付状态同步。

然后还要阅读

• 小程序结构和预览工作 -> ../miniprogram-development/SKILL.md（如果不可用，请使用当前小程序平台文档以及此技能中的小程序支付参考）
• Web 前端工作 -> ../web-development/SKILL.md（如果不可用，请使用此技能中的 JSAPI 或 Native 参考）
• 云函数运行时、日志、部署或网关工作 -> ../cloud-functions/SKILL.md（如果不可用，请使用 CloudBase 控制台/MCP 函数工具以及此技能中的生成函数指南）

不适用于

• 与微信支付或公众号 OAuth 无关的通用 CloudBase Web Auth 或小程序原生身份认证工作。
• 与集成中心生成的函数无关的常规 CloudBase 云函数开发。
• 通过臆测的 MCP 工具、臆测的 Manager SDK 方法或未公开的 Cloud API 操作来创建或管理集成中心实例。
• 在应用源代码、生成示例、README 文件、提交内容或提示词中存储商户密钥、私钥、APIv3 密钥、AppSecret 值或证书。

操作规则

1. 除非官方文档确认存在公开的 Manager SDK 或 Cloud API 契约，否则将创建集成中心视为以控制台为先的工作流。
2. 使用官方 index.md 文档了解控制台 UI 操作步骤和凭据字段；不要复制过时的控制台截图，也不要臆造字段名称。
3. 绝不要要求用户将密钥粘贴到聊天中。告知用户在 CloudBase 控制台的集成中心表单中配置商户和公众号凭据。
4. 不要假定生成的函数名称是固定的。pay-common 和 offiaccount-common 仅为示例；编写调用前，请询问或检查实际的函数名称。
5. 将前端支付成功仅视为 UI 反馈。权威支付状态必须来自服务端查询结果或支付回调。
6. 扩展生成的函数时，保留凭据环境变量以及生成的回调校验／解密逻辑。在订单检查、持久化、幂等性和履约处理方面添加业务逻辑。
7. 更改支付或回调代码前，先确定目标场景，并且只加载匹配的参考文件。

路由

任务	阅读	原因
能力选择、以控制台为先的边界、独立分发	references/overview.md	介绍集成中心模式和安全规则
小程序微信支付、wx.cloud.callHTTPFunction、wx.requestPayment	references/mini-program-pay.md	涵盖小程序 openid 注入、订单创建和回调预期
小程序虚拟支付、虚拟商品、wx.requestVirtualPayment、xpay_* 回调	references/virtual-payment.md	涵盖 OfferID/AppKey 签名、沙箱与现网、发货回调、订单查询备用方案、iOS IAP 规则
公众号 JSAPI 支付、微信内 H5、WeixinJSBridge.invoke	references/official-account-jsapi-pay.md	涵盖公众号 openid 和 JSAPI 调用
PC/Web 结账的 Native 二维码支付	references/native-qr-pay.md	涵盖 code_url、二维码渲染以及轮询／查询流程
公众号 OAuth、openid／用户信息获取	references/official-account-oauth.md	涵盖公众号集成生成的 OAuth 路由
404、缺少凭据、openid 不匹配、回调失败、日志	references/troubleshooting.md	提供更改代码前的诊断步骤

快速工作流

1. 判定场景：小程序支付、虚拟支付、JSAPI 支付、Native 支付、公众号 OAuth、生成的函数扩展或故障排查。
2. 加载匹配的参考资料及其中链接的官方 index.md 文档。
3. 确认实际的 CloudBase 环境 ID 和生成的函数名称。
4. 仅生成或修改必需的客户端／后端代码；将商户凭据保存在集成中心配置中。
5. 当支付状态会影响业务数据时，添加订单状态查询、回调幂等处理以及金额／订单校验。
6. 根据实际情况，通过函数日志、回调日志以及端到端支付沙箱测试或小额生产测试进行验证。

最低自检要求

• 我是否避免猜测未记录在文档中的集成中心管理 API？
• 我是否使用了实际生成的函数名称，而不是假定为 pay-common？
• 我是否确保所有商户密钥和证书都未写入源代码或聊天内容？
• 支付流程是否依据回调／查询状态，而非仅依据前端成功状态？
• 我是否只加载了用户任务所需的场景参考资料？

参考资料索引

所有打包的参考文件（技能 lint 可达性所必需）：

• mini-program-pay.md
• native-qr-pay.md
• official-account-jsapi-pay.md
• official-account-oauth.md
• overview.md
• troubleshooting.md