# 小程序环境配置统一使用域名访问 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 文件内容**

将以下内容：
```bash
VITE_APP_ENV=dev
VITE_API_BASE_URL=http://localhost:19089/api
VITE_WS_URL=ws://localhost:19089
VITE_DEBUG=true
```

修改为：
```bash
# 开发环境配置（本地开发调试）
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: 提交更改**

```bash
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 文件内容**

将以下内容：
```bash
# 体验环境配置（小程序体验版）
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
```

修改为：
```bash
# 测试环境配置（小程序体验版）
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: 提交更改**

```bash
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，需确认内容）：

```bash
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
```

修改为：
```bash
# 生产环境配置（小程序正式版）
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: 提交更改**

```bash
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: 更新环境配置说明**

将环境配置表格更新为：

```markdown
| 文件 | 说明 | 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: 提交更改**

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

---

### Task 6: 验证小程序编译

**Files:**
- Build Output: `mini-program/unpackage/dist/test/mp-weixin`

- [ ] **Step 1: 执行测试环境编译**

```bash
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 证书