daoqi/youle_framework
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
23 Commits 1 Branch 0 Tags
master
Commit Graph
9 Commits
Author SHA1 Message Date
joywayer 2ce936e7ec 删除hook，框架改动 2026-08-19 08:14:48 +08:00
joywayerandClaude Opus 4.8 96971f3072 文档红线细化：新增服务端请求合法性验证(§8)+悲观UI/输入-渲染解耦，收紧 shared 与常量准入门槛 
- 服务端 04：新增「操作请求合法性验证（不可信客户端）」章节——五层验证栈
  (座位鉴权/阶段门/操作可用性/幂等去重/参数校验)、统一裁决网关默认拒绝、
  availableActions 兼任决策依据与准入白名单、出牌回合门防死代码；后续章节顺延重编号
- 前端 04/05：悲观 UI——点击只发请求包、对局状态表现收包后更新，收包处理器触发源无关，
  AI 托管/他人广播共用同一更新路径；响应/掷骰交互按钮隐藏为受控乐观清除例外
- shared 准入门槛（前后端 04/05 §9/§8）：进 shared 的门槛是「前后端都真正用到且必须
  逐字一致」而非「它是玩法逻辑」；前端只展示+悲观UI ⇒ 计算类逻辑不进 shared，默认留服务端
- 硬编码常量准则（服务端 04 §10）：魔法字符串默认常量化(单一来源)；常量放 shared 亦按
  同一准入门槛判定，仅前后端都用到才进 shared/constants

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-11 04:12:27 +08:00
joywayerandClaude Opus 4.8 46f65de7ed 前端规范新增两条：常量化 id（含群组/Spine）+ 显隐走 showXxx/hideXxx 
- 强化「常量集中、禁硬编码」（05 §4 / README 红线速查 / 05 §11 审查表）：
  明确 UI 代码禁止任何硬编码 id/裸值，覆盖精灵/群组/图层/图片/声音/Spine
  等全部 id 与资源，一律用对应常量；补 Spine→Spine 动作配置映射。
- 新增「显隐走 showXxx/hideXxx 接口」（02 §3 范式第4条 / 05 §9 红线 /
  README 红线速查 / 05 §11 审查表）：UI 组件及零件的精灵/群组显隐必须由组件
  暴露的 showXxx/hideXxx 控制，禁止别处直接用其精灵/群组 id 去 show/hide，
  否则绕过组件、状态分散、重连刷新不一致（与 UI 组件专职一脉相承）。
- 显隐条同进 README 红线速查（@import 常驻层）；未改任何小节标题，
  链接/锚点审计通过。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-07 12:21:11 +08:00
joywayerandClaude Opus 4.8 b59a6f9ca5 前端规范新增两条：重连即重画（两场景）+ UI 组件专职 
- 重连处理规范（04 §3.3 详解 / 05 §6 红线 / README 红线速查 / 05 §11 审查表）：
  前端必须同时处理「断线重连」与「硬刷新·页面重载」两种恢复场景；本质是
  恢复数据 → 逐个调各 UI 组件 setXxx/refreshXxx 恢复数据与界面状态，复用
  同一条重画路径，绝不为重连单写一套渲染。
- UI 组件专职（05 §9 红线 / README 红线速查 / 05 §11 审查表）：每个界面的
  数据与渲染只由其对应 UI 组件实现；别的模块要改/刷该界面一律调组件公开
  接口，禁止在别处重复实现重叠或类似的界面逻辑（否则多份状态源，重连/刷新
  必然不一致）。
- 两条同时进 client README 红线速查（@import 常驻层），使其每次会话在上下文。
- 未改任何小节标题；链接/锚点审计通过。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-06 21:52:39 +08:00
joywayerandClaude Opus 4.8 6b00b80741 文档：跨目录链接的显示文字改为位置无关写法 
链接目标本就是相对路径，但显示文字硬写了 docs/xxx/development-guide
这类绝对式路径名——目录一旦整体移动，文字即过时（链接仍可跳）。
将 10 处显示文字统一改为「篇号 + 篇名」等只依赖文档自身、不依赖
所在路径的写法（如 docs/server/development-guide/03 §6 →
03 §6「端到端收发全链路」），engineering README 自称路径同样收敛为
泛指的 engineering/。至此保持三套目录相对位置不变即无需改任何链接。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 23:25:43 +08:00
joywayerandClaude Opus 4.8 182bb03d05 文档：补全 CLAUDE.md 文档索引并清理失效引用 
- CLAUDE.md：编号 01→05/04 修正为 01→06/04，补三套文档优先级
  （硬红线以 dev-guide 为准）与「编号↔主题」对照表
- client README 阅读顺序表补上遗漏的 06 子游戏接入模式与Hooks外置
- 修正 README 及正文交叉链接的旧路径（server/docs、client/docs、
  docs/engineering → docs/{server,client,games/engineering}，
  相对层级 ../../../ → ../../），共 7 处
- engineering 文档移除对已删除路径（docs/architecture、
  .github/copilot/skills）的引用，改为通用表述

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 23:15:39 +08:00
joywayer ae43bd528f 优化开发守则文档 2026-07-05 22:29:20 +08:00
joywayer 2e59742bc9 优化聊天气泡文档 2026-07-01 23:27:46 +08:00
joywayerandClaude Opus 5 594820d393 初始化仓库：友乐/gameabc 房卡游戏平台脚手架（client + server + docs） 
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-07-01 18:13:26 +08:00