优化阅读页跳转逻辑,优先传递章节中间ID(mid),以提升分享功能的一致性。更新相关页面以支持新逻辑,并在多个页面中添加mid数据绑定,确保数据传递的完整性。

This commit is contained in:
Alex-larget
2026-02-28 11:10:39 +08:00
parent 8af2d808f9
commit 244fe98591
106 changed files with 3379 additions and 239 deletions

View File

@@ -0,0 +1,5 @@
# 2026-02-26 | 产品经验
> 本日经验条目,格式:类型 | 摘要 | 升级 Skill
---

View File

@@ -0,0 +1,7 @@
# 产品经理 经验记录 - 2026-02-28
## stitch_soul 需求评审会议
- **stitch_soul 串联「内容→会员→导师」变现路径**:临时需求池 10 个稿子覆盖目录、导师、会员、首页、资料编辑,需在正式需求文档中明确 73 章、导师、案例库、会员的业务定义与验收标准。
- **待澄清项**73 章与现有内容库是否同一套;导师与内容作者是否同一人;「案例库」是独立内容池还是章节分类;会员权益与价格策略。
- **优先级建议**:首页/目录/会员 > 导师列表/详情 > 资料编辑。

View File

@@ -0,0 +1,4 @@
# 产品经理 经验索引
| 日期 | 摘要 | 文件 |
|------|------|------|

View File

@@ -0,0 +1,5 @@
# 2026-02-26 | 后端经验
> 本日经验条目,格式:类型 | 摘要 | 升级 Skill
---

View File

@@ -0,0 +1,7 @@
# 后端开发 经验记录 - 2026-02-28
## stitch_soul 需求评审会议
- **现有基础**soul-api 已有 chapter、book、vip 模型;导师能力需新建或扩展现有 match 体系(现有 mentor 为 match 类型,非独立导师实体)。
- **待设计**:导师列表/详情/搜索筛选、预约单、会员权益与预约支付打通;接口挂 `/api/miniprogram/*`
- **协同**:与产品核对 chapter/book/vip 现状后,给出导师/预约/会员权益的模型与接口方案。

View File

@@ -0,0 +1,4 @@
# 后端工程师 经验索引
| 日期 | 摘要 | 文件 |
|------|------|------|

View File

View File

@@ -0,0 +1,10 @@
# 2026-02-27 | 团队经验
> 本日跨角色共享的架构决策、业务规则。格式:类型 | 摘要 | 关联 Skill
---
## 输入框样式(前端通用)
- **最佳实践 | 输入框 padding**:设置 input 的 padding/背景/边框时,用 div 或 view 包裹 inputpadding 写在容器上input 仅做文字样式,可避免光标截断、布局异常。
- **适用**小程序、管理端React input 同理)

View File

@@ -0,0 +1,11 @@
# 团队共享 经验记录 - 2026-02-28
## stitch_soul 需求评审会议
- **stitch_soul 定位** stitch 产品线在 Soul 创业派对上的扩展,串联「内容阅读 + 导师咨询」变现路径。
- **架构协同**:需与现有 soul-api/soul-admin/miniprogram 架构协同;严禁混用 admin/miniprogram 路由;接口按使用方挂载。
- **开发顺序**:产品补充需求文档 → 后端给出模型与接口方案 → 管理端/小程序按优先级分阶段实现。
## 会议规则升级
- **问题与作答区**:开完会后必须将待确认/待澄清问题列出,在会议纪要中增加「问题与作答区」节,问题表含:序号、问题、责任角色、作答(留空供后续填写);便于追溯闭环。

View File

@@ -0,0 +1,6 @@
# 团队 经验索引(跨角色共享)
> 架构决策、业务规则、路由约定等跨角色共享内容。
| 日期 | 摘要 | 文件 |
|------|------|------|

View File

@@ -0,0 +1,5 @@
# 2026-02-26 | 小程序经验
> 本日经验条目,格式:类型 | 摘要 | 升级 Skill
---

View File

