启动失败

如果 Aichat 无法正常打开，或提示本地后端没有启动，可以按本页顺序排查。

提示安装不完整

如果看到类似“安装不完整”“缺少必要的本地资源”“local backend 无法启动”的提示，通常表示客户端缺少本地后端资源，或系统阻止了本地组件运行。

建议处理：

1. 完全退出 Aichat。
2. 重新打开客户端。
3. 如果仍失败，从官方入口重新下载安装最新版。
4. 检查系统安全软件或杀毒软件是否隔离了客户端文件。
5. 确认安装包没有被移动、拆分或手动删除内部文件。

提示本地后端没有正常启动

Aichat 的部分能力依赖本地后端。它负责本地会话、Agent 运行、技能和工作区相关能力。

如果本地后端没有启动，可能会影响：

1. 对话创建。
2. Agent 启动。
3. 技能加载。
4. 本地工作区任务。

建议先重启客户端，再检查是否需要更新。

提示数据库初始化或迁移失败

如果看到 database migration、database init、BOOTSTRAP 等错误，说明本地数据初始化过程失败。

建议处理：

1. 重启客户端。
2. 检查磁盘空间是否充足。
3. 检查系统是否阻止应用写入本地数据目录。
4. 更新到最新版。
5. 如果仍失败，联系提供方，不要随意删除本地数据目录。

什么时候联系提供方

这些情况建议直接联系提供方：

1. 重装最新版后仍提示安装不完整。
2. 每次启动都出现本地后端错误。
3. 数据库初始化一直失败。
4. 安全软件反复隔离客户端组件。
5. 提示信息里有你无法判断的错误码。

反馈时附上系统版本、客户端版本、错误截图、发生时间和你已经尝试过的步骤。