常见问题
本页解决:第一次使用陶泥工坊时最常见的概念和边界问题。具体故障步骤见故障排查。
陶泥工坊、陶泥儿和 Genarrative 是什么关系?
- 陶泥工坊:桌面客户端,用来创建和管理游戏项目、与 Agent 协作、生成资源、预览和导出。
- 陶泥儿:客户端里的 AI 创作助手人格,也是平台账号与主站品牌使用的名字。
- Genarrative:平台与产品体系名称。网页端还提供图片画布、作品广场、账号与钱包等能力。
客户端里的对话对象叫陶泥儿,但安装、更新和反馈时使用“陶泥工坊”这个名字。
需要联网吗?
需要。以下能力依赖网络:
- 登录、钱包、会员和邀请。
- 与陶泥儿的模型回合。
- 图片、音频、3D 等生成。
- 云存档、发布、平台素材库和更新检查。
本地项目文件、已下载素材和本地预览在断网时仍可能打开,但依赖安装、模型和上传会失败。
项目保存在哪里?
项目保存在你新建时选择的目录,或设置里配置的「项目创建目录」。每个项目是一个独立文件夹。
项目里的 .agent 保存项目身份、资源清单、会话历史和本地 Agent 数据。复制项目时建议整个文件夹一起复制;只复制源码会丢失项目身份和对话上下文。
关闭客户端会丢东西吗?
已经保存的项目文件和资源不会因为关闭客户端而消失。以下内容可能丢失或需要重新开始:
- 尚未提交的生成草稿。
- 尚未保存的 UI 编辑器改动。
- 正在运行的本地预览。
- 尚未发送的对话草稿(取决于会话是否已保存)。
已提交的生成任务通常在重启后可以从任务或恢复队列继续查看;不要因为关闭窗口就重复提交。
陶泥儿会直接改我的代码吗?
会。在项目工作台里,陶泥儿可以在当前项目目录内读取、创建和修改文件,也可以运行项目自己的构建和验证命令。具体能做什么受当前操作权限、项目范围和客户端安全边界限制。
建议:
- 重要项目先用 Git 或复制目录做备份。
- 不要在项目里放密钥、Cookie、私钥或与创作无关的敏感文件。
- 大改前先提交一次版本,或让陶泥儿先写计划。
为什么有时生成前要确认,有时直接扣费?
看对话栏右上角的「操作权限」:
- 需要审批:Agent 发起的付费生成先弹确认。
- 不需要审批:Agent 可以直接提交。
这是当前客户端的全局偏好,跨项目生效,不是单项目或单次授权。你自己在生成面板里主动点生成会直接提交,不再单独弹出这条付费确认;金额以服务端扣费结果为准。
生成失败了,泥点会退吗?
资产操作确认失败或调用异常时,已扣泥点会自动进入服务端退款队列,客户端不会在本地自行退款或补扣。退款到账后,账单里会出现「泥点消耗退款」或「资产操作退回」记录。遇到失败:
- 先看生成任务侧栏和账单。
- 不要立刻重复提交同一请求。
- 如果提示“结果未知”或“需要核对”,扣费会先保留,等任务终态和对账结果确认是否退款;不要重复提交。
- 账单长时间没有退款记录时,带任务信息、扣费时间和账单截图联系反馈。
切换会话会中断正在运行的回合吗?
不会。会话列表切换只改变当前查看的会话,正在运行的回合继续在原来的会话里执行。你可以稍后切回去看结果。
关闭生成面板会取消任务吗?
不会。关闭面板只是收起界面。已提交的生成继续在后台执行,完成后会落成资源卡。删除占位卡也只影响展示,不取消后台任务。
预览是永久的吗?
不是。本地预览由当前客户端进程启动,端口和进程随客户端退出失效。重新打开项目后需要重新运行。预览状态不会写入项目清单。
导出和发布是一回事吗?
不是。
- 导出:生成某个平台的产物,例如陶泥儿包、Windows 包、APK、单网页、TapTap 包。
- 发布:把产物上传到陶泥儿或第三方平台,并完成审核/上架。
陶泥工坊可以打包;部分平台还能让陶泥儿在授权后上传;审核和平台后台操作仍可能需要你完成。
能在多台电脑上用同一个账号吗?
可以登录同一个账号,但本地项目目录默认只在本机。项目是否能在另一台机器继续,取决于你是否复制了完整项目文件夹,以及相关云端快照是否可用。
不要把同一个项目目录同时挂到两台正在运行的客户端上编辑。两个进程可能同时写清单、布局和会话文件。
支持哪些客户端系统?
以官方下载页当前提供的安装包为准。当前官方客户端支持 Windows 和 macOS;Android 导出目标生成的是可安装 APK,不等同于陶泥工坊客户端本身支持 Android。
可以同时打开多个项目吗?
正式客户端以单窗口切换项目为主。不要在同一个客户端里期待两个项目并排编辑;需要对比时,先保存并切换项目,或复制项目后用另一个受控环境打开。
项目组里的“移除”会删除文件吗?
不会。它只从最近项目列表移除。要删除项目,请在文件管理器里删除整个项目文件夹,并先确认没有预览、生成或导出任务在使用它。
为什么工程里会出现 .agent、.export、node_modules?
.agent:项目身份、资源清单、会话和本地 Agent 数据。.export:导出表单、导出素材暂存和打包产物。node_modules:项目依赖,预览和构建需要。
这些目录不一定都要提交到 Git。依赖和构建产物通常应忽略;.agent 是否提交取决于你是否需要保留项目身份和对话历史。
可以把项目发给别人吗?
可以,但先确认里面有没有不想公开的内容:
.agent可能包含对话历史、项目路径和资源清单。.export可能包含发布草稿、封面、截图和产物。- 项目源码和素材本身会随文件夹一起发出。
- 开启共创并上传工程时,整个工程可能对他人可见。
发之前建议复制一份,删除 .agent 中的私人会话、.export 草稿和本地依赖,再做一次干净打包。
为什么导入项目后提示布局变化?
客户端会记录项目的工程根和运行方式。目录结构变化、换了入口文件,或从别的机器复制过来时,记录可能不再匹配。按当前目录重新识别即可;确认后只更新 .agent 配置,不会改工程源码。