Renderbus云渲染农场-AI驱动的新一代云渲染平台
首页案例关于我们
注册
注册领渲染券
Renderbus云渲染农场-AI驱动的新一代云渲染平台
首页案例关于我们帮助/教程登录
请问有什么可以帮助您?
可以在这里输入您遇到的问题
Pixmax Renderer for Maya 帮助文档rft 使用帮助:排错与常见问题
问题反馈?
在使用过程中,遇到问题或有其他建议,都可以跟我们沟通哦~
在线沟通
Chat now with support
帮助中心AI渲染
rft 使用帮助:排错与常见问题

rft 使用帮助:排错与常见问题

1. 先记住四句话

  1. 你不需要学命令行。 说清目标(哪个场景、哪个项目、大概什么配置),Agent 负责执行。
  2. 涉及花钱或删除的操作,先看计划再确认。 Agent 应该先给你预览,不要随口说“直接提交”“不用确认”。
  3. 出错先把完整报错交给 Agent,不要自己反复重试、重复提交、删文件。 很多“越修越乱”都是重复操作造成的。
  4. Agent 按本文排查后仍解决不了,找在线客服。 不要自己重装、改系统设置或删数据目录;先保留现场。

一句话:你负责判断“要不要做”,Agent 负责“怎么做”,客服负责“账号、费用和云端异常”。

2. Renderbus CLI 是什么

Renderbus CLI 是 Renderbus 云渲染的命令行工具与 MCP Server。它把 分析场景 → 设置参数 → 上传资产 → 提交渲染 → 查询任务/帧 → 下载结果 串成无 UI、可脚本化、可被 AI Agent 直接调用的流程。

可以把它理解成云渲染的“遥控器”:你在 Agent 里用自然语言提需求,Agent 调用 Renderbus CLI 去操作云端。

2.1 它和 Renderbus 云渲染是什么关系

先说结论:Renderbus 云渲染是云端平台;Renderbus CLI 是装在电脑上的客户端。

名字 是什么 你可以怎么理解
Renderbus 云渲染 真正干活的云端平台 “渲染工厂”
Renderbus CLI 官方提供的“电脑端客户端”,用输入文字指令的方式操作 “工厂的遥控器”

所以:Renderbus CLI 就是操作 Renderbus 云端的那台“遥控器”,不是云端本身。

2.2 它和 Agent、云端怎么配合

你(说目标)
  ↓
AI Agent(听懂、拆步骤、调用 Renderbus CLI)
  ↓
Renderbus CLI(负责操作云端)
  ↓
Renderbus 云端(分析、上传、提交、渲染、下载)

2.3 那些技术词是什么意思

词 通俗解释
命令行 / CLI 用“输入文字指令”来操作软件的方式,像在黑色窗口里打字,而不是点按钮。由 Agent 用,你不需要学。
MCP AI 助手和 Renderbus CLI 之间的“通用插头”。有了它,Agent 可以直接调用 Renderbus CLI,不用模拟人敲键盘。你不需要配置。
后台服务 / daemon Renderbus CLI 的“后台小工”,负责上传、下载、分析等长任务;你关掉窗口它还在干活。电脑重启后可能需要叫醒,让 Agent 处理。
skills 给 Agent 看的“操作说明书”,告诉它遇到什么情况该怎么用 Renderbus CLI。
Agent 你平时用的 AI 助手(Cursor、Claude Code、Codex、WorkBuddy、DSH 等),负责听懂需求并调用 Renderbus CLI。

你日常只需要接触“Agent”和“云端页面”;命令行、MCP、daemon、skills 都是它们内部的分工,不需要你操作。

2.4 它能帮你做什么、不能替你做什么

它能帮你做 它不能替你做什么
分析场景、检查参数 替你做艺术判断(用哪个相机、哪版贴图)
上传场景和贴图 替你付费、替你授权、替你点“同意”
提交渲染、查任务、下载结果 保证云端任务一定成功(还取决于资产、配置、平台状态)
克隆已有作业、改参数重跑 修复制作软件本身的崩溃或工程错误
查失败帧、重提失败帧 绕过账号权限、余额或平台维护

3. 第一次使用

只需要三步,具体操作都交给 Agent:

步骤 你要做什么 注意
① 安装 Renderbus CLI 让 Agent 帮你安装;或打开网页安装页按提示安装 不要手动改环境变量、不要装到系统目录
② 登录 Agent 会给你一个浏览器链接,你本人登录并确认授权 链接一次性,不要转发;不要把密码/验证码给 Agent
③ 连接 Agent 让 Agent 完成接入;装完重启 Agent 客户端 WorkBuddy 还需要在「连接器」里点一次“信任”

如果本机还没有 Agent:先让 IT/同事帮你装一个(Cursor / Claude Code / Codex / WorkBuddy / DSH 均可),不要自己照着命令敲。

