chore(backlog): 记录 g274 完成

2026-10-26 22:59:58 +08:00
parent b93e8b01a5
commit fa84a392fb
2 changed files with 10 additions and 0 deletions
@@ -2852,6 +2852,15 @@
      "status": "done",
      "domain": "new",
      "notes": "出场延迟与关闭立刻收是一对：只做延迟会出现「关得也慢」，遮罩在数据回来后又挂 120ms 更像卡住；所以延迟只作用于「显示」这一个方向，paint(false) 直接执行。内容降透明度到 0.5 而不是隐藏：留位才能让遮罩收起时不跳动。踩坑：ButtonProps.label 已收窄为 string（g240 遗留），demo 里想传函数型文案会直接类型报错，改成固定文案 + 状态切换"
+    },
+    {
+      "id": "g274",
+      "title": "补三条新组件的组合配方（骨架 / 刷新遮罩 / 审阅面板）",
+      "motivation": "配方文件停在配方 15，而那 15 条写的都是老组件（表单、弹窗、表格分页）。本轮新加的 layout / loading / jsonViewer / diffView / codeBlock / signaturePad 在配方里一个字都没有——Agent 拿到单组件参数表能知道「怎么调」，却不知道「怎么拼」，于是很可能把 layout 当卡片用、把 diffView 当全文展示用。配方是唯一能表达「职责边界」的载体。",
+      "acceptance": "recipes.md 新增配方 16（layout + breadcrumb + menu + card 后台页骨架）、17（loading 包住 dataTable 的刷新遮罩）、18（codeBlock + diffView + copyButton + tag 的变更审阅面板），编号自 15 连续递增、每条都有代码块与 3 条要点、代码块内至少含一个已注册组件 id；要点写清职责边界（骨架不塞交互、遮罩不换空数据、diff 不代替全文）；llms-full.txt 与文档站随 npm run docs 重生成；npm run check 全绿",
+      "status": "done",
+      "domain": "tooling",
+      "notes": "配方 16 里特意写了「不要再套一层 overflow:auto」——layout 内容区自己就是滚动容器且已在细条名单内，两层滚动会让吸顶页头与滚动条重复出现，这类「两个都对、拼起来错」的坑只能靠配方说明。配方 17 强调 finally 收遮罩：只写 try 分支的示例会诱导出「异常时遮罩永远挂着」的实现"
    }
  ]
 }