AGC 画布：锚点让位标题栏、生成浮层贴边、拖动误触点击、读秒 100ms 与图集参考口径 #448

Merged

suzmii merged 4 commits from fix/agc-canvas-bugfix into master 2026-09-21 13:04:12 +08:00

Conversation 0 Commits 4 Files Changed 20

+1264 -114

4 Commits

Author	SHA1	Message	Date
suzmii	562e1ba586	「生成任务」侧栏读秒改为 100ms 粒度：与对话侧共用同一份时钟 ... - ResourceCanvasAssetGenerationTasksPanelView：删掉面板自带的 1000ms interval 与 nowMillis 状态；两条任务行的「已耗时」下沉为叶子组件（AssetGenerationElapsedLabel / ResourceEditElapsedLabel），各自订阅共享 hook useLiveNow（LIVE_TIMER_TICK_MS = 100）。 - 为什么不是面板级时钟：面板上通常同时挂着多条任务，100ms 的 tick 落在面板上等于每 0.1 秒重建整个侧栏；useLiveNow 的注释明确要求调用方是叶子节点。终态行不订阅，已耗时定格在账本给的结束时间上。 - 行为：不足一分钟的耗时本来就显示到 0.1 秒（formatElapsedDuration），现在每 100ms 真的更新一次，不再是「带小数却 1 秒跳一格」。 - 用例：新增「读秒按 100ms 刷新（0.0 → 0.1 → 0.5 秒）」「终态行不再走表，定格在结束时间」「秒表只订在运行中的那一行上（setInterval 只被调用一次）」；把 LIVE_TIMER_TICK_MS 临时改回 1000 时第一条用例即红，粒度确实被钉住。	2026-09-21 12:48:21 +08:00
suzmii	b4ce6877c8	修掉「拖动占位卡仍触发点击」的真因：点击抑制的计时起点必须在松手那一刻 ... - useResourceCanvasGenerationPlaceholders：抑制状态在越过拖动阈值时只登记、不起计时器，改到 pointerup 才起 0ms 计时（deferDragClickSuppressionCleanup）；pointercancel 与切项目走 clearDragClickSuppression 立刻收干净。 - 原实现（越过阈值时就起 0ms 计时器）在真实鼠标下不成立：一次拖动里 pointermove 横跨多轮宏任务，计时器早在松手前就把抑制清掉，收尾那次 click 照样生效——jsdom 同步发 move/up 看不见这一档，所以上一版用例是假绿。 - 用例补上真实时序：拖动过程中显式让时钟走一轮宏任务再松手；宿主用例还补上浏览器在 pointerup 之后补发的 lostpointercapture，并断言它不能把这次拖动的抑制一起清掉。 - 敏感性已双向验证：把计时器搬回「越过阈值那一刻」、以及让 lostpointercapture 清抑制，两条用例都会红；改用例前的同步版本对两种错法都会绿（所以上一版没抓住）。 - 注释写明计时起点为什么是松手那一刻，并与资源卡链路的 deferSkippedResourceCardClickCleanup 对齐口径。	2026-09-21 12:34:47 +08:00
suzmii	7b57cba14d	补齐「图集（生成图标素材）为什么没有 @」的当面说明与依据 ... - 生成浮层：不给 @ 选择器的入口新增一段说明行（`data-resource-canvas-generation-reference-free`），讲清「该入口走平台图集通道，参考只有一张权威规范图（图标规范），不支持另挑参考图」——验收现场那条「生成图标素材没法 @」读起来像漏了按钮，原因其实在通道上。 - 样式：说明行允许折行、沿用次要文字色；与既有的「参考图 n/5」计数行区分开。 - 用例：图集入口断言说明行在场；逐条入口断言「说明行」与「@ 选择器」严格互补；原「不呈现参考选择」的判据从按词匹配改成按计数元素/计数值匹配（说明行本身会提到「参考图」三个字）。 - 文档：入口矩阵补「图集为什么没有 @」一条，写明图集走 `icon-spritesheets` 通道、提交体只有 referenceId + iconDescriptions（无 referenceImageSrcs）、结果绑定硬校验参考恰好一张，以及「平台 OpenAPI 该请求 schema 有 referenceImageSrcs 字段，放开属于产品 + 平台口径变更」。	2026-09-21 12:23:32 +08:00
suzmii	beebcca4de	修复 AGC 画布四项验收问题：锚点让位标题栏、浮层不再撞画布边缘、拖动不再触发点击、图标规范参考口径对齐 ... - 生成任务锚点新增「资源总览」档：资源总览页仍贴画布顶边内缩 0.85rem，资源栏目画布页让开顶部钉住的整宽栏目标题栏（42px + 0.5rem），两档切换走 margin-top 过渡（减动效下关掉）。 - 生成浮层的顶边与可用高度改为按占位卡的真实屏幕位置算（卡下沿到安全底边），不再假设卡片贴在安全带上沿——占位落到下半屏时浮层底边不再越过画布下沿被切掉。 - 生成浮层新增水平收口：按「浮层左右各留 12px」把锚点收进画布可视范围，卡片靠边时浮层不再有一半落到画布之外；宽度口径与面板 CSS 同源（min(560px, 100% - 24px)）。 - 新增画布卡片手势的共享判据 resourceCanvasGestureExceededDragThreshold（阈值仍取 RESOURCE_CANVAS_DRAG_THRESHOLD）：资源卡与生成占位卡共用同一份「拖动还是点击」判断。 - 生成占位卡修掉拖动收尾误触点击：越过阈值才算拖动、登记一次性点击抑制（consumeDragClick）由宿主消费，「拖动中」样式也从越过阈值那一刻起才亮。 - 生成占位卡的删除按钮起手手势不再被当成「点卡片」：按起手点判定，松手落回卡片时不触发开合生成浮层。 - 图标规范面板的参考选择注释按现行判据改写（只有图集 icon-spritesheet 不接受用户参考），入口矩阵文档同步补「参考图（@ 引用）」口径并修掉「本地 IPC 没有参考图入参」的旧说法。 - 补齐回归用例：手势模型判据、占位卡拖动/点击与阈值、宿主级「拖完不弹浮层且普通点击仍开合」、浮层顶边与水平收口、锚点分档与跨文件标题栏高度守卫、逐条生成入口的 @ 与判据一致、图标规范面板的 @ 与提交带引用。 - 共享记忆 pitfalls.md 记录两条排障口径：卡类手势必须只有一份阈值与点击抑制判据；画布浮层几何只能按真实屏幕位置算、分页锚点必须让开钉死的标题栏。	2026-09-21 11:58:13 +08:00