CodeBuddy仅从项目根目录加载CODEBUDDY.md,需确认/config show输出含“Loaded CODEBUDDY.md”路径;文件须UTF-8无BOM、首行非空/注释、禁用Markdown语法;结构须含路径前缀、资源命名、动词映射、响应语义四要素。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让CodeBuddy在接口调试中稳定复用同一套API规范,必须确保CODEBUDDY.md文件被正确识别、实时生效且不被意外覆盖。该文件一旦配置错误或路径错位,所有后续生成的接口代码将偏离RESTful约定,导致联调失败或前端反复适配。
确认CODEBUDDY.md是否被CodeBuddy读取
CodeBuddy只在项目根目录下主动加载CODEBUDDY.md,不会向上递归查找父目录文件。若当前工作目录不是项目根目录,该文件将完全失效。
执行命令:/config show → 查看输出中是否包含 【Loaded CODEBUDDY.md from /path/to/your/project】 字样。
若未出现该提示,说明CodeBuddy未定位到该文件——此时无论文件内容多么规范,都不会影响任何代码生成行为。
CodeBuddy VS Code插件
CodeBuddy VS Code插件下载入口,整理CodeBuddy腾讯云代码助手的官方插件地址、安装入口和基础功能说明。
下载
CODEBUDDY.md内容校验与最小必要结构
文件必须以UTF-8无BOM编码保存,首行不可为空行或注释,否则解析失败后CodeBuddy会静默回退至默认规则。
方法一:基础可用结构(仅含路径与动词约束)
写入以下三行即可触发基本RESTful识别:
API规范:所有接口路径以/api/v1/开头
资源名使用复数名词(如users、orders)
使用标准HTTP动词(GET/POST/PUT/PATCH/DELETE)
方法二:完整生产级结构(含状态码与响应契约)
需严格包含四类字段:路径前缀、资源命名、动词映射、响应语义。缺任意一项,CodeBuddy将对缺失项采用默认值(如状态码默认全为200),造成调试时HTTP状态异常。
【禁止在CODEBUDDY.md中使用Markdown标题(如#、##)或代码块```包围内容】 ——CodeBuddy解析器不支持Markdown语法,仅识别纯文本行内冒号分隔的键值对,遇到标题符号会导致整行跳过。
多项目切换时CODEBUDDY.md自动加载验证
第一步:在终端进入项目A根目录 → 输入 /folder /path/to/project-a → 等待右上角路径更新完成;
第二步:立即执行 /config show → 确认输出中显示 project-a 的 CODEBUDDY.md 路径;
第三步:切换至项目B → 输入 /folder /path/to/project-b → 再次运行 /config show;
第四步:对比两次输出中的“Loaded CODEBUDDY.md”路径是否分别指向各自项目根目录。
若第二次仍显示 project-a 路径,说明 project-b 根目录下缺失 CODEBUDDY.md 文件,或文件名拼写错误(例如写成 codebuddy.md 或 CODEBUDDY.MD)。
