codebuddy 生成 nginx 配置需明确上下文：一、通过 codebuddy.md 声明需求；二、对话中提供含服务类型、端口域名、代理路径、安全性能的四要素描述；三、基于识别出的项目结构（如 dist 目录、vue/spring boot 特征）自动推导；四、调用 mcp 协议标准化生成并验证；五、粘贴现有配置+问题描述，ai 定位修复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 进行服务器运维辅助时，需要为 Web 服务生成符合生产环境要求的 Nginx 配置文件，但未获得预期输出，则可能是由于项目上下文缺失或指令描述不够明确。以下是多种可立即执行的生成方式：
一、通过 CODEBUDDY.md 显式声明配置需求
CodeBuddy 依赖根目录下的 CODEBUDDY.md 文件理解项目基础设施意图。该文件是触发 Nginx 配置生成的关键上下文锚点。
1、在项目根目录新建或编辑 CODEBUDDY.md 文件。
2、在文件中明确写入基础设施需求，例如：
“本项目需部署为 Vue 前端单页应用，后端 API 地址为 https://api.example.com，要求 Nginx 实现：静态资源直接返回、/api 路径反向代理至后端、启用 gzip 压缩、禁用 server_tokens。”
3、保存文件后，在 CodeBuddy 界面中输入指令：“根据 CODEBUDDY.md 生成完整 nginx.conf”。
二、在对话中提供完整部署拓扑描述
当未配置 CODEBUDDY.md 或需临时生成时，可通过自然语言精准描述服务拓扑，CodeBuddy 将据此推导出匹配的 Nginx 配置逻辑。
1、在 AI 对话框中输入包含以下四要素的指令：
— 服务类型（如 Vue、React、Node.js、PHP）；
— 监听端口与域名；
— 反向代理路径及目标地址；
— 安全与性能要求（如 HTTPS、gzip、缓存策略）。
2、示例指令：“生成适用于 RuoYi-Vue 前端的 Nginx 配置：监听 80 端口，域名 www.ruoyi.com，所有 / 开头请求服务 dist 目录，/prod-api 路径代理至 http://127.0.0.1:8080，启用 gzip 和 expires 头”。
3、确认生成内容后，复制输出的 nginx.conf 片段至服务器 /etc/nginx/conf.d/ 目录并重载配置。
三、基于已识别项目结构自动推导
CodeBuddy 在扫描到特定项目特征（如 package.json 中含 "build": "vue-cli-service build"、存在 dist/ 目录、或识别出 Spring Boot + Vue 分离架构）时，会主动建议并生成配套 Nginx 配置。
1、确保项目已完整拉取至本地工作区，且 dist/ 或 build/ 目录存在（或已执行过构建命令）。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
2、在 CodeBuddy 中执行命令：“分析当前项目结构并生成推荐 Nginx 部署配置”。
3、AI 将输出带注释的 nginx.conf，其中 location 块严格对应 detected 的前端路由模式（如 history 模式下自动添加 try_files $uri $uri/ /index.html）。
四、调用 MCP 协议直接生成并验证
MCP（Model Context Protocol）支持通过标准化指令调用 CodeBuddy 的部署模块，绕过自然语言歧义，直连配置生成引擎。
1、在终端或 CodeBuddy CLI 中运行：
codebuddy mcp:invoke --module=nginx --action=generate --config='{"mode":"spa","upstream":"http://localhost:8080","domain":"app.local"}'
2、系统将输出语法校验通过的配置文本，并附带一条用于验证的 shell 命令：
nginx -t -c /dev/stdin
3、将输出内容保存为 nginx.conf 后，可直接用于 nginx -s reload 流程。
五、修复现有配置中的典型错误
当已有 nginx.conf 存在语法错误或功能缺陷（如跨域未生效、404 路由丢失、proxy_pass 末尾斜杠遗漏），CodeBuddy 可定位并修正。
1、将当前配置内容粘贴至对话框，并附加说明：“此配置在 Vue history 模式下刷新页面返回 404，请修复 location / 块”。
2、CodeBuddy 将高亮指出问题行（如缺少 try_files 指令），并替换为正确片段。
3、输出修正后的完整配置，其中关键修复项以 加粗绿色字体 标注，例如：
“location / { try_files $uri $uri/ /index.html; }”。
