AGC 画布验收：生成参考、占位卡、资源名称及布局交互问题 #411

New Issue

2026-09-17T20:03:16+08:00

suzmii commented

2026-09-17 20:03:16 +08:00

问题来源

2026-09-17《AGC 画布验收报告》：
https://kcnz41bksl1c.feishu.cn/wiki/PT7kwkJK0iKMp9kgZhRcnEHWnib

问题、原因与预期

问题	当前原因	修复与验收目标
工具栏生图不能添加参考素材	生成表单及本地生成命令缺少用户参考接线	通过 @ 选择当前项目已登记图片，真实资产 ID 经当前账号绑定进入生成请求，而非仅拼名称
生成入口直接弹窗、缺素材时部分工具不能进入	入口可用性与生成前置耦合，缺少画布占位生命周期	点击先创建占位卡，在关联面板操作；必要规范前置提交时验证；成功结果接管最新占位位置
各类资源卡缺少名称	卡面隐藏正式资源名	统一显示正式资源 label，长名称省略且可查看完整名称
文档卡展示无效正文片段	卡面将正文摘要作为缩略预览	改为居中文档图标与名称，完整正文保留在独立预览
整理画布看起来无效	既有重算保留手动坐标，且未纳入组织操作历史	显式整理当前栏目全部素材（含手动及筛选隐藏素材），其他栏目不变；一次撤销恢复坐标与手动标记
框选后不能批量移动	拖动和写回主要按单资源处理	可见多选集整体移动、保持相对位置，松手批量保存，一次撤销

范围

包含原六项、追加的多选素材批量标签需求及其必要回归修复；不包含拖入对话批量 @、复制聊天引用或历史素材替换交互。不修改数据库 schema，不新增远程公开 API。

修复落地

实现已在 feat/agc-canvas-acceptance 集成，最新合并提交 20b1fd63d，包含 master 195b7dd5d；对应 PR #412，目标分支为 master。原六项与批量标签已完成本地实现和自动化验证，真实客户端验收仍待完成。

生成参考与占位：ResourceCanvasAssetGenerationPanelView、生成任务队列、useResourceCanvasGenerationPlaceholders、ProjectDevelopmentView、原生 canvas_generation。
名称和文档卡：ResourceCard、卡片样式及资源预览模型。
整理、多选移动和撤销：useProjectResourceCanvasLayout、布局模型及历史模型。

验收清单

空素材项目可进入生成流程，必要前置在提交时检查。
参考素材真实进入生成请求；普通生成总参考不超过 5 张，图集不接受额外参考，SVG 不进入参考候选。
生成失败保留草稿并按原身份重试；成功结果接管占位最新位置。
所有资源卡显示正式名称，文档详情、媒体播放、JSON/UI 设计入口保持可用。
整理、多选移动和撤销不影响其他栏目，不跨项目或排序模式写错布局。
完成真实客户端交互验收及必要的真实 Provider 生成验证。

当前验证与边界

本地定向测试 424 项通过；appSurface 450 项通过、20 项跳过；原生引用测试 17 项通过；AGC 类型检查、Rust all-targets 编译、编码及文档索引检查通过。

真实付费 Provider 生成及完整 Tauri IPC 联调未执行；末版浮层高度与居中仍需真实客户端复验。卡片名称沿用正式落盘文件名，可能带生成时间戳和扩展名。远程 CI 结果以 PR 实际状态为准。

2026-09-17 追加需求：多选素材批量标签

问题与修复

多选素材后原标签编辑入口只操作首项，缺少一次给整组素材追加标签的能力。

画布选中工具栏“编辑标签”与资源面板“批量标签”都进入同一标签编辑器的批量模式。
打开时冻结完整目标集，一次追加用户输入的标签；保留每份素材已有标签、正式分类和其它字段，不将已有标签并集分发给每份素材。
原生 add_local_project_resource_tags 沿用项目权限、写锁和 revision CAS：整批校验后一次写 manifest；任何目标缺失或标签越界时零部分写入。
每批最多 200 个不同素材；标签沿用 16 个/每个 32 字符的限制；重复标签不重复追加，整批无变化不写盘、不推进 revision、不增加审计。
保存中锁定重复提交、输入、删除与关闭；失败保留草稿；切项目/回读期间切项目按代次与身份丢弃迟到结果。
混合选择含版本卡或未登记资源时整批禁用并给原因，不静默只改可写子集。

落地位置

ResourceClassificationPanel、ResourceCanvasPanelView、resourceBatchTagTargetModel、工作台 index.tsx；原生 project/manifest.rs、commands.rs、main.rs 及 classification_tests。

验收状态

本地前端 9 文件、68 项定向测试通过（含真实工作台组件的 9 项集成测试）。
原生分类测试 22 项通过；独立 review 有效发现已修复。
本轮合入 master 195b7dd5d 后，11 文件、137 项定向测试、AGC typecheck、Rust all-targets 编译、编码/文档索引检查通过。
真实客户端批量标签操作与原生 IPC 写盘验收。

菜单收纳已由 PR #410 合入主线，本分支复用而不重复开发。动画失败、未完成编辑恢复、资源面板卡死，以及聊天拖拽 @/复制引用不扩入此次新增需求。master #394 的抠图修复随本轮合并带入，不记作本 PR 独立实现。

CI 定时跟进已按用户要求删除；本次推送可能触发仓库 CI，但不代表新提交 CI 已通过，也不恢复定时监视。飞书未写入。

