# 🎉 Soul派对小程序 - 立即测试

> ✅ **配置完成！服务器已启动！现在可以直接测试了！**

---

## ✅ 当前状态

| 项目 | 状态 | 信息 |
|------|------|------|
| **后端服务器** | 🟢 运行中 | http://localhost:3001 |
| **小程序AppID** | ✅ 已配置 | wx0976665c3a3d5a7c |
| **API地址** | ✅ 已配置 | http://localhost:3001/api |
| **配置文件** | ✅ 已更新 | miniprogram/app.js |

---

## 🚀 立即开始（只需2步）

### 第1步：打开微信开发者工具

1. 打开 **微信开发者工具**
2. 点击 **"导入项目"**
3. 选择目录：

\`\`\`
/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram
\`\`\`

4. AppID自动识别：`wx0976665c3a3d5a7c`
5. 点击 **"导入"**

---

### 第2步：启用本地调试并编译

1. 点击右上角 **"详情"**
2. 找到 **"本地设置"**
3. ✅ 勾选 **"不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书"**
4. 点击工具栏 **"编译"** 按钮

✅ **完成！** 现在可以在模拟器中看到小程序了！

---

## 📱 生成测试二维码

### 真机预览

1. 点击工具栏 **"预览"** 按钮
2. 自动生成小程序码
3. 用微信扫码
4. 在手机上体验

---

## 🎯 功能测试

### 测试首页

- 查看书籍封面
- 浏览最新章节
- 点击章节进入阅读

### 测试匹配书友

- 点击底部 **"匹配书友"** Tab
- 点击 **"开始匹配"** 按钮
- 观看星空动画
- 等待3-6秒匹配成功

### 测试我的页面

- 点击底部 **"我的"** Tab
- 查看分销中心
- 点击 **"生成推广海报"**
- 测试复制邀请码

### 测试阅读功能

- 从首页点击任意章节
- 查看章节内容渲染
- 点击底部工具栏
- 测试目录、书签功能

---

## 📊 API接口测试

### 测试书籍接口

\`\`\`bash
curl http://localhost:3001/api/book/latest-chapters
\`\`\`

### 测试管理后台

\`\`\`bash
curl http://localhost:3001/api/admin
\`\`\`

### 测试微信登录

\`\`\`bash
curl -X POST http://localhost:3001/api/wechat/login \
  -H "Content-Type: application/json" \
  -d '{"code":"test_code"}'
\`\`\`

---

## 🌐 查看可视化测试页面

在浏览器打开：

\`\`\`
file:///Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram/测试二维码.html
\`\`\`

---

## ⚙️ 配置信息

### 小程序配置

\`\`\`javascript
// miniprogram/app.js
globalData: {
  apiBase: 'http://localhost:3001/api',  // 本地开发
  appId: 'wx0976665c3a3d5a7c',
  appSecret: 'a262f1be43422f03734f205d0bca1882'
}
\`\`\`

### 项目配置

\`\`\`json
// miniprogram/project.config.json
{
  "appid": "wx0976665c3a3d5a7c",
  "projectname": "soul-party-book"
}
\`\`\`

---

## 🔧 服务器管理

### 查看服务器状态

服务器正在后台运行，端口：**3001**

### 重启服务器（如需要）

\`\`\`bash
# 进入项目目录
cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"

# 重新启动
pnpm dev
\`\`\`

### 停止服务器

在终端按 `Ctrl + C`

---

## ❓ 常见问题

### Q1: 模拟器显示空白

**解决**：
1. 确认勾选了"不校验合法域名"
2. 检查控制台是否有错误
3. 确认API地址：`http://localhost:3001/api`

### Q2: 无法连接到服务器

**解决**：
1. 确认服务器正在运行（端口3001）
2. 在浏览器测试：http://localhost:3001
3. 查看终端是否有错误信息

### Q3: 真机预览提示域名错误

**解决**：
这是正常的，因为使用了HTTP而非HTTPS。
- 在开发者工具中测试（已勾选不校验）
- 正式部署时需要配置HTTPS

---

## 🎨 自定义配置

### 切换到线上API

当部署到服务器后，修改 `miniprogram/app.js`：

\`\`\`javascript
apiBase: 'http://kr-soul.lytiao.com/api'  // 改为线上地址
\`\`\`

---

## 📚 相关文档

| 文档 | 说明 |
|------|------|
| **立即测试.md** | 本文档 - 快速测试指南 |
| **快速启动指南.md** | 详细启动步骤 |
| **小程序部署说明.md** | 完整部署文档 |
| **小程序项目总览.md** | 项目总览 |
| **测试二维码.html** | 可视化测试页面 |

---

## 📞 需要帮助？

### 联系方式


### 项目路径

\`\`\`
/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验
\`\`\`

---

## 🎉 准备好了！

**所有配置已完成，服务器已启动！**

现在：
1. 打开微信开发者工具
2. 导入项目
3. 勾选"不校验合法域名"
4. 点击编译

**开始测试吧！** 🚀

---

**配置完成时间**: 2025年1月14日 23:00  
**服务器地址**: http://localhost:3001  
**AppID**: wx0976665c3a3d5a7c  
**状态**: ✅ 可以立即测试
