项目开发工作台

本页解决什么问题：带你看懂项目工作台的资源管理、运行、版本、对话、钱包和返回入口，知道每个区域该在什么时候用。

工作台是一个单窗口

项目工作台在陶泥工坊主窗口内打开。首页、项目组、模板库和项目工作台通过左侧栏切换，不会为每个项目额外开一个编辑器窗口。

“打开项目目录”和“在浏览器打开”会调用系统文件管理器或浏览器，属于外部窗口；它们不改变“客户端里只有一个当前项目”的事实。

工作台结构

区域	作用
顶部工具条	切换资源管理/运行，打开项目目录、资源面板、整理画布和版本入口
主视窗左侧/中间	资源总览、资源栏目画布或游戏运行画面
右侧对话栏	与陶泥儿 Agent 对话，负责生成、修改和排障
左上角或布局顶部	泥点余额入口
对话顶栏	会话列表、发布入口、设置
最左侧窄栏	返回首页、项目组或模板库

窄窗口下，“打开项目目录 / 资源面板 / 整理画布”可能收进“更多”菜单。它们仍然是同一批动作。

顶部：资源管理与运行

资源管理

点“资源管理”进入资源画布。这里展示项目中已经登记的资源，以及本地项目版本卡。

页面通常包括：

• “资源总览”：按栏目显示资源摞和数量。
• “所有资源”：跨栏目查看全部资源。
• UI 交互、角色与对象、场景与环境、音频、文档、3D 资产、待归类、项目版本等栏目。
• 生成任务侧栏：查看后台正在生成或已经完成的素材任务。

运行

点顶部“运行”页签会切换到运行画面，并触发本地预览。运行页签本身就是播放入口，不需要另外找“播放”按钮。

运行画面支持：

• 游戏画面直接嵌入工作台。
• “在浏览器打开”用系统浏览器查看当前预览。
• “刷新运行画面”重新载入页面。改完代码后通常需要点它，游戏不是 Vite 热更新。
• “全屏预览”只放大游戏画面，不放大整个工作台。
• “点选素材”在运行画面中选择区域，用于和素材建立引用关系。

运行失败时，页面会显示失败原因。若失败被判定为项目布局不可用，客户端会重新识别目录并询问是否更新项目配置。完整运行说明见运行与预览。

资源总览与栏目画布

资源总览按功能分类显示资源。点一个栏目进入该栏目的画布，点“返回资源总览”回到总览。

资源卡

资源卡可以显示名称、类型、预览和版本绑定状态。常见操作包括：

• 点选资源，打开底部选中工具条。
• 按住 Shift、Ctrl 或 Cmd 点击，追加多选。
• 拖动卡片改变画布位置。
• 在卡片或工具条上查看预览、放大预览、查看信息。
• 对符合条件的资源执行“编辑标签 / 设置素材类型 / 重命名 / 预览 / 替换素材 / 删除素材”等动作。
• 对符合条件的设计文档打开“UI 编辑器”。

资源卡上的“当前使用”高亮取决于当前选中的项目版本。切换版本后，高亮会随版本绑定变化。

空态

如果显示“暂无已登记资源”或“没有匹配资源”：

1. 检查当前栏目和筛选条件。
2. 清除搜索或标签筛选。
3. 打开资源面板或使用上传入口添加素材。
4. 如果刚结束生成，等待清单同步后再定位一次。

资源面板

点顶部“资源面板”打开资源面板浮层。它适合批量查看和操作当前筛选范围内的资源：

• 点条目追加选择。
• “全选”选择当前面板中的资源。
• “清空选择”取消选择。
• “批量标签”给多个已登记素材追加标签。
• “下载”保存选中的真实文件。
• “上传素材”把本地素材导入项目。
• 在提示区查看上传、下载或失败结果。

没有资源时“资源面板”按钮不可用。项目版本卡没有真实文件，不能当作普通素材下载。

备注

资源面板中的选择和画布选中可以互相保留。批量标签只接受真实已登记素材；混入项目版本或未登记资源时，页面会说明为什么不能整批写入。

整理画布

“整理画布”不是删除资源，也不是自动排版整个项目。它只重排当前目标范围内的资源卡坐标：

• 在某个栏目画布中，整理当前栏目。
• 在“所有资源”页，整理全部栏目。
• 手动拖过的坐标也会被本次整理覆盖。
• 其他栏目不受影响。
• 本次整理可以撤销。

