先做这三件事
- 看报错卡片：对话里的失败卡片会写明原因和建议。点开可以看到原始的技术细节。卡片上的重试图标（提示「用同样的问题重新调用模型」）可以原样再试一次。
- 试着发「继续」：很多中途停下的情况，已生成的内容和工具结果都保留着，发一句「继续」它就接着做。
- 收集信息：还解决不了的话，打开关于对话框点「复制诊断信息」，再到 设置 › 基础环境 › 环境监测 点「导出诊断包…」。日志位置见 数据与备份 › 日志。
模型调用失败
| 卡片标题 | 原因与处理 |
|---|
| 还没有配置大模型… | 还没接入任何模型平台，见 快速开始。 |
| API Key 被拒绝 | 密钥错了或过期了。到模型设置里重新填密钥，点「检测」确认。 |
| 没有访问该模型的权限 | 这个密钥所在的账号没开通这个模型。去平台开通，或换一个模型。 |
| 请求被服务端拒绝 | 常见原因：模型 ID 写错、参数不被支持、输入超出上限。核对模型 ID 是否和平台文档完全一致。 |
| 模型配置有误，无法发起调用 | 检查接口地址、模型名称和凭据。 |
| 触发服务端限流 | 调用太频繁或额度用完，稍后再试。 |
| 服务端返回错误 / 模型服务不可用 | 平台那边的问题，稍后重试一般会恢复。 |
| 无法连接到模型服务 | 检查网络、代理和接口地址。本机模型要确认服务已启动。 |
| 模型没有返回任何内容 | 重试，或者换个问法。 |
| 模型调用超时 | 重试，或在平台的「高级设置…」里调大请求超时（最长 300 秒）。 |
想看发给模型的完整请求，打开 模型调用日志，再复现一次。排查完记得关掉。
「模型运行进程」相关的错误
每次调用模型，EasyAI Work 都会启动一个独立的运行进程。报错标题里带「模型运行进程」的，都是这个进程出了问题：
- 启动超时 / 启动即退出 / 无法启动：多半是安装不完整，或者运行环境缺东西。卡片详情里是这个进程自己的报错。重启应用后仍然出现的话，重新安装一遍。
- 版本不匹配：主程序和运行进程不是同一次安装的，通常是升级没装完整。重新安装即可。
- 意外退出 / 连接中断 / 通信异常：先重试。经常出现的话，看一下内存是否吃紧（状态栏有内存条），或者提交诊断信息给我们。
运行中途停下
| 提示 | 原因与处理 |
|---|
| 下一次模型调用将超出模型上下文窗口 | 对话太长了。已生成的内容都在，发「继续」，下次调用前会先自动压缩。 |
| 模型拒绝了请求：上下文超出窗口 | 一次发的内容太多。开一个新任务、缩短输入，或换一个窗口更大的模型。也可以检查模型设置里的「上下文窗口」是否填对了。 |
| 本次运行达到推理轮数上限 | 单次运行的轮数到顶了，发「继续」接着做。 |
| 触发了工具调用次数 / 输出字符数 / 时长的失控保护 | 这是防止无限循环的保护，不是配置项。确认智能体没在原地打转后，发「继续」。时长上限是 24 小时。 |
| 用户已取消本次运行 / 在应用关闭时被中断 | 不算失败，已生成的内容保留。重新发送或发「继续」。 |
遇到「本次运行超出预算上限」或「累计 Token 超出上限」时，已生成的内容都保留着，同样发「继续」即可。
功能用不上
| 现象 | 原因与处理 |
|---|
| 绑了技能或连接器，智能体却不用 | 模型可能不支持工具调用（编辑器会提示）。换一个标了「工具」能力的模型。 |
| 发了图片，模型说看不到 | 模型没标「视觉」能力，只收到了文件路径。如果它官方支持看图，在模型设置里给它勾上「视觉」；否则换一个视觉模型。 |
| 「这些技能没有通过完整性校验」 | 技能文件在安装后被改过。到技能页重新安装，见 技能 › 完整性校验。 |
| 智能体没有联网搜索 | 还没启用任何搜索引擎，见 联网搜索。 |
| 连接器「需授权」或「需重新登录授权」 | 打开 ＋ › 连接器，点「连接」；或在连接器卡片上点「登录授权…」。 |
| 连接器卡片显示「需要 uv / Node」 | 本机缺运行时。在 设置 › 基础环境 › 运行时环境 点「安装缺失项」。 |
| 「此系统暂不支持安全凭证存储」 | 系统没有可用的凭据库，保存不了令牌。只在 macOS 和 Windows 上支持。 |
| 审批卡片一直没出现，任务卡在「等待审批」 | 看看别的任务页或手机渠道上是不是有待处理的卡片；审批 10 分钟没人处理会失效，这一步不执行。 |
启动与数据
| 现象 | 处理 |
|---|
| macOS 提示「无法打开」「无法验证开发者」 | 第一次要在「应用程序」里右键 → 打开，见 安装。 |
| 「EasyAI Work 无法打开你的数据」 | 数据被更新的版本用过，或升级数据格式失败。可以装回较新的版本，或者在对话框里选一份备份「恢复所选备份」。数据本身没有被改动，而且已经留了一份副本。 |
| 界面是英文 | 默认语言跟随系统的首选语言。到 设置 › 通用设置 › 常规 › 界面语言 改成中文。 |
| 窗口关了程序还在 | 这是正常的：关窗口只是收到托盘或菜单栏里，见 关闭窗口与托盘。 |
| 换电脑后模型都用不了 | 密钥不在备份里，要重新输入，见 从备份恢复。 |
在线更新失败
| 提示 | 处理 |
|---|
| 无法连接更新服务器 / 下载未完成 | 检查网络后重试。 |
| 更新源签名无效 / 安装包校验失败 | 没有安装任何东西。重试；反复出现的话，到官网下载安装包手动安装。 |
| 磁盘剩余空间不足 | 清理磁盘，或在关于对话框里点「清理已下载的安装包」。 |
| 无法备份你的数据，已取消本次更新 | 更新前必须先备份成功。检查磁盘空间后重试。 |
| 更新未完成 | 当前仍是旧版本，可以再试一次，或手动运行安装包。点「查看日志」看 update.log。 |