《月圆玩梗夜 · 中秋谐音梗闯关猜词》需求文档

题3 中秋玩梗猜词｜形态：移动 H5 ｜ slug=mooncake ｜定调见 concept.md

一、业务场景

中秋节 C 端互动传播 H5。背景：品牌/社群在中秋想要一个"发出去就有人玩、玩了想转发"的轻互动。目标用户：18-40 岁移动端用户，爱玩梗、爱晒朋友圈。核心价值：把中秋从"高冷灯谜"翻译成"全民玩梗猜词"——每题是一个中秋谐音梗/emoji 谜/网络梗，笑着闯关，通关晒"玩梗战绩卡"。

二、用户需求 / 角色

闯关玩家：想轻松有趣地玩、答对有爽感、答错有台阶下（表情包吐槽而非挫败）→ 关卡制 + 即时动效反馈 + 答错彩蛋。
好胜玩家：想拿三星通关、想省提示冲高分 → 星级评分 + 消耗积分偷看博弈 + 进阶三色 BOSS 关。
社交玩家：想晒成绩、想拉人来玩 → 玩梗战绩卡一键分享 + 称号体系。

三、业务流程（主链路，全链路闭环）

首页（主视觉 + 统计 + 月相关卡地图）→ 选关进入 答题页（题干 → 输入/四选一 → 即时正误动效｜可点提示气泡消耗积分偷看）→ 逐题作答 → 本关 星级结算（正确数/用时/得分/1-3 星 + 积分变动动画）→ 【下一关 ↺ 回答题页】或【回首页解锁下一关，月相 +1】→ 全 6 关通关 → 玩梗战绩卡（称号 + 汇总 + 分享）。

弹窗/反馈节点：规则弹窗、提示气泡、答对光效+撒花、答错月饼表情包彩蛋、三色翻牌反馈（进阶关）、星级揭晓、空状态。

四、功能模块（✅=核心可操作功能，硬指标 ≥3 项，本案 ≥8 项）

模块1 首页与关卡地图

✅ 月相进度关卡地图：6 关，随通关进度月亮由缺到圆；每关 已通关 / 当前可玩 / 未解锁 三态视觉区分 + 星级（0-3 星）
✅ 点击关卡进入答题（未解锁关有锁态提示 toast）
顶部统计卡：总积分 / 已通关数 / 总关数（6）
开始/继续按钮（定位到当前可玩关）
✅ 规则说明弹窗（玩法/计分/提示规则）

模块2 答题核心

✅ 题目展示：图片 / emoji / 文字题干（多题型）
✅ 作答方式：拼音/文字输入框（模糊匹配，声调容错）或四选一按钮（按题型切换）
✅ 即时正误反馈：答对放大 + 桂花光效 + 撒花（canvas-confetti）；答错抖动 + 月饼表情包彩蛋 + 吐槽文案，并显示正确答案 + 解析
每题单题计分 + 连续答对连击加成
关内进度指示（第 X/Y 题）

模块3 提示与辅助（消耗积分博弈）

✅ 提示气泡：点灯泡消耗积分弹玩梗式引导文案（"这题和你昨晚吃的月饼有关…"）
查看原图/放大提示（图片题）
跳过本题（消耗积分或计 0 分，可选）
积分不足时的空态引导（去答对赚积分）

模块4 计分与星级结算

✅ 关卡结算页：本关正确数 / 错误数 / 用时 / 得分
✅ 星级评分 1-3 星（按正确率 + 提示使用数评定），星级揭晓动效
累计积分变动动画（CountUp 数字滚动）
下一关 / 重玩本关 / 回首页

模块5 进阶关 · 汉兜三色猜字（signature，嫁接方向 A）

✅ 四字祝福逐字翻牌：绿=字对且位置对 / 橙=字对位置错 / 灰=不含
拼音速查表辅助（消除法）
有限次数猜测（如 6 次）

模块6 玩梗战绩卡与分享（signature，嫁接方向 C）

✅ 通关生成战绩卡：称号（按表现）+ 总星级 + 用时 + 提示次数
Canvas 合成战绩卡，可保存图片
分享入口（模拟分享 toast / 保存到相册）

模块7 数据持久化与空态

✅ localStorage 持久化：积分 / 已通关 / 每关星级 / 提示使用（刷新不丢）
空状态友好提示：无战绩、积分不足、未解锁关
重置游戏（清进度）入口

页面地图（对齐 app/pages.json）

id	标题	hash	跳往
home	首页 · 月相关卡地图	#/	quiz, share
quiz	答题页	#/quiz	result, home
result	关卡结算（星级）	#/result	quiz(下一关), home, share
share	玩梗战绩卡	#/share	home

截图态（shots）：home / quiz-image（看图题）/ quiz-correct（答对光效）/ quiz-wrong（表情包彩蛋）/ quiz-hanle（三色进阶）/ result（星级）/ share（战绩卡）。

五、数据字段（前端 mock，与 app/mock.js 一致）

实体	字段	说明	量级
关卡 level	id / seq / name / theme / desc / questionIds / unlockBy	6 关，各绑场景（月饼铺子/赏月现场/谐音梗擂台/emoji灯谜/网络热梗/团圆宴）	6
题目 question	id / levelId / type(image·emoji·choice·pinyin·hanle) / prompt / assetHint / answer / pinyin / options / analysis / memeHint / difficulty / score	多类别多难度	20+ 题
进度 progress	totalScore / clearedLevels[] / starMap{levelId:star} / hintUsed / combo	localStorage 持久化	1
战绩 record	title(称号) / totalStars / timeSec / hintCount / clearedAt	通关生成	——
表情包 meme	id / img / text(吐槽文案)	答错彩蛋池	6+

六、操作逻辑 / 边界

拼音模糊匹配：忽略声调、忽略空格、简繁/大小写归一；答案支持多个别名。
计分：单题基础分 + 连击加成（连对额外分）+ 星级门槛（3 星=全对且提示≤1）。
提示扣分：查看提示/原图消耗固定积分，积分不足禁用并空态引导。
三色判定（进阶关）：逐字比对答案，位置对→绿、字在但位错→橙、字不在→灰；超次数判负显示答案。
持久化：每次积分/星级/通关变动即写 localStorage；提供重置。
空态：未解锁关锁态 + toast；积分不足禁用提示；战绩为空引导先通关。

七、评分对齐表（按分作答）

评分维度（分值）	我的对应实现
视觉品质与中秋氛围（25）	国潮插画 + 朱红/桂金/月白 `festive` 主题 + 月相/花灯/月饼/玉兔/桂花素材 + 手写国潮标题字体（逃默认审美）
玩法流程完整性（25）	首页→关卡解锁→答题→星级结算→下一关/战绩卡全链路闭环（§三）
玩梗创意与趣味性（20）	真中秋谐音梗/网络梗题库 + 提示气泡玩梗文案 + 答错月饼表情包彩蛋 + 战绩卡称号（网感/传播）
交互与动效体验（20）	输入即时反馈 + 答对光效撒花/答错抖动彩蛋 + 关卡切换 + 汉兜三色翻牌（signature）
题目丰富度（10）	20+ 题，5 类题型（看图/emoji/谐音四选一/拼音输入/三色），6 关进阶难度
【加分】额外创新创意（+10）	消耗积分偷看博弈 + 汉兜三色进阶关 + 月相进度 + 玩梗战绩卡分享
【加分】完整后台可运行（+20）	评估性价比，视时间以 backend-addon 接入（题库/排行后台，非必做）