codebuddy通过项目级记忆文件(.codebuddy/memory.md)固化api调试结果,支持结构化记录接口信息,新会话自动读取;还可封装为skill实现自动化调试流程,并支持从对话中提取生成记忆片段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你在CodeBuddy里调试完一个API接口,下次打开新会话时发现请求参数、响应结构、鉴权方式全丢了,得重新翻聊天记录或手动重输——这不是操作失误,而是没把调试过程固化为可复用的项目知识。
把接口调试结果存成项目级记忆文件
CodeBuddy的项目记忆机制不依赖会话,而是靠本地Markdown文件主动承载上下文。每次调试完,立刻生成一份结构化记录,后续所有会话都能自动读取。
第一步:在项目根目录下创建 【.codebuddy/MEMORY.md】 文件(注意开头是点号,必须放在项目最外层)。
第二步:用以下格式写入接口信息,字段名不能改,冒号后必须有空格:
```markdown
# 接口调试记忆
## 用户登录接口
- 方法:POST
- 地址:https://api.example.com/v1/auth/login
- 请求头:
Authorization: Bearer {token}
- 请求体示例:
{ "username": "admin", "password": "123456" }
- 成功响应字段:
- data.token(JWT字符串)
- data.expires_in(秒数)
```
第三步:保存文件后,在任意新会话中直接输入“调用用户登录接口”,AI会自动匹配MEMORY.md里的描述并生成完整curl命令——它不是靠记住你上次说了什么,而是实时读取这个文件。
⚠️ 注意:如果项目根目录下没有.codebuddy文件夹,需手动创建;若已存在但缺MEMORY.md,AI不会报错也不会提醒,只会当没这回事。
用Skill封装高频调试动作
当你反复要对同一组接口做相同操作(比如带签名的请求、token刷新后再调用),光记参数不够,得把整个逻辑打包成可执行单元。
方法一:手动生成Skill文件夹
在项目根目录下新建 【.codebuddy/skills/api-debug-login/】 文件夹。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手,支持自然语言驱动开发。 - 必备触发词:CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景:安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
在该文件夹内新建SKILL.md,内容必须包含name和description字段:
```yaml
---
name: api-debug-login
description: 调试用户登录接口,自动处理JWT token刷新与携带
allowed-tools: Bash, Write
---
你是登录接口调试专家,按以下步骤执行:
1. 读取当前项目下的.config/auth.json获取基础配置
2. 执行curl POST请求获取新token
3. 将token写入临时文件.tmp/token.jwt
4. 用该token调用目标接口并返回原始响应
```
方法二:用CLI快速注册(适合临时验证)
终端执行:cb save "登录调试流程" --content "curl -X POST https://api.example.com/v1/auth/login -H 'Content-Type: application/json' -d '{\"username\":\"admin\",\"password\":\"123456\"}'"
这条命令会把curl语句存进 【~/.codebuddy/snippets/】,下次用cb use "登录调试流程"就能直接输出到终端——但它不绑定项目上下文,跨项目调用时可能出错。
让AI自动提取调试对话生成记忆
你不需要每条都手动整理,CodeBuddy能从你当前会话的调试对话中抽取出关键字段,自动生成MEMORY.md片段。
第一步:确保当前会话中已完整展示过一次成功请求(含完整URL、headers、body、response)。
第二步:对AI说:“请把刚才调试的用户登录接口整理成项目记忆格式。”
第三步:AI会输出一段标准Markdown文本,**复制整段内容,粘贴覆盖到项目根目录下的.codebuddy/MEMORY.md对应接口区块**——不要追加,否则重复字段会导致解析失败。
第四步:保存文件,立即生效。下次新会话里提到“登录接口”,AI就会优先引用这份记忆,而不是猜测或搜索历史聊天。