可以直接对 Agent 说:

请帮我安装并连接 Renderbus CLI,装完告诉我需要重启哪个客户端。
请帮我检查 Renderbus CLI 是否可用:登录状态、后台服务、传输组件是否正常。

登录时请记住:

  • 走浏览器登录时,必须由你本人确认授权;Agent 不能替你点“同意”。
  • 登录链接是一次性的,过期就重新生成;不要发到群里或发给别人。
  • 不要把密码、短信验证码、登录令牌(token)、授权链接发给任何人,包括 Agent 和客服。

4. 怎么让 Agent 帮你

4.1 说清四件事

  1. 目标:提交、查状态、下载、重跑、克隆。
  2. 对象:场景文件路径 / 任务号 / 项目名。
  3. 约束:软件配置、内存、帧范围、输出目录。
  4. 边界:先预览、不要提交、不要删除、不要花钱。

4.2 可以直接照着说

你想做什么 对 Agent 说
提交场景 “帮我用 Renderbus CLI 提交 D:\shot\a.ma,软件配置用 Maya2024,内存 64G;先预览,不要真提交。”
确认后提交 “预览没问题,按这个计划提交;提交前再复述一次项目和费用相关参数。”
查任务 “帮我查任务 <任务号> 现在什么状态,有没有失败帧。”
下载结果 “把任务 <任务号> 的结果下载到 D:\out,先告诉我文件数和大小。”
只重跑失败帧 “看任务 <任务号> 的失败帧,先解释原因,再给重提计划,不要直接重提。”
克隆 “把任务 <任务号> 克隆一份,帧范围改成 1-120,先预览改了哪些参数。”
排查问题 “这是完整报错:<粘贴>。请先诊断原因和下一步,不要直接重试。”
给客服摘要 “请生成一份给在线客服的诊断摘要,包含账号、任务号、时间、错误码和已尝试操作,不要包含密码/token。”

4.3 三句万能话术

请先只做预览,不要提交、不要删除、不要产生费用。
请解释这个报错的原因和下一步,不要直接重试。
请把结论写成我能看懂的步骤,并告诉我哪些操作需要我确认。

4.4 不要对 Agent 说

  • “不用确认,直接提交。”(可能占作业号并按机时计费)
  • “重试到成功为止。”(可能重复上传、重复提交)
  • “把数据目录删了重装。”(可能丢历史、凭据和断点)
  • “把我的密码/验证码拿去登录。”(凭据不应交给任何自动化工具)

5. 出问题时的固定处理顺序

第 1 步:先停

  • 不要反复点提交、不要重复下载、不要连续重试。
  • 不要删除本地文件、不要删数据目录、不要重装。
  • 不要关闭正在上传/下载的窗口或电脑。

第 2 步:留证据

把下面几样收好,后面 Agent 和客服都需要:

  • Agent 最后一段完整回复(整段复制,不要只截一句)。
  • 错误码(如 E_TIMEOUT)或 traceId(如果有)。
  • 出问题的任务号(任务列表里的数字 ID)。
  • 发生时间、场景文件名、软件和版本。
  • 截图(如果界面有红色报错)。

第 3 步:让 Agent 诊断

这是完整报错:<粘贴>。
请先判断是登录、网络、后台服务、传输组件、账号权限还是云端任务的问题;
告诉我下一步怎么做,不要直接重试。

第 4 步:按建议做

常见动作只有几类:

  • 重新登录(你本人在浏览器确认)。
  • 让 Agent 启动或重启后台服务。
  • 换一个下载目录 / 确认磁盘空间。
  • 等 10~30 分钟再查(云端排队或平台波动)。
  • 让 Agent 只重试失败的那一部分。

第 5 步:还不行,找在线客服

把第 2 步的证据和第 8 节的清单一起发给客服。不要自己先重装或删数据,否则现场就没了。

6. 常见问题速查

