优化 Game Agent 资源画布展示与默认缩放 #208

Merged
kdletters merged 5 commits from agc-resource-canvas-types into master 2026-08-31 14:36:58 +08:00
Member

变更内容

1. 普通资源画布隐藏游戏代码

  • 资源画布的大纲、分页和卡片展示不再显示“游戏代码”栏目。
  • 保留内部完整的五栏目布局契约,避免已有代码资源坐标被重写。
  • 补充回归测试,确认游戏代码不会出现在普通资源画布中,且代码端点不可见时不会渲染对应依赖边。

2. 增加资源类型角标

  • 资源卡右上角增加类型角标,用于快速识别资源类型。
  • 类型从既有资源投影字段推导,覆盖图片、SVG、视频、音频、文档、任务产物、Agent 回执、项目版本等类型,并为未知类型兜底。
  • 该能力仅用于前端展示,不新增后端字段或修改资源投影契约。

3. 限制默认自动适配缩放

  • 画布首次自动适配和显式复位时的默认最大缩放统一限制为 1.5,避免内容较少或只有一个资源时卡片被放得过大。
  • 该限制对设计文档、美术、音频、游戏代码、项目版本全部资源栏目生效。
  • 用户主动缩放仍沿用现有上限,不受默认适配上限影响。
  • 用户调整后的画布缩放会按排序模式和栏目保留;切换到其他栏目再返回后,仍恢复用户调整后的 viewport,而不是重新自动放大。

兼容性

  • 不修改后端 API、SpacetimeDB schema 或 /api/external/v1
  • 资源类型角标是展示层推导逻辑,不改变资源数据结构。
  • 内部布局仍保留游戏代码栏目契约,已有布局数据不需要迁移。

验证

  • resourceCanvasLayoutModel.test.ts
  • project-development.suite.ts 相关 App Surface 用例
  • npm run typecheck
  • npm run check:encoding
  • Prettier 相关文件检查
  • git diff --check

历史分支检查不替代最新 head CI;PR 更新后将以最新 CI 结果为准。

## 变更内容 ### 1. 普通资源画布隐藏游戏代码 - 资源画布的大纲、分页和卡片展示不再显示“游戏代码”栏目。 - 保留内部完整的五栏目布局契约,避免已有代码资源坐标被重写。 - 补充回归测试,确认游戏代码不会出现在普通资源画布中,且代码端点不可见时不会渲染对应依赖边。 ### 2. 增加资源类型角标 - 资源卡右上角增加类型角标,用于快速识别资源类型。 - 类型从既有资源投影字段推导,覆盖图片、SVG、视频、音频、文档、任务产物、Agent 回执、项目版本等类型,并为未知类型兜底。 - 该能力仅用于前端展示,不新增后端字段或修改资源投影契约。 ### 3. 限制默认自动适配缩放 - 画布首次自动适配和显式复位时的默认最大缩放统一限制为 `1.5`,避免内容较少或只有一个资源时卡片被放得过大。 - 该限制对设计文档、美术、音频、游戏代码、项目版本全部资源栏目生效。 - 用户主动缩放仍沿用现有上限,不受默认适配上限影响。 - 用户调整后的画布缩放会按排序模式和栏目保留;切换到其他栏目再返回后,仍恢复用户调整后的 viewport,而不是重新自动放大。 ## 兼容性 - 不修改后端 API、SpacetimeDB schema 或 `/api/external/v1`。 - 资源类型角标是展示层推导逻辑,不改变资源数据结构。 - 内部布局仍保留游戏代码栏目契约,已有布局数据不需要迁移。 ## 验证 - `resourceCanvasLayoutModel.test.ts` - `project-development.suite.ts` 相关 App Surface 用例 - `npm run typecheck` - `npm run check:encoding` - Prettier 相关文件检查 - `git diff --check` 历史分支检查不替代最新 head CI;PR 更新后将以最新 CI 结果为准。
suzmii added 1 commit 2026-08-29 16:51:55 +08:00
隐藏资源画布游戏代码并补充类型标识
Project CI / Repository checks (pull_request) Successful in 3m28s
Project CI / Backend tests (pull_request) Failing after 4m59s
Project CI / Frontend tests (pull_request) Successful in 4m11s
Project CI / Native shell tests (pull_request) Failing after 6m8s
14818c2c0c
- 资源画布仅展示文档、美术、音频、项目版本四个可见栏目,保留五类内部投影和依赖事实。

- 为可见资源卡增加可访问、可测试的中文类型 Tag,并隐藏代码端点依赖边。

- 补充资源投影、画布回归测试及 PRD 四栏目验收描述。
kdletters requested changes 2026-08-31 10:46:43 +08:00
kdletters left a comment
Member

当前 head 的 Backend tests 与 Native shell tests 均失败,需先修复并重新跑完整 CI 后再合并。

当前 head 的 Backend tests 与 Native shell tests 均失败,需先修复并重新跑完整 CI 后再合并。
Member

请先修复远端 Backend tests 与 Native shell tests 失败,并在当前 head 重新跑完整 CI。

请先修复远端 Backend tests 与 Native shell tests 失败,并在当前 head 重新跑完整 CI。
suzmii added 1 commit 2026-08-31 10:48:38 +08:00
限制资源画布默认适配缩放
Project CI / Backend tests (pull_request) Failing after 4m33s
Project CI / Native shell tests (pull_request) Failing after 6m4s
Project CI / Frontend tests (pull_request) Successful in 4m0s
Project CI / Repository checks (pull_request) Successful in 6m48s
75bdd0ac9d
- 将资源画布初次适配与复位的默认最大缩放统一为 1.5,覆盖全部资源栏目。

- 保留用户主动缩放的通用上限,并补充跨栏目 viewport 记忆回归。

- 同步技术方案中的资源总览缩放与视口记忆描述。
suzmii changed title from 隐藏资源画布游戏代码并补充资源类型标识 to 优化 Game Agent 资源画布展示与默认缩放 2026-08-31 10:50:14 +08:00
suzmii added 1 commit 2026-08-31 10:51:53 +08:00
Merge branch 'master' into agc-resource-canvas-types
Project CI / Repository checks (pull_request) Has been cancelled
Project CI / Frontend tests (pull_request) Has been cancelled
Project CI / Backend tests (pull_request) Has been cancelled
Project CI / Native shell tests (pull_request) Has been cancelled
445d6a05e1
kdletters added 1 commit 2026-08-31 10:55:50 +08:00
Merge branch 'master' into agc-resource-canvas-types
Project CI / Native shell tests (pull_request) Successful in 16m46s
Project CI / Repository checks (pull_request) Successful in 6m12s
Project CI / Frontend tests (pull_request) Successful in 4m24s
Project CI / Backend tests (pull_request) Successful in 7m43s
218ce3ac81
Member

Close #217 #218

Close #217 #218
suzmii requested review from kdletters 2026-08-31 12:50:37 +08:00
suzmii added 1 commit 2026-08-31 14:31:40 +08:00
Merge branch 'master' into agc-resource-canvas-types
Project CI / Repository checks (pull_request) Successful in 6m4s
Project CI / Frontend tests (pull_request) Successful in 6m8s
Project CI / Native shell tests (pull_request) Successful in 22m6s
Project CI / Backend tests (pull_request) Successful in 13m21s
fecd3efb25
kdletters merged commit 1c2f82e246 into master 2026-08-31 14:36:58 +08:00
kdletters deleted branch agc-resource-canvas-types 2026-08-31 14:36:58 +08:00
Sign in to join this conversation.