故障排查

按问题类型查找对应的提示和解决方法。如果仍无法解决，请反馈给我们。

安装与启动

现象	解决方法
macOS 提示无法验证开发者	确认安装包来自官网，在 系统设置 → 隐私与安全性 中选择「仍要打开」
Windows 安装时卡住	首次安装可能需要下载 WebView2 组件，请保持联网
「小一智能体未能启动」	点击「重新加载」；仍然失败时，退出后重新打开
「暂时无法打开工作台」	点击「重新连接」
「退出前保存未完成，应用仍在运行」	检查是否有任务仍在执行，等待完成或停止后再退出

登录

提示	解决方法
登录已超时，请重新登录	在浏览器中停留过久，回到小一点击「重新打开登录页」
登录失败，请检查网络后重试	检查网络连接，确认可以打开 platform.z1x-ai.com
登录会话已过期 / 已结束，请重新登录	点击「重新登录」，本地数据不受影响
账户工作区连接已失效，请重新登录	重新登录即可恢复
无法访问系统安全凭据存储	小一需要使用系统钥匙串（macOS）或凭据管理器（Windows）保存登录凭据，请在系统弹窗中允许访问
浏览器登录后没有跳回小一	确认小一仍在运行；在浏览器提示「打开小一智能体」时选择允许

运行环境

状态	解决方法
运行环境准备失败	检查网络后，在 设置 → 版本与运行环境 中重试
运行环境需要更新	按提示更新
运行环境需要修复	点击「修复运行环境」

如果反复失败：展开 高级诊断 → 环境诊断，点击「检查运行环境」，再点击「复制诊断信息」，将内容反馈给我们。

网络

提示	说明
无法连接服务，请检查网络后重试	检查网络，或关闭可能拦截连接的代理 / 防火墙
网络连接中断，正在进行第 N 次重连…	小一会自动重连，一般无需操作
网络仍未恢复，任务继续执行并将自动重连	任务不会丢失，网络恢复后自动继续
模型连接出现波动，正在恢复输出…	自动恢复中，请稍候
消息未送达，原消息已保留	点击「重试发送」

积分与额度

提示	解决方法
本月额度不足，无法完成本次任务	等待提示中的重置时间，或使用独立积分
剩余积分不足，无法完成本次任务	在云平台开通套餐，见套餐与积分

额度恢复后，回到原任务点击「继续」即可接着做。

任务执行

提示	解决方法
所选模型不可用，请选择其他模型后重试	在模型选择中换一个模型
当前任务选择的模型已下架或不可用	从模型列表重新选择后再发送
模型目录暂不可用	检查网络后重试
所选模型不支持当前图片输入	换一个支持图片的模型，或移除图片
当前内容较多……请减少部分内容后重试	减少附件或拆分任务；也可以使用 /compact 或开启新任务
请求过于频繁，请稍后重试	稍等片刻后重试
当前运行中的任务过多	等待其他任务完成后重试
当前任务正在执行中，请等待本轮结束后再提交	等待本轮结束，或直接发送消息排队
附件上传失败	检查文件是否超过 500 MB，或移除后重新添加
你没有执行此操作的权限	确认登录的账户是否正确
当前账户已停用	请联系我们

文件与预览

现象	解决方法
此文件暂不支持在线预览	下载原文件用本地软件查看
找不到生成的文件	在工作区中切换到「全部」并点击刷新；或在项目设置中「打开所在文件夹」
知识库构建中断	退出应用会暂停构建，重新打开后点击「继续构建」

收集日志

反馈问题时，附上日志可以帮助我们更快定位原因。日志位于：

日志	位置
应用运行日志	~/.z1x/users/<账户 ID>/v3/logs/desktop/runtime.log
启动日志	~/.z1x/logs/desktop/
运行环境安装日志	~/.z1x/logs/environment/

Windows 中 ~ 表示 C:\Users\<用户名>。「复制诊断信息」的内容中已包含运行环境日志的路径。