CodeBuddy需注入领域知识以理解业务语义:通过左侧Context添加含domain/core/business的本地目录,用// @ctx:标签激活对应上下文,支持调试变量或日志动态注入,还可通过context-profiles隔离测试环境上下文。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

让CodeBuddy真正看懂你正在写的业务代码,而不是只盯着语法和格式——它需要知道这段函数是处理订单退款、那个类封装的是用户积分规则、当前分支正对接支付网关的灰度接口。
注入领域知识到CodeBuddy工作区
打开CodeBuddy左侧边栏 → 点击「Context」图标 → 选择「Add Context Source」→ 从下拉菜单中选「Local Folder」。
在弹出窗口中,【必须选中包含 domain/、core/、business/ 这类目录名的根路径】,不能只选 src/main/java —— 否则它只会看到通用工具类,看不到你的 OrderService 或 RefundPolicy。
勾选「Auto-refresh on file change」,点击「Confirm」。
用注释锚点激活上下文感知
在你要提问或请求补全的代码上方,插入一行特殊注释:// @ctx: refund_flow_v2。
CodeBuddy会立刻识别这个标签,并将此前加载的 refund_flow_v2 相关文件(如 RefundProcessor.java、RefundStateMachine.md、refund_api.yaml)临时提升为高优先级上下文。
注意:标签名必须与你项目文档里实际使用的业务术语完全一致,大小写和下划线都不能错;写成 // @ctx: RefundFlowV2 就会失效。
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 问题
动态注入运行时上下文片段
方法一:在调试会话中右键变量 → 「Send to CodeBuddy Context」→ 选择「Current Stack Frame + Local Variables」。
方法二:复制一段关键日志输出(例如 [INFO] RefundApplyCommand validated: amount=299.00, reason=ITEM_DEFECT, channel=WECHAT)→ 粘贴到CodeBuddy输入框第一行 → 按 Ctrl+Enter 发送。
这一步会让CodeBuddy把该日志结构映射为临时实体模型,后续生成的建议会自动对齐字段语义,比如把 amount 当作 BigDecimal 处理,而非泛型 Number。
隔离测试环境上下文
第一步:在项目根目录创建 .codebuddy/context-profiles/ 目录。
第二步:在该目录下新建 staging.json,内容为:
{ "active": true, "include_paths": ["src/main/resources/config-staging/", "docs/api-contracts/staging/"] }
第三步:在VS Code状态栏点击「Context Profile」→ 切换为 staging → 所有后续交互将忽略 prod 配置和正式契约文档。
第四步:执行「Reload Context」命令,确保新配置生效。

















