CodeBuddy 的 doctor 命令是官方内置深度诊断工具，执行 codebuddy doctor 触发五层检查（LSP进程、CLI工具链、MCP服务器、IDE插件、本地缓存），输出彩色结构化报告；支持导出JSON快照或上传至腾讯云诊断后台；可定向诊断MCP、LSP及权限模块。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你面对服务启动失败、日志无输出、插件静默或连接器状态异常等复杂故障时，CodeBuddy 的 doctor 命令是官方内置的深度诊断入口，它不依赖网络模型推理，而是直接采集本地进程、端口、配置、权限与MCP服务状态，生成结构化健康报告。
执行基础诊断并查看实时报告
在项目根目录或任意终端中运行：codebuddy doctor。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
该命令会自动触发五层检查：LSP进程存活性、CLI工具链完整性、MCP服务器连通性、IDE插件注册状态、本地缓存一致性。输出结果以彩色区块呈现，绿色✅表示通过，红色❌标出具体失败项及错误码。
若终端返回“【No MCP server configured】”，说明尚未启用MCP集成——此时 doctor 不会报错，但后续远程诊断功能将不可用。
导出完整诊断快照供协作分析
方法一：生成带时间戳的JSON报告文件
执行：codebuddy doctor --output-format json --print > doctor-report-$(date +%Y%m%d-%H%M%S).json。
该命令强制非交互模式输出，并将完整诊断数据（含进程PID、监听端口列表、配置路径哈希、MCP服务URL）写入本地文件。
方法二：直接上传至腾讯云诊断后台（需已登录）
执行：codebuddy doctor --upload。
系统会自动打包当前环境指纹（不含源码与敏感凭证），生成唯一诊断ID并返回可分享链接，技术支援团队可通过该ID复现你的本地环境拓扑。
针对特定模块执行定向诊断
第一步：确认当前活跃的MCP服务实例
运行：codebuddy doctor --mcp。
它会主动向所有已注册的MCP服务器（如 ssh-mcp-server、lighthouse-mcp）发送心跳探测，并列出响应延迟、认证状态与可用工具集。
第二步：检查语言服务器（LSP）是否卡死或端口冲突
运行：codebuddy doctor --lsp。
这一步会杀掉所有残留的 codebuddy-lsp 进程，清空 ~/.codebuddy/lsp/ 下的临时套接字文件，并尝试重启LSP服务；【注意：此操作会中断当前IDE中的代码补全，需重启编辑器生效】。
第三步：验证CLI权限沙箱是否被意外绕过
运行：codebuddy doctor --permissions。
输出中若出现 “dangerously-skip-permissions: true”，说明某次调用曾使用 --dangerously-skip-permissions 参数——该状态会持续影响后续所有CLI命令，必须手动清除配置或重置权限策略。
