---
title: "常见问题"
description: "使用中可能遇到的问题及处理办法。"
lang: zh
---

遇到问题时，可以先对照下面几种常见情况。

## 端口被占用，无法启动

- 确认是否已经有另一个 Bi 正在运行
- 确认系统防火墙是否放行
- 在设置中把端口更换为其他值

## 界面打开了，但显示的是旧版本

浏览器可能缓存了旧页面，强制刷新一次即可：

- Windows：`Ctrl + Shift + R`
- macOS：`Command + Shift + R`

## 中文显示乱码

终端面板中的输出通常不会乱码。如果在 Windows 控制台直接运行命令时出现乱码，多与系统的字符编码设置有关。

## 智能体一直停在等待确认

默认情况下，每一次操作都需要你的确认。如果一直没有看到确认提示，请检查设置中是否关闭了确认机制，或者该操作已被拦截规则拒绝。

## 模型报错或连接失败

- 检查设置中的服务地址、密钥和模型名是否填写正确
- 如果某个模型暂时不可用，可以改用其他模型
- 使用自动选择时，某个模型不可用会自动尝试其他可用的模型

## 会话不见了

会话保存在本机。请不要删除程序目录下的 `.bi` 目录。如果会话已被删除，目前无法恢复；建议对重要的会话及时导出为 Markdown 备份，见[会话](/docs/using-bi/sessions)。

## 磁盘占用变大

检查点会随着会话逐渐积累，占用一定空间。不再需要时，可以在产物面板中清理旧的检查点，见[检查点与回退](/docs/advanced/checkpoints)。

## 仍然无法解决

请先记录以下信息，便于排查：

- 出问题时的现象
- 复现的步骤
- 你当时的操作

寻求帮助时请一并提供这些信息，并注意不要附带模型密钥。