GenarrativeAI/Genarrative
11
0
Fork 0
Code Issues 22 Pull Requests 10 Actions Packages Projects 1 Releases Wiki Activity

资源画布支持引擎资源预览与模型交互预览 #413

Merged
kdletters merged 2 commits from codex/agc-cocos-engine-resources into master 2026-09-17 20:28:40 +08:00
Conversation 0 Commits 2 Files Changed 33
+3060 -53
kdletters commented 2026-09-17 20:24:08 +08:00
Member
Copy Link
Copy Source

目的

资源画布支持引擎（Cocos Creator）资源的只读预览：能被发现、登记、进入画布，并按类型出预览。

主要改动

  • 发现层识别 Cocos 资源并区分 model / binary 两个发现类别；.meta 等导入侧车文件仍只可发现
  • 登记层按扩展名写入既有 canonical kind（模型/场景/预制体 → scene，动画 → character-animation，材质/特效 → code，图集与容器 → document），不新增 manifest 契约字段
  • 引擎工程的 library/ / temp/ / profiles/ / local/ 不再进入发现结果（仅当目录确实是 Cocos 工程），同名目录在非引擎工程里照常列出
  • 资源画布新增三个卡面分支：模型缩略图（整页共用一个 WebGL 上下文）、结构摘要（Cocos 序列化资源）、类型卡（客户端解不了的容器）
  • 新增模型放大预览浮层：左键旋转 / 右键或中键平移 / 滚轮缩放 / 复位视角
  • 模型预览上限 32 MiB；缩略图按布局尺寸 2 倍超采样，缓存键改用稳定身份
  • 引擎图像容器（tga/tif/tiff/hdr）在原生侧转码成 PNG 后复用既有图片预览链路
  • 修复资源卡状态边框吃掉内容盒导致的卡面与角标位移
  • 同步 Agent 提示词与 AGC 技能文档，并补里程碑与踩坑文档

验证

  • cargo check、cargo fmt --check
  • Rust 定向：cargo test … cocos 9 条、resource_inspect::tests 7 条、agent_asset_import_tests 9 条、生成目录过滤用例
  • 前端：resource + project 套件 52 文件 / 546 用例；appSurface 450 通过 / 20 跳过；app tsc --noEmit
  • npm run check:encoding、git diff --check、npm run check:doc-index
  • 真机：在真实客户端内打开本地 Cocos 夹具工程，逐栏核对模型缩略图 / 结构摘要 / TGA 转码 / 类型卡，并量过卡片在指针移开、悬停、选中三态下几何完全一致

未验证

  • 模型缩略图与放大预览的真机视觉只覆盖自带夹具工程；多文件 glTF（外部 .bin/贴图）与超大模型仍是类型卡