你看到的现象 可能原因 你可以怎么做 要找客服吗
提示“未登录”或登录过期 登录态失效 让 Agent 重新发起登录,你本人在浏览器确认 账号异常、反复掉线时找
登录链接打不开 / 已过期 链接一次性、浏览器拦截 让 Agent 重新生成;换浏览器;不要转发 持续打不开时找
提示“后台服务未启动”“连接失败” 后台服务没运行,或电脑重启过 让 Agent 启动/重启后台服务;不要手动结束 Renderbus CLI 进程 反复失败时找
上传一直 0% 或很慢 网络、线路、文件太大 让 Agent 看进度和线路;暂停再继续;换网络 超过 30 分钟无进度找
上传完成,但任务没开始 只上传了文件,还没提交渲染 让 Agent 确认是否已提交 已提交但长时间不开始找
下载下来 0 个文件 过滤条件、文件已存在、云端输出被清理 让 Agent 先浏览云端文件清单 云端确实没有输出时找
任务一直“等待中”/“渲染中”不动 排队、资源不足、任务卡住 让 Agent 查任务状态和帧日志;等 30 分钟 超过 30 分钟无变化找
有失败帧 资产缺失、参数不对、节点报错 让 Agent 看失败帧日志,修好后只重提失败帧 反复失败时找
分析失败 / 配置不匹配 软件配置版本不对,或本机没装对应的制作软件(Maya / 3ds Max 等) 让 Agent 查软件配置并给方案;确认场景版本 云端没有该版本配置时找客服/管理员
提示没有传输引擎 传输组件缺失或被禁用 让 Agent 修复/安装传输组件 安装失败时找
提示余额不足 / 无权限 / 账号锁定 账号或费用问题 让 Agent 读错误说明;准备账号信息 是
提示平台关闭 / 区服不对 平台维护,或登录区服与任务不一致 让 Agent 查可用区服 平台长期关闭时找
磁盘空间不足 本地空间不够 清理磁盘或换下载目录 不会清理时找 IT/客服
网络超时 / 请求过多 网络波动、短时间请求太多 等几分钟,让 Agent 重试一次 持续出现时找
Agent 找不到 Renderbus CLI / 工具不可用 没装好,或客户端没重启 重启 Agent 客户端;让 Agent 自检/重装 仍不行时找
电脑重启后作业不见了 后台服务未恢复,或作业中断 让 Agent 查作业状态并重试 云端任务丢失时找
不小心重复提交了 多次确认/重试 立即停止,让 Agent 列出任务;联系客服说明 是(可能重复计费)
收到可疑登录链接/索要验证码 钓鱼或冒充 不要点、不要给验证码;从官方入口联系客服 是

看到这些错误码,先知道大概方向

错误码 大概意思 先做什么
E_UNAUTHENTICATED 没登录 / 登录过期 让 Agent 重新发起登录
E_DAEMON_UNREACHABLE 后台服务没启动 让 Agent 启动/重启后台服务
E_ENGINE_MISSING 传输组件没装 让 Agent 修复传输组件
E_TIMEOUT / E_NETWORK 网络慢或超时 等几分钟重试一次
E_RATE_LIMITED 请求太频繁,被限流 等几分钟再试
E_PARTIAL 部分成功、部分失败 让 Agent 看失败明细,只重试失败部分
E_BALANCE_NOT_ENOUGH 余额不足 充值或联系客服
E_PERMISSION_DENIED 没有权限 核对账号/主子账号授权,找客服
E_CONFLICT 状态冲突,可能已提交过 先让 Agent 查现有任务,不要重复提交
E_PLATFORM_CLOSED 平台关闭/维护 换区服或等平台开放

记不住错误码没关系,把完整报错复制给 Agent 就行;它会翻译成下一步。

7. 什么时候找在线客服

出现以下情况,不要再自己反复尝试,直接找在线客服:

  1. 账号问题:登录失败、异地验证、实名认证、主子账号、权限、账号被锁。
  2. 费用问题:余额、扣费、重复扣费、退款、发票、合同。
  3. 云端任务异常:长时间无进度、状态卡住、任务消失、输出文件丢失或损坏。
  4. 平台/区服异常:平台长期关闭、区服不可用、换区后任务异常。
  5. 资产问题:上传后云端找不到、资产转移卡住、输出不完整。
  6. 安全问题:凭据泄露、异常登录、收到可疑链接或索要验证码。
  7. Agent 按本文排查后仍无法解决,或 Agent 建议“联系客服/管理员”。
  8. 需要人工确认的商务、赔偿、特殊权限开通。

顺序很重要:先保留现场,再找客服。不要先重装、删数据、改系统设置,否则客服很难定位。

8. 联系客服前准备什么

8.1 信息清单

信息 在哪找
账号(手机/邮箱) 你自己知道
品牌 / 区服 Agent 可以告诉你;或登录页/任务页显示
任务号(数字 ID,如有) 任务列表;让 Agent 查
发生时间 大概到分钟即可
场景软件和版本 例如 Maya 2024、3ds Max 2025
完整报错 整段复制 Agent 的回复,或截图
错误码 / traceId 报错里带 E_... 或 traceId 的那一行
已经尝试过什么 例如“重新登录过”“重启过后台服务”
是否影响交付 紧急程度、最晚什么时候要

8.2 可以直接复制给客服

账号:
品牌/区服:
任务号(如有):
发生时间:
场景软件及版本:
完整报错(文字或截图):
错误码 / traceId(如有):
已经尝试过:
是否影响交付 / 紧急程度:

8.3 安全提醒

  • 不要发送密码、短信验证码、登录 token、一次性授权链接。
  • 截图前注意遮住与问题无关的客户名、项目名、本地路径。
  • 只从官方入口联系客服;不要相信私聊里发来的“客服链接”。

