前言¶
在 CloudBase 上接微信支付或公衆號 OAuth，常見難點不在「能不能調微信 API」，而在集成中心生成的雲函數名不固定、回調驗籤與 openid 場景要對齊、商戶密鑰不能進倉庫。翻官方 Markdown 和集成中心文檔往往要跨好幾頁，Agent 也容易按示例函數名硬編碼或把前端支付成功當成終態。
下面介紹 SkillHub 上的 @tencent-adm/cloudbase-wechat-integration（微信生態集成 · WeChat Integration）。它把 CloudBase 集成中心下的微信能力整理成 Agent 可執行的 SKILL.md 與分場景 reference，由騰訊雲 CloudBase 團隊維護，當前版本 v2.36.0，分類爲 dev-programming，標籤 requires_api_key=false（Skill 本身不要求單獨配置 API Key；微信支付仍須在控制台配置商戶與公衆號憑證）。
這是什麼¶
一句話定位：面向 CloudBase 應用的微信生態集成指南 Skill，以集成中心爲入口，覆蓋小程序支付、公衆號 JSAPI / Native 支付、公衆號 OAuth、openid 處理，以及集成中心生成的支付相關雲函數擴展。
出品與分發：發佈者爲騰訊雲 CloudBase 團隊，來源 enterprise；在 SkillHub 座標 @tencent-adm/cloudbase-wechat-integration，SkillHub 頁面評分 100000，下載 6095 次（以 SkillHub 展示爲準）。
官方入口：
- SkillHub API：
https://api.skillhub.cn/tencent-adm/cloudbase-wechat-integration - SkillHub 詳情：
https://www.skillhub.cn/skills/tencent-adm/cloudbase-wechat-integration - CloudBase 文檔（安裝與測試提示詞）：
https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/prompts/cloudbase-wechat-integration
核心功能¶
以下內容與 Skill 包內 SKILL.md（v2.36.0）及官方文檔頁一致，僅列已寫明的能力。
支付與 OAuth 場景¶
| 場景 | Skill 內 reference | 要點 |
|---|---|---|
| 小程序微信支付 | references/mini-program-pay.md |
wx.cloud.callHTTPFunction、wx.requestPayment、openid 注入與回調預期 |
| 小程序虛擬支付 | references/virtual-payment.md |
wx.requestVirtualPayment、OfferID / AppKey 簽名、xpay_* 回調、沙箱與現網 |
| 公衆號 JSAPI 支付 | references/official-account-jsapi-pay.md |
公衆號 openid、WeixinJSBridge.invoke |
| Native 掃碼支付 | references/native-qr-pay.md |
code_url、二維碼展示、輪詢 / 查單 |
| 公衆號 OAuth | references/official-account-oauth.md |
集成中心生成的 OAuth 路由、openid / userinfo |
| 排錯 | references/troubleshooting.md |
404、憑證缺失、openid 不一致、回調失敗、日誌 |
Agent 執行契約（Operating Rules 摘要）¶
- 集成中心實例創建以控制台爲主，不猜測未文檔化的 Manager SDK / Cloud API。
- 控制台步驟與憑證字段以官方
index.md爲準；pay-common、offiaccount-common僅爲示例函數名，調用前須確認環境內真實函數名。 - 商戶密鑰、APIv3 密鑰、AppSecret、證書等只配置在集成中心，不寫入源碼、提交記錄或對話。
- 前端支付成功僅作 UI 反饋；訂單狀態以服務端查單或支付回調爲準；擴展生成函數時保留驗籤 / 解密邏輯，並補充冪等與履約。
不適用範圍¶
純 CloudBase Web 登錄、與支付無關的小程序身份、非集成中心生成函數的一般雲函數開發，以及通過猜測 MCP 創建集成中心實例——Skill 明確建議改用控制台或官方 CloudBase MCP 工具。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式。按你使用的 Agent 選擇安裝方式；安裝後通常需重啓或重新加載 Agent 才能識別 skills 目錄。
方式一：SkillHub CLI（國內商店）¶
先確認是否已安裝 skillhub（說明見 https://skillhub.cn/install/skillhub.md）：
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 安裝文檔執行完整安裝或僅 CLI。安裝 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別：
skillhub install tencent-adm/cloudbase-wechat-integration --dir <skills 目錄>
常用目錄（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/ - Claude Code：
~/.claude/skills/
也可將下面提示詞交給 AI，讓其按 https://skillhub.cn/install/skillhub.md 安裝 @tencent-adm/cloudbase-wechat-integration（SkillHub 頁面提供的同款說明）。
方式二：CloudBase 文檔中的 npx skills¶
騰訊雲開發文檔「應用集成：微信生態集成」給出的安裝命令如下。
安裝全部 CloudBase Skills：
npx skills add tencentcloudbase/cloudbase-skills
僅安裝本 Skill：
npx skills add https://github.com/tencentcloudbase/skills --skill cloudbase-wechat-integration
同套件兄弟 Skill¶
Skill 內通過相對路徑引用同目錄旁的 CloudBase 技能（如 ../miniprogram-development/SKILL.md、../cloud-functions/SKILL.md）。若本地缺失，應安裝完整 CloudBase 插件或對應 Skill，而不是用 HTTP 拉遠程 SKILL 替代。
典型用法¶
1. 用官方測試提示詞觸發 Skill¶
CloudBase 文檔建議用自然語言驗證 Agent 是否按集成中心路徑回答，例如：
- 「在 CloudBase 小程序中接入微信支付，並處理支付回調」
- 「幫我用 CloudBase 集成中心實現公衆號 JSAPI 支付」
- 「在 Web 站點中接入微信 Native 掃碼支付並查詢訂單狀態」
- 「通過 CloudBase 集成中心獲取公衆號 openid 並用於支付」
2. Quick Workflow（Skill 內六步）¶
- 判定場景：小程序支付、虛擬支付、JSAPI、Native、公衆號 OAuth、擴展生成函數或排錯。
- 加載對應
references/*.md及其中鏈接的官方文檔。 - 確認 CloudBase 環境 ID 與真實生成函數名。
- 只改必要的客戶端 / 後端代碼，憑證留在集成中心。
- 若業務依賴支付結果，增加查單、回調冪等與金額 / 訂單校驗。
- 用雲函數日誌、回調日誌及沙箱或小額實付做端到端驗證。
3. 人工查閱集成中心文檔¶
Skill 將以下文檔列爲人工參考（控制台細節可能變更）：
- 集成中心介紹：
https://docs.cloudbase.net/integration/introduce.md - 集成中心使用：
https://docs.cloudbase.net/integration/usage.md
適用場景與注意¶
適合誰
- 已在或計劃使用 CloudBase 集成中心接微信支付的團隊。
- 希望 Cursor、Codex、Claude Code 等 Agent 按統一規則寫支付 / OAuth 代碼、少犯「函數名寫死」「密鑰進倉庫」類錯誤的開發者。
限制與注意
- 微信支付與公衆號能力依賴你在 CloudBase 控制台完成集成中心配置；Skill 不能替代商戶平臺簽約與憑證管理。
- 生成函數名、環境 ID 因項目而異，須以控制台或日誌爲準。
- 虛擬支付、iOS IAP 等規則以
virtual-payment.md與微信官方政策爲準。 - SkillHub 統計（評分、下載量）會隨時間變化，以 SkillHub 頁面實時數據爲準。
結尾¶
@tencent-adm/cloudbase-wechat-integration 把 CloudBase 微信生態接入收斂到「集成中心 + 分場景 reference + 操作紅線」，適合作爲 Agent 側的長期執行契約。需要安裝或查看詳情時，可打開 SkillHub：https://www.skillhub.cn/skills/tencent-adm/cloudbase-wechat-integration，或 API 座標頁：https://api.skillhub.cn/tencent-adm/cloudbase-wechat-integration。
