Prune stale docs and update .hermes content

Delete a large set of outdated documentation (many files under docs/ and .hermes/plans/, including audits, design, prd, technical, planning, assets, and todos). Update and consolidate .hermes content: refresh shared-memory pages (decision-log, development-workflow, document-map, pitfalls, project-overview, team-conventions) and several skills/references under .hermes/skills. Also modify AGENTS.md, README.md, UI_CODING_STANDARD.md, docs/README.md and .encoding-check-ignore. Purpose: clean up stale planning/audit material and keep current hermes documentation and related top-level docs in sync.
This commit is contained in:
2026-05-15 06:24:07 +08:00
parent 2eded08bc7
commit 3cb3efb4d0
708 changed files with 4033 additions and 142328 deletions

View File

@@ -1,46 +0,0 @@
# 大鱼吃小鱼运行页规则入口说明 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. 关闭弹窗后回到玩法舞台,不改变当前运行快照。