遇到问题
查看部署要求、额度共享、Agent 支持和协作者名额，并按当前状态处理常见使用问题。
先确认卡住的是登录、运行环境、模型、任务、预览还是发布。同一个操作出现“已保存”“已受理”或“结果待确认”时，仍需查看该流程的最终结果。
部署需要什么配置？
推荐 1 核 CPU、2 GB 内存，内存不能低于 2 GB。当前安装要求 Linux x86_64、systemd，以及 root 或免密 sudo 权限。
SSH 部署还需要可访问的公网 IP、用户名和私钥，服务器需允许通过 22 端口连接。连接云账号时，需要所选厂商的实例查询和部署权限。
完整步骤见安装部署。
额度如何共享？
在 Hosted 共享运行环境中，协作者保留各自的登录身份，模型调用使用运行环境所有者的模型额度。同一环境里的 App 和对话共享该环境所使用的额度，不会因邀请成员自动为每个人新增一份模型额度。
打开设置 → 用量查看当前登录账户的模型账本。环境所有者可以查看自己账户对应的消耗；协作者不能把自己的用量页当作所有者的完整余额页。
| 使用情况 | 消耗归属与查看方式 |
|---|---|
| Hosted 中自己执行任务 | 消耗该运行环境所有者的模型额度。 |
| Hosted 中协作者执行任务 | 仍消耗运行环境所有者的模型额度。 |
| Hosted 自动化执行 | 使用目标运行环境所有者的模型额度。 |
| 自建 Node 使用自行配置的模型服务 | 用量按该模型服务的账户或 Key 统计，不计入 MargoWork 的 Hosted 用量页。 |
用量页区分订阅积分与永久赠送积分。额度加载失败、尚未返回数据与剩余为零是不同状态；先重试读取，再判断是否耗尽。
协作者遇到环境额度不足时，联系运行环境所有者处理。共享额度不等于每个成员拥有独立配额或可以查看其他成员的账单。详见用量查看。
支持哪些 Agent？
当前接入 Codex、Pi、Claude。实际可选项由当前运行环境提供；环境或 Agent 暂不可用时，列表可能不可选。
更多 Agent 正在逐步适配，后续关注发布计划。不同 Agent 的模型、附件和执行中追加输入能力可能不同，具体操作见Agent 使用。
可以邀请多少协作者？
每个账户可邀请 5 位协作者，需要更多名额时可通过 Team 入口了解升级方案。
当前 Free 与 Solo 均提供 5 位协作成员；升级 Solo 本身不会增加协作者名额。套餐以账户页展示的权益为准。邀请和成员管理见协作共创。
登录不了，或者接受邀请时提示账户不匹配？
先确认登录方式和邮箱是否属于同一个账户。密码错误、验证码过期与登录状态失效应按页面提示分别处理，完整步骤见登录与账户。
协作邀请发送给特定邮箱。接受邀请时，需要登录受邀邮箱对应的账户，并完成所需的邮箱验证。已登录其他账户时，切换到受邀账户后再打开原邀请；邀请失效或已撤销时，请邀请方重新发送。
服务器连接失败，或者一直等待连接？
先看当前安装记录，不立即新增另一台 Server：
- **等待服务器连接：**查看当前部署任务的安装进度，使用页面提供的操作确认结果。
- **SSH 登录失败：**核对用户名和私钥；需要 sudo 时确认免密权限。
- **SSH 连接超时：**核对公网 IP、22 端口、防火墙和服务器运行状态。
- **云实例加载失败：**核对云账号凭据与查询权限，重试当前查询；空列表还需检查所选云产品。
- **连接中断、结果待确认：**刷新或重试确认原安装任务，等待明确结果。
- **已确认失败：**按具体错误修正条件，再使用当前页面提供的重试入口。
Server 已准备就绪但没有模型时，继续配置 AI 服务；服务器连接与模型可用是两个独立检查。详见安装状态。
云账号 AccessKey、SSH 凭据和模型 API Key 有什么区别？
| 凭据 | 填写位置与用途 |
|---|---|
| 云账号 AccessKey / SecretId 等 | 云账号部署表单，用于查询目标实例并执行部署。 |
| SSH 私钥 | SSH 部署表单，用于登录目标服务器。 |
| 模型 API Key 或支持的 OAuth | 当前 Node 的模型服务配置，用于调用模型。 |
| 网站变量 / Secret | App 的网站配置，用于应用本身访问外部服务。 |
| Cloudflare 发布连接 | App 的发布目标选择，用于发布网站。 |
把正确的凭据放在对应配置入口。网站业务 Secret 不等于 Cloudflare 发布授权；安装成功也不代表模型已经授权。具体操作见安装部署、模型配置和网站配置。
发出消息后没有结果，或者显示失败，怎么办？
先确认原消息是否已经出现在对话中，再判断任务状态。输入框清空、请求已提交和 Agent 已完成任务不能互相替代。
- **连接中或历史尚未加载：**等待连接恢复并查看原对话，确认是否已经收到请求。
- **明确发送失败：**按页面提供的重试入口处理；重试前确认原请求未在另一处继续执行。
- **模型不可用或凭据失效：**打开当前 Node 的模型服务配置，完成授权或测试，再回到任务。
- **额度不足：**按额度共享说明确认消耗归属；协作者需要联系环境所有者。
- **无权执行：**确认 App 角色和当前对话权限；查看者不能直接发起任务。
- **任务已停止：**查看停止前的回复和文件，再明确下一步修改要求；停止不会自动回滚已完成的操作。
向支持人员反馈时，提供当前 Node / App、时间、错误原文与操作步骤。不要重复发送同一条会修改文件或外部数据的请求来判断是否恢复。
应用列表为空，或找不到创建 App 的入口，怎么办？
应用制作需要先进入可编辑的 App。可以打开你已有的 App，或通过受邀账户接受 App 协作邀请后进入。
如果当前账户没有可用 App，且界面没有提供新建入口，就无法从这个界面完成新建。保留当前页面与版本信息，反馈具体入口问题；不要把新建普通 Chats 对话当作已经创建了 App。
已有可编辑 App 时，按应用制作流程继续。应用列表中的“编辑”用于修改已有应用信息，不代表创建一个新应用。
应用已经生成，为什么预览仍打不开？
生成文件和预览准备完成是两个步骤。预览可能仍在启动，或者应用构建、启动、文件入口存在错误。
- 确认仍在正确的 Node 和 App 中。
- 查看预览当前提示以及 Agent 的处理结果。
- 如果启动失败，在原 App 对话提供错误，要求修正后重新打开预览。
- 页面已显示但内容不对时，刷新预览并检查主要交互。
- 数据接口在预览中失败时，确认应用使用的开发配置；生产网站 Secret 不会自动注入开发预览。
预览可打开不代表已经对外发布。需要分享正式网站时，继续发布流程。
发布失败，或线上网站没有最新修改，怎么办？
先区分以下情况：
| 当前情况 | 下一步 |
|---|---|
| 看不到网站配置或发布入口 | 确认自己是 App 所有者；协作编辑权限不等于发布权限。 |
| 没有可用 Cloudflare 连接或账号 | 检查当前环境中的连接和授权，再设置发布目标。 |
| 缺少必需网站配置 | 在网站配置中补齐对应值，再发布。 |
| 正在发布 | 等待当前发布完成。 |
| 结果待确认 | 先读取或重试确认当前结果，不立即发起另一轮发布。 |
| 明确发布失败 | 查看错误，修正应用构建、配置或连接问题后重新发布。 |
| 线上仍能打开旧内容 | 确认本次发布是否成功；旧链接仍可访问不能证明最新修改已上线。 |
网站代码修改、变量修改和 Secret 修改都需要成功发布后才作用于正式网站。开发预览与线上网站是不同状态，详见发布状态与更新网站。
自动化保存了，为什么还没有结果？
创建并启用保存任务并启用计划，不等于已经成功执行。先核对时间、时区、启用状态和运行环境，再查看运行记录 → 查看对话。
- 还未到执行时间时，可以按权限使用立即运行检查一次。
- 有未保存修改时，先保存，再手动运行。
- 运行记录没有“查看对话”时，当前记录尚未提供可打开的对话；不能把它当作已经有成功结果。
- 单次任务时间已过期时，通过重设并启用设置新的时间。
- 要更换创建时确定的 Node、App 或 Agent，使用复制新建建立新任务。
- 任务已运行但内容不符合预期时，检查实际运行对话，再调整任务说明、输入文件和模型。
完整案例和停用方式见自动化创建。
MCP 或 Skills 配置后，为什么任务还不能使用？
确认当前 Node 与配置时一致，并检查资源本身的状态。MCP 需要外部账户授权时，保存连接信息与完成账户授权是不同步骤；返回授权页面完成后，再检查连接结果。
Skills 的可用来源与使用入口取决于当前运行环境和 Agent。需要某项能力时，在任务中明确说明；不要把资源名称出现在列表中当作外部服务已经连接成功。
按Agent 使用中的 MCP / Skills 流程处理，连接失败时保留服务名称和错误信息，不提供 Token 或私钥。
升级后仍显示旧版本，或者结果待确认，怎么办？
先刷新服务器详情中的版本和原升级任务状态。页面查询失败时，不把空版本当作已更新；显示结果待确认时，也不直接当作失败重新部署。
只有当前版本更新，并且服务器恢复可用，才能确认升级完成。明确失败且提供重试入口时，按原任务提示处理。步骤见升级维护。
反馈问题时提供什么？
提供操作时间、当前 Node / App、具体步骤、期望结果、实际提示和不含隐私的截图。区分“已经尝试”“请求已受理”“结果待确认”“明确成功或失败”，能让问题更快定位。
密码、验证码、API Key、AccessKey Secret、私钥不放进公开反馈。