跳到主要内容

常见问题

本页解决:第一次使用陶泥工坊时最常见的概念和边界问题。具体故障步骤见故障排查。

陶泥工坊、陶泥儿和 Genarrative 是什么关系?​

  • 陶泥工坊:桌面客户端,用来创建和管理游戏项目、与 Agent 协作、生成资源、预览和导出。
  • 陶泥儿:客户端里的 AI 创作助手人格,也是平台账号与主站品牌使用的名字。
  • Genarrative:平台与产品体系名称。网页端还提供图片画布、作品广场、账号与钱包等能力。

客户端里的对话对象叫陶泥儿,但安装、更新和反馈时使用“陶泥工坊”这个名字。

需要联网吗?​

需要。以下能力依赖网络:

  • 登录、钱包、会员和邀请。
  • 与陶泥儿的模型回合。
  • 图片、音频、3D 等生成。
  • 云存档、发布、平台素材库和更新检查。

本地项目文件、已下载素材和本地预览在断网时仍可能打开,但依赖安装、模型和上传会失败。

项目保存在哪里?​

项目保存在你新建时选择的目录,或设置里配置的「项目创建目录」。每个项目是一个独立文件夹。

项目里的 .agent 保存项目身份、资源清单、会话历史和本地 Agent 数据。复制项目时建议整个文件夹一起复制;只复制源码会丢失项目身份和对话上下文。

关闭客户端会丢东西吗?​

已经保存的项目文件和资源不会因为关闭客户端而消失。以下内容可能丢失或需要重新开始:

  • 尚未提交的生成草稿。
  • 尚未保存的 UI 编辑器改动。
  • 正在运行的本地预览。
  • 尚未发送的对话草稿(取决于会话是否已保存)。

已提交的生成任务通常在重启后可以从任务或恢复队列继续查看;不要因为关闭窗口就重复提交。

陶泥儿会直接改我的代码吗?​

会。在项目工作台里,陶泥儿可以在当前项目目录内读取、创建和修改文件,也可以运行项目自己的构建和验证命令。具体能做什么受当前操作权限、项目范围和客户端安全边界限制。

建议:

  • 重要项目先用 Git 或复制目录做备份。
  • 不要在项目里放密钥、Cookie、私钥或与创作无关的敏感文件。
  • 大改前先提交一次版本,或让陶泥儿先写计划。

为什么有时生成前要确认,有时直接扣费?​

看对话栏右上角的「操作权限」:

  • 需要审批:Agent 发起的付费生成先弹确认。
  • 不需要审批:Agent 可以直接提交。

这是当前客户端的全局偏好,跨项目生效,不是单项目或单次授权。你自己在生成面板里主动点生成会直接提交,不再单独弹出这条付费确认;金额以服务端扣费结果为准。

生成失败了,泥点会退吗?​

资产操作确认失败或调用异常时,已扣泥点会自动进入服务端退款队列,客户端不会在本地自行退款或补扣。退款到账后,账单里会出现「泥点消耗退款」或「资产操作退回」记录。遇到失败:

  1. 先看生成任务侧栏和账单。
  2. 不要立刻重复提交同一请求。
  3. 如果提示“结果未知”或“需要核对”,扣费会先保留,等任务终态和对账结果确认是否退款;不要重复提交。
  4. 账单长时间没有退款记录时,带任务信息、扣费时间和账单截图联系反馈。

切换会话会中断正在运行的回合吗?​

不会。会话列表切换只改变当前查看的会话,正在运行的回合继续在原来的会话里执行。你可以稍后切回去看结果。

关闭生成面板会取消任务吗?​

不会。关闭面板只是收起界面。已提交的生成继续在后台执行,完成后会落成资源卡。删除占位卡也只影响展示,不取消后台任务。

预览是永久的吗?​

不是。本地预览由当前客户端进程启动,端口和进程随客户端退出失效。重新打开项目后需要重新运行。预览状态不会写入项目清单。

导出和发布是一回事吗?​

不是。

  • 导出:生成某个平台的产物,例如陶泥儿包、Windows 包、APK、单网页、TapTap 包。
  • 发布:把产物上传到陶泥儿或第三方平台,并完成审核/上架。

陶泥工坊可以打包;部分平台还能让陶泥儿在授权后上传;审核和平台后台操作仍可能需要你完成。

能在多台电脑上用同一个账号吗?​

可以登录同一个账号,但本地项目目录默认只在本机。项目是否能在另一台机器继续,取决于你是否复制了完整项目文件夹,以及相关云端快照是否可用。

不要把同一个项目目录同时挂到两台正在运行的客户端上编辑。两个进程可能同时写清单、布局和会话文件。

支持哪些客户端系统?​

以官方下载页当前提供的安装包为准。当前官方客户端支持 Windows 和 macOS;Android 导出目标生成的是可安装 APK,不等同于陶泥工坊客户端本身支持 Android。

可以同时打开多个项目吗?​

正式客户端以单窗口切换项目为主。不要在同一个客户端里期待两个项目并排编辑;需要对比时,先保存并切换项目,或复制项目后用另一个受控环境打开。

项目组里的“移除”会删除文件吗?​

不会。它只从最近项目列表移除。要删除项目,请在文件管理器里删除整个项目文件夹,并先确认没有预览、生成或导出任务在使用它。

为什么工程里会出现 .agent、.export、node_modules?​

  • .agent:项目身份、资源清单、会话和本地 Agent 数据。
  • .export:导出表单、导出素材暂存和打包产物。
  • node_modules:项目依赖,预览和构建需要。

这些目录不一定都要提交到 Git。依赖和构建产物通常应忽略;.agent 是否提交取决于你是否需要保留项目身份和对话历史。

可以把项目发给别人吗?​

可以,但先确认里面有没有不想公开的内容:

  • .agent 可能包含对话历史、项目路径和资源清单。
  • .export 可能包含发布草稿、封面、截图和产物。
  • 项目源码和素材本身会随文件夹一起发出。
  • 开启共创并上传工程时,整个工程可能对他人可见。

发之前建议复制一份,删除 .agent 中的私人会话、.export 草稿和本地依赖,再做一次干净打包。

为什么导入项目后提示布局变化?​

客户端会记录项目的工程根和运行方式。目录结构变化、换了入口文件,或从别的机器复制过来时,记录可能不再匹配。按当前目录重新识别即可;确认后只更新 .agent 配置,不会改工程源码。

相关页面​