happy-life-star/docs/superpowers/plans/2026-03-18-mini-program-domain-config.md

小程序环境配置统一使用域名访问 Implementation Plan

For agentic workers: REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (- [ ]) syntax for tracking.

Goal: 修改小程序所有环境配置文件，统一使用域名 lifescript.happylifeos.com 通过 HTTPS/WSS 协议访问服务器后端 API。

Architecture: 修改 .env.development、.env.test、.env.production 三个环境配置文件，将 API 和 WebSocket 地址从 localhost/IP 地址改为域名访问，使用 HTTPS 和 WSS 加密协议。

Tech Stack: UniApp, Vite, 环境变量配置

---

Chunk 1: 环境配置文件修改

Task 1: 修改开发环境配置 (.env.development)

Files:

• Modify: mini-program/.env.development

• Step 1: 修改 .env.development 文件内容

将以下内容：

VITE_APP_ENV=dev
VITE_API_BASE_URL=http://localhost:19089/api
VITE_WS_URL=ws://localhost:19089
VITE_DEBUG=true

修改为：

# 开发环境配置（本地开发调试）
VITE_APP_ENV=dev
VITE_API_BASE_URL=https://lifescript.happylifeos.com/api
VITE_WS_URL=wss://lifescript.happylifeos.com/ws
VITE_DEBUG=true

• Step 2: 验证文件格式正确

确认文件内容没有多余的空格或格式问题

• Step 3: 提交更改

git add mini-program/.env.development
git commit -m "fix: 开发环境配置改为域名访问 (HTTPS/WSS)"

---

Task 2: 修改测试环境配置 (.env.test)

Files:

• Modify: mini-program/.env.test

• Step 1: 修改 .env.test 文件内容

将以下内容：

# 体验环境配置（小程序体验版）
VITE_APP_ENV=test
VITE_API_BASE_URL=http://101.200.208.45:19089/api
VITE_WS_URL=ws://101.200.208.45:19089
VITE_DEBUG=true

修改为：

# 测试环境配置（小程序体验版）
VITE_APP_ENV=test
VITE_API_BASE_URL=https://lifescript.happylifeos.com/api
VITE_WS_URL=wss://lifescript.happylifeos.com/ws
VITE_DEBUG=true

• Step 2: 验证文件格式正确

确认文件内容没有多余的空格或格式问题

• Step 3: 提交更改

git add mini-program/.env.test
git commit -m "fix: 测试环境配置改为域名访问 (HTTPS/WSS)"

---

Task 3: 修改生产环境配置 (.env.production)

Files:

• Modify: mini-program/.env.production

• Step 1: 修改 .env.production 文件内容

将以下内容（注意：当前文件第一行是 VITE_APP_ENV=prod 但文件名是 production，需确认内容）：

VITE_APP_ENV=prod
VITE_API_BASE_URL=http://101.200.208.45:19089/api
VITE_WS_URL=ws://101.200.208.45:19089
VITE_DEBUG=false

修改为：

# 生产环境配置（小程序正式版）
VITE_APP_ENV=prod
VITE_API_BASE_URL=https://lifescript.happylifeos.com/api
VITE_WS_URL=wss://lifescript.happylifeos.com/ws
VITE_DEBUG=false

• Step 2: 验证文件格式正确

确认文件内容没有多余的空格或格式问题

• Step 3: 提交更改

git add mini-program/.env.production
git commit -m "fix: 生产环境配置改为域名访问 (HTTPS/WSS)"

---

Chunk 2: 代码验证和文档更新

Task 4: 验证环境配置代码兼容性

Files:

• Read: mini-program/src/config/env.js

• Read: mini-program/src/utils/env.ts

• Step 1: 检查 src/config/env.js 文件

确认文件中的配置逻辑能够正确处理 HTTPS 和 WSS 协议地址

预期：该文件只是读取环境变量，不需要修改

• Step 2: 检查 src/utils/env.ts 文件

确认请求封装代码能够正确处理 HTTPS 和 WSS 协议地址

预期：该文件使用 API_BASE_URL 拼接请求地址，不需要修改

• Step 3: 提交验证结果

如果代码不需要修改，跳过提交

---

Task 5: 更新 README.md 文档

Files:

• Modify: mini-program/README.md

• Step 1: 更新环境配置说明

将环境配置表格更新为：

| 文件 | 说明 | API 地址 | WebSocket 地址 |
|------|------|----------|----------------|
| `.env.development` | 开发环境配置 | https://lifescript.happylifeos.com/api | wss://lifescript.happylifeos.com/ws |
| `.env.test` | 测试环境配置 | https://lifescript.happylifeos.com/api | wss://lifescript.happylifeos.com/ws |
| `.env.production` | 生产环境配置 | https://lifescript.happylifeos.com/api | wss://lifescript.happylifeos.com/ws |

• Step 2: 更新各环境配置示例

将三个环境的配置示例都更新为使用域名的格式

• Step 3: 提交更改

git add mini-program/README.md
git commit -m "docs: 更新环境配置文档说明"

---

Task 6: 验证小程序编译

Files:

• Build Output: mini-program/unpackage/dist/test/mp-weixin

• Step 1: 执行测试环境编译

cd mini-program
npm run build:mp-weixin:test

预期：编译成功，无错误

• Step 2: 验证编译产物中的环境变量

检查编译后的文件中环境变量是否正确注入

预期：API_BASE_URL 和 WS_URL 应为域名地址

• Step 3: 提交验证

如果编译成功，记录验证结果

---

验证步骤

完成所有任务后，执行以下验证：

1. 配置验证: 确认三个环境配置文件都已更新为域名访问
2. 编译验证: 确认小程序可以正常编译
3. 代码验证: 确认现有代码能够正确处理 HTTPS/WSS 地址

---

注意事项

1. 所有环境都使用 HTTPS/WSS 协议，微信小程序要求加密连接
2. 开发环境也使用服务器 API，本地无需启动后端服务
3. 确保服务器 CORS 配置允许小程序域名访问
4. 确保服务器 Nginx 配置了正确的 SSL 证书