daoqi/youle_framework
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
17 Commits 1 Branch 0 Tags
1d9bc049f190be3009362547904b3892ff533ec7
Commit Graph
17 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
joywayerandClaude Opus 4.8 1d9bc049f1 硬约束：机械红线校验（PreToolUse 阻断 + git pre-commit）+ PostCompact 重注入 
把可机器判定的硬红线从"投喂"升级为"硬拦截"，并补上事后/工具无关/压缩三个缺口：

- .claude/hooks/check-redlines.js：校验「可编辑范围」(路径级，禁改平台/
  vendor/00_Surface/02_Input/server 平台，app.js 例外) 与「严格 ES5」(运行时
  .js 禁箭头/模板串/class/let/const，去注释与字符串后高信号匹配)。双模式：
  PreToolUse 读工具入参、命中即 deny 阻止写入；--staged 扫暂存文件、命中即
  非零退出阻断提交。
- settings.json：PreToolUse 增挂 check-redlines(在 remind 之前)；新增
  PostCompact 钩子清空 .spec-injected，使压缩后下次编辑重新全量注入规范。
- .githooks/pre-commit + core.hooksPath=.githooks：提交边界硬闸，工具无关
  （Claude Code/别的编辑器/人手改都过）。
- 已校准：81 个现有运行时 js 零 ES5 误报（可编辑的 framework 25 文件全过），
  平台文件正确判为禁改；真违规(箭头/模板/const/class/改 vendor/改 class)全拦、
  合法 ES5 与注释里的 => 全放行；pre-commit 实测拦住 ES5 违规提交。

判断类规范(职责单一/数据权威设计/房间隔离)机器判不了，不在本层，仍靠投喂
+（可选）改后复审 agent。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-06 09:25:59 +08:00
joywayerandClaude Opus 4.8 d2ea3218b4 CLAUDE.md：删与 @import README 重复的架构速览与编号主题表 
三份 README 已 @import 常驻上下文，其「一页纸模型 / 阅读顺序表」比
CLAUDE.md 的复述更全，故删冗余、只留指路：

- 删「架构速览」骨架四条（协议/单向依赖/三层路由/接入两模式）——
  内容在 README 一页纸与编号正文（如接入两模式在 client 06 正文+红线表）
- 删「编号↔主题」对照表——README 阅读顺序/导航表已列
- 可编辑范围表保留（最高价值 always-on 操作护栏），升为独立小节并加指路
- 仓库简介 / 常用命令 / 强制声明+@import / Git 自动提交许可等 CLAUDE 专属内容全留

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-06 09:02:30 +08:00
joywayerandClaude Opus 4.8 f2f618b965 降耗②·铺开：按试点尺度精简其余 12 篇编号正文 
沿用 client 02 的保守尺度（规范条款/表格/关键代码/标题/链接全保留，
只压缩冗长代码示例、重复解说、演进历史、✅/❌ 成对代码块）逐篇精简
client 01/03/04/05/06、server 01/02/03/04、engineering 01/02/03。

- 12 篇合计 78,171 → 74,726 字符（省 3,445，~4.4%）；红线密集篇（client
  05、server 04）极保守、几乎不动，符合"不丢规范优先于省字数"。
- 已核验：51 个跨文档链接目标全部存在、3 个锚点全部命中真实标题；
  server 03 §6、server 04 §8/§10/§11 等被引用小节标题逐字未改；README 未动。
- 每篇均随附规范保留清单逐条自查（并行子代理完成、逐份复核）。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-06 08:52:16 +08:00
joywayerandClaude Opus 4.8 7b43d3ee44 降耗②·试点：精简 client 02（规范零丢失，−15%） 
保守精简：31 条规范、三张参考表(API/ID范围/生命周期)、set-refresh
核心范式全部保留；只压缩冗长代码示例、把 ✅/❌ 代码块转文字、删两处
演进历史/范例背景注。10,631 → 8,967 字符（−1,664，~15%）。

作为其余 12 篇编号正文精简的尺度基准。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-06 08:44:59 +08:00
joywayerandClaude Opus 4.8 57b950cf31 降耗①：按区注入排除 README，去掉与 @import 的重复 
README（红线速查/一页纸总则）已由 CLAUDE.md 用 @import 常驻每次会话，
按区注入里再读一遍是纯重复。readDirDocs 过滤掉 README.md，只注编号正文。

