前言¶
开发微信小程序商城时，前端页面和后端接口通常要分开推进：页面结构、交易链路（首页、分类、商品详情、购物车、结算、订单、个人中心）要自己搭，接口的鉴权方式、返回体结构、每个方法的调用示例也要自己对着文档拼。结果是同一套商城逻辑在不同项目里被反复实现，接口细节容易记错。
下面介绍的 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