9. FAQ

Q1:我需要学命令行吗?

不需要。你只需要把目标说清楚;命令由 Agent 执行。本文提到的命令只是给 Agent 看的,你不用背。

Q2:Agent 说“请先登录”,为什么它不能替我登录?

登录需要你本人在浏览器里确认授权,Agent 不能替你点“同意”。它只能帮你发起登录、把链接给你。不要为了省事把密码或验证码交给 Agent。

Q3:Agent 让我确认,我能直接同意吗?

先看它复述的内容:项目、场景、帧范围、内存/机型、输出目录、大概费用。确认无误再同意;不确定就让它解释。提交会占作业号并按机时计费。

Q4:为什么每次都要先“预览”?

预览不提交、不花钱,只给你看“将要传哪些文件、提交什么参数、下到哪里”。确认预览后再执行,能避免大部分误操作。

Q5:上传/下载要另外收费吗?

渲染费用主要按机时计算;上传/下载是否产生流量或存储费用,以平台计费规则为准。涉及费用的问题直接问在线客服,不要让 Agent 猜。

Q6:提交后能取消吗?会退钱吗?

可以尝试“停止/放弃”,但已经消耗的机时通常无法退回。具体退费规则以平台为准,找客服确认。

Q7:任务卡住多久算异常?

先看是否有进度变化。超过 30 分钟没有任何变化,让 Agent 查状态和日志;仍无进展就找客服,不要反复重提。

Q8:我能同时提交多个任务吗?

可以,但要注意本机网络、上传带宽和账号并发限制。让 Agent 分批提交并跟踪,不要一次性全点。

Q9:换电脑/重装后历史还在吗?

历史、凭据和作业记录默认在本机数据目录里;换电脑不会自动同步。让 Agent 先备份/迁移,再重装。不要直接删数据目录。

Q10:能把任务转给别人吗?

云端任务的归属和授权由平台控制,不是复制一个任务号就行。需要共享或转移时找客服/管理员。

Q11:Agent 和客服说法不一致,听谁的?

账号、费用、权限、云端状态以客服/平台为准;本机操作和参数以 Agent 为准。把双方说法都保留,别自行猜测。

Q12:文档里的命令我需要执行吗?

不需要。本文的命令是给 Agent 查的。你只需要用自然语言说目标,或把报错复制给 Agent。

Q13:出问题后可以自己重装 Renderbus CLI 吗?

先不要。重装可能丢掉本地凭据、历史、断点和现场。先让 Agent 诊断;确实需要重装时,让 Agent 先备份数据目录。

Q14:怎么判断 Agent 做得对不对?

看三点:① 它有没有先预览;② 它复述的项目/任务号/帧范围/路径对不对;③ 它有没有在花钱或删除前让你确认。三者都满足,基本可以放心。

Q15:客服需要我提供什么?

按第 8 节的清单准备。最重要的是:任务号、发生时间、完整报错、错误码/traceId、已经尝试过什么。

10. 一页纸术语表

词 通俗解释
Agent 你平时用的 AI 助手,负责理解需求并调用工具
Renderbus CLI 云渲染的“遥控器”,Agent 通过它操作云端
CLI 命令行界面;由 Agent 使用,你不需要手敲
MCP Agent 连接 Renderbus CLI 的一种标准接口
后台服务 / daemon 本机常驻进程,负责上传、下载、分析等长任务
任务号 / task_id 云端渲染任务的数字 ID,找客服最常用
作业号 / job_id 本地后台服务的作业 ID,用于查上传/下载进度
区服 / 平台 云端资源池,例如 CPU 3 区、GPU 区
软件配置 云端的一套“软件 + 版本 + 插件”组合,分析前要匹配
分析 读取场景,生成可提交的参数和资产清单
提交 把任务正式发给云端渲染;会占作业号并计费
资产 场景、贴图、缓存等需要上传的文件
输出 渲染完成的图片/序列帧
登录令牌 / token 登录后系统发放的凭证,等同于密码,不能外发
traceId 一次操作的追踪编号,排查时很有用
预览 / dry-run 只展示计划,不真正执行、不花钱
传输引擎 负责上传/下载的组件;缺失时只能预览不能传

11. 需要更多细节

普通用户看到这里就够了。需要深入时,把下面两份文档交给 Agent,而不是自己读:

维护约定:如果常见问题、客服边界或错误码解释发生变化,同步更新本文件;命令细节变化更新 CLI_REFERENCE.md 与对应 docs/skills/<skill>/SKILL.md。

问题反馈?
在使用过程中,遇到问题或有其他建议,都可以跟我们沟通哦~
在线沟通
Chat now with support
  • 2424
    24小时全国服务热线
    400-003-4560
  • wechat