最常见的原因是agent.exe未真正运行，需通过任务管理器“详细信息”页搜索确认进程是否存在，并用sc query WorkBuddyAgent检查服务状态是否为RUNNING；若失败，需排查服务注册路径、防火墙拦截、DNS解析异常或WinHTTP代理冲突。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy Agent 进程没起来，但系统没报错
Windows 下 WorkBuddy 无法连接，最常见的原因是 agent.exe 没有真正运行——它可能启动后几秒就静默退出，任务管理器里看不到，服务列表里也查不到。这不是网络问题，是进程托管失效。
检查方法：打开任务管理器 → 切换到「详细信息」页签 → 搜索 agent.exe；若无结果，说明进程未存活。
- 先确认是否已按官方方式注册为服务：执行
sc query WorkBuddyAgent，返回STATE: 4 RUNNING才算正常；若为STOPPED或报1060错误，说明服务未创建成功或路径错误 - 手动启动失败时，别直接双击
agent.exe——它不是 GUI 程序，必须以服务方式或带--daemon参数运行（但 Windows 不推荐后者） - 注册服务时
binPath=值里不能有空格未转义，例如"C:\Program Files\WorkBuddy\agent.exe"必须写成"\"C:\Program Files\WorkBuddy\agent.exe\""，否则sc create会 silently 截断路径
防火墙/杀软拦截了 agent.exe 的出站连接
WorkBuddy Agent 默认使用 HTTPS 连接 workbuddy.codebuddy.cn，但 Windows Defender 防火墙或第三方安全软件可能把它当成未知程序，默认阻止出站流量，且不弹提示。
现象是：ping workbuddy.qq.com 能通，nslookup workbuddy.codebuddy.cn 也能解析，但 Agent 日志卡在 “connecting to gateway…” 无后续。
- 临时关闭 Windows Defender 防火墙测试：执行
netsh advfirewall set allprofiles state off，再启动服务看是否恢复（测试完记得开回来） - 更稳妥做法：在「高级安全 Windows Defender 防火墙」中新建出站规则，针对
C:\Program Files\WorkBuddy\agent.exe允许所有连接 - 某些国产杀软（如 360、腾讯电脑管家）会深度 hook 网络调用，即使加了白名单也可能拦截；可尝试右键杀软图标 → 「退出防护」再试
DNS 解析异常导致 agent 连不上认证网关
WorkBuddy 登录流程依赖多个域名：前端页面走 workbuddy.qq.com，后端通信走 workbuddy.codebuddy.cn，飞书集成还涉及 open.feishu.cn。任一环节 DNS 解析失败，都会表现为“无法连接”，但错误日志里往往只显示超时，不提 DNS。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
典型表现：nslookup workbuddy.codebuddy.cn 返回 *** Can't find workbuddy.codebuddy.cn: No response from server，而其他域名正常。
- 优先换 DNS 测试：执行
netsh interface ip set dns "以太网" static 119.29.29.29（换成腾讯 DNS），再试nslookup - 若仅
codebuddy.cn域名解析失败，可能是本地 hosts 被污染，检查C:\Windows\System32\drivers\etc\hosts是否有该域名的错误映射行 - 注意：
ipconfig /flushdns对这种系统级 DNS 缓存无效，需配合netsh interface ip delete arpcache清 ARP 表，并重启 WorkBuddy 服务
代理设置冲突让 agent 绕不过企业网络策略
很多企业环境强制启用系统级 HTTP 代理（比如通过组策略下发 PAC 文件），而 WorkBuddy Agent 并不读取 Windows 的 IE 代理设置，也不会自动走系统代理——它会直连，结果被网关丢弃。
现象是：浏览器能登录 WorkBuddy 网页版，但桌面客户端/Agent 始终连不上；抓包发现 agent.exe 发出的 TLS 握手包根本没发出，或发出去后无响应。
- 检查当前代理状态：执行
netsh winhttp show proxy，若返回非Direct access (no proxy server)，说明 WinHTTP 层有代理配置，而 agent 正是基于 WinHTTP 实现的 - 临时清除代理：执行
netsh winhttp reset proxy，然后sc stop WorkBuddyAgent & sc start WorkBuddyAgent - 若企业策略不允许清除代理，需联系 IT 部门将
*codebuddy.cn和*feishu.cn加入代理豁免列表（Bypass list）
WorkBuddy 在 Windows 上的连接问题，90% 都卡在「进程没活下来」或「连出去的第一步就被拦住」。DNS 和代理这两项最容易被忽略——因为它们不影响浏览器，却足以让后台 agent 彻底失联。调试时别急着改配置，先用 sc query 和 netsh winhttp show proxy 看清真实状态。
