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,49 +0,0 @@
# 方洞挑战拖拽玩法重构 2026-05-05
## 1. 目标
把方洞挑战从“按洞口按钮点选”改成“拖拽形状到目标洞口”的玩法,同时把洞口选项与形状选项的编辑关系改成稳定 ID + 名称联动。
## 2. 编辑态规则
1. 洞口选项不再暴露 `square / circle / triangle` 之类的下拉框。
2. 每个洞口选项只保留稳定 `holeId`、可编辑名称 `label`,以及可选图片字段。
3. 洞口名称改动后,所有引用该洞口的形状选项下拉框必须同步显示新名称。
4. 形状选项不再直接绑定洞口“形状类型”,而是绑定一个目标洞口 `targetHoleId`
5. 形状选项下拉框展示的是洞口名称,底层值是 `targetHoleId`
6. 形状选项仍保留自己的视觉配置字段,如 `shapeKind``imagePrompt``imageSrc`
7. 去掉加分选项,所有洞口选项一律平权。
## 3. 运行态规则
1. 运行态上半区展示全部洞口,布局成一块平面。
2. 下半区展示当前轮次的形状选项。
3. 每轮随机选择一个形状选项作为当前轮显示项,并以它绑定的 `targetHoleId` 作为目标洞口。
4. 箭头动画只负责给出随机引导洞口,不绑定正确答案;多洞口时优先避开当前正确洞口,避免直接剧透。
5. 用户把当前形状拖到任意洞口上松开后,前端把该洞口的 `holeId` 提交给后端。
6. 后端以 `holeId === currentShape.targetHoleId` 作为唯一判定标准。
7. 命中后进入下一轮;未命中时后端返回错误反馈、清空连击并保留当前运行态。
8. 计分不再包含任何加分洞口分支。
9. 游戏模式下洞口和当前选项只展示图片卡片,不再按 `shapeKind` / `holeKind` 裁剪成圆形、三角形、星形等几何形状。
## 4. 图片槽位
1. 封面图、背景图、形状图、洞口图都使用独立图片槽位。
2. 洞口图对应新的历史素材类型 `square_hole_hole_image`
3. 图片槽位查看面板内保留历史图片、上传入口和 AI 生成入口。
## 5. 后端契约要求
1. 共享契约里补充形状到洞口的目标引用字段。
2. 共享契约里补充洞口图片字段。
3. 运行态快照里必须包含当前形状对应的目标洞口信息,便于前端画箭头。
4. 作品和草稿返回的洞口数据必须和运行态保持同一组 ID 与名称。
## 6. 验收标准
1. 编辑洞口名称后,形状下拉框立即显示新名称。
2. 洞口编辑不再出现 `square / circle / triangle` 下拉框。
3. 运行态不再是按钮点选洞口,而是拖拽命中。
4. 每轮都能看到箭头或高亮引导洞口,但该引导不等同于正确答案。
5. 计分中不再出现 `bonus` 相关加分。
6. 游戏模式中洞口、当前选项和拖拽影子不再显示几何形状,只显示对应图片或中性图片占位。