# ⚡ Soul派对小程序 - 快速启动指南

> 配置完成！现在可以直接测试了！

---

## ✅ 配置已完成

| 项目 | 状态 | 配置值 |
|------|------|--------|
| **AppID** | ✅ | `wx0976665c3a3d5a7c` |
| **API域名** | ✅ | `http://kr-soul.lytiao.com` |
| **本地API** | ✅ | `http://localhost:3000` |
| **后端服务器** | 🟢 运行中 | 端口3000 |

---

## 🚀 立即开始测试（3步骤）

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

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

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

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

---

### 第2步：启用本地调试

在开发者工具中：

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

> 💡 这样才能访问本地API：`http://localhost:3000`

---

### 第3步：点击编译

点击工具栏 **"编译"** 按钮

✅ **完成！** 现在可以在模拟器中测试了！

---

## 📱 生成测试二维码

### 在模拟器中测试

直接在开发者工具的模拟器中查看效果

---

### 在真机上测试

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

---

## 🎯 功能测试清单

### 首页测试

- [ ] 书籍封面展示
- [ ] 最新章节列表
- [ ] 点击章节跳转阅读
- [ ] 购买按钮响应

### 匹配书友测试

- [ ] 点击底部TabBar"匹配书友"
- [ ] 星空背景动画流畅
- [ ] 点击"开始匹配"
- [ ] 3-6秒后匹配成功
- [ ] 显示匹配用户信息

### 我的页面测试

- [ ] 点击底部TabBar"我的"
- [ ] 查看分销中心
- [ ] 点击"生成推广海报"
- [ ] 复制邀请码功能

### 阅读页测试

- [ ] 从首页点击章节
- [ ] 章节内容正常渲染
- [ ] 底部工具栏显示
- [ ] 点击目录查看章节列表

---

## 🌐 查看测试页面

在浏览器打开：

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

这个页面包含：
- 完整配置信息
- 详细测试步骤
- 注意事项

---

## 🔧 服务器状态

### 后端API服务器

✅ **已启动** - 运行在端口 3000

### 测试API接口

\`\`\`bash
# 测试书籍列表接口
curl http://localhost:3000/api/book/latest-chapters

# 测试管理后台
curl http://localhost:3000/api/admin
\`\`\`

---

## 📊 项目文件位置

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

小程序源码：
/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram

配置文件：
- miniprogram/project.config.json (AppID配置)
- miniprogram/app.js (API地址配置)

部署文档：
- miniprogram/小程序部署说明.md (完整部署指南)
- 小程序项目总览.md (项目总览)
\`\`\`

---

## ⚙️ 修改配置（如需要）

### 切换API地址

**使用本地API**（开发时）：

编辑 `miniprogram/app.js`：

\`\`\`javascript
apiBase: 'http://localhost:3000/api'
\`\`\`

**使用线上API**（部署后）：

\`\`\`javascript
apiBase: 'http://kr-soul.lytiao.com/api'
\`\`\`

⚠️ 修改后需要重新编译

---

## 🔄 重启服务器

如果后端服务器出现问题：

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

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

---

## 📞 遇到问题？

### 常见问题

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

**解决**：
1. 检查后端服务器是否运行
2. 确认勾选了"不校验合法域名"
3. 查看控制台错误信息

#### Q2: 无法连接到API

**解决**：
1. 确认API地址：`http://localhost:3000/api`
2. 测试接口：在浏览器访问 `http://localhost:3000/api/admin`
3. 重启后端服务器

#### Q3: 真机预览显示"不在以下request合法域名列表中"

**解决**：
这是因为使用了HTTP而非HTTPS。两个选择：
1. 在开发者工具中测试（已勾选不校验）
2. 正式部署时配置HTTPS

---

### 联系支持


---

## 🎉 测试完成后

### 下一步操作

1. ✅ **测试所有功能** - 确保一切正常
2. 🌐 **部署到服务器** - 使用域名 `kr-soul.lytiao.com`
3. 🔒 **配置HTTPS** - 申请SSL证书
4. 📋 **配置域名白名单** - 在小程序后台配置
5. 📤 **上传代码审核** - 提交到微信审核
6. 🚀 **发布上线** - 审核通过后发布

详细步骤查看：`miniprogram/小程序部署说明.md`

---

## 📚 相关文档

- **小程序部署说明.md** - 完整部署指南
- **小程序项目总览.md** - 项目总览
- **README.md** - 使用说明
- **测试二维码.html** - 可视化测试页面

---

**准备好了吗？** 打开微信开发者工具开始测试吧！🚀

---

**配置完成时间**: 2025年1月14日  
**AppID**: wx0976665c3a3d5a7c  
**域名**: http://kr-soul.lytiao.com  
**状态**: ✅ 可以立即测试
