CodeBuddy生成配置文件需三选一：①在项目根目录创建CODEBUDDY.md并严格按格式声明需求；②对话中提供服务类型、端口域名、代理路径、安全性能四要素；③依赖自动识别dist/Vue/Spring Boot等项目特征。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让CodeBuddy生成配置文件，核心在于提供足够明确的上下文：要么通过项目根目录的 CODEBUDDY.md 声明基础设施意图，要么在对话中精准描述服务拓扑四要素（类型、端口域名、代理路径、安全性能），再或者依赖它自动识别出的 dist 目录、Vue/Spring Boot 等项目特征进行推导。缺一不可。
通过 CODEBUDDY.md 显式声明需求
这是最稳定、可复用的方式，尤其适合团队协作或 CI/CD 流程固化。
第一步：在项目根目录新建或编辑 【CODEBUDDY.md】 文件。该文件必须位于项目最外层，不能放在子目录里，否则 CodeBuddy 扫描不到。
第二步：写入具体部署要求，例如：“本项目为 Vue 前端单页应用，后端 API 地址为 https://api.example.com，要求 Nginx 实现：静态资源直接返回、/api 路径反向代理至后端、启用 gzip 压缩、禁用 server_tokens。”
第三步：保存文件后，在 CodeBuddy 界面输入指令：“根据 CODEBUDDY.md 生成完整 nginx.conf”。这一步必须严格使用“根据 CODEBUDDY.md”作为开头，否则不会触发上下文读取逻辑。
在对话中提供完整部署拓扑描述
适用于临时调试、快速验证或尚未建立 CODEBUDDY.md 的新项目。
方法一：输入包含四要素的自然语言指令。必须同时说明服务类型（如 Vue）、监听端口与域名（如 80 端口 + www.ruoyi.com）、反向代理路径及目标地址（如 /prod-api → http://127.0.0.1:8080）、安全与性能要求（如 gzip、expires 头）。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
方法二：直接粘贴现有配置片段 + 问题描述。比如把一段报错的 nginx.conf 发过去，加上“这段配置 reload 失败，提示 invalid number of arguments in ‘proxy_pass’ directive”，CodeBuddy 会定位到 proxy_pass 后缺少斜杠的问题并修复。
这一步操作起来很简单，直接把文件拖进去就行。但注意：如果只说“帮我配个 Nginx”，CodeBuddy 无法推断 dist 目录位置或后端端口，会返回通用模板而非适配你项目的配置。
基于已识别项目结构自动推导
CodeBuddy 在扫描到特定项目特征时会主动建议生成配套配置，前提是项目结构已就绪。
① 确保 dist/ 或 build/ 目录存在——如果你还没运行过 npm run build 或 mvn clean package，CodeBuddy 就无法确认前端资源输出路径，也不会触发 Vue/Spring Boot 模式识别。
② 打开 CodeBuddy 工作区，等待左下角状态栏显示“已识别 Vue 项目结构”或“检测到 Spring Boot + Vue 分离架构”。此时点击弹出的“生成 Nginx 配置”按钮即可。
③ 如果没弹出建议，手动执行 /detect project 命令强制触发结构扫描。这个命令会重新遍历 package.json、pom.xml、application.yml 等关键文件，比重启软件更高效。
