codebuddy 可自动诊断微服务接口异常根因：先验证 cli 是否安装，再捕获带 -v 的 curl 输出，提交后执行其返回的首条验证命令（如 netstat、lsof 或 ss），精准定位服务未启动、端口占用、防火墙拦截或路由配置错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当微服务接口在终端调用时返回异常响应（如 curl 显示 Connection refused、timeout、空响应或非预期状态码），且本地服务日志无报错、端口看似正常，需快速定位是网络层、服务进程、环境变量还是配置加载问题——CodeBuddy 可基于终端上下文自动识别异常模式并给出可执行的验证路径。
确认终端是否已接入 CodeBuddy CLI
打开任意项目目录下的终端，执行：
codebuddy --version
若返回类似 codebuddy 3.2.1 的版本号，说明 CLI 已就绪；若提示“command not found”，则跳过后续所有步骤，先完成安装。
这一步操作起来很简单，直接把文件拖进去就行。
捕获当前终端异常现场
在复现接口异常的同一终端窗口中，立即执行以下命令：
curl -v http://localhost:8080/health 2>&1 | head -n 50
将完整输出（含请求头、响应头、错误行）复制下来。注意：不要截屏，必须复制纯文本；【不带 -v 参数的 curl 会丢失关键诊断信息，无法触发 CodeBuddy 的协议层分析】
如果命令执行后卡住超过 8 秒，按 Ctrl+C 中断，再补加 --connect-timeout 3 参数重试。
向 CodeBuddy 提交结构化诊断请求
方法一：交互式会话诊断
1、运行 codebuddy 启动交互模式
2、粘贴上一步获得的 curl -v 完整输出
3、紧接着输入：“请判断是服务未启动、端口被占、防火墙拦截，还是路由配置错误，并给出第一条验证命令”
方法二：单次指令直达
codebuddy "分析以下 curl -v 输出：$(cat /tmp/curl-log.txt) —— 判断失败根因并返回一个能立刻验证的 shell 命令"
注意：CodeBuddy CLI 默认只读取当前工作目录及子目录文件，【/tmp/curl-log.txt 必须真实存在且有读权限，否则会静默跳过该文件】
执行 CodeBuddy 返回的首条验证命令
第一步：netstat -tuln | grep :8080
第二步：lsof -i :8080 2>/dev/null || echo "lsof 未安装，改用 netstat"
第三步：curl -I http://127.0.0.1:8080/health 2>/dev/null | head -n 1
若 CodeBuddy 返回的是 ss -tuln 命令，直接执行即可；它比 netstat 更快且默认预装于新发行版 Linux 和 macOS；Windows 用户若收到此命令，需改用 Get-NetTCPConnection -LocalPort 8080（PowerShell）。
