 suzmii
|
ea9668e4a9
|
资源总览「所有资源」卡补上资源预览
- 现象与归因：「所有资源」卡的预览区一直是空的，原因是我在 1cc9a2381 里加的闸 `!isResourceBookAllTarget(category)`（当时为避开"同一张资源卡挂两份"）让它一张卡片计划都不生成；预览卡从来只由画本场景注入，占位摞本身不含卡片
- 改为真正生成卡片计划：喂进去的仍是全量投影（与标题栏计数徽标同一份口径），但当成一摞交给栏目卡同一个选取函数 `selectResourceBookOverviewCards`——没有视图中心时按投影顺序取前 `RESOURCE_BOOK_OVERVIEW_STACK_LIMIT`(=3) 张，与栏目卡每摞上限同口径；不分类型列，避免 66 项一口气铺出十几列
- 预览用同一个 `renderCard` 与同一套 `resourceBookOverviewCardLayout` 几何渲染，唯一差别是宿主类名换成 `.game-resource-book-preview-card`：转场层按 `.game-resource-book-scene-card` 收集 FLIP 节点并以 `card:${resourceId}` 为键，同一张卡两个宿主会让两条记录互相顶掉，因此预览宿主不进收集范围（`resourceBookController` 一行未改）
- 预览宿主带 `aria-hidden` + `pointer-events: none`：无障碍树与 `getByRole` 里每张资源卡仍然只有栏目卡那一份，不会重复命中；点预览区仍走进「所有资源」页，栏目卡预览卡仍可选中
- 转场淡出集合（`resourceBookPlanKeysRef` 那段）跳过「所有资源」组，避免预览节点被当成"离开视图的卡片"按子画布坐标重新贴到画布别处
- `ResourceBookThumbnail`：该卡正文的占位摞从最多 3 摞改为对齐真实摞数的 1 摞，卡片高度回到与栏目卡同一条口径
- `styles.css`：把 `.game-resource-book-preview-card` 并进 `.game-resource-book-scene-card` 的两条既有规则（宿主几何、主态卡片圆角/阴影）与 `prefers-reduced-motion`；没有新写一套预览样式
- 断言（`project-development.suite.ts`）：预览卡的 `data-resource-card-id` 序列恰等于全量投影前 3 个、条数 == `min(3, 计数徽标)`、预览里是完整卡片（视觉体 + 选中按钮）、宿主在 `aria-hidden` 子树里、宿主几何规则与栏目卡共用同一条
- 断言（新增用例）：空项目下沿用既有空态「暂无资源」、预览节点 0 个、计数 `0 项`、入口行仍在，卡片不破版
- 单测（`resourceBookLayout.test.ts`）：把已被新行为取代的旧断言（`all` 组不出卡片、全计划无重复卡片键）删掉，换成新合同（预览 = 全量投影前 3 张、只铺一列、各栏目摞不变），并补空投影 → 0 张
- 变异验证（两条都跑过并已还原）：① 喂进去的资源改回空数组 → `AssertionError: expected +0 to be 4`；② 恢复旧闸（计数仍正确、预览为 0）→ `AssertionError: expected [] to deeply equal [ Array(3) ]`
|
2026-09-11 15:37:17 +08:00 |
|
|
suzmii
|
1cc9a23815
|
资源总览新增「所有资源」汇总卡与全部资源页
- 渲染层新增 `RESOURCE_BOOK_ALL_TARGET = 'all'` 特殊项：跨端契约 `ProjectResourceCanvasCategory` 不加 `'all'`，sidecar schema 不升版，落盘布局的 `section` 也不会出现它
- 资源总览第 0 张卡即「所有资源」：排在全部栏目卡之前，复用同一套缩略图类名/圆角/底色/阴影与栏目标题栏组件，不新增卡片样式
- 该卡的计数徽标取全量资源数，口径等于各栏目计数之和（同一份画布投影，不另算一套）
- 画本场景的栏目顺序与资源分组各多一个渲染层入口；`buildResourceBookScenePlan` 对特殊项只出计数与标题栏，不铺卡片，避免同一张资源卡在总览里挂载两份（`data-resource-card-id` 查询与 FLIP 的 `card:*` 键都会撞车）
- 新增「所有资源」页：栏目大纲 + 收起资源按钮 + 按栏目分组的滚动卡片网格；卡片复用栏目页同一颗渲染器与卡宽高，容器与网格样式补齐在 styles.css
- 该页的卡片显式关掉拖拽（卡片坐标不属于任何栏目画布，写回会污染布局 sidecar），保留选中/播放/菜单交互，并把光标与 `touch-action: pan-y` 交给滚动容器
- 栏目大纲抽成 `ResourceBookOutlineNav`，栏目页与全部资源页共用同一条入口带；渲染出的 DOM 与抽取前一致
- `renderResourceBookCard` 增加可选 `draggable` 参数，`ResourceCard` 的三个移动端指针回调改为可选
- 断言：总览存在「所有资源」卡且为第 0 张、计数等于全量资源数且等于各栏目计数之和、点它进入的页面按栏目分组且每组都挂真实资源卡、场景计划里特殊项不出卡片且整份计划无重复卡片键、全部资源页分组只保留非空栏目且保持总览顺序
- 既有「N 项」徽标断言从全文档文本查找收窄到 character 栏自己的标题栏（新增第 0 张卡后同文案会撞车，收窄而非放宽）
|
2026-09-11 11:21:03 +08:00 |
|
|
suzmii
|
2f8753f597
|
AGC 资源画布切换为 6 类资产分类加项目版本栏目（阶段二：投影轴与栏目表落地）
- 契约层把 ProjectResourceCanvasPosition.section 加宽为 PersistedProjectResourceCanvasSection 并删除旧 ProjectResourceCanvasSection 联合
- 七个分区类型消费点改用 ProjectResourceCanvasCategory：投影、布局模型、布局 Hook、分区高度、依赖图层与画布历史
- RESOURCE_CANVAS_SECTION_ORDER 改为 PROJECT_RESOURCE_CANVAS_SECTIONS，删除 RESOURCE_CANVAS_VISIBLE_SECTION_ORDER
- reconcileResourceCanvasLayout 接入读时归一化：旧栏目值按资源当前分区改写 section，坐标与手动标记原样保留
- 归并后的布局与原布局逐项不同，由既有协调路径判定 changed 并写回一次新分区，不引入迁移脚本
- 投影层五个资源入表点统一走 projectResourceCanvasCategory：项目版本独立成栏、Agent 回执归文档、其余按资产分类
- 新增 projectResourceDisplayKind 收敛 manifest 资产 subtype 即 kind 的显示类型口径，projectResourceTypeLabel 不再依赖旧栏目
- 卡片预览、编辑分流、媒体工具条、预览文案与画布历史快照改用显示类型与新分区，历史快照入栈时收窄到现行分区
- index.tsx 删除可见栏目导入与 visibleCategoryOrder，栏目标签由资源筛选唯一中文口径派生并补齐 7 栏
- index.tsx 补齐 7 栏默认视口与 7 个栏目图标（新增 LayoutGrid、Users、PackageOpen，移除已无用的 Code2）
- index.tsx 删除 canvasResources 的 code 过滤：只登记游戏代码的项目现在落在待归类栏目并正常显示卡片
- 新增只登记游戏代码项目的 UI 回归用例，覆盖栏目大纲、默认落地栏目与代码卡片渲染
- 测试夹具按新分区轴迁移，新增旧栏目 sidecar 读时归并用例与栏目顺序用例
- 共享测试 harness 的资源卡查询正则允许栏目标签自带空格（UI 交互）
- 同步 PRD 与共享记忆决策记录的栏目口径描述
|
2026-09-10 20:41:19 +08:00 |
|
|
suzmii
|
4fb0de2c94
|
C3 资源画本转场改为真实元素 FLIP
- resourceBookController 重写为真实元素 FLIP：begin 在提交前记录 First，play 测 Last 后给同一节点加反向 transform，sync 按布局签名做可中断重基
- 转场进行中重基用剩余时长（下限 80ms），空闲布局变化用完整 420ms，预览图尺寸晚到的二次布局变化不再瞬移
- 宿主节点几何基准改存 world 局部坐标，平移和缩放不会让上一次的干净矩形过期
- 不可见节点钉在 First 淡出、挂载节点淡入；搜索/排序导致的卸载保留一帧淡出；返回总览时源栏目未回到摞上的卡片按子画布布局淡出
- 新增 buildResourceBookScenePlan 渲染计划，渲染、转场签名与淡出集合共用同一份数据
- 删除 ResourceBookTransitionLayer 与克隆快照逻辑，清理 styles.css 的转场层和 data-book-motion 隐藏规则
- 重写 resourceBookController.test.ts，补 resourceBookLayout/resourceBookModel 用例与 appSurface 同节点断言
- 同步技术方案转场段与 pitfalls 经验条目
|
2026-09-09 20:24:10 +08:00 |
|
|
suzmii
|
2c5ad3903e
|
总览摞按当前视图就近选卡
总览原先按资源数组顺序取前 3 张，和进入子画布后视口内最近的卡片不是同一批，FLIP 找不到对应终点就退化成淡入淡出，返回总览时还会跳成另一张图
新增 selectResourceBookOverviewCards：按卡片中心到该栏目当前视口中心的距离选最近的卡片，仍受筛选可见性约束
每栏目视口中心换算到画布坐标后传入资源画本场景
补充 resourceBookLayout 用例覆盖无视图中心、就近排序与筛选过滤
|
2026-09-09 16:16:16 +08:00 |
|
|
suzmii
|
36747b3ece
|
修复资源总览摞堆叠旋转与卡片预览懒加载
- 总览每个资源类型最多铺 3 张卡片，其余数量由栏目标题栏的“N 项”表达
- 总览摞旋转角改为固定小角度，素材变多后不再随堆叠下标无限增大
- 总览摞下标小的卡片压在上层，不再被模糊卡遮住最上面那张清晰卡
- 截断前先按搜索可见性过滤，避免搜索结果落在深处时总览显示空摞
- 资源卡片可见性观察改用真正包含卡片的容器，恢复滚动时的预览懒加载
- 补充资源画本布局单测、预览观察根回归用例和总览摞上限用例
|
2026-09-08 20:23:33 +08:00 |
|