## 目的 资源画布支持引擎（Cocos Creator）资源的**只读预览**：能被发现、登记、进入画布，并按类型出预览。 ## 主要改动 - 发现层识别 Cocos 资源并区分 `model` / `binary` 两个发现类别；`.meta` 等导入侧车文件仍只可发现 - 登记层按扩展名写入**既有** canonical kind（模型/场景/预制体 → `scene`，动画 → `character-animation`，材质/特效 → `code`，图集与容器 → `document`），不新增 manifest 契约字段 - 引擎工程的 `library/` / `temp/` / `profiles/` / `local/` 不再进入发现结果（仅当目录确实是 Cocos 工程），同名目录在非引擎工程里照常列出 - 资源画布新增三个卡面分支：模型缩略图（整页共用一个 WebGL 上下文）、结构摘要（Cocos 序列化资源）、类型卡（客户端解不了的容器） - 新增模型放大预览浮层：左键旋转 / 右键或中键平移 / 滚轮缩放 / 复位视角 - 模型预览上限 32 MiB；缩略图按布局尺寸 2 倍超采样，缓存键改用稳定身份 - 引擎图像容器（tga/tif/tiff/hdr）在原生侧转码成 PNG 后复用既有图片预览链路 - 修复资源卡状态边框吃掉内容盒导致的卡面与角标位移 - 同步 Agent 提示词与 AGC 技能文档，并补里程碑与踩坑文档 ## 验证 - `cargo check`、`cargo fmt --check` - Rust 定向：`cargo test … cocos` 9 条、`resource_inspect::tests` 7 条、`agent_asset_import_tests` 9 条、生成目录过滤用例 - 前端：`resource` + `project` 套件 52 文件 / 546 用例；`appSurface` 450 通过 / 20 跳过；app `tsc --noEmit` - `npm run check:encoding`、`git diff --check`、`npm run check:doc-index` - 真机：在真实客户端内打开本地 Cocos 夹具工程，逐栏核对模型缩略图 / 结构摘要 / TGA 转码 / 类型卡，并量过卡片在指针移开、悬停、选中三态下几何完全一致 ## 未验证 - 模型缩略图与放大预览的真机视觉只覆盖自带夹具工程；多文件 glTF（外部 .bin/贴图）与超大模型仍是类型卡
kdletters added 2 commits 2026-09-17 20:24:08 +08:00
资源画布支持引擎资源预览与模型交互预览 b22a6523fa 
发现层识别 Cocos Creator 资源并区分 model / binary 两个发现类别
登记层按扩展名写入既有 canonical kind，不新增 manifest 契约字段
引擎工程的 library / temp / profiles / local 不再进入发现结果，非引擎工程不受影响
资源画布新增模型缩略图、结构摘要与类型卡三个引擎资源卡面分支
新增模型放大预览浮层：左键旋转、右键或中键平移、滚轮缩放与复位视角
模型预览上限放宽到 32 MiB，缩略图按布局尺寸超采样并按稳定身份缓存
引擎图像容器在原生侧转码成 PNG 后复用既有图片预览链路
修复资源卡状态边框吃掉内容盒导致的卡面与角标位移
同步引擎资源口径到 Agent 提示词与 AGC 技能文档
补齐定向用例、里程碑与踩坑文档
Merge remote-tracking branch 'origin/master' into codex/agc-cocos-engine-resources
Project CI / AI game creator shell Rust shard 1/4 (pull_request) Has been cancelled
Details
Project CI / AI game creator shell Rust shard 2/4 (pull_request) Has been cancelled
Details
Project CI / AI game creator shell Rust shard 3/4 (pull_request) Has been cancelled
Details
Project CI / AI game creator shell Rust shard 4/4 (pull_request) Has been cancelled
Details
Project CI / AI game creator shell Rust smoke (pull_request) Has been cancelled
Details
Project CI / AI game creator shell Rust crates (pull_request) Has been cancelled
Details
Project CI / Backend tests (pull_request) Has been cancelled
Details
Project CI / Native shell tests (pull_request) Has been cancelled
Details
Project CI / Frontend tests (pull_request) Has been cancelled
Details
Project CI / Repository checks (pull_request) Has been cancelled
Details
Project CI / AI game creator shell web tests (pull_request) Has been cancelled
Details
2f5b412253 
# Conflicts:
#	apps/ai-game-creator-shell/package.json
#	apps/ai-game-creator-shell/src-tauri/resources/agc-skills/manifest.json
#	docs/project-memory/shared-memory/decision-log.md
#	docs/project-memory/shared-memory/pitfalls.md
#	package-lock.json
kdletters merged commit d5743cd4b8 into master 2026-09-17 20:28:40 +08:00
kdletters deleted branch codex/agc-cocos-engine-resources 2026-09-17 20:28:40 +08:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
Compat/Breaking
Breaking change that won't be backward compatible
 Kind/Bug
Something is not working
 Kind/Documentation
Documentation changes
 Kind/Enhancement
Improve existing functionality
 Kind/Feature
New functionality
 Kind/Security
This is security issue
 Kind/Testing
Issue or pull request related to testing
Priority
Critical
1
The priority is critical
Priority
High
2
The priority is high
Priority
Low
4
The priority is low
Priority
Medium
3
The priority is medium
Reviewed
Confirmed
1
Issue has been confirmed
Reviewed
Duplicate
2
This issue or pull request already exists
Reviewed
Invalid
3
Invalid issue
Reviewed
Won't Fix
3
This issue won't be fixed
Status
Abandoned
3
Somebody has started to work on this but abandoned work
Status
Blocked
1
Something is blocking this issue or pull request
Status
Need More Info
2
Feedback is required to reproduce issue or to continue work
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
HuangJiaJia JenkenB k88936 (王德宇) kdletters (段舒康) laura2008 (王乐) lhk229 (孔令弘) Loer (农洛儿) loong suzmii (董羽秦) taobaisu (叶东旭) wuxiangwanzi (王子民) YixuanLiu ziyu
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: GenarrativeAI/Genarrative#413
Delete Branch "codex/agc-cocos-engine-resources"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?