CodeBuddy 的高级功能并非通过隐藏的“解锁”按钮激活,而是借助命令行参数、配置文件或交互式指令来主动启用。其默认已集成所有能力,关键在于如何灵活运用——如同瑞士军刀,若不展开工具,便仅是一块金属。接下来,我们逐一解析这些高级功能的具体用法。

系统提示词定制:掌控AI行为的关键开关
这是最常用也最关键的高级控制手段,提供三种方式适用于不同协作场景:
- 完全替换:使用
--system-prompt参数覆盖全部默认指令,适用于专项任务,例如“仅生成带单元测试的 Rust 函数,禁用所有解释性文字”。 - 文件加载:通过
--system-prompt-file prompt.txt引入外部提示词文件,便于团队统一维护并通过 Git 管理版本。 - 追加指令:借助
--append-system-prompt补充额外要求,例如“所有输出必须包含中文注释”,日常推荐使用,可保留基础能力不丢失。
权限模式切换:平衡效率与安全
CodeBuddy 默认采用自动授权,但在复杂或生产环境中建议手动干预:
- auto 模式:适用于本地开发与验证,对可信操作自动执行,提升效率。
- plan 模式:执行前显示完整操作计划,支持逐项确认或跳过,适用于重构类任务。
- manual 模式:每次文件写入及命令执行均需回车确认,适合敏感项目或初学者学习流程。
多模型协同:按任务选择最佳模型
并非所有模型都适合所有任务。CLI 支持细粒度指定:
- 主推理任务使用
--model deepseek-v3.1处理逻辑密集型编码。 - 图文生成任务采用
--text-to-image-model flux-dev生成 UI 原型图。 - 图像编辑任务利用
--image-to-image-model stable-diffusion-xl修改已有截图。
RAG 知识库接入:让AI理解你的项目背景
无需上传整个代码仓库,仅需一条命令即可注入私有上下文信息:
- 运行
codebuddy --rag-path ./docs --rag-embedding bge-m3,AI 就能引用本地的 API 文档、设计规范或历史 issue 等私有上下文。 - 支持增量更新,修改文档后重新运行命令即可刷新知识索引。
- 适用于技术栈迁移、遗留系统维护等需要强上下文的任务。
