更新文档，新增测试人员角色及其职责，调整团队结构以包含六个角色。优化会议记录和经验库，确保文档内容一致性，增强跨角色协作与经验共享功能。

.cursor/README.md

@@ -15,7 +15,7 @@
 ├── 经验库/                   # 经验沉淀，用于自动升级 Skills
 │   ├── README.md
 │   ├── 经验清单.md
-│   └── {小程序/管理端/后端/产品/助理橙子/团队}/
+│   └── {小程序/管理端/后端/产品/测试/助理橙子/团队}/
 └── 会议记录/                 # 多角色会议纪要（橙子生成）
     ├── README.md
     ├── _模板.md
@@ -32,6 +32,7 @@
 | 管理端开发工程师 | soul-admin/ | SKILL-管理端开发.md |
 | 后端开发 | soul-api/ | SKILL-API开发.md（说「后端」「API」也可触发） |
 | 产品经理 | 开发文档/1、需求/、临时需求池/ | SKILL-产品经理.md |
+| 测试人员 | miniprogram、soul-admin、soul-api | SKILL-测试.md（说「测试」「QA」也可触发） |
 | 助理橙子 | 讨论后记录、经验升级 | SKILL-助理橙子-文档同步.md |
 
 **经验库**：每角色独立文件夹 + 团队（跨角色共享）。用户说「吸收经验」「升级 skills」→ 入库 + 升级 Skill；说「保存开发进度」「任务完成」「搞定了」→ 更新项目索引。详见 [经验库 README](./经验库/README.md)。
@@ -46,6 +47,7 @@
 | soul-admin/ | `SKILL-管理端开发.md` | soul-admin-boundary |
 | soul-api/ | `SKILL-API开发.md` | soul-api |
 | 开发文档/1、需求/、临时需求池/ | `SKILL-产品经理.md` | product-manager |
+| 测试、测试用例、回归测试、功能测试、QA | `SKILL-测试.md` | - |
 | 小橙、橙子、讨论完毕、记录、同步文档 | `SKILL-助理橙子-文档同步.md` | assistant-xiaofeng |
 | 吸收经验、升级 skills、保存开发进度、任务完成、搞定了 | `SKILL-助理橙子-文档同步.md` | assistant-xiaofeng |
 | 跨端功能开发 | `SKILL-角色流程控制.md` | - |
@@ -80,6 +82,7 @@
 | 管理端开发工程师 | SKILL-管理端开发 | 三端架构 → API开发 → 变更关联检查 |
 | 后端开发 | SKILL-API开发 | soul-api 规范 → 三端架构 → 变更关联检查 → MySQL直接操作 |
 | 产品经理 | SKILL-产品经理 | 需求汇总、运营与变更 |
+| 测试人员 | SKILL-测试 | 变更关联检查、小程序/管理端/API 规范 |
 | 助理橙子 | SKILL-助理橙子-文档同步 | - |
 
 ### 场景 Skill
@@ -99,7 +102,7 @@
 
 | 文档 | 说明 |
 |------|------|
-| [开发团队职责定义](./docs/开发团队职责定义.md) | 五角色职责、Skills 分配 |
+| [开发团队职责定义](./docs/开发团队职责定义.md) | 六角色职责、Skills 分配 |
 | [三角色边界定义](./docs/三角色边界定义.md) | 开发三角色源码与业务边界 |
 | [角色驱动Skills分析](./docs/角色驱动Skills分析.md) | Skills 组织方式 |
 | [经验库 README](./经验库/README.md) | 经验入库、Skills 升级流程 |

.cursor/docs/开发团队职责定义.md

@@ -1,6 +1,6 @@
 # Soul 创业派对 - 开发团队职责定义
 
-> **开发团队**：2 前端 + 1 后端 + 1 产品 + 1 助理。按职责分配 Skills，有**经验库**用于根据经验自动升级 Skills。速查见 [.cursor/README.md](../README.md)。
+> **开发团队**：2 前端 + 1 后端 + 1 产品 + 1 测试 + 1 助理。按职责分配 Skills，有**经验库**用于根据经验自动升级 Skills。速查见 [.cursor/README.md](../README.md)。
 
 ---
 
