跳到主要内容

资源画布与素材管理

本页解决什么问题：帮你找到项目里的素材，并完成浏览、选择、移动、整理、引用、改名、删除和替换等日常管理。

进入项目后，点击工作台顶部的 资源管理。资源总览会显示「所有资源」入口和 8 个栏目入口，每个入口都带当前资源数量。点击栏目卡即可进入该栏目的画布。

提示

第一次进入时，资源总览只展示每个栏目的一小摞预览。先点 所有资源 可以快速看清项目里全部已登记素材，再回到具体栏目整理。

资源总览的 8 个栏目​

栏目适合放什么
UI 交互界面图、图标、图标规范、UI 设计图等
角色与对象角色形象、角色规范、道具和对象素材
场景与环境场景图、背景和环境素材
音频音效、背景音乐
文档说明、设定、JSON、代码和结构化文档
3D 资产3D 模型、绑骨产物和动画产物
待归类暂时无法判断用途的任务产物、附件等
项目版本本地版本记录，不是普通素材

「所有资源」是总览入口，不是第 9 个栏目。它会把各栏目素材放在同一张跨栏目画布中展示。

依赖和类型两种排列​

工作台右上角提供 依赖 和 类型 两种排列方式，两种方式共用同一批素材，但各自保存画布位置。

依赖​

  • 画布会按素材之间的引用关系排列卡片。
  • 有引用关系的卡片之间会画连线，鼠标移到连线上可以查看关系说明。
  • 检测到依赖环时，关系说明会明确标注「依赖环」。
  • 依赖图读取失败时，画布上方会显示失败原因。素材本身不会因此被删除。

类型​

  • 画布会按素材类型聚合排列，适合快速找到同类文件。
  • 类型视图不显示依赖连线。
  • 两种排列的画布位置互不影响，切换回来时仍会恢复该模式上次的位置。
备注

新素材加入项目后，画布只会补位，不会自动把整张画布重新排一遍。需要全局整齐时，请手动点击 整理画布。

选择素材卡​

  1. 单击一张卡：只选中这一张。
  2. 按住 Ctrl、Command 或 Shift 再点其他卡：追加或取消选择。
  3. 在画布空白处按住左键拖出选框：框选范围内的素材。
  4. 单击画布空白处：清空当前选择。

选中一张素材后，卡片旁会出现选中工具条；选中多张时，批量操作只对当前完整选择集生效。

移动和框选​

  • 拖动单张卡会移动它，并记住新的手动位置。
  • 先框选多张，再拖动其中任意一张已选卡，整组会保持相对位置一起移动。
  • 如果按住的是未选中的卡，则仍按单卡拖动处理。
  • 拖动松手后才统一保存；拖动期间切换项目、窗口失焦或保存失败会取消本次拖动预览。
  • 画布空白处左键拖框选；按住鼠标右键、中键或空格再拖动可以平移画布。

把素材拖进对话​

  1. 选中一张或多张已登记素材。
  2. 按住卡片拖到右侧陶泥儿对话栏。
  3. 对话栏出现「松手即可 @ 引用 N 项素材」时松开。
  4. 素材会以 @素材名 的形式插入输入框。

只有已登记到项目里的素材才能被 @ 引用。任务临时产物、未登记附件或项目版本会提示「这些素材还没登记为项目资源，不能 @ 引用」。

注意

拖到对话栏表示“引用素材”，不是“把文件搬出项目”。这次拖动不会修改素材所在的栏目或画布坐标。

整理、撤销和缩放​

  • 整理画布：把当前栏目内全部素材重新排成自动布局，包含之前手动摆放的卡。筛选条件不会缩小整理范围。
  • 撤销：Ctrl/Cmd + Z 或右下角撤销按钮，可撤销移动和整理。
  • 重做：Ctrl/Cmd + Shift + Z 或 Ctrl + Y，恢复刚才撤销的布局。
  • 整理和拖动都以一次完整操作为撤销单位；多选拖动只算一步。
  • 右下角提供缩小、放大、百分比和 适应内容大小。
  • 滚轮用于平移画布；按住 Ctrl/Cmd 滚动或触控板捏合用于缩放，不会让整个客户端页面跟着缩放。

「所有资源」页也能统一浏览和拖动，但每张卡仍写回它所属栏目的位置。整理「所有资源」时会影响全部栏目。

单张素材卡上的操作​

选中素材后，工具条会按素材类型显示可用动作。看不到某个动作，通常表示当前素材类型或来源不支持该操作。

动作用途
快速编辑对已登记图片做一次图像修改，生成一张新素材
生成动画对角色图片生成动作序列帧，源图不变
引用把素材作为 @ 引用插入对话
编辑标签为该素材追加或删除标签
设置素材类型点击卡片右上角类型标签，打开分类面板；选中即保存
批量标签选择至少两张素材后统一追加标签
重命名修改素材显示名和对应文件名
预览放大查看图片、文档或引擎模型
3D 预览打开 3D 模型查看器
UI 编辑器打开 UI 设计图或 UI 设计 JSON
替换素材替换当前版本正在使用的素材，只对已绑定当前版本的素材显示
删除素材从项目中移除该素材登记

