故障排查

先收集信息，再对号入座，避免盲目重装。

反馈前这 5 项

1. 版本号（关于页或安装包）
2. Windows
3. 现象 + 步骤
4. 报错原文（弹窗、401、日志）
5. 是否代理 / 杀软 / 公司网

日志位置（Windows 打包版）

%APPDATA%\AIPC UP\logs\desktop-startup.log

在资源管理器地址栏粘贴上述路径的上一级也可进入。附日志时打码令牌与 API Key。

---

窗口打不开 / 闪退

1. 是否从完整安装路径启动
2. 托盘退出后，任务管理器结束残留进程再开
3. 端口 3008 / 5123 是否被占用
4. 杀软是否隔离安装目录
5. 查看启动日志中的 ERROR
6. 覆盖安装同版本或上一稳定版

卡在注册 / 登录

• 用户名过短、密码过短、两次密码不一致
• 未勾选协议
• 本地账号 ≠ 慧AI 账号：本地账号用于远程访问登录；慧AI 登录令牌在 设置 → 必要配置 里填

见 安装与启动、远程访问。

能打开但不能对话

1. 设置 → 必要配置 是否完成
2. 慧AI：令牌是否 保存 → 检查连接 通过
3. 自定义：Key完整；Base URL格式符合服务要求和当前输入框说明
4. 额度是否用尽
5. 代理是否拦截慧AI 或你的 Base URL
6. 新建会话再试

助手一直「未就绪」/「启动中」

1. 检查连接是否已成功
2. 保存配置后等 10–30 秒，点状态刷新
3. 杀软是否拦截相关进程
4. 仍失败：看启动日志，附状态截图反馈

见 AI 助手与模型。

模型列表空 / 选不了模型

• 设置 → 模型配置 是否已加载
• 必要配置是否通过
• 自定义模式 Key 是否有效

能聊不能读项目文件

• 是否选对项目根
• 工具/权限是否允许读文件
• 会话是否绑错工作区

浏览器自动化

现象	处理
令牌/资源包	必要配置检查
扩展未连接	重启 Chrome 与 AIPC UP
无工具	MCP 未开或桥未启动

见 浏览器自动化。

桌面自动化

• 令牌 + 桌面资源包
• Windows防火墙、应用控制或UAC是否拦截
• 多屏 DPI 导致点击偏移
• UAC 提权窗口可能点不到

见 桌面自动化。

远程 / 通讯平台

远程访问：令牌与流量、是否在远程访问页启动、本机是否睡眠退出。

通讯平台：不依赖慧AI 令牌；查 设置 → 通讯平台 服务与白名单。

端口占用

服务	默认
工作台	3008
远程协作相关	5123

用资源监视器或 netstat 找占用进程；结束冲突或按版本说明改端口。

任务 / 插件异常

• 任务标签不出现：TaskMaster CLI 是否安装；设置 → 任务 是否启用；是否重启
• 插件安装失败：网络、仓库地址、本机 Git；只装信任源
• 见 任务与 PRD、插件

场景对照

场景	优先看
刚装完	安装路径、本地账号（远程登录用）、杀软、日志
换电脑	重新配令牌/Key
升级后工具没了	智能体/MCP 是否重新启用
只有语音不行	令牌、语音资源包、麦克风权限
只有远程不行	本机保活、隧道、鉴权
任务/插件	上一节

仍无法解决

整理五元组 + 打码日志 → 联系与反馈
说明：是否必现、是否新装、是否刚升级。