@@ -12,6 +12,7 @@
 | **管理端开发工程师** | React 管理后台 | soul-admin/ | SKILL-管理端开发.md |
 | **后端开发** | Go + Gin + GORM 接口服务 | soul-api/ | SKILL-API开发.md |
 | **产品经理** | 需求、验收、协调 | 开发文档/1、需求/、临时需求池/ | SKILL-产品经理.md |
+| **测试人员** | 功能测试、回归测试、三端联调 | miniprogram、soul-admin、soul-api | SKILL-测试.md |
 | **助理橙子** | 讨论后记录、文档同步 | 触发词：小橙、橙子、讨论完毕 | SKILL-助理橙子-文档同步.md |
 
 ---
@@ -63,7 +64,17 @@
 | **主 Skill** | SKILL-产品经理.md |
 | **产出** | 需求汇总、需求分析、验收清单、项目推进表 |
 
-### 3.2 助理橙子
+### 3.2 测试人员
+
+| 项目 | 说明 |
+|------|------|
+| **职责** | 功能测试、回归测试、三端（小程序、管理端、API）联调验证 |
+| **测试范围** | miniprogram、soul-admin、soul-api |
+| **主 Skill** | SKILL-测试.md |
+| **产出** | 测试用例、测试报告、Bug 列表 |
+| **协同** | 与开发角色对接 Bug、验收前测试 |
+
+### 3.3 助理橙子
 
 | 项目 | 说明 |
 |------|------|
@@ -82,6 +93,7 @@
 | 管理端开发工程师 | SKILL-管理端开发 | 三端架构、API开发、变更关联检查 | 角色流程控制 |
 | 后端开发 | SKILL-API开发 | soul-api 规范、三端架构、变更关联检查、MySQL直接操作 | 角色流程控制 |
 | 产品经理 | SKILL-产品经理 | 需求汇总、运营与变更 | - |
+| 测试人员 | SKILL-测试 | 变更关联检查、小程序/管理端/API 规范 | - |
 | 助理橙子 | SKILL-助理橙子-文档同步 | - | - |
 
 ### 通用 / 场景 Skill（全员）