卡片右上角的类型标签来自素材功能分类。点类型标签可以打开「设置素材类型」面板，选中后立即写入当前素材，不需要再点保存。JSON 和 UI 设计图会单独显示「JSON」「UI 设计」类型，但不会改变它所在栏目。

批量追加标签​

  1. 在画布或资源面板中选择至少两张已登记素材。
  2. 点击 编辑标签 或资源面板里的 批量标签。
  3. 输入要追加的标签，用中英文逗号、顿号或换行分隔。
  4. 点击 添加。

批量模式只追加标签，不会删除素材原有标签，也不会批量改类型。整批最多 200 个不同素材；如果选择里混入项目版本、未登记附件或已删除素材，入口会禁用并说明原因。

备注

打开批量标签后，操作对象会冻结为当时的选择集。之后在画布上换选，不会悄悄改变这一批的写入范围。

重命名素材​

  1. 选中已登记素材，点击 重命名。
  2. 输入新的文件名。
  3. 点击 重命名。

新文件名不能为空，不能包含目录分隔符或 ..，也不能改变扩展名。重命名只改文件名和素材登记，不会自动改写游戏源码里对旧文件名的引用。

删除素材​

  1. 选中已登记素材，点击 删除素材。
  2. 客户端会先检查它是否被游戏版本使用。
  3. 如果被使用，会列出相关版本。
  4. 默认只删除素材，相关版本会保留一个失效引用。
  5. 勾选 把相关游戏版本一并删除 后，素材和相关版本会在同一次操作里删除。
  6. 点击 删除 确认。
注意

「把相关游戏版本一并删除」不可恢复。默认不勾选，是为了避免为了清理一张图而误删版本记录。

删除素材会把它从项目素材列表中移除。磁盘原文件不会因为这次“取消登记”被自动清空；需要彻底清理磁盘时，请到项目目录自行处理。

替换素材​

替换素材 用于把当前版本正在使用的一张素材换成另一张兼容素材。满足以下条件才会出现：

  • 素材是项目已登记资产。
  • 素材被当前选中的游戏版本使用。

操作步骤：

  1. 选中当前版本使用的素材。
  2. 点击 替换素材。
  3. 在非模态面板里选择候选，或直接点击画布上的另一张素材。
  4. 点击确认。

分类不同或素材类型不同的候选会显示禁用原因，但仍会列出来，避免被误以为“素材不存在”。格式或尺寸规格不同只会提示，不一定阻止替换。

替换会直接修改当前版本的资源绑定，不会新建版本。成功后，源素材卡显示「已被 … 替换」，替换素材卡显示「替换自 …」。该标注只在当前会话保留。

资源面板​

点击工作台顶部的 资源面板，打开一个独立浮层。它和画布共用同一份选择状态，适合集中挑选、上传和下载。

  • 上传素材：可一次选择多个图片、音频或视频文件；上传期间不能关闭面板。
  • 全选 / 清空选择：对当前筛选结果和画布选择同步生效。
  • 批量标签：选择至少两张可写入素材后可用。
  • 下载：只对能真实落盘的素材启用；项目版本卡没有文件，不能下载。
  • 面板中的预览失败会显示具体原因，不会只留一块空白。

恢复未完成的编辑​

顶部出现 管理未完成编辑 (N) 时，说明有草稿或后台未完成操作。

  1. 点击该入口，打开 未完成的资源编辑。
  2. 本地草稿可 继续编辑 或 丢弃草稿。
  3. 后台待恢复任务可 继续原编辑。
  4. 如果服务身份需要确认，会显示当前服务地址和 确认当前服务并继续。
  5. 明确失败的远程任务可 移出恢复队列。
  6. 需要只读对账的任务只显示 只读对账，不会允许继续写入。
  7. 读取失败时可点 重试读取。

本会话里的快速编辑草稿关闭客户端后不会保留；已进入后台任务记录的任务会按记录状态恢复。关闭客户端前请先处理需要保留的草稿。

生成任务侧栏​

资源画布和 UI 编辑器右上角有 生成任务 侧栏。它可以在不打断画布操作的情况下查看：

  • 图片、音频、3D 模型等后台生成任务。
  • 快速编辑、生成动画等修改任务。
  • AI 项目命名任务。
  • 进行中的阶段、已耗时、失败原因。

任务完成后，可以点 定位到素材 跳到结果卡。收起侧栏不会取消任务，也不会删除占位或结果。

提示

运行页不显示生成任务侧栏，避免遮挡游戏画面。切回资源管理即可继续查看。

常见失败和处理​

现象处理
依赖图读取失败刷新或重新进入项目；素材文件本身仍可用
素材在画布上暂时看不见清除搜索条件，或点提示里的 清除搜索并定位
标签已保存但刷新失败写入已经成功，重新进入项目后复查标签即可
替换失败按面板提示检查分类、类型、当前版本绑定或项目是否已被别处修改
删除时版本冲突重新打开项目后再操作，避免用旧版本号覆盖新修改
上传中无法关闭资源面板等上传结束，避免进度和失败提示被藏起来
未完成编辑无法继续先确认服务身份，或按提示移出失败队列

需要生成图片时，继续阅读 图片生成与规范图。需要处理音频或 3D 时，阅读 音频与 3D 资产。