CodeBuddy数据分析任务异常需按四层路径排查：一、确认数据源就绪（如src/、.log、package.json等）且未被.codebuddyignore误排除；二、重启codebuddy-lsp进程并启用自动重启；三、检查索引状态，必要时删除.codebuddy/目录重建；四、验证codebuddy.tencentcloudapi.com连通性及账号是否开通“智能分析”权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy在执行数据分析类任务（如日志统计、代码度量、依赖分析、性能瓶颈识别）时出现结果为空、数值异常、超时中断或提示“上下文不足”，需按数据源接入、分析引擎状态、项目索引完整性、权限与网络四层路径逐项验证。
确认分析任务所依赖的数据源是否就绪
CodeBuddy的数据分析能力不是凭空运行的，它必须基于可读取、结构化、未被排除的原始数据。若你刚打开一个空文件夹、或项目中只有配置文件没有源码，分析自然无法启动。
打开当前工作区根目录，在资源管理器中确认是否存在以下至少一类内容：【src/ 目录、.log 文件、package.json / pom.xml、trace.json 或 profiler 输出】。若全是 README.md、.gitignore 和空文件夹，立即停止执行分析命令——补全数据再操作。
检查 .codebuddyignore 文件是否存在并误删了关键路径。例如该文件中若含 src/**、logs/*.log 等行，会导致分析引擎直接跳过所有源码和日志——删掉这行或注释掉即可。
重启数据分析语言服务器（LSP）进程
CodeBuddy对日志聚合、调用链分析、复杂度计算等任务依赖独立的语言服务器进程。该进程崩溃后，IDE界面无报错，但所有分析按钮点击后仅转圈或秒退。
第一步：在终端中执行 killall -9 codebuddy-lsp（macOS/Linux）或 taskkill /f /im codebuddy-lsp.exe（Windows）强制终止残留进程。
第二步：打开IDE设置 → 搜索 “analysis” → 找到 “CodeBuddy > Analysis: Auto Restart LSP” 选项，确保其为启用状态。这一步能防止下次崩溃后需手动干预。
第三步：右键任意源码文件 → 选择 “CodeBuddy: Analyze This File” 触发一次轻量分析。若状态栏右下角出现“Analyzing… 1/3”进度提示，说明LSP已成功拉起。
检查项目索引是否完成或损坏
方法一：查看IDE右下角状态栏
若显示 “Indexing… 78%” 或 “Index failed” 字样，说明CodeBuddy尚未构建完语义图谱。此时执行任何深度分析都会返回不完整结果或报错“no symbols found”。等待索引完成，或点击该提示文字手动触发“Rebuild Index”。
方法二：手动清除缓存重建
关闭IDE → 进入工作区根目录 → 删除 .codebuddy/ 子目录（注意不是 .vscode/ 或 .idea/）→ 重新打开IDE。这会强制CodeBuddy从头扫描全部文件，耗时略长但可解决因增量索引错乱导致的字段缺失、调用关系断裂等问题。
【删除前请确认你未在 .codebuddy/ 下手动保存过自定义规则配置，该目录内无用户级配置，纯属运行时缓存】
验证分析功能所需的网络与权限
部分分析能力（如第三方依赖漏洞扫描、云服务调用链映射、模型驱动的异常模式识别）需调用 codebuddy.tencentcloudapi.com 的分析API。
在终端中运行：curl -I https://codebuddy.tencentcloudapi.com/v1/analysis/health。若返回 HTTP/2 200，说明服务端可用；若卡住或返回 403/502，则问题出在网络策略或Token权限上。
打开IDE → 帮助 → Open Logs Folder → 找到最新日期的 log.zip → 解压后打开 main.log → 搜索关键词 “analysis” 和 “403”。若发现大量 “Unauthorized for resource /v1/analysis/dependency” 记录，说明当前登录账号未开通 Coding Plan 中的「智能分析」模块权限，需前往腾讯云控制台开通。
