跳到主要内容
ZeroWorks

常见问题

快速排查无法发送、模型失败、工具未就绪、新来源接入、任务中断,以及内容保存位置等常见问题。

为什么还不能发送第一条消息?

发送按钮不可用,通常是会话前置条件还没齐:模型连接、工作区、权限模式或附件。逐项确认后即可发出。

  1. 确认已经完成引导设置:至少配好一个模型连接,并选好默认模型。
  2. 为新对话选择工作区、权限模式与模型。
  3. 检查附件是否上传完成,按页面提示补齐缺少的内容后再发送。

模型已配置,为什么仍然失败?

保存配置只说明设置已被接受。实际调用还需要有效凭据、正确的模型标识、可用额度和正常服务连接。

  1. 核对当前会话选择的模型与服务商,阅读具体错误提示。
  2. 检查凭据、模型标识与服务连通性;模型列表是手工配置的,需要自己确认写对了。
  3. 先发送一条简短文字请求,再逐步加入文件、工具或更复杂的任务。
提示词示例

请回复“连接成功”,暂时不要使用工具。

为什么找不到技能或来源工具?

  • 技能:确认技能目录下的 SKILL.md 存在、名称正确,并且当前项目能够发现它,再输入 / 查找。
  • 来源:确认来源已在当前工作区里配置并启用,并且已经成功发现工具;“已配置”还不代表可使用。
  • 权限:不同权限模式开放的工具不同,Explore 模式之外的写入类工具需要先放开权限。
  • 授权:GitHub、Linear 等服务只提供当前凭据权限范围内的工具和数据。

如何接入新的数据来源?

接入新来源就是为它写一份配置:来源是工作区里的一个目录加一份 config.json,声明它的类型、地址与认证方式,写好之后回到对话中确认工具真的可用。

  1. 在侧栏“数据源”中选择添加来源,或请 Agent 按来源指南在当前工作区创建 config.json;先确认目标服务与认证方式。
  2. 按来源类型补齐配置:本地进程用 stdio,远程服务用 Streamable HTTP 或 SSE,并填写地址与请求头。
  3. 按来源配置选择 oauth、bearer 或 none,通过专用表单保存凭据。OAuth 在应用中完成授权;能否自动续期取决于服务端是否提供有效刷新令牌。
  4. 执行状态检查,确认已经发现工具后,再回到对话里先发一条只读请求试用。

我的内容和任务保留在哪里?

  • 对话:在当前工作台的历史列表中继续;归档或分叉不会复制项目文件。
  • 项目文件:位于运行工作台的环境中,需要时另行下载或导出。
  • 页面与技能:和工作区在一起,删掉工作区目录就会一起消失。
  • 任务:Tasks 的任务定义、运行日志与节点结果持久保存在工作区,可从记录恢复;普通后台命令不能因此跨重启存活。定时自动化需要主机和进程保持开启。
  • 记忆:通过记忆来源(MCP)保存,按会话和工作区归纳,跨会话保留的是结论而不是完整过程。

任务为什么没有继续跑?

  • 工作台进程退出或重启:普通后台命令会停止。Tasks 可读取持久日志恢复运行,先核对已完成节点及重试目标;定时自动化依赖主机和进程在线。
  • 等待确认:任务卡在需要批准的步骤上时,没有人点击确认就不会继续。
  • 上下文被压缩:会话过长时前面的内容会被整理成摘要,需要的信息可能已经不在原文里。
  • 模型或额度问题:调用失败、额度不足或服务商异常都会中断当前步骤。
  • 环境变化:目录被移动、依赖被删除或凭据过期,也会让后续命令无法执行。

能否离线使用?

每一步推理都需要可访问的模型。云端模型需要网络;已安装并完成验证的本地模型可在本机离线推理,但依赖外部网页、来源或远端模型的操作仍需要网络。断网时也可以浏览已保存的会话与本机文件。

模型与来源密钥通过专用凭据表单保存;代理 URL 中的认证信息属于普通配置文件的例外,详见配置参考。离线前先用实际任务验证本地模型的工具与上下文能力。

  1. 需要连续处理任务时,先确认网络可用,并留出额度。
  2. 需要离线推理时,提前安装并验证本地模型连接,准备所需依赖和文件;权限模式仍按任务需要选择。
  3. 需要留存结果时,在断网前完成导出。

读到这里,回到你的第一项任务。

把目标、资料与期望成果写清楚,按快速开始准备模型与工作区。执行之后,对照资料检查结果,再决定下一步。