活动开发踩坑与防范指南
帮助你避免活动开发中的常见陷阱，提供上线前自查清单、测试标准和应急处理流程。
🤖 AI 执行指令
当用户调用此 skill 时，根据需求提供踩坑防范指导。
使用场景判断
- 上线前检查 → 提供完整的自查清单
- 排查问题 → 根据症状匹配已知踩坑场景
- 代码审查 → 检查高危代码模式
- 线上应急 → 提供止损流程和监控要点
风险分级速查
高优先级（资损/阻断/合规）
- 核心数值：奖励 ID/数量、商品 ID/价格、概率/保底值、道具时效
- 时间配置：活动整体时间、礼包售卖时间、独立玩法阶段时间
- 资金链路：充值到账、购买扣费、道具到账数量
- 核心功能：礼物功能（定时/价格/魅力值/成长值）、NPC 玩法、定时任务
- 线上风险：ROI 监控、测试数据清理、白屏问题
中低优先级（体验/展示）
- 活动规则说明、页面文案、展示错位
- 链接中出现
dev 字符、同名资源混淆、资源提前曝光
- 非核心接口异常导致的展示问题
礼物玩法踩坑
礼盒保底
| 检查项 |
说明 |
反例 |
| 保底对象 |
明确是送礼人还是收礼人保底（默认送礼人） |
东南亚 avatar 礼盒保底对象搞反 |
| 非独立保底 |
大保底清理小保底，小不清大 |
— |
| 独立保底 |
大小互不干扰，同时触发时优先大保底（小保底顺延） |
— |
| 概率冲突 |
概率中奖与保底同时触发 → 优先保底 |
— |
| 概率还原 |
上线前确认大奖概率已还原，无测试"必中"配置 |
— |
惊喜礼物
| 检查项 |
说明 |
反例 |
| 保底对象 |
默认送礼人。收礼人保底需检查动效勾选 |
日服失落的宝藏收送反转 |
| 特殊概率 |
连击/一次性送礼/轮次等特殊逻辑 |
越南服盲盒概率翻倍失效 |
收送礼关联
| 检查项 |
说明 |
反例 |
| 关联抽奖 |
确认触发阈值、奖励对象（送/收礼人） |
2022.8 会玩星空音乐节 |
| 奖励归属 |
主页特效给送礼人还是收礼人 |
法语服购物狂欢特效配错 |
| 概率总和 |
随机奖励概率之和必须 = 100% |
2025.10 恋语之森概率错误 |
NPC 玩法
- 必须覆盖语音房、私聊等所有送礼场景
- 验证礼物计数准确性和返还逻辑
礼包玩法踩坑
常规礼包三必核
- 价格一致：图片价格 = 实际扣费 = 配置表价格 = goods-point 价格
- 内容正确：道具 ID、数量、时效（永久 vs 限时）
- 时间窗口：开始/结束时间在活动期内，不可提前外显
连锁/组合礼包
- 已购前置礼包后，后续礼包外显/隐藏逻辑需检查
not_show 字段
配置类踩坑
道具与奖励
| 检查项 |
说明 |
反例 |
| 性别道具 |
男用户发男道具，女用户发女道具 |
会玩狼人礼包性别发错 |
| 永久道具替换 |
已拥有永久道具再获得时替换为碎片/体验卡/金币 |
会玩如梦令常驻抽奖返回空 |
| 数值变动 |
活动中途修改数值必须二次核对 |
2025.07 阿语服家族数值异常 |
版本与任务
| 检查项 |
说明 |
反例 |
| Version/Offset 重置 |
新一期活动必须重置 |
华语服支线活动 Offset 未重置 |
| 任务周期 |
每日刷新 vs 活动期间一次性 |
— |
搭建活动
- 链接检查：确保不包含
dev 字符（高优）
- 资源检查：同名礼包图、弹窗图是否混淆
手写代码高危场景
手写保底逻辑
必须加分布式锁（Redis Lock） ← 防并发
触发保底后必须清空计数 ← 防重复触发
概率 vs 保底冲突 → 优先保底
大 vs 小保底冲突 → 优先大保底
必须打印 TriggerGuarantee / ClearGuarantee 日志
反例：2025.12 全明星保底异常（触发后未清空计数）
组件修改与自定义
| 规则 |
原因 |
反例 |
修改配置前必须 DeepCopy |
禁止直接修改全局配置对象 |
2023.06 韩服鉴宝局 |
| 循环追加奖励检查 Slice 复用 |
可能导致数量指数级增长 |
— |
| 修改公共方法需全量回归 |
DoChipLottery/SendRewards 等影响面大 |
— |
定时任务与 Hook
| 检查项 |
说明 |
反例 |
| 白名单过滤 |
是否会误发给线上用户 |
土服年中盛典误发头像框 |
| 活动结束判断 |
任务执行时活动是否已结束 |
2025.06 韩服榜单提前结算 |
| Hook 拦截范围 |
确认正确的 TaskID/ZoneID |
韩服语音房 Hook 误伤日服 |
冒烟测试标准
| 模块 |
必测用例 |
优先级 |
| 主流程 |
充值→购买礼包→扣金币→获道具→进包/榜单增加 |
高 |
| 异常流程 |
余额不足购买；活动未开始/已结束时请求 |
高 |
| 白屏检查 |
首次加载、弱网下是否白屏 |
高 |
| 社交互动 |
A送礼给B→A扣包→B加魅力/收礼 |
高 |
| NPC玩法 |
给NPC送礼→计数增加→触发返还/特效 |
高 |
| 显示逻辑 |
Banner、弹窗、红点、价格展示 |
中 |
线上验证与监控
上线前
- 白名单账号在正式服完整流程验证
- 再次确认概率、价格配置已还原为正式版本
上线后（前 30 分钟）
- 日志监控：关注 panic 和 error 日志
- ROI 监控：关注产出/消耗比，大奖短时间大量产出需立即熔断
- 用户反馈：客服群、玩家群前 5 分钟反馈最快暴露问题
- 测试数据清理（高优）：清理榜单数据、跑马灯记录
应急止损流程
1. 止损第一 → 关闭活动入口/充值接口/下架商品（优先于查 Bug）
2. 切断流量 → 配置路由拦截或降级
3. 保留现场 → 不急着重启（除非内存泄漏），保留日志
4. 信息同步 → 告警群同步"已发现问题，正在处理"，避免重复排查
核心经验总结
配置类问题（最高频）
- 价格、概率、奖励 ID 是最容易出错的配置项
- 三方核对：策划文档 vs 配置后台 vs 代码常量，三者必须一致
- 中途改数值必须二次确认
代码类问题
- 并发场景必须加锁
- 全局配置对象只读，修改前 DeepCopy
- 公共方法修改需全量回归测试
流程类问题
- 新一期活动必须重置 Version/Offset
- 定时任务注意活动状态和区域过滤
- Hook 注册注意作用域，避免误伤其他服务
上线类问题
- 测试配置（必中概率等）必须还原
- 上线后 30 分钟持续监控
- 测试数据必须清理
典型使用场景
场景 1：上线前自查
/activity-troubleshooting 活动要上线了，帮我做个检查清单
我会根据活动类型提供针对性的自查清单。
场景 2：排查问题
/activity-troubleshooting 保底逻辑好像不对，用户多触发了一次
我会根据症状匹配已知踩坑场景，提供排查方向。
场景 3：应急处理
/activity-troubleshooting 线上出问题了，怎么处理？
我会提供止损流程和优先级建议。