suzmii 31fcbb79dc pitfalls：记一条「只跑门禁子集 → 同一天两次 CI 红」 ...

- 现象：dd7cf401a 给 lint-staged 加 *.rs 键，但本地从未跑过 check:git-hooks（它是 npm run lint 链里的一环），而 scripts/git-hooks.test.mjs 用 assert.deepEqual 钉住 lint-staged 的整份配置形状 → CI 以 deepStrictEqual 失败；本批更早还因 check:rustfmt 红过一次（15660a98b 修 8 处格式偏差），成因是 pre-commit 的 lint-staged 当时只覆盖 *.{js,mjs,cjs,ts,tsx}，Rust 格式本地无守卫
- 原因：npm run lint 是一条 && 长链（encoding / npm-workspaces / git-hooks / rustfmt / spacetime-schema / production-ops / preview-deployer / maintenance-page / eslint / typecheck），中间任一步失败则其后步骤根本不执行，「跑到第 N 步就以为本地绿了」；更隐蔽的是本地若因环境原因在中间断掉（如 Windows 上 check:git-hooks 第 2 个用例的 EBUSY），后面那些本来能通过的步骤也从未被验证
- 处理：push 前按完整链路跑；&& 链在某一步失败时，必须把失败步之后的每一步单独再跑一遍（10 步 + git diff --check）并逐条记 exit code（取 exit code 不要接管道）；改动碰到 package.json / .husky/ / scripts/ 下的门禁资产时，check:git-hooks 是必跑项
- 验证：本次 check:git-hooks 因本机 Windows EBUSY 中断后，补跑其后各步全部 exit 0（spacetime-schema / production-ops / preview-deployer / maintenance-page / lint:eslint / typecheck / encoding），只有 check:rustfmt 红且红在别人在途的 .rs（assets.rs:519 落在其未提交 hunk +470,62、commands.rs:3079 落在其未提交 hunk +3068,58）；变异验证：把 *.rs 从 package.json 摘掉 → 第 1 个用例以同样的 deepStrictEqual operator 变红，还原（SHA256 一致）后回 ok
- 纯文档追加：文件末尾 +8 行、无删改；本条只提交 docs/project-memory/shared-memory/pitfalls.md 一个路径

2026-09-12 01:28:05 +08:00

..

decision-log.md

decision-log：把守卫范围与本地限制两条裁定写进既有条目

2026-09-12 01:15:11 +08:00

development-workflow.md

修复原生应用CI测试与持久化图片生成恢复

2026-09-09 03:17:03 +00:00

document-map.md

Revert "文档同步：资源管理页改为栏目分页纵向滚动网格"

2026-09-11 11:07:59 +08:00

handoff-template.md

统一 Rust 与 TypeScript 格式化门禁

2026-09-01 16:28:34 +08:00

pitfalls.md

pitfalls：记一条「只跑门禁子集 → 同一天两次 CI 红」

2026-09-12 01:28:05 +08:00

project-overview.md

AGC产物迁移npm与Phaser4

2026-09-08 15:11:36 +08:00

team-conventions.md

补齐共享 UI 组件库与展示页交互 (#202)

2026-08-31 14:10:44 +08:00