fnvtk/soul

Files

v0 f3195d9331 refactor: overhaul homepage and app structure

Simplify homepage, show chapter counts, display directory, trim bottom nav, in-page match feature, move marketing content, and enhance "My" page.

#VERCEL_SKIP

Co-authored-by: undefined <undefined+undefined@users.noreply.github.com>

2026-01-14 05:10:32 +00:00

4.6 KiB

Raw Blame History

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

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

✅ 当前状态

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

🚀 立即开始（只需2步）

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

打开 微信开发者工具
点击 "导入项目"
选择目录：

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

AppID自动识别：wx0976665c3a3d5a7c
点击 "导入"

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

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

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

📱 生成测试二维码

真机预览

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

🎯 功能测试

测试首页

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

测试匹配书友

点击底部 "匹配书友" 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: 模拟器显示空白

解决：

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

Q2: 无法连接到服务器

解决：

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

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的创业实验 ```

🎉 准备好了！

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

现在：

打开微信开发者工具
导入项目
勾选"不校验合法域名"
点击编译

开始测试吧！ 🚀

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

4.6 KiB Raw Blame History Unescape Escape