# 常见问题与排查

从现象找到最短检查路径，并提供可复现的反馈。

更新于: 2026-10-16
Desktop 0.5.0-rc.53 · Web 0.5.0-rc.36
Canonical: https://ai.z-group.cn/docs/zh/troubleshooting/

## AI 没有回复怎么办？
先看是否等待批准，再看执行电脑在线状态和模型连接。用不含附件的简单问题测试；失败时记录错误类型，不公开密钥。异常回合可停止，但停止不撤销已完成操作。
## 为什么有项目却打不开文件？
先确认文件属于哪台电脑。云端或远程镜像里的路径不等于本机路径；核对实际执行端、目录存在性和文件权限。
## 知识上传成功，为什么搜索不到？
上传、解析、草稿审查和正式知识是不同阶段。检查是否解析失败、仍在草稿箱或选错知识库，再尝试短关键词和材料编号。
## 同账号为什么内容不同？
核对是否选择同一执行电脑、工作区和会话。不同电脑的同名项目不会自动合并；同步范围也可能不同。
## 定时任务没运行怎么办？
检查启用开关、时区、规则、执行端运行状态、模型和运行记录。电脑休眠或退出应用时不能假定任务继续执行或自动补跑。
## 手机没有批准卡片或通知怎么办？
批准卡片需要原会话真实待批准且电脑在线；通知还依赖系统权限与推送服务。先查看会话，不要仅依据通知判断。
## 如何提供有效反馈？
```text
软件版本与操作系统：
使用方式：桌面 / 云端网页 / 远程 / Android
执行端与工作区：使用非敏感简称
操作步骤：
预期结果：
实际结果与错误提示：
是否稳定复现：
```
截图隐藏账号、密钥、私有文件路径与客户内容。保留错误时间和时区，便于对照运行记录。

## 连接数据源后提示上下文或输出额度不足？
先核对实际执行电脑已更新到 rc.50 或以上。大量外部工具会按需查找和调用，避免一次性装入全部工具说明；这不扩大模型本身的上下文上限。数据源激活后会自动接续当前任务并保留权限与计划；点击停止会取消尚未执行的自动接续。若仍提示上下文不足，请减少单次输入、过大的工具结果或切换支持更长上下文的模型。此类错误不等同于网络断开。

## 提示思考耗尽额度、未生成正文
这表示服务端报告 length，且本次只产生思考，没有正文或工具调用；不能仅凭这一提示认定历史或工具占满上下文。先查看是否正在恢复；一次恢复仍失败或接口能力未知时，在[模型能力与预算](../settings/)核实输出能力、请求上限与支持的推理档位。正文截断会保留已生成内容；工具参数截断不会执行不完整调用。停止不会撤销此前已经成功的工具操作。

## ECS 在线版打开较慢
区分登录页、连接执行端和加载会话三个阶段。首次打开或升级后需要重新下载界面；弱网下可能比已缓存的再次打开慢。rc.52 缩减首屏图标资源，图表引擎在显示图表时加载，等待期间保留图表位置；新版执行端会在会话列表中一次返回权限状态，避免逐条等待。旧执行端仍走兼容核对。不要反复刷新或新建重复会话；连接错误可使用页面重试，反馈时提供非敏感的版本、耗时、会话数量和是否首次打开，不发送聊天正文。

## 桌面在线模型提示账号连接中断或离线宽限期
从 rc.53 起，短暂账号心跳失败不会阻止仍有效的登录凭据请求在线模型。网络恢复后可直接重试对话，或在设置 → 账号点击“同步模型策略”；后台也会逐步重试账号校验，持续失败时最多间隔五分钟。登录凭据过期时需要先联网续期；授权已撤销或账号停用时需要重新登录或联系管理员。本地项目、知识库和自行配置的本地模型继续可用。账号连接错误与模型响应超时不同；仅某个模型变慢时，反馈模型名称、错误时间和是否长对话，不提供聊天正文或密钥。