【报Bug】uni-agent

欢迎到专业群（ uni-agent技术交流群 ） 咨询，群中有相关专业的管理员和群友。

好的，非常理解您在使用 uni-agent 时突然卡住、长时间无法响应所带来的焦虑和不便。根据您描述的现象（写到一半卡住、重启HBuilderX无效、重装uni-agent无效、切换网络和模型均无效），这通常不是网络问题，而是与 uni-agent 服务进程的状态或本地通信有关。

结合知识库信息，为您提供以下排查思路和解决方案：

1. 核心排查方向：本地防火墙或代理软件拦截

uni-agent 在运行时会启动本地服务进程，HBuilderX 需要通过特定端口（如 4096）与它通信。如果防火墙或代理软件拦截了这个本地连接，就会导致界面卡死，无法响应。

• 暂时关闭防火墙：请先尝试暂时关闭您的系统防火墙，然后重启 HBuilderX 再试一次。
• 配置防火墙规则：如果关闭防火墙后恢复正常，说明是防火墙拦截了端口。您可以参考知识库中的详细步骤，为 uni-agent 的通信端口（如 4096）添加入站规则，放行连接。具体操作可参考文档：报错：fetch failed 排查步骤。
• 检查代理/VPN：如果您开启了代理或VPN软件，请将 127.0.0.1、localhost、::1 这几个本地地址加入代理的白名单或设置为直连，然后重启HBuilderX重试。

2. 辅助排查：检查项目上下文

uni-agent 提供“同时处理多个项目”的功能，有时卡住可能与项目上下文切换有关。

• 确认项目上下文：请确保 uni-agent 聊天窗口上方选择的是您当前正在操作的项目。
• 尝试在新窗体中打开：您可以尝试在项目上右键，选择【在新窗体中打开】，然后在新窗体中打开 uni-agent 聊天视图，开启一个新对话，看看是否恢复正常。具体操作可参考文档：同时处理多个项目的任务。

3. 其他尝试

如果以上方法都无效，可以尝试：

• 开启新会话：在 uni-agent 聊天视图中，点击“开启新聊天”，避免当前会话的上下文导致卡死。
• 检查版本：确保您使用的 HBuilderX 和 uni-agent 插件都是最新版本。您可以在插件市场查看 uni-agent 的更新日志，确认是否有修复类似问题的版本。

如果问题依然存在，可以进入官方交流群寻求更直接的技术支持。