Genarrative/docs/technical/BIG_FISH_RUNTIME_RULE_ENTRY_2026-04-26.md

大鱼吃小鱼运行页规则入口说明 2026-04-26

背景

大鱼吃小鱼玩法规则已经在 PRD 与运行态技术方案中定义，但网站运行页没有给玩家查看规则的入口。玩家进入 /big-fish 或正式运行页后，只能看到当前等级、状态和事件日志，无法在游玩前快速理解吞噬、合成、胜负条件。

设计结论

1. 规则入口放在运行页顶部操作区，使用 CircleHelp 图标按钮。
2. 默认界面不直接铺规则长文案，点击按钮后打开独立模态窗口。
3. 模态窗口只保留玩家决策所需的核心规则：
   • 拖动方向控制移动。
   • 吃掉低级或同级野生实体并收编。
   • 碰到更高级野生实体时，己方实体会被吃掉。
   • 3 个同级己方实体自动合成更高一级。
   • 拥有最高等级后通关，己方实体归零后失败。
4. 入口必须在移动端单手可点，不遮挡舞台主体。
5. 规则内容只做说明，不参与任何前端裁决；真实规则仍以后端运行快照为准。

游玩统计规则

所有作品都需要对自身以及用户做游玩统计。

大鱼吃小鱼正式运行时必须遵守：

1. 正式开始游玩已发布作品时，更新作品自身播放统计。
2. 已登录用户写入 profile_played_world，world_key = big-fish:{session_id}。
3. profile_id 保存大鱼作品号/会话号，world_type = BIG_FISH。
4. world_title 使用玩法草稿标题，world_subtitle 优先使用副标题，其次使用核心乐趣。
5. owner_user_id 使用大鱼作品归属用户 ID。
6. 退出或结算上报 elapsedMs 后，后端按增量刷新 profile_dashboard_state.total_play_time_ms 和明细中的 last_observed_play_time_ms。

落地范围

1. src/components/big-fish-runtime/BigFishRuntimeShell.tsx
   • 增加规则按钮与规则模态窗口。
   • 复用 UnifiedModal，避免在当前玩法舞台内容流里展开说明。
2. src/components/big-fish-runtime/BigFishRuntimeShell.test.tsx
   • 覆盖规则入口打开与关闭。

验收口径

1. 进入大鱼吃小鱼运行页后，右上角可看到规则图标入口。
2. 点击规则入口后出现独立弹窗。
3. 弹窗能展示核心吞噬、合成、通关与失败规则。
4. 关闭弹窗后回到玩法舞台，不改变当前运行快照。