## 问题来源 2026-09-17《AGC 画布验收报告》： https://kcnz41bksl1c.feishu.cn/wiki/PT7kwkJK0iKMp9kgZhRcnEHWnib ## 问题、原因与预期 | 问题 | 当前原因 | 修复与验收目标 | | --- | --- | --- | | 工具栏生图不能添加参考素材 | 生成表单及本地生成命令缺少用户参考接线 | 通过 @ 选择当前项目已登记图片，真实资产 ID 经当前账号绑定进入生成请求，而非仅拼名称 | | 生成入口直接弹窗、缺素材时部分工具不能进入 | 入口可用性与生成前置耦合，缺少画布占位生命周期 | 点击先创建占位卡，在关联面板操作；必要规范前置提交时验证；成功结果接管最新占位位置 | | 各类资源卡缺少名称 | 卡面隐藏正式资源名 | 统一显示正式资源 label，长名称省略且可查看完整名称 | | 文档卡展示无效正文片段 | 卡面将正文摘要作为缩略预览 | 改为居中文档图标与名称，完整正文保留在独立预览 | | 整理画布看起来无效 | 既有重算保留手动坐标，且未纳入组织操作历史 | 显式整理当前栏目全部素材（含手动及筛选隐藏素材），其他栏目不变；一次撤销恢复坐标与手动标记 | | 框选后不能批量移动 | 拖动和写回主要按单资源处理 | 可见多选集整体移动、保持相对位置，松手批量保存，一次撤销 | ## 范围包含原六项、追加的多选素材批量标签需求及其必要回归修复；不包含拖入对话批量 @、复制聊天引用或历史素材替换交互。不修改数据库 schema，不新增远程公开 API。 ## 修复落地实现已在 `feat/agc-canvas-acceptance` 集成，最新合并提交 `20b1fd63d`，包含 master `195b7dd5d`；对应 PR #412，目标分支为 `master`。原六项与批量标签已完成本地实现和自动化验证，真实客户端验收仍待完成。 - 生成参考与占位：`ResourceCanvasAssetGenerationPanelView`、生成任务队列、`useResourceCanvasGenerationPlaceholders`、`ProjectDevelopmentView`、原生 `canvas_generation`。 - 名称和文档卡：`ResourceCard`、卡片样式及资源预览模型。 - 整理、多选移动和撤销：`useProjectResourceCanvasLayout`、布局模型及历史模型。 ## 验收清单 - [ ] 空素材项目可进入生成流程，必要前置在提交时检查。 - [ ] 参考素材真实进入生成请求；普通生成总参考不超过 5 张，图集不接受额外参考，SVG 不进入参考候选。 - [ ] 生成失败保留草稿并按原身份重试；成功结果接管占位最新位置。 - [ ] 所有资源卡显示正式名称，文档详情、媒体播放、JSON/UI 设计入口保持可用。 - [ ] 整理、多选移动和撤销不影响其他栏目，不跨项目或排序模式写错布局。 - [ ] 完成真实客户端交互验收及必要的真实 Provider 生成验证。 ## 当前验证与边界本地定向测试 424 项通过；appSurface 450 项通过、20 项跳过；原生引用测试 17 项通过；AGC 类型检查、Rust all-targets 编译、编码及文档索引检查通过。真实付费 Provider 生成及完整 Tauri IPC 联调未执行；末版浮层高度与居中仍需真实客户端复验。卡片名称沿用正式落盘文件名，可能带生成时间戳和扩展名。远程 CI 结果以 PR 实际状态为准。 ## 2026-09-17 追加需求：多选素材批量标签 ### 问题与修复多选素材后原标签编辑入口只操作首项，缺少一次给整组素材追加标签的能力。 - 画布选中工具栏“编辑标签”与资源面板“批量标签”都进入同一标签编辑器的批量模式。 - 打开时冻结完整目标集，一次追加用户输入的标签；保留每份素材已有标签、正式分类和其它字段，不将已有标签并集分发给每份素材。 - 原生 `add_local_project_resource_tags` 沿用项目权限、写锁和 revision CAS：整批校验后一次写 manifest；任何目标缺失或标签越界时零部分写入。 - 每批最多 200 个不同素材；标签沿用 16 个/每个 32 字符的限制；重复标签不重复追加，整批无变化不写盘、不推进 revision、不增加审计。 - 保存中锁定重复提交、输入、删除与关闭；失败保留草稿；切项目/回读期间切项目按代次与身份丢弃迟到结果。 - 混合选择含版本卡或未登记资源时整批禁用并给原因，不静默只改可写子集。 ### 落地位置 `ResourceClassificationPanel`、`ResourceCanvasPanelView`、`resourceBatchTagTargetModel`、工作台 `index.tsx`；原生 `project/manifest.rs`、`commands.rs`、`main.rs` 及 `classification_tests`。 ### 验收状态 - [x] 本地前端 9 文件、68 项定向测试通过（含真实工作台组件的 9 项集成测试）。 - [x] 原生分类测试 22 项通过；独立 review 有效发现已修复。 - [x] 本轮合入 master 195b7dd5d 后，11 文件、137 项定向测试、AGC typecheck、Rust all-targets 编译、编码/文档索引检查通过。 - [ ] 真实客户端批量标签操作与原生 IPC 写盘验收。菜单收纳已由 PR #410 合入主线，本分支复用而不重复开发。动画失败、未完成编辑恢复、资源面板卡死，以及聊天拖拽 @/复制引用不扩入此次新增需求。master #394 的抠图修复随本轮合并带入，不记作本 PR 独立实现。 CI 定时跟进已按用户要求删除；本次推送可能触发仓库 CI，但不代表新提交 CI 已通过，也不恢复定时监视。飞书未写入。

suzmii referenced a pull request that will close this issue

2026-09-17 20:04:43 +08:00

修复 AGC 画布生成、卡片展示与布局交互 #412

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: GenarrativeAI/Genarrative#411