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-05-02
## 背景
玩家从公开拼图作品进入运行态后,左上角返回会直接离开玩法。若玩家因为体验不佳准备退出,需要在首次退出时给出改造入口,让玩家可以把当前作品复制为自己的草稿继续调整。
本轮只改拼图运行时前端交互与既有改造链路,不新增后端表,不改变拼图存档投影规则,不接入旧 `server-node`
## 交互规则
1. 触发点只限拼图运行态左上角返回按钮。
2. 对同一浏览器里的同一拼图 `profileId`,首次点击返回时不直接退出,而是弹出独立面板。
3. 面板标题固定为两行:
- `体验不佳?`
- `试试改造功能!`
4. 面板主按钮为 `作品改造`,点击后复用公开详情页已有的拼图改造链路:
- 使用当前运行关卡的 `currentLevel.profileId` 调用 `remixPuzzleGalleryWork(profileId)`,避免下一关或相似作品运行态误用旧详情页作品。
- 成功后写入 `puzzleFlow.session`
- 进入 `puzzle-result`,即游戏作品改造页。
5. 面板次按钮为 `保存并退出`,点击后关闭面板并执行原返回逻辑。
6. 非首次点击返回不再弹出面板,直接执行原返回逻辑。
## UI 布局
1. 面板保持居中独立弹层,移动端宽度不超过屏幕安全边距,桌面端保持紧凑。
2. 面板只展示标题与两个行动按钮,不增加说明性文案。
3. 标题使用两行居中排版,顶部可以放无文字图标强化游戏感。
4. `作品改造` 为主按钮,视觉权重高于 `保存并退出`
5. 两个按钮纵向排列,固定触控高度,确保移动端易点击。
## 首次状态
首次曝光是浏览器侧 UI 引导状态,不是业务真相态:
1.`currentLevel.profileId` 作为作品粒度。
2. 使用 `localStorage` 记录已展示状态。
3. `localStorage` 不可用时,使用当前组件生命周期内的内存集合兜底,避免同一挂载周期重复弹出。
4. 点击 `作品改造``保存并退出` 都视为已经完成本次引导曝光。
## 验收
1. 首次点击拼图运行态左上角返回,出现标题为 `体验不佳?试试改造功能!` 的独立面板。
2. 点击 `作品改造` 后进入拼图结果页改造草稿。
3. 点击 `保存并退出` 后返回原目标页面。
4. 同一作品再次点击左上角返回,不再出现面板。
5. 不影响设置面板里的返回按钮、失败续时、通关结算和下一关入口。