# 小程序 UI 基础层 小程序使用 `tdesign-miniprogram` 提供成熟的交互控件,再由 `apps/miniapp/components/ui/` 提供品牌层封装。行业模板只负责内容和字段配置,不直接依赖 TDesign 组件名。 ## 首次预览 在微信开发者工具中打开 `apps/miniapp` 后执行「工具 → 构建 npm」。构建完成后,工具会生成被 `.gitignore` 忽略的 `miniprogram_npm/` 目录,页面即可解析 `tdesign-miniprogram/*` 组件路径。 依赖升级后需要重新执行一次「构建 npm」。CI 或发布流程也必须先完成该步骤,再上传小程序代码。 ## 组件边界 - `BrandButton`、`BrandField`、`BrandEmpty`、`BrandLoading`:稳定的品牌交互契约,页面只依赖这些封装。 - `tdesign-miniprogram`:输入、按钮、弹层、加载等基础行为和无障碍细节。 - 页面和行业模板:只消费统一字段与状态,不出现 `templateKey === "food"` 一类分支。 品牌颜色、圆角和间距统一维护在 `apps/miniapp/styles/tokens.wxss`。 ## 本地 API 地址 开发环境 API 地址默认配置在 `apps/miniapp/app.js`。换网络后可以直接在开发者工具 Console 执行: ```js wx.setStorageSync("apiBaseUrl", "http://新的局域网IP:3001"); ``` 然后重新编译小程序。恢复默认地址可执行: ```js wx.removeStorageSync("apiBaseUrl"); ``` 真机调试时,手机和电脑必须处于同一局域网,API 进程需监听可被局域网访问的地址,且防火墙允许 `3001` 端口。