6296392e80
完成首页数据模型的统一重构，具体变更如下： 1. 重构公共首页API接口，移除`playRecommendations`字段，将玩法推荐数据统一放入`experiences`字段 2. 更新前后端类型定义、序列化逻辑与前端页面组件，适配新的API响应结构 3. 为微信登录相关接口添加`trust_env=True`配置，支持企业代理环境并新增`socksio`依赖 4. 新增图片画廊上传组件，重构SingleImageUploader组件支持自定义宽高比 5. 重构Toast与Select组件的实现与样式，统一后台UI设计系统 6. 移除个人中心页面不必要的返回事件与顶部标题组件，优化详情卡片布局 7. 新增微信接口单元测试，更新官方文档与测试用例适配变更 8. 删除过期的文档图片资源
WonderQ MiniAPP
WonderQ 移动端前台项目，使用 uni-app、Vue 3、TypeScript 和 TailwindCSS，目标端为 H5 与微信小程序。
后台 API 已分离到 D:\www\znkj\WonderQ-Admin，后台管理 UI 已分离到 D:\www\znkj\WonderQ-Admin-UI。当前仓库只维护移动端前台体验。
Scripts
yarn install安装依赖。yarn dev/yarn dev:h5启动 H5 开发服务，默认访问http://localhost:5173。yarn dev:mp-weixin生成微信小程序开发包。yarn build/yarn build:h5类型检查并构建 H5。yarn build:mp-weixin类型检查并构建微信小程序。yarn test运行共享数据和业务工具函数测试。npm run capture:source采集源站参考。npm run download:assets下载源站资源。
Runtime
- Node 需要满足 uni-app、TailwindCSS 和
weapp-tailwindcss的当前要求，建议使用 Node 20.19+ 或 22.12+。 - H5 仍通过
/api代理访问http://localhost:4000。 - uni-app 路由与小程序配置位于
src/pages.json和src/manifest.json。 - 微信小程序构建产物输出到
dist/build/mp-weixin，需用微信开发者工具打开验证。
Visual Conventions
- 移动端采用简约、内容优先的风格：白色和低饱和中性色为基础，绿色用于主操作和选中态。
- 卡片、输入框和按钮优先使用 8-12px 圆角、细边框和轻阴影；避免大面积渐变、装饰性光晕和重阴影。
- 顶部栏与底部导航保持扁平和固定，选中态使用颜色、细线或浅色底区分，不使用浮动徽章或会改变布局的缩放动画。
- 全局色彩和共享表面样式集中在
src/app.css，页面新增样式优先复用--wq-*变量和共享组件。
Backend And Admin
- API 服务：在
WonderQ-Admin中运行安装、开发和构建命令。 - 后台 UI：在
WonderQ-Admin-UI中运行安装、开发和构建命令。