@@ -103,6 +115,7 @@
 | 编辑 soul-admin/** | 管理端开发工程师 | SKILL-管理端开发 + soul-admin-boundary |
 | 编辑 soul-api/** | 后端开发 | SKILL-API开发 + soul-api |
 | 编辑 开发文档/1、需求/、临时需求池/ | 产品经理 | SKILL-产品经理 |
+| 说 测试、测试用例、回归测试、功能测试、QA | 测试人员 | SKILL-测试 |
 | 说 小橙、橙子、讨论完毕、记录、同步文档 | 助理橙子 | SKILL-助理橙子-文档同步 |
 
 ---
@@ -111,7 +124,7 @@
 
 | 项目 | 说明 |
 |------|------|
-| **位置** | `.cursor/经验库/`，每角色独立文件夹（小程序/管理端/后端/产品/助理橙子） |
+| **位置** | `.cursor/经验库/`，每角色独立文件夹（小程序/管理端/后端/产品/测试/助理橙子） |
 | **项目索引** | 每角色有 `项目索引.md`，根据开发进度做总结、保存进度，**每次保存写日期** |
 | **经验存储** | 按天存储，文件名 `YYYY-MM-DD.md`，在对应角色文件夹下 |
 | **用途** | 沉淀 bug 修复、最佳实践、决策、踩坑；根据经验**自动升级 Skills** |

.cursor/rules/soul-project-boundary.mdc

@@ -48,6 +48,7 @@ alwaysApply: true
 | 管理端、soul-admin、React、后台管理 | 管理端开发工程师 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-管理端开发.md` |
 | 小程序、miniprogram、C 端、微信小程序 | 小程序开发工程师 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-小程序开发.md` |
 | 产品、需求、验收、排期、需求文档 | 产品经理 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-产品经理.md` |
+| 测试、测试用例、回归测试、功能测试、QA | 测试人员 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-测试.md` |
 
 ### 按场景触发词
 

.cursor/skills/SKILL-助理橙子-文档同步.md

@@ -82,6 +82,7 @@ description: 开发团队文档同步与经验升级。小橙、橙子、讨论
 | 管理端开发工程师 | `管理端` | `e:\Gongsi\Mycontent\.cursor\经验库\管理端\` |
 | 后端开发 | `后端` | `e:\Gongsi\Mycontent\.cursor\经验库\后端\` |
 | 产品经理 | `产品` | `e:\Gongsi\Mycontent\.cursor\经验库\产品\` |
+| 测试人员 | `测试` | `e:\Gongsi\Mycontent\.cursor\经验库\测试\` |
 | 助理橙子 | `助理橙子` | `e:\Gongsi\Mycontent\.cursor\经验库\助理橙子\` |
 
 #### 5.2 跨端经验写入规则

.cursor/skills/SKILL-团队会议.md

@@ -32,7 +32,7 @@ description: Soul 创业派对开发团队多角色会议。语义化触发：
    → 宣布参会角色（根据议题自动判断：涉及哪些端就叫哪些角色）
 
 第二步：各角色依次发言
-   → 按【产品经理】→【后端开发】→【管理端开发工程师】→【小程序开发工程师】顺序
+   → 按【产品经理】→【后端开发】→【管理端开发工程师】→【小程序开发工程师】→【测试人员】（验收/测试相关时）顺序
    → 每个角色从自身专业视角对议题发表意见
    → 格式：【角色名】：内容
 
@@ -79,6 +79,11 @@ description: Soul 创业派对开发团队多角色会议。语义化触发：
 - 支付/登录/场景值是否有特殊要求？
 - 与现有页面的衔接点？
 
+### 【测试人员】关注点（验收、测试相关会议时参与）
+- 测试用例覆盖哪些场景？边界条件？
+- 三端联调（小程序↔API、管理端↔API）验证点？
+- 回归测试清单？已知风险？
+
 ---
 
 ## 4. 橙子会议收尾流程（会议结束后必须执行）
@@ -100,6 +105,7 @@ description: Soul 创业派对开发团队多角色会议。语义化触发：
 | 后端开发 | 后端 |
 | 管理端开发工程师 | 管理端 |
 | 小程序开发工程师 | 小程序 |
+| 测试人员 | 测试 |
 
 对每个参会角色，执行：
 

.cursor/skills/SKILL-测试.md

@@ -0,0 +1,72 @@
+---
+name: soul-tester
+description: Soul 创业派对测试人员。功能测试、回归测试、三端（小程序、管理端、API）联调验证。Use when 测试, 测试用例, 回归测试, 功能测试, QA.
+---
+
+# Soul 创业派对 - 测试人员 Skill
+
+当你在**功能测试、回归测试、三端联调验证**时，使用本 Skill。测试人员负责小程序、管理端、API 的功能与集成测试，不参与源码编写。
+
+---
+
+## 1. 职责范围
+
+| 职责 | 说明 | 产出 |
+|------|------|------|
+| 功能测试 | 按需求验证功能正确性 | 测试用例、通过/失败记录 |
+| 回归测试 | 变更后验证原有功能未破坏 | 回归清单、测试报告 |
+| 三端联调 | 小程序↔API、管理端↔API 数据流验证 | 联调记录 |
+| Bug 反馈 | 复现步骤、环境、期望 vs 实际 | Bug 列表、复现说明 |
+
+---
+
+## 2. 测试范围
+
+| 端 | 目录 | API 路径 | 重点 |
+|----|------|----------|------|
+| 小程序 | miniprogram/ | /api/miniprogram/* | 登录、支付、推荐码、VIP、阅读、分享 |
+| 管理端 | soul-admin/ | /api/admin/*、/api/db/* | 内容管理、用户、订单、提现、VIP 角色、推广设置 |
+| API 后端 | soul-api/ | 全部 | 接口契约、鉴权、分润、支付回调 |
+
+---
+
+## 3. 测试原则
+
+- **路径隔离**：小程序只调 miniprogram；管理端只调 admin/db；不得混用。
+- **鉴权**：需登录接口需带 token；401 时正确跳转登录。
+- **数据流**：下单→支付→回调→分润；推荐码绑定→访问记录；VIP 资料保存→排行展示。
+- **变更检查**：开发完成变更后，可参考 soul-change-checklist 做关联检查，避免遗漏。
+
+---
+
+## 4. 常用测试场景
+
+| 场景 | 验证点 |
+|------|--------|
+| 小程序登录 | 微信登录、手机号、token 持久化 |
+| 购买与支付 | 下单、微信支付、回调更新、购买状态 |
+| 推荐与分润 | 扫码/分享带 ref、绑定、分润计算 |
+| VIP 功能 | 开通、资料填写、头像上传、保存、排行展示 |
+| 管理端 CRUD | 列表、搜索、分页、新增、编辑、删除 |
+| 提现 | 申请、审核、状态流转、到账确认 |
+
+---
+
+## 5. 产出与协同
+
+| 产出 | 说明 |
+|------|------|
+| 测试用例 | 场景、步骤、期望结果 |
+| 测试报告 | 通过率、失败用例、环境信息 |
+| Bug 列表 | 复现步骤、关联端、严重程度 |
+
+**协同**：发现 Bug 时与对应开发角色（小程序/管理端/后端）对接；验收前完成测试并输出报告。
+
+---
+
+## 6. 何时使用本 Skill
+
+- 编写或执行测试用例时
+- 做回归测试、功能验证时
+- 三端联调、接口契约验证时
+- 说「测试」「测试用例」「回归测试」「功能测试」「QA」时

.cursor/会议记录/README.md

@@ -27,13 +27,14 @@ YYYY-MM-DD_会议主题.md
 ## 基本信息
 - **时间**：YYYY-MM-DD HH:mm
 - **议题**：xxx
-- **参与角色**：产品经理、后端开发、管理端开发工程师、小程序开发工程师
+- **参与角色**：产品经理、后端开发、管理端开发工程师、小程序开发工程师、测试人员
 
 ## 各角色发言
 ### 【产品经理】...
 ### 【后端开发】...
 ### 【管理端开发工程师】...
 ### 【小程序开发工程师】...
+### 【测试人员】...（验收/测试相关）
 
 ## 讨论过程
 （关键讨论节点记录）

.cursor/会议记录/_模板.md

@@ -9,7 +9,7 @@
 - **时间**：YYYY-MM-DD HH:mm
 - **议题**：{从用户消息提取}
 - **触发方式**：{语义化触发词}
-- **参与角色**：{根据议题自动判断：产品经理、后端开发、管理端开发工程师、小程序开发工程师}
+- **参与角色**：{根据议题自动判断：产品经理、后端开发、管理端开发工程师、小程序开发工程师、测试人员}
 
 ---
 
@@ -33,6 +33,10 @@
 
 （从 C 端用户体验、交互流程、接口依赖角度发言）
 
+### 【测试人员】（验收/测试相关会议时）
+
+（从测试用例、三端联调、回归清单、已知风险角度发言）
+
 ---
 
 ## 讨论过程
@@ -59,6 +63,7 @@
 | 管理端开发工程师 | {任务} | 高/中/低 | {日期} |
 | 小程序开发工程师 | {任务} | 高/中/低 | {日期} |
 | 产品经理 | {任务} | 高/中/低 | {日期} |
+| 测试人员 | {任务} | 高/中/低 | {日期} |
 
 ---
 
@@ -82,6 +87,10 @@
 
 - {从本次会议提炼的小程序相关经验}
 
+### 测试人员
+
+- {从本次会议提炼的测试相关经验}
+
 ### 团队共享
 
 - {跨角色共享的架构决策或业务规则}

.cursor/经验库/README.md

@@ -22,6 +22,9 @@
 ├── 产品/
 │   ├── 项目索引.md
 │   └── YYYY-MM-DD.md
+├── 测试/
+│   ├── 项目索引.md
+│   └── YYYY-MM-DD.md
 ├── 助理橙子/
 │   ├── 项目索引.md
 │   └── YYYY-MM-DD.md

.cursor/经验库/测试/2026-02-27.md

@@ -0,0 +1,65 @@
+# 测试 - 经验记录 - 2026-02-27
+
+## 小程序静态审查报告
+
+**测试时间**：2026-02-27  
+**测试方式**：代码级静态分析  
+**测试范围**：miniprogram 全目录（不含 backup 文件）
+
+---
+
+### 一、API 路径隔离检查 ✅ 通过
+
+| 检查项 | 结果 | 说明 |
+|--------|------|------|
+| 是否只调 /api/miniprogram/* | ✅ | 所有 app.request 均使用 miniprogram 路径 |
+| 是否误调 /api/admin/*、/api/db/* | ✅ | 无违规调用 |
+| wx.uploadFile URL | ✅ | 使用 baseUrl + /api/miniprogram/upload |
+
+**说明**：`read.js.backup` 中曾有 `/api/db/config`，该文件为备份，非线上代码。
+
+---
+
+### 二、主要页面与接口映射
+
+| 页面/模块 | 主要接口 | 状态 |
+|-----------|----------|------|
+| 首页 index | vip/members、users、book/all-chapters | ✅ |
+| 目录 chapters | book/all-chapters | ✅ |
+| 阅读 read | book/chapter、purchase-status、pay、qrcode | ✅ |
+| 我的 my | config、withdraw/*、earnings、user/update、vip/status | ✅ |
+| VIP vip | vip/status、vip/profile、upload、pay | ✅ |
+| 推广 referral | referral/data、qrcode、withdraw | ✅ |
+| 匹配 match | match/config、match/users、ckb/join、ckb/match、pay | ✅ |
+| 设置 settings | user/update、user/profile、phone、upload | ✅ |
+| 地址 addresses | user/addresses | ✅ |
+| 提现记录 | withdraw/records、confirm-info | ✅ |
+| 购买记录 purchases | orders | ✅ |
+| 会员详情 member-detail | vip/members、users | ✅ |
+| 搜索 search | book/hot、book/search | ✅ |
+
+---
+
+### 三、建议手工验证场景
+
+| 场景 | 验证点 | 优先级 |
+|------|--------|--------|
+| 登录 | 微信登录、token 持久化、401 跳转 | 高 |
+| VIP 购买 | 下单、支付、开通成功、资料填写、头像上传 | 高 |
+| 推荐码 | 分享带 ref、扫码绑定、分润展示 | 高 |
+| 超级个体 | 加载骨架、头像展示、点击进详情 | 中 |
+| 朋友圈分享 | 所有页面右上角「分享到朋友圈」可点 | 中 |
+| 提现 | 申请、记录、确认收款 | 中 |
+| 地址管理 | 增删改查、默认地址 | 低 |
+
+---
+
+### 四、发现与建议
+
+1. **输入框规范**：VIP 等表单已按「view 包裹 input」规范实现，符合 SKILL-小程序开发 §6。
+2. **朋友圈分享**：各页面已启用 wx.showShareMenu + onShareTimeline，推荐码会随 query 传递。
+3. **超级个体**：已有 4 圆形骨架加载动画，加载完成后再展示内容或空态。
+
+---
+
+**结论**：小程序代码在 API 路径隔离、规范遵从方面**通过静态审查**。建议在真机/模拟器中按上表手工验证核心流程。

.cursor/经验库/测试/项目索引.md

@@ -0,0 +1,22 @@
+# 测试 - 项目索引
+
+> 测试人员经验与测试进度。**每次保存必须写日期**。
+
+---
+
+## 项目总结
+
+测试人员负责小程序、管理端、API 的功能测试、回归测试与三端联调。主 Skill：SKILL-测试.md。
+
+---
+
+## 开发/测试进度
+
+| 日期 | 进度摘要 | 状态 |
+|------|----------|------|
+| 2026-02-27 | 测试人员角色与 Skill 初始化 | 已完成 |
+| 2026-02-27 | 小程序静态审查（API 路径、页面接口、手工验证建议） | 已完成 |
+
+---
+
+**最后更新**：2026-02-27

.cursor/经验库/经验清单.md

@@ -12,6 +12,7 @@
 | 管理端 | [管理端/项目索引.md](./管理端/项目索引.md) | 管理端/YYYY-MM-DD.md |
 | 后端 | [后端/项目索引.md](./后端/项目索引.md) | 后端/YYYY-MM-DD.md |
 | 产品 | [产品/项目索引.md](./产品/项目索引.md) | 产品/YYYY-MM-DD.md |
+| 测试 | [测试/项目索引.md](./测试/项目索引.md) | 测试/YYYY-MM-DD.md |
 | 助理橙子 | [助理橙子/项目索引.md](./助理橙子/项目索引.md) | 助理橙子/YYYY-MM-DD.md |
 | 团队（跨角色共享） | [团队/项目索引.md](./团队/项目索引.md) | 团队/YYYY-MM-DD.md |
 

.gitignore

@@ -2,3 +2,5 @@
 soul-api/wechat/info.log
 next-project
 soul-admin/node_modules
+soul-api
+soul-api.exe

miniprogram/app.js

@@ -9,8 +9,8 @@ App({
   globalData: {
     // API基础地址 - 连接真实后端
     // baseUrl: 'https://soulapi.quwanzhi.com',
-    // baseUrl: 'https://souldev.quwanzhi.com',
-    baseUrl: 'http://localhost:8080',
+    baseUrl: 'https://souldev.quwanzhi.com',
+    // baseUrl: 'http://localhost:8080',
     
     
     // 小程序配置 - 真实AppID

soul-api/dev_dev.py

@@ -3,7 +3,7 @@
 """
 soul-api Go 项目一键部署到宝塔，重启的是宝塔里的 soulDev 项目
 - 本地交叉编译 Linux 二进制
-- 上传到 /www/wwwroot/自营/soul-dev
+- 上传到 /www/wwwroot/self/soul-dev
 - 重启 soulDev：优先宝塔 API（需配置），否则 SSH 下 setsid nohup 启动
 
 宝塔 API 重启（可选）：在环境变量或 .env 中设置
@@ -44,7 +44,7 @@ except ImportError:
 
 # ==================== 配置 ====================
 
-DEPLOY_PROJECT_PATH = "/www/wwwroot/自营/soul-dev"
+DEPLOY_PROJECT_PATH = "/www/wwwroot/self/soul-dev"
 DEFAULT_SSH_PORT = int(os.environ.get("DEPLOY_SSH_PORT", "22022"))
 
 

soul-api/devlop.py

@@ -3,7 +3,7 @@
 """
 soulApp (soul-api) Go 项目一键部署到宝塔
 - 本地交叉编译 Linux 二进制
-- 上传到 /www/wwwroot/自营/soul-api
+- 上传到 /www/wwwroot/self/soul-api
 - 重启：优先宝塔 API（需配置），否则 SSH 下 setsid nohup 启动
 
 宝塔 API 重启（可选）：在环境变量或 .env 中设置
@@ -44,7 +44,7 @@ except ImportError:
 
 # ==================== 配置 ====================
 
-DEPLOY_PROJECT_PATH = "/www/wwwroot/自营/soul-api"
+DEPLOY_PROJECT_PATH = "/www/wwwroot/self/soul-api"
 DEFAULT_SSH_PORT = int(os.environ.get("DEPLOY_SSH_PORT", "22022"))
 
 

开发文档/6、后端/管理端鉴权设计.md

@@ -1,6 +1,6 @@
 # soul-api 管理端登录判断与权限校验
 
-> 来源：soul-api/管理端鉴权设计.md
+> 来源：soul-api/管理端鉴权设计.md。已整理至开发文档。
 
 ---
 

开发文档/8、部署/商家转账.md

@@ -1,6 +1,6 @@
 # 商家转账 PowerWeChat 调用示例
 
-> 来源：soul-api/商家转账.md。完整实现见 [提现功能完整技术文档](提现功能完整技术文档.md)。
+> 来源：soul-api/商家转账.md。已整理至开发文档。完整实现见 [提现功能完整技术文档](提现功能完整技术文档.md)。
 
 ---
 

开发文档/8、部署/宝塔反向代理说明.md

@@ -0,0 +1,87 @@
+# soul-api 域名 404 原因与解决
+
+> 来源：soul-api/宝塔反向代理说明.txt
+
+## 原因
+
+域名请求先到 Nginx，若没有把请求转发到本机 8080 的 Go，或站点用了 root/静态目录，就会 404。
+
+---
+
+## 一、先确认 Go 是否在跑（必做）
+
+在宝塔终端或 SSH 里执行：
+
+```
+curl -s http://127.0.0.1:8080/health
+```
+
+- 若返回 `{"status":"ok"}`：说明 Go 正常，问题在 Nginx，看下面第二步。
+- 若连接被拒绝或超时：说明 8080 没在监听。去 宝塔 → Go项目管理 → soulApi → 服务状态，看是否「运行中」；看「项目日志」是否有报错。
+
+---
+
+## 二、Nginx 必须「整站走代理」，不能走 root
+
+添加了反向代理仍 404，多半是：
+
+- 站点默认有 `location / { root ...; index ...; }`，请求被当成静态文件处理，`/health` 找不到就 404；
+- 或反向代理只绑在了子路径（如 `/api`），`/` 和 `/health` 没被代理。
+
+**做法**：让 soulapi.quwanzhi.com 的**所有路径**都走 8080，不要用 root。
+
+在宝塔：网站 → soulapi.quwanzhi.com → 设置 → 配置文件，找到该站点的 `server { ... }`，按下面两种方式之一改。
+
+### 方式 A：只保留一个 location /（推荐）
+
+把 server 里**原来的** `location / { ... }`（含 root、index 的那段）**删掉或注释掉**，只保留下面这一段：
+
+```nginx
+location / {
+    proxy_pass http://127.0.0.1:8080;
+    proxy_http_version 1.1;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+}
+```
+
+保存 → 重载 Nginx（或 宝塔 里点「重载配置」）。
+
+### 方式 B：整站用下面这一整段 server（HTTPS 示例）
+
+若你希望整站只做反向代理、不混静态，可以把该站点的 server 块整体替换成下面内容（把 your_ssl_cert 等换成你实际的证书路径；没有 SSL 就只用 listen 80 那段）：
+
+```nginx
+server {
+    listen 80;
+    listen 443 ssl http2;
+    server_name soulapi.quwanzhi.com;
+    # SSL 证书路径按宝塔实际填写，例如：
+    # ssl_certificate    /www/server/panel/vhost/cert/soulapi.quwanzhi.com/fullchain.pem;
+    # ssl_certificate_key /www/server/panel/vhost/cert/soulapi.quwanzhi.com/privkey.pem;
+
+    location / {
+        proxy_pass http://127.0.0.1:8080;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+}
+```
+
+保存并重载 Nginx。
+
+---
+
+## 三、改完后自测
+
+- 本机：`curl -s https://soulapi.quwanzhi.com/health`
+- 或浏览器打开：https://soulapi.quwanzhi.com/health  
+
+应看到：`{"status":"ok"}`
+
+- 打开 https://soulapi.quwanzhi.com/ 应看到「部署成功」页面。

开发文档/8、部署/订阅消息.md

@@ -1,6 +1,6 @@
 # 提现订阅消息（PowerWeChat）
 
-> 来源：soul-api/订阅消息.md。提现成功后向用户发送订阅消息。
+> 来源：soul-api/订阅消息.md。提现成功后向用户发送订阅消息。已整理至开发文档。
 
 ---
 

开发文档/README.md

@@ -38,10 +38,12 @@
 | 文档 | 说明 |
 |------|------|
 | [5、接口/API接口完整文档](5、接口/API接口完整文档.md) | API 完整文档 |
+| [6、后端/管理端鉴权设计](6、后端/管理端鉴权设计.md) | soul-api 管理端 JWT 鉴权、路由分层 |
 | [8、部署/部署总览](8、部署/部署总览.md) | 部署入口、分销与流程 |
+| [8、部署/宝塔反向代理说明](8、部署/宝塔反向代理说明.md) | soul-api 域名 404 排查、Nginx 反向代理配置 |
 | [8、部署/提现功能完整技术文档](8、部署/提现功能完整技术文档.md) | 微信支付商家转账到零钱 API 集成 |
 | [8、部署/分销提现流程图](8、部署/分销提现流程图.md) | 提现业务流程图 |
-| [8、部署/订阅消息](8、部署/订阅消息.md) | 提现成功订阅消息 |
+| [8、部署/订阅消息](8、部署/订阅消息.md) | 提现成功订阅消息（PowerWeChat） |
 | [8、部署/商家转账](8、部署/商家转账.md) | PowerWeChat 商家转账示例 |
 
 ### 临时需求池