前言¶
開發微信小程序商城時，前端頁面和後端接口通常要分開推進：頁面結構、交易鏈路（首頁、分類、商品詳情、購物車、結算、訂單、個人中心）要自己搭，接口的鑑權方式、返回體結構、每個方法的調用示例也要自己對着文檔拼。結果是同一套商城邏輯在不同項目裏被反覆實現，接口細節容易記錯。
下面介紹的 Skill「小程序商城」解決的就是這個問題：它基於 Ushopun（優社雲AI）官方 miniProgramV2 真實項目構建，把頁面和接口對接規範一起內置。當你需要開發對接 Ushopun 後端（優社雲）的微信小程序商城時調用它即可。
這是什麼¶
小程序商城 是一個面向微信小程序商城前端開發的 Skill，座標爲 @user_99b1d2cb/xiaochengxushangcheng，由社區發佈者 user_99b1d2cb 維護，分類爲 dev-programming，來源爲 community，當前版本 2.0.2，SkillHub 評分 100000，下載 1139 次。
它做的事是把兩件事打包到一起：
- 一個基於 Ushopun 官方 miniProgramV2 真實項目構建的商城前端，覆蓋完整交易鏈路的頁面。
- 一份 dev.ushopun.com OpenAPI 的完整對接規範，以及每個方法的調用示例。
定位上，它不是從零生成代碼的通用腳手架，而是一套已經和 Ushopun 後端對齊過的項目與接口約定。
核心功能¶
商城頁面與交易鏈路¶
內置頁面覆蓋：
- 首頁、分類
- 商品詳情
- 購物車、結算
- 訂單、個人中心
合計 50+ 頁面，對應一條完整的交易鏈路：瀏覽商品 → 加購 → 結算 → 下單 → 訂單管理 → 個人中心。
Ushopun OpenAPI 對接規範¶
內置 dev.ushopun.com OpenAPI 的接口對接規範，要點如下：
- 接口前綴：
/api/v2 - 返回體結構：
code/content/data - 鑑權參數：
guid/token/shopId - 每個方法都帶有調用示例
後端接口文檔位置¶
後端接口文檔參考 Skill 同目錄下的 openapi.json。其中 servers 使用 {tenant}.ushopun.com 泛域名模板：
- 開發環境填
dev - 正式環境替換爲租戶子域名
安裝與啓用¶
Skill 基於通用 SKILL.md 格式。該 Skill 標註 requires_api_key=false，即調用時不需要額外的 API Key 配置。
在支持 SkillHub 的編碼工具（如 Cursor、Codex CLI、Claude Code）中，通過官方地址引入即可：
https://api.skillhub.cn/user_99b1d2cb/xiaochengxushangcheng
引入後，在需要開發對接 Ushopun 後端的微信小程序商城任務中調用該 Skill。需要說明的是，官方頁面當前無法訪問，因此本文不逐條列出各工具的獨立命令；請以官方地址頁面提供的說明爲準。
典型用法¶
Skill 內置的接口規範覆蓋每個方法的調用示例。以 dev 環境爲例，使用時需要關注的三組約定是：
接口前綴：/api/v2
返回體：code / content / data
鑑權：guid / token / shopId
servers: {tenant}.ushopun.com
開發環境 tenant = dev
正式環境 tenant = 租戶子域名
實際調用時，按方法示例拼接前綴、攜帶 guid / token / shopId，再按 code / content / data 解析返回體即可。
適用場景與注意¶
適合：
- 使用 Ushopun（優社雲AI）作爲後端，需要開發微信小程序商城前端的開發者
- 需要快速拿到商城頁面結構與接口調用示例的項目
需要注意：
- 該 Skill 與 Ushopun 後端強綁定，接口前綴、返回體結構、鑑權字段都是按其規範定義的；後端不是 Ushopun 的項目不建議直接使用
- 接口文檔以同目錄
openapi.json爲準，servers是泛域名模板，開發環境填dev，上線前要替換成正式租戶子域名 - 頁面基於官方 miniProgramV2 真實項目構建，代碼結構跟隨該項目，改動前建議先熟悉其目錄組織
- 本次覈實的頁面數據（評分 100000、下載 1139、版本 2.0.2）來自 SkillHub 抓取資料，實際使用前可在官方頁面再確認一次
結尾¶
小程序商城 的價值在於把商城頁面和 Ushopun 接口對接規範放到一起：頁面不用從零搭，接口前綴、返回體、鑑權字段和調用示例也不用自己整理。如果你正在做對接 Ushopun 後端的微信小程序商城，可以從官方地址開始：
https://api.skillhub.cn/user_99b1d2cb/xiaochengxushangcheng