@@ -0,0 +1,19 @@
# 小程序开发工程师 经验记录 - 2026-02-27
---
## 输入框 padding 最佳实践
- **场景**:设置 input 的 padding、背景、边框等样式时直接作用于 input 可能导致光标被截断、布局异常。
- **方案**:用 `<view>` 包裹 `<input>`padding/背景/边框写在 view 上input 仅设置 width、font-size、color 等文字相关样式。
- **示例**
```xml
<view class="form-input">
<input placeholder="提示文字" value="{{value}}" bindinput="onInput" />
</view>
```
```css
.form-input { padding: 16rpx 24rpx; background: rgba(255,255,255,0.06); border: 1rpx solid rgba(255,255,255,0.1); border-radius: 12rpx; }
.form-input input { width: 100%; font-size: 28rpx; color: #fff; background: transparent; }
```
- **升级**:已写入 SKILL-小程序开发 §6 表单与输入框

View File

@@ -0,0 +1,7 @@
# 小程序开发工程师 经验记录 - 2026-02-28
## stitch_soul 需求评审会议
- **页面范围**:首页、目录、导师列表/详情、会员落地页、个人资料/编辑;全部接口走 `/api/miniprogram/*`
- **支付**:会员购买、导师预约支付需按微信支付规范实现。
- **时机**:待需求与接口确定后按优先级分阶段排期(建议:内容→会员→导师→资料编辑)。

View File

@@ -0,0 +1,4 @@
# 小程序开发工程师 经验索引
| 日期 | 摘要 | 文件 |
|------|------|------|

View File

@@ -0,0 +1,12 @@
# 开发助理(橙子)
> 规则进化执行、通用经验池、项目索引。经验:`.cursor/agent/开发助理/evolution/`
## 目录结构
| 目录 | 说明 |
|------|------|
| evolution/ | 通用经验池 |
| archived/ | 已归档经验 |
| script/ | 规则进化 bat 入口 |
| 项目索引/ | 各角色开发进度索引 |

View File

@@ -0,0 +1,5 @@
# 2026-02-26 | 助理橙子经验
> 本日经验条目,格式:类型 | 摘要 | 升级 Skill
---

View File

@@ -0,0 +1,6 @@
# 开发助理 经验索引(通用)
> 无明确角色归属的通用经验。助理橙子执行时可按需参考。
| 日期 | 摘要 | 文件 |
|------|------|------|

View File

