环境参数、域名与证书

前端参数

ui/frontend/.env.local 由受控渠道提供，运行时解析入口为 services/api/runtime-env.js。

参数	含义
VITE_DUOGEX_API_HOST	对外网关基址，保留目标环境要求的路径前缀
VITE_DUOGEX_TENANT_ID、VITE_DUOGEX_APPLICATION_ID	目标租户与应用
VITE_WECHAT_APP_ID	小程序身份配置，需与工具及后台一致
VITE_VIDEO_SERVICE_API_BASE_URL	尚待迁移的旧视频服务地址，正式构建要求 HTTPS
VITE_RELEASE_CHANNEL	开发或正式通道
VITE_ENABLE_PAYMENT_SIMULATION	开发模拟支付开关，生产通道强制关闭
VITE_ENABLE_PAGE_PERF_DIAGNOSTICS	页面诊断，正式构建关闭

Vite 参数进入构建产物，修改后需要重新构建；不能在其中保存设备 Secret、商户私钥或服务端认证凭据。

域名配置

微信平台根据实际调用配置 request、uploadFile、downloadFile 等合法域名。除网关外，还需核对媒体存储、图片和下载真实来源；工具中临时关闭域名校验不代表真机可用。

Gateway 和外部回调使用有效 HTTPS 证书。检查域名解析、证书链、到期时间、反向代理前缀与响应，不靠浏览器首页能打开判断所有 API 可用。

服务端与变更检查

Nacos namespace、数据库、Redis、设备商与支付参数属于服务端部署范围。变更前保留当前配置版本与引用，确认客户端是否兼容；修改后验证登录、公开读取、业务读写和媒体下载。环境切换脚本只改网关 host，不自动完成上述配置。