故障排除

启动、AI 连接、工作区、性能与日志路径。

故障排除

按现象自助排查。仍无法解决时，携带版本号联系客服。也可先查 常见问题。

启动异常

打不开或闪退

  1. 确认满足 系统要求。
  2. 以管理员身份运行，或从 产品页 重装最新版。
  3. 如需提供日志（请先脱敏），常见位置：
    • Windows：%APPDATA%\ZF-AI\logs\
    • macOS：~/Library/Logs/ZF-AI/
    • Linux：~/.config/ZF-AI/logs/

启动偏慢

  1. 减少开机自动加载的扩展与多余项目（MCP · 工作区）。
  2. 设置 → 启动选项 关闭非必要项（设置中心）。
  3. 确认磁盘空间充足。

AI 无法使用

连接失败

  1. 检查网络、代理、防火墙。
  2. 按 配置 AI 模型 · 测连 重新测试。
  3. 确认套餐类型与密钥匹配。
  4. 换另一个已配置服务商验证。
  5. 仍失败：记录报错原文与版本号（帮助 → 关于）。

回答不理想

  1. 把需求写具体，并附上文件或选中内容（给助手足够上下文）。
  2. 换更适合任务的模型（见 配置 AI 模型 中的“模型选型建议”）。
  3. 清空过长历史（AI → 清空对话历史）。
  4. 关闭无关文件；复杂任务改用 Workflow 或先在 Ask 中拆清任务。
  5. 检查 Skills / Rules 是否互相冲突或过严。

助手执行操作失败

  1. 目标文件是否被占用、磁盘是否已满。
  2. 设置 → 工具权限 是否已授权。
  3. Agent 场景下是否在变更对比中误点拒绝。
  4. 见 Agent 操作建议。

变更对比不出现或不生效

  1. 确认当前模式为 Agent（或 Workflow 中含改文件步骤）。
  2. 工具权限是否允许写文件。
  3. 刷新或重开 AI 面板后再试。
  4. 用更小的单文件改动验证流程是否正常。

工作区异常

文件列表为空或不全

  1. 路径与读取权限是否正确。
  2. 右键 刷新。
  3. 忽略规则是否过宽（工作区 · 忽略）。

无法新建 / 删除 / 重命名

  1. 文件是否被其他程序占用。
  2. 是否有写入权限、磁盘是否充足。
  3. 必要时以管理员身份运行。

自动任务

多会话或多项目切换后内容对不上

  1. 确认当前工作区和当前会话是否选对。
  2. 手动刷新会话历史或重新打开会话。
  3. 必要时重新登录后再试。

定时任务没有触发

  1. 检查 Cron 表达式是否正确。
  2. 确认任务是否处于启用状态。
  3. 确认绑定会话 ID 是否有效。
  4. 到 会话与自动任务 对照触发任务配置。

Inbox 任务到了但执行失败

  1. 确认模型是否可用。
  2. 确认目标会话存在且状态正常。
  3. 查看错误提示后重跑。
  4. 如是自动化链路，先缩小为最简单提示词验证。

MCP 扩展异常

  1. 总开关是否开启；单项是否启用。
  2. 状态旁错误提示（浏览器未安装、权限不足等）。
  3. 关闭其他冲突扩展后重连。
  4. 回到 MCP 扩展 重新检查启停、连接和刷新工具步骤。

扩展与插件

  1. AI 设置 → 扩展 中是否已启用。
  2. 插件根目录是否设对，点 刷新。
  3. 检查 是否仍有错误；存在错误时无法发布。
  4. 发布后开新会话再调用工具。
  5. 预览 UI 失败时，核对 views.json 入口与 ui/ 文件是否已保存。
  6. 详见 扩展与插件开发、插件编辑器。

运行卡顿

  1. 关闭不用的工作区与大文件预览。
  2. 设置 → 外观 降低动画（见 设置中心 的外观设置说明）。
  3. 关闭本机其他高占用程序。

联系客服时请提供

  1. 版本号（帮助 → 关于）
  2. 复现步骤与期望结果
  3. 必要日志片段（已脱敏）
  4. 相关截图（可选）

官网入口：产品页 · 文档中心 · 套餐与价格

相关链接