4.2 KiB
4.2 KiB
开发团队经验清单
跨角色经验索引。经验在
agent/*/evolution/，项目索引在agent/开发助理/项目索引/。
各角色经验库
| 角色 | 项目索引 | 按日经验 |
|---|---|---|
| 小程序 | agent/开发助理/项目索引/小程序.md | agent/小程序开发工程师/evolution/ |
| 管理端 | agent/开发助理/项目索引/管理端.md | agent/管理端开发工程师/evolution/ |
| 后端 | agent/开发助理/项目索引/后端.md | agent/后端工程师/evolution/ |
| 产品 | agent/开发助理/项目索引/产品.md | agent/产品经理/evolution/ |
| 测试 | agent/开发助理/项目索引/测试.md | agent/软件测试/evolution/ |
| 助理橙子 | agent/开发助理/项目索引/助理橙子.md | agent/开发助理/evolution/ |
| 团队（跨角色共享） | agent/开发助理/项目索引/团队.md | agent/团队/evolution/ |
索引表
| 日期 | 角色 | 类型 | 升级 Skill | 摘要 |
|---|---|---|---|---|
| 2026-02-27 | 小程序、团队 | 最佳实践 | SKILL-小程序开发 §6、SKILL-管理端开发 §4.1 | 输入框 padding 用 view/div 包裹 |
| 2026-02-28 | 小程序、管理端 | 最佳实践 | miniprogram §6、admin §4.1 | input 边距口诀「外边包 view、内部 width 100%」；match 弹窗已修正 |
| 2026-03-03 | 小程序 | 最佳实践 | miniprogram §8 | 我的页面卡片区边距 16rpx，个人中心类页面布局规范 |
| 2026-03-10 | 团队 | 架构/运维约定 | lobster-macos-vm Skill | Windows 上统一使用 WSL2+QEMU+OneClick 的"龙虾"方案安装 macOS 虚拟机，禁止 Docker 直跑 macOS |
| 2026-03-10 | 小程序 | 最佳实践 | miniprogram-dev SKILL §my | my.js 阅读统计改为后端接口（loadDashboardStats），禁止用随机数时间/标题占位 |
| 2026-03-10 | 后端 | bug 修复 | api-dev SKILL | 聚合接口三处修复：recentChapters 去重、totalReadMinutes 最小1分钟、DB 错误返回 500 |
| 2026-03-10 | 团队 | 方法论 | - | 新旧版代码对比：以功能完整性为基准，批量 diff + 分类取舍，不以日期判优劣 |
| 2026-03-10 | 管理端 | 最佳实践 | admin-dev SKILL §toast | Toast 通知系统落地：utils/toast.ts 纯原生实现，全系统 18 文件 alert → toast 批量替换 |
| 2026-03-12 | 管理端 | bug 修复 | admin-dev SKILL §ts | ContentPage TypeScript 严格类型：可选字段 ?? 兜底、接口补字段、API 映射、setState 传参 |
| 2026-03-12 | 团队 | 架构/设计 | - | 密钥/token 设计：关联小程序 key、@ 人物 token；不暴露真实密钥、服务端兑换 |
| 2026-03-12 | 后端 | 最佳实践 | mysql-direct SKILL | persons token 字段；Model 新增字段后需执行 ALTER 迁移脚本 |
| 2026-03-12 | 管理端 | 设计落地 | - | 关联小程序存 key、@ 人物 id=token；链接标签与 PersonItem 约定 |
| 2026-03-12 | 小程序 | 设计落地 | - | contentParser mpKey/token；onLinkTagTap、onMentionTap 传 key/token 兑换 |
| 2026-03-10 | 后端 | bug 修复 | api-dev SKILL | chapters 表新增 hot_score 列，修复 1054 Unknown column 错误；DB 变更 SOP：ALTER→model→重启 |
| 2026-03-10 | 团队 | 方法论 | - | DB 变更 SOP + Toast 批量替换方法论（脚本替换后必须人工复查 toast.info 语义） |
| 2026-03-12 | 后端、团队 | 业务规则 | api-dev SKILL、team three-tier-arch | 9.9 买断统一由后端折叠为 hasFullBook/has_full_book，小程序和管理端只认该信号；可通过用户资料开关 OR 订单实现赠送全书 | | 2026-03-13 | 小程序、后端、团队 | 业务规则 | api-dev SKILL、miniprogram-dev SKILL、three-tier-arch SKILL | 文章详情预览统一由后端按 50% 截取，小程序按 accessState 使用预览/全文，外层 content 与 data.content 始终一致以避免泄露全文 |
已吸收经验（历史）
- SetVipModal：SKILL-管理端开发 4.1 表单弹窗
- vip_roles：SKILL-API开发 3.2、SKILL-MySQL直接操作 8
最后更新：2026-03-13（文章预览规则统一、小程序与后端对齐）