必须重新初始化才能让AI准确识别当前真实结构；先执行/status检查Project Root和Detected Framework是否匹配现状，若不一致则删除.codebuddy/.cache并运行/init扫描当前目录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当接口调试项目因重构、迁移或框架升级导致目录结构、入口文件、依赖关系发生实质性变动时，CodeBuddy 原有对项目上下文的理解会失效，继续执行 /init 或自然语言指令可能生成错误路径、调用不存在的模块、遗漏新接入的中间件。必须重新初始化才能让 AI 准确识别当前真实结构。
确认是否真需重新初始化
先执行 /status 查看当前项目解析状态。若输出中 【Project Root】 路径与你当前终端所在目录不一致，或 【Detected Framework】 显示为 “Unknown” 或明显过时（如显示 Express 3.x 但实际已迁至 FastAPI），说明上下文已失效，必须重置。
不要跳过这步——误判会导致后续所有操作基于错误结构，改得越多错得越深。
彻底清除旧上下文缓存
CodeBuddy 的项目理解缓存存在本地，仅靠重启或切换目录无法清空。必须手动删除：
在项目根目录下运行：rm -rf .codebuddy/.cache
这一步不可省略。缓存残留会使 /init 读取旧索引而非扫描当前文件，尤其当新增了 src/ 目录但旧缓存仍指向 legacy/ 时，AI 会完全忽略新结构。
执行全新项目初始化
确保终端当前工作目录就是你要调试的项目根目录（即包含 package.json、pyproject.toml 或 server.js 的那一层）。
在 CodeBuddy 交互界面中输入：/init
系统将自动扫描全部文件，识别语言、框架、API 路由定义文件（如 routes/、controllers/）、配置入口（如 config/index.ts）、测试目录（test/ 或 __tests__/）。扫描完成后会生成一份结构摘要，例如：“检测到 3 个 RESTful 路由文件，2 个 Swagger 定义，1 个统一错误处理器”。
此时再输入接口调试指令，如“调用 /v2/users/list 接口并验证返回字段”，AI 才能准确定位 handler 文件、构造 mock 请求体、注入正确环境变量。
