读完你能：按现象完成常见故障自查，收集必要信息并找到下一步支持入口。
- 重启应用。
- 在 设置 → 必要配置 点击检测令牌。
- 检查网络、代理、防火墙和本地端口。
- 在 设置 → 关于 检查更新。
- 在 设置 → 系统 → 日志目录 查看当前目录，点击该字段右侧的文件夹按钮定位或选择目录；再收集日志并记录版本、系统和复现步骤。
以下每个场景先做表格中的检查，再按步骤操作。
| 现象 | 先检查 |
|---|
| 启动画面卡住、白屏或主窗口无响应 | 任务管理器中是否还有 AIPC UP 进程，日志是否有启动错误 |
- 退出残留的 AIPC UP 进程后重新启动。
- 确认工作目录和日志目录存在且当前用户可访问。
- 若日志指向 GPU 或渲染问题，更新显卡驱动并尝试关闭硬件加速。
- 仍无法启动时，记录错误文本并提交诊断报告。
| 现象 | 先检查 |
|---|
| “检测令牌”失败、令牌无效或无法连接慧AI服务 | 令牌是否完整，网络是否能访问慧AI服务 |
- 在 设置 → 必要配置 重新粘贴令牌，去掉首尾空格。
- 确认令牌未被撤销且账号资源仍可用。
- 检查代理、防火墙和系统时间。
- 保存后再次点击“检测令牌”。
| 现象 | 先检查 |
|---|
| 401、鉴权失败、超时或发送消息后没有响应 | 当前模型、API Key、Base URL 和服务商状态 |
- 在 设置 → 模型 确认选中了预期模型。
- 重新检查 Key、Base URL 和模型名称，不要把慧AI令牌当作模型 API Key。
- 查看服务商额度、区域限制和网络代理。
- 用最短消息重试，并记录响应状态码。
| 现象 | 先检查 |
|---|
| Agent 无法运行、提示未登录或启动失败 | 必要配置状态和修复页提示 |
- 完成登录并在必要配置页重新检测令牌。
- 打开 Agent 的修复页，按页面提示补齐运行依赖。
- 关闭并重新打开当前会话。
- 若提示本地数据迁移或安装不完整，更新或重新安装最新版并保留日志。
| 现象 | 先检查 |
|---|
| 点击麦克风没有转写或提示未配置 | 麦克风权限、慧AI令牌和网络 |
- 在系统隐私设置中允许 AIPC UP 使用麦克风。
- 在必要配置页检测令牌并确认语音资源可用。
- 关闭占用麦克风的其他应用后重试。
- 检查网络和输入设备，记录识别服务的错误信息。
| 现象 | 先检查 |
|---|
| 点击悬浮窗入口后看不到窗口 | 其他显示器边缘、任务栏和窗口是否在屏幕外 |
- 检查任务栏附近和其他显示器边缘。
- 使用应用提供的悬浮窗入口再次切换显示状态。
- 断开外接显示器后重启应用。
- 仍无窗口时记录显示器布局和应用版本。
| 现象 | 先检查 |
|---|
| 文件管理器显示只读提示，无法写入 | 当前目录权限、文件系统挂载状态和 Git 工作区状态 |
- 确认目录仍存在且当前账号有写权限。
- 检查磁盘是否已满，以及目录是否被系统以只读方式挂载。
- 在文件管理器中切换到可写目录验证范围。
- 需要修改时，先在操作系统文件管理器中确认权限，再重开项目。
| 现象 | 先检查 |
|---|
| 浏览器自动化无法连接 Chrome | Chrome 是否开启远程调试，调试端口是否可访问 |
- 打开 Chrome，在地址栏访问
chrome://inspect/#remote-debugging。
- 按 Chrome 页面提示开启远程调试，并确认目标页面已打开。
- 检查 AIPC UP 的浏览器自动化配置和端口没有被其他程序占用。
- 重新运行连接检测，再用一个低风险动作验证。
| 现象 | 先检查 |
|---|
Windows 桌面键鼠自动化提示 client.exe 未运行 | client.exe 是否存在并运行，相关本地端口是否可用 |
- 确认系统为 Windows，并检查辅助程序是否被安全软件隔离。
- 在任务管理器确认
client.exe 正在运行。
- 检查本地服务端口没有被其他程序占用。
- 重启应用后再次运行低风险诊断。
| 现象 | 先检查 |
|---|
| 局域网或公网 WebUI 打不开 | 端口、防火墙、公网隧道状态和远程配额 |
- 局域网访问时确认设备在同一网络，并检查默认端口
25808。
- 在防火墙中允许应用的本地端口通信。
- 公网访问时重新关闭并开启隧道，确认公网配额未用尽。
- 不要把公网链接公开；仍失败时记录网络环境和错误页面。
| 现象 | 先检查 |
|---|
| 机器人已配置但平台没有收到或回复消息 | 配对审批、凭证有效期和平台机器人权限 |
- 在通讯平台设置中确认凭证没有过期，并重新保存配置。
- 检查待处理的配对请求并完成审批。
- 确认机器人在目标群组或会话中具有发送消息权限。
- 发送一条短消息测试，并查看网关日志。
| 现象 | 先检查 |
|---|
| 检查、下载或安装更新失败 | 网络、磁盘空间、应用进程和安装日志 |
- 重试检查并确认代理或防火墙没有拦截更新服务器。
- 关闭应用和占用安装目录的进程后重试。
- 查看日志，记录版本、错误文本和失败阶段。
- 从官网下载安装包，手动覆盖安装后再次检查版本。
日志默认位置随系统和安装方式而变。请在 设置 → 系统 → 日志目录 使用界面显示的当前目录；点击右侧文件夹按钮可定位或选择日志目录，变更后按提示重启应用。收集所需日志后，可在 设置 → 关于 → 反馈问题 使用反馈入口。诊断事件和日志报告是否发送取决于发行版配置与触发条件；提交前检查内容。仍无法解决时，前往联系与支持。