- server 首注 54,339 → 49,416 字符（省 ~4.9K）
- client 首注（含 client+engineering 两个 README）省 ~5.5K
- 注入文案标注「README 已随 CLAUDE.md 常驻，此处为编号正文」
- 零规范损失（内容未删，只是不重复注入）；pipe-test 确认无 README 段、
  正文与跨区去重逻辑不变

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-06 08:35:15 +08:00
joywayerandClaude Opus 4.8 ec58d0e584 强制遵守升级：编辑区域时按会话注入完整规范全文（非仅红线） 
从"红线常驻"升级为"全部规范时刻在场"：真正开工某区域时，把该区域的
完整编号文档 + engineering 通则全文自动注入上下文，新会话同样触发。

- remind-docs.js：PreToolUse 时按路径判定区域（server / client），
  每会话「首次」编辑相关区域即全量注入对应 docs 目录所有 .md 全文；
  同会话再改同区域只给简短「已注入、继续遵守」提醒；跨区域共享的
  engineering 通则每会话只注一次。会话级去重用 .spec-injected 哨兵。
- settings.json：新增 SessionStart 钩子，每个新会话清空哨兵目录，
  保证新会话必然重新全量注入。
- .gitignore：忽略 .claude/.spec-injected/（会话级临时状态）。
- 已 pipe-test：首注 55K/44K 字符全文、二次简短、跨区去重、docs 免打扰、
  SessionStart 清空、settings 结构校验，全部通过。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-06 08:03:50 +08:00
joywayerandClaude Opus 4.8 a931143c1e 强制遵守三套开发文档：README @import + PreToolUse 提醒 hook 
把"必须严格遵守 docs 三套文档"从软指令变成硬机制，同时消除 SSOT 重复：

- CLAUDE.md 用 @import 把三份 README（含各自红线速查/一页纸总则）
  常驻每次会话上下文，删掉手写的红线摘要——红线以 README 权威源为准，
  不再在 CLAUDE.md 另抄一份
- 新增 .claude/hooks/remind-docs.js：PreToolUse 钩子，编辑 client/**、
  server/** 前按路径把"必须遵守的对应编号文档 + 红线"注入上下文（非阻塞）
- 新增 .claude/settings.json 注册该 hook（matcher Edit|Write|MultiEdit）；
  已 pipe-test 各路径分支 + sentinel 验证 hook 实际触发

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-06 07:57:25 +08:00
joywayerandClaude Opus 4.8 dfac1c637b CLAUDE.md：瘦身为入口+红线缓存，规范细节交还三套 README 
按 SSOT 原则消除重复：CLAUDE.md 不再复述 docs 的规范，只承担
always-loaded 入口与极简红线缓存，详细说明的权威回归各 README。

- 删除架构分层详解（两棵目录树）、硬性规则逐条、测试纪律 7 条整段、
  Git 4 条整段
- 保留并压缩：仓库简介、构建命令、可编辑范围表、导航 + 编号↔主题表
- 新增「红线摘要」一段（6 条，每条标注权威见哪份 README）
- 测试/Git 收敛为指路 + 仅保留 README 里没有的 CLAUDE 专属操作许可
  （如"允许自动提交"）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 23:37:30 +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 9fea8f5227 文档：移除对仓库外 docs/important 规范的悬空引用 
docs/important/ 不在本仓库（属外部/私有平台规范），相关链接均为死链。
删除 client/02、client/03、server/README 三处引用，改写为「以平台的
资源管理接口规范为准」等不带路径的通用表述，保留规范性含义、消除断链。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 23:21:33 +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
joywayer 7e83dc27c9 优化聊天气泡 2026-07-01 23:17:57 +08:00
joywayerandClaude Opus 5 911cc9cc23 CLAUDE.md：补充测试纪律说明 
明确测试代码可不守 ES5、正式代码禁止为测试服务、禁止为通过率降标准、
测试失败先裁根因、用例需覆盖正反面与边界。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-07-01 18:34:43 +08:00
joywayerandClaude Opus 5 7c24f9732d CLAUDE.md：补充 Git 提交纪律说明，允许及时自动提交 
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-07-01 18:29:22 +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