AGC资源画布选中菜单收纳与卡片入口调整 #409

New Issue

2026-09-17T17:57:20+08:00

suzmii commented

2026-09-17 17:57:20 +08:00

问题与原因

AGC 画布选中资源后，图片处理与宿主追加动作全部平铺在横向工具栏内；动作数较多时菜单过长。「素材类型」与「信息」也占用工具栏位置，挤占高频操作。

已确认方案

产品对比后选择「常用直达 + 更多」，不采用「素材处理 / 素材管理 / 预览」分类收纳方案。

按当前可用动作及既有顺序，主工具栏最多直接显示前 5 项（分隔线不计数）。
剩余动作进入「更多」：鼠标悬停或点击后，向上展开独立纵向列表；顶边空间不足时避让，长列表内部滚动，不带动背景画布。
「素材类型」与「信息」移到资源卡片右上角，样式参照 Web 美术画布：类型标签 + 信息圆钮。未选中卡片可以直接打开信息；类型修改仅对已登记 manifest 资产开放。
两个卡片入口不触发卡片拖拽、框选或误切换；信息仍复用既有只读字段，类型修改仍走当前持久化链路。

实施思路

将通用收纳交互与卡片角标放入 packages/shared，Web/AGC 复用表现组件，资源命令与可用性保留在宿主。
共享选中工具栏增加可选数量限制，仅 AGC 启用前 5 项限制，Web 工具栏默认行为不变。
更多浮层复用现有 portal 归属；覆盖移入浮层、外部关闭、Escape、键盘导航、换选关闭、禁用项及视口边界。
信息状态绑定资源身份，避免从未选中卡片打开时被选中变化立即关闭，也避免换选后显示旧资源。
更新当前专题规范、工作台与 Web 卡片回归；按类型检查、定向测试和交互预览验证。

验收标准

不超过 5 项不出现更多；超过 5 项时所有可用动作均有入口且顺序不变。
悬停可稳定进入上方列表，点击/键盘可操作；点击动作后关闭，禁用状态和原有命令语义保持一致。
资源卡能直接查看信息和修改类型，卡片拖动/选中/缩放不受影响。
图片、视频、音频、文档、虚拟版本及未登记附件按原有权限与动作可用性展示。
定向测试、类型检查、编码/文档索引/diff 检查通过；真实客户端未验证项单独说明。

边界与当前状态

不修改后端、schema、权限、资源操作业务规则或默认 Web 菜单。不将方案 B 接入正式工作台。
已做本地交互草稿与 A/B 演示；继续以本 Issue 作为正式实现依据。当前完整工作台回归有 2 项涉及 Supervisor/Runtime 事件后的版本显示失败，尚待确认基线和与本变更的关系，不能作为已通过项。
本次仅获准创建 Issue；推送、PR、飞书需求登记与线上发布另行确认。

## 问题与原因 AGC 画布选中资源后，图片处理与宿主追加动作全部平铺在横向工具栏内；动作数较多时菜单过长。「素材类型」与「信息」也占用工具栏位置，挤占高频操作。 ## 已确认方案产品对比后选择「常用直达 + 更多」，不采用「素材处理 / 素材管理 / 预览」分类收纳方案。 1. 按当前可用动作及既有顺序，主工具栏最多直接显示前 5 项（分隔线不计数）。 2. 剩余动作进入「更多」：鼠标悬停或点击后，向上展开独立纵向列表；顶边空间不足时避让，长列表内部滚动，不带动背景画布。 3. 「素材类型」与「信息」移到资源卡片右上角，样式参照 Web 美术画布：类型标签 + 信息圆钮。未选中卡片可以直接打开信息；类型修改仅对已登记 manifest 资产开放。 4. 两个卡片入口不触发卡片拖拽、框选或误切换；信息仍复用既有只读字段，类型修改仍走当前持久化链路。 ## 实施思路 - 将通用收纳交互与卡片角标放入 packages/shared，Web/AGC 复用表现组件，资源命令与可用性保留在宿主。 - 共享选中工具栏增加可选数量限制，仅 AGC 启用前 5 项限制，Web 工具栏默认行为不变。 - 更多浮层复用现有 portal 归属；覆盖移入浮层、外部关闭、Escape、键盘导航、换选关闭、禁用项及视口边界。 - 信息状态绑定资源身份，避免从未选中卡片打开时被选中变化立即关闭，也避免换选后显示旧资源。 - 更新当前专题规范、工作台与 Web 卡片回归；按类型检查、定向测试和交互预览验证。 ## 验收标准 - 不超过 5 项不出现更多；超过 5 项时所有可用动作均有入口且顺序不变。 - 悬停可稳定进入上方列表，点击/键盘可操作；点击动作后关闭，禁用状态和原有命令语义保持一致。 - 资源卡能直接查看信息和修改类型，卡片拖动/选中/缩放不受影响。 - 图片、视频、音频、文档、虚拟版本及未登记附件按原有权限与动作可用性展示。 - 定向测试、类型检查、编码/文档索引/diff 检查通过；真实客户端未验证项单独说明。 ## 边界与当前状态不修改后端、schema、权限、资源操作业务规则或默认 Web 菜单。不将方案 B 接入正式工作台。已做本地交互草稿与 A/B 演示；继续以本 Issue 作为正式实现依据。当前完整工作台回归有 2 项涉及 Supervisor/Runtime 事件后的版本显示失败，尚待确认基线和与本变更的关系，不能作为已通过项。本次仅获准创建 Issue；推送、PR、飞书需求登记与线上发布另行确认。

suzmii referenced a pull request that will close this issue

2026-09-17 18:52:42 +08:00

重构AGC资源画布菜单与卡片入口 #410

suzmii changed title from ~~AGC资源画布选中菜单收纳与卡片入口调整（方案A）~~ to AGC资源画布选中菜单收纳与卡片入口调整

2026-09-17 18:59:59 +08:00

suzmii closed this issue

2026-09-17 20:56:44 +08:00

Sign in to join this conversation.