资源不多、布局还没加载完或当前范围没有资源时，整理按钮可能禁用。

依赖与类型排序

顶部“依赖 / 类型”切换的是资源画布的排列方式：

模式	行为
依赖	依据资源之间的精确引用关系排列，并绘制连线
类型	按资源类型和栏目组织画布

这里的“依赖”不是安装 npm 依赖，“类型”也不是修改素材类型。安装依赖和运行构建属于“运行”流程；修改素材类型请在选中资源后使用“设置素材类型”。

打开项目目录

点“打开项目目录”会用系统文件管理器打开当前工程根目录。

适合用来：

• 查看源码和素材文件。
• 在外部编辑器中编辑代码。
• 确认构建产物或日志位置。

在外部修改文件后，回到客户端可能需要刷新清单或重新运行预览。不要在客户端正在生成、恢复版本或保存布局时同时大面积改写同一批文件，否则可能触发版本冲突。

项目版本

顶部版本入口显示当前的本地项目版本。它是陶泥工坊内部的工程版本，不是平台发布版本，也不代表作品已经上架。

版本菜单中：

• “版本 N”按工程迭代顺序排列。
• 标为“最新”的卡片代表最新内部版本，发布时通常取最新版本。
• 当前版本会在资源卡上参与“当前使用”高亮。
• 没有 Git 文件快照的历史版本显示“不可恢复”。
• 切换版本前会自动保存当前修改；恢复期间对话发送会暂时被拦住。
• 恢复后会停止旧预览，并按恢复后的源码重建；构建成功后才允许继续预览。

如果上次版本切换或保存没有完成，菜单会提供“恢复切换前内容”或“继续完成版本保存”。先完成这一步，再进行其它写操作。

注意

项目版本不是云备份。它保存在本地工程里，客户端卸载、目录被删除或磁盘损坏时同样可能丢失。重要节点请另外备份工程。

右侧陶泥儿对话

右侧是当前项目的主对话栏。你可以用它：

• 描述要新增、修改或修复的内容。
• 上传附件、@ 引用项目素材、$ 引用 Skill。
• 切换、新建、重命名或删除会话。
• 查看执行过程、思考过程和工具结果。
• 设置陶泥儿的操作权限。
• 打开发布/导出面板。

详细操作见与陶泥儿对话。素材浏览、整理和 UI 编辑器分别见资源画布与素材管理和UI 编辑器。

钱包

工作台会显示泥点余额入口。打开后可查看余额明细、充值、账单和兑换码。Agent 发起付费生成时，是否先弹确认取决于“操作权限”设置。

余额不足或泥点被冻结时，生成可能被服务端拒绝。先处理余额或账户限制，再重新发送“继续”或重新发起任务。

审批与设置

点对话顶栏的齿轮打开“对话设置”：

• “运行配置”：打开 Agent 设置。
• “操作权限”：选择“需要审批”或“不需要审批”。

这两项都是当前客户端的全局偏好，跨项目生效，不只在当前项目或当前这一句话里有效。修改后建议先确认状态已保存，再发起付费生成。

返回首页或项目组

点最左侧窄栏的首页图标回到首页，点文件夹图标进入项目组。退出工作台不会自动删除当前项目或会话。

如果当前有任务正在生成、版本正在恢复或文件正在导入，切换页面前最好先等它结束。切换页面不会中断已经在后台运行的回合，但你会离开当前观察位置。

策划工作台与游戏工作台

如果项目是从“做方案”或“策划补全”进入的，打开项目时会先看到策划工作台：

• 主区是策划阶段和工作区文件。
• 右侧是“与策划 Agent 对话”。
• 没有资源画布、运行页签和项目版本入口。

在顾问阶段点“做成游戏”后，同一个项目会切换到本页介绍的游戏工作台。

常见问题

现象	先检查什么
资源区为空	当前栏目、搜索筛选、资源是否已登记
运行画面空白	是否已点“运行”；是否需要“刷新运行画面”；是否有构建错误
预览改了代码没变化	游戏不会自动热更新，点刷新或重新运行
版本不能恢复	该历史版本没有 Git 文件快照
版本切换后画面没更新	等恢复和重建完成；失败时查看版本错误
发布入口不可用	当前回合可能正在运行，先等回合结束
看不到项目版本	项目还没有内部版本，或当前在 UI 编辑器聚焦页
不确定快捷键	查看快捷键与画布手势