@@ -0,0 +1,46 @@
@echo off
chcp 65001 >nul
set PYTHONUTF8=1
set PYTHONIOENCODING=utf-8
cd /d "%~dp0..\..\..\.."
:menu
cls
echo ========================================
echo 开发助理 - 规则进化 一键操作
echo ========================================
echo.
echo 1. 添加经验(从 stdin 粘贴 JSON
echo 2. 列出经验池
echo 3. 执行进化(归档 + 可选应用新规则)
echo 4. 退出
echo.
set /p choice=请选择 (1-4):
if "%choice%"=="1" goto add
if "%choice%"=="2" goto list
if "%choice%"=="3" goto evolve
if "%choice%"=="4" exit
goto menu
:add
echo.
echo 请粘贴 AI 输出的 JSON按 Ctrl+Z 回车结束:
python .cursor\scripts\evolution.py add --stdin
pause
goto menu
:list
echo.
python .cursor\scripts\evolution.py list
pause
goto menu
:evolve
echo.
set /p RULE_FILE=新规则文件路径(留空则仅归档):
if "%RULE_FILE%"=="" (
python .cursor\scripts\evolution.py evolve --archive
) else (
python .cursor\scripts\evolution.py evolve --archive --rule "%RULE_FILE%"
)
pause
goto menu

View File

@@ -0,0 +1,6 @@
@echo off
chcp 65001 >nul
cd /d "%~dp0..\..\..\.."
echo 开发助理 - 列出经验池
python .cursor\scripts\evolution.py list
pause

View File

@@ -0,0 +1,6 @@
@echo off
chcp 65001 >nul
cd /d "%~dp0..\..\..\.."
echo 开发助理 - 执行进化(归档经验池)
python .cursor\scripts\evolution.py evolve --archive
pause

View File

@@ -0,0 +1,12 @@
@echo off
chcp 65001 >nul
set PYTHONUTF8=1
set PYTHONIOENCODING=utf-8
cd /d "%~dp0..\..\..\.."
echo 开发助理 - 添加经验
echo.
echo 请将 AI 输出的 JSON 粘贴到下方,按 Ctrl+Z 回车结束:
echo.
python .cursor\scripts\evolution.py add --stdin
echo.
pause

View File

@@ -0,0 +1,36 @@
# 开发团队经验清单
> 跨角色经验索引。经验在 `agent/*/evolution/`,项目索引在 `agent/开发助理/项目索引/`。
---
## 各角色经验库
| 角色 | 项目索引 | 按日经验 |
|------|----------|----------|
| 小程序 | [agent/开发助理/项目索引/小程序.md](./项目索引/小程序.md) | agent/小程序开发工程师/evolution/ |
| 管理端 | [agent/开发助理/项目索引/管理端.md](./项目索引/管理端.md) | agent/管理端开发工程师/evolution/ |
| 后端 | [agent/开发助理/项目索引/后端.md](./项目索引/后端.md) | agent/后端工程师/evolution/ |
| 产品 | [agent/开发助理/项目索引/产品.md](./项目索引/产品.md) | agent/产品经理/evolution/ |
| 测试 | [agent/开发助理/项目索引/测试.md](./项目索引/测试.md) | agent/软件测试/evolution/ |
| 助理橙子 | [agent/开发助理/项目索引/助理橙子.md](./项目索引/助理橙子.md) | agent/开发助理/evolution/ |
| 团队(跨角色共享) | [agent/开发助理/项目索引/团队.md](./项目索引/团队.md) | agent/团队/evolution/ |
---
## 索引表
| 日期 | 角色 | 类型 | 升级 Skill | 摘要 |
|------|------|------|------------|------|
| 2026-02-27 | 小程序、团队 | 最佳实践 | SKILL-小程序开发 §6、SKILL-管理端开发 §4.1 | 输入框 padding 用 view/div 包裹 |
---
## 已吸收经验(历史)
- **SetVipModal**SKILL-管理端开发 4.1 表单弹窗
- **vip_roles**SKILL-API开发 3.2、SKILL-MySQL直接操作 8
---
**最后更新**2026-02-27

View File

@@ -0,0 +1,3 @@
# 项目索引
存放各角色子项目开发进度、状态。每角色对应一份索引。

View File

@@ -0,0 +1,25 @@
# 产品 - 项目索引
> 根据开发进度对项目做总结,保存开发进度,方便下次继续开发。**每次保存必须写日期**。
---
## 项目总结
Soul 创业派对产品定位:面向创业者的社区/工具型小程序。核心需求文档在 `开发文档/1、需求/需求汇总.md`,项目推进表在 `开发文档/10、项目管理/项目落地推进表.md`,临时需求/分析在 `临时需求池/`
---
## 开发进度
| 日期 | 摘要 | 状态 |
|------|------|------|
| 2026-02-26 | 项目索引初始化,.cursor 规则优化完成 | 已完成 |
| 2026-02-27 | 开发进度同步会议汇报进度待办「资料不解锁」补充、≥3 章弹窗明确 | 已完成 |
| 2026-02-28 | stitch_soul 需求评审:内容→会员→导师变现路径,待产品补充正式需求文档 | 待续 |
> **格式说明**:每次开发后在此追加一行,日期格式 YYYY-MM-DD状态用已完成 / 进行中 / 待续 / 搁置
---
**最后更新**2026-02-28

View File

@@ -0,0 +1,24 @@
# 助理橙子 - 项目索引
> 根据开发进度对项目做总结,保存开发进度,方便下次继续开发。**每次保存必须写日期**。
---
## 项目总结
助理橙子负责开发团队文档同步与经验升级。触发词:小橙/橙子/橙橙/🍊。核心流程文件:`SKILL-助理橙子-文档同步.md`。经验结构agent/*/evolution 按角色 + 按日/按条存储 + 项目索引。
---
## 开发进度
| 日期 | 摘要 | 状态 |
|------|------|------|
| 2026-02-26 | 项目索引初始化经验库五角色目录结构搭建SKILL 补充角色映射表与跨端写入规则 | 已完成 |
| 2026-02-28 | .cursor 按 cursor标准模板 重构agent 目录、config、evolution.py、meeting | 已完成 |
> **格式说明**:每次开发后在此追加一行,日期格式 YYYY-MM-DD状态用已完成 / 进行中 / 待续 / 搁置
---
**最后更新**2026-02-28

View File

@@ -0,0 +1,26 @@
# 后端 - 项目索引
> 根据开发进度对项目做总结,保存开发进度,方便下次继续开发。**每次保存必须写日期**。
---
## 项目总结
soul-apiGo + Gin + GORM + MySQL提供三组路由`/api/miniprogram/*`(小程序)、`/api/admin/*` + `/api/db/*`(管理端)、`/api/payment/*`(支付回调)。微信生态通过 PowerWeChat 集成。当前核心模块用户、订单、分销、VIP、提现、章节、配置。
---
## 开发进度
| 日期 | 摘要 | 状态 |
|------|------|------|
| 2026-02-26 | 项目索引初始化,.cursor 规则优化完成 | 已完成 |
| 2026-02-27 | 开发进度汇报computeOrderCommission 会员分润差异化20%/10%已实现vip_roles、vip_activated_at、referral_config 扩展已完成miniprogram/admin/db 三组路由就绪 | 已完成 |
| 2026-02-27 | 开发进度同步会议:进度已同步至开发文档,待办资料完善校验 | 已完成 |
| 2026-02-28 | stitch_soul 需求评审:需梳理 chapter/book/vip设计导师/预约/会员权益模型与接口 | 待续 |
> **格式说明**:每次开发后在此追加一行,日期格式 YYYY-MM-DD状态用已完成 / 进行中 / 待续 / 搁置
---
**最后更新**2026-02-28

View File

@@ -0,0 +1,24 @@
# 团队 - 项目索引
> 跨角色共享的架构决策、业务规则、团队级经验。根据讨论进度更新,**每次保存必须写日期**。
---
## 项目总结
Soul 创业派对全项目架构与约定路由隔离miniprogram/admin/db、三端协同流程、经验按角色+按日存储、会议纪要独立存档、语义触发词驱动角色切换。
---
## 开发进度
| 日期 | 摘要 | 状态 |
|------|------|------|
| 2026-02-27 | 项目索引初始化;团队经验库目录建立 | 已完成 |
| 2026-02-28 | stitch_soul 需求评审:内容→会员→导师变现路径,需与现有三端架构协同 | 已完成 |
> **格式说明**:每次架构级讨论后在此追加一行,日期格式 YYYY-MM-DD
---
**最后更新**2026-02-28

View File

@@ -0,0 +1,27 @@
# 小程序 - 项目索引
> 根据开发进度对项目做总结,保存开发进度,方便下次继续开发。**每次保存必须写日期**。
---
## 项目总结
小程序微信原生C 端主要功能:用户注册/登录、VIP 购买、章节阅读、分销推荐、提现申请、找伙伴。当前已上线核心功能,持续迭代优化中。
---
## 开发进度
| 日期 | 摘要 | 状态 |
|------|------|------|
| 2026-02-26 | 项目索引初始化,.cursor 规则优化完成 | 已完成 |
| 2026-02-27 | 开发进度汇报:永平落地已完成(海报 scene、我的收益、推广中心、VIP 相关);找伙伴、提现、阅读、分销核心功能已上线 | 已完成 |
| 2026-02-27 | 开发进度同步会议进度已同步至开发文档待办资料完善弹窗、≥3 章弹窗 | 已完成 |
| 2026-02-27 | 吸收经验:输入框 padding 用 view 包裹,已升级 SKILL-小程序开发 §6 | 已完成 |
| 2026-02-28 | stitch_soul 需求评审:首页/目录/导师/会员/资料五类页面,待需求与接口确定后分阶段实现 | 待续 |
> **格式说明**:每次开发后在此追加一行,日期格式 YYYY-MM-DD状态用已完成 / 进行中 / 待续 / 搁置
---
**最后更新**2026-02-28

View File

@@ -0,0 +1,23 @@
# 测试 - 项目索引
> 测试人员经验与测试进度。**每次保存必须写日期**。
---
## 项目总结
测试人员负责小程序、管理端、API 的功能测试、回归测试与三端联调。主 SkillSKILL-测试.md。
---
## 开发/测试进度
| 日期 | 进度摘要 | 状态 |
|------|----------|------|
| 2026-02-27 | 测试人员角色与 Skill 初始化 | 已完成 |
| 2026-02-27 | 小程序静态审查API 路径、页面接口、手工验证建议) | 已完成 |
| 2026-02-28 | stitch_soul 需求评审:关键场景为阅读/付费/会员/导师预约/资料;待需求确定后补充联调用例 | 待续 |
---
**最后更新**2026-02-28

View File

@@ -0,0 +1,26 @@
# 管理端 - 项目索引
> 根据开发进度对项目做总结,保存开发进度,方便下次继续开发。**每次保存必须写日期**。
---
## 项目总结
管理端React + Vite + Tailwind主要功能用户管理、订单管理、提现审核、VIP 管理、内容/章节管理、配置项管理、数据统计。调用 `/api/admin/*``/api/db/*` 接口JWT Bearer 鉴权。
---
## 开发进度
| 日期 | 摘要 | 状态 |
|------|------|------|
| 2026-02-26 | 项目索引初始化,.cursor 规则优化完成 | 已完成 |
| 2026-02-27 | 开发进度汇报:内容管理仅 API 按钮、推广中心、SetVipModal、VIP 角色管理、推广设置会员分润配置、VIP 排序等均已落地 | 已完成 |
| 2026-02-27 | 开发进度同步会议:进度已同步至运营与变更 | 已完成 |
| 2026-02-28 | stitch_soul 需求评审:待后端方案确定后规划章节/导师/会员/预约管理页面 | 待续 |
> **格式说明**:每次开发后在此追加一行,日期格式 YYYY-MM-DD状态用已完成 / 进行中 / 待续 / 搁置
---
**最后更新**2026-02-28

View File

@@ -0,0 +1,5 @@
# 2026-02-26 | 管理端经验
> 本日经验条目,格式:类型 | 摘要 | 升级 Skill
---

View File

@@ -0,0 +1,7 @@
# 管理端开发工程师 经验记录 - 2026-02-28
## stitch_soul 需求评审会议
- **待支撑能力**:章节管理(增删改、排序、免费/付费/NEW、导师管理审核、标签、价格、展示、会员配置权益、价格、有效期、预约管理列表、状态
- **接口依赖**`/api/admin/*``/api/db/*`;字段需与 miniprogram 端统一。
- **时机**:待后端方案确定后规划管理端页面与接口对接。

View File

@@ -0,0 +1,4 @@
# 管理端开发工程师 经验索引
| 日期 | 摘要 | 文件 |
|------|------|------|

View File

@@ -0,0 +1,4 @@
# 老板分身 经验索引
| 日期 | 摘要 | 文件 |
|------|------|------|

View File

@@ -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 路径隔离、规范遵从方面**通过静态审查**。建议在真机/模拟器中按上表手工验证核心流程。

View File

@@ -0,0 +1,7 @@
# 测试人员 经验记录 - 2026-02-28
## stitch_soul 需求评审会议
- **关键联调场景**:阅读进度、免费/付费解锁、会员权益、导师预约与支付、资料完善与提现限制。
- **三端**miniprogram ↔ soul-api、soul-admin ↔ soul-api变更后需回归支付、登录、提现等现有流程。
- **待办**:需求确定后补充三端联调用例与回归清单。

View File

@@ -0,0 +1,4 @@
# 软件测试 经验索引
| 日期 | 摘要 | 文件 |
|------|------|------|