文心快码
支持代码解释、注释生成与单元测试生成的 AI 编程助手。
文心快码 Comate 是百度的 AI 编程助手，提供 IDE 插件与独立 AI IDE。除补全和问答外，当前官方文档还介绍 Zulu 智能体、行间命令、项目规则与知识增强。
文心快码 能做什么
处理具体函数时可从行间命令开始：解释代码、补充注释、生成单测或拆分函数。较复杂任务可交给 Zulu，但应先把项目规范和允许的修改范围写清楚。
规则存放在项目 .comate/rules，按始终、指定文件或手动方式生效。独立 IDE 的预览调试、企业部署和插件能力应分别核对。
使用 Zulu 及专用智能体
官方将 Zulu 作为默认交互入口，并介绍自定义与多智能体协作。它可结合规则和 MCP 使用领域知识及工具，适合有清晰范围的编程任务。
从函数位置调用常用操作
行间命令可解释代码、生成函数注释、补充测试、提出调优建议或拆分函数。问答类任务默认由 Ask，生成与优化类由 Zulu 处理。
按项目设置规则
规则文件位于 .comate/rules，格式为 .mdr，可始终生效、按文件匹配或手动提及。规则内容应短而明确，并核对当前任务是否满足生效条件。
结合代码库和文档辅助编码
官方介绍上下文引擎结合当前代码库与技术文档，用于补全和对话；独立 IDE 另有前端预览和元素级调试。
- 核心用途
- Zulu 编码、代码问答、补全与单测
- 可完成的工作
- 函数理解、测试补齐与项目规范执行
- 如何开始
- 安装兼容 IDE 插件或独立 IDE 后打开项目
- 使用条件
- 规则有项目范围；部分命令有明确触发条件
如何使用 文心快码
- 选定兼容的产品入口
按官方支持列表选择 VS Code、JetBrains 等插件或独立 Comate IDE，核对系统和版本要求。
- 打开工程并整理规则
写清框架、目录和验证约定；需要持续使用时存入项目规则，并选择正确生效方式。
- 从目标函数触发命令
定位函数使用行间快捷入口，或选中代码后从右键菜单调用解释、注释或单测功能。
- 核对结果并迭代
检查输出与业务行为、规则是否一致；必要时补充上下文继续对话，再运行项目检查。
给函数补说明和测试
适合：维护已有代码的开发者
- 准备输入
- 目标函数、业务含义与边界输入
- 操作方法
- 编辑建议：先使用代码解释核对行为，再生成注释和单测，补充模型不知道的业务前提，运行测试确认结果。
- 预期交付物
- 准确注释与可运行测试
- 人工检查
- 注释、断言和实现应一致，测试需覆盖异常而非只测试正常路径。
让修改遵循项目规则
适合：多人维护同一项目的团队
- 准备输入
- 目录规范、框架约定与测试要求
- 操作方法
- 编辑建议：在 .comate/rules 创建规则，选择合适生效方式，再用小任务检查生成位置和风格是否符合约定。
- 预期交付物
- 可以复用的项目规则
- 人工检查
- 指定文件规则要匹配当前上下文；仅手动提及不一定覆盖文件匹配条件。
拆分满足条件的长函数
适合：需要改善可维护性的工程师
- 准备输入
- 职责过多的函数和现有回归测试
- 操作方法
- 编辑建议：先检查函数拆分命令的长度条件，要求保持对外行为，再核对新函数边界和调用关系。
- 预期交付物
- 职责更清楚的函数候选
- 人工检查
- 官方命令要求至少 20 行且少于 4500 字符；重构后需验证行为保持一致。
界面与参考图片
开始前需要了解
规则仅对当前项目生效
规则保存在 .comate/rules；是否在团队中共享还取决于版本管理。不要把一个项目配置当成全局默认。
规则范围需满足匹配条件
指定文件规则依赖对话上下文中的文件匹配；官方提醒不建议直接改文件头的生效字段，应优先从规则列表修改。
函数拆分并非任意代码可用
行间函数拆分要求函数或方法至少 20 行且少于 4500 字符；其他情况应使用适合的对话任务并检查结果。
独立 IDE 与企业特性另有条件
预览调试是独立 IDE 的特色；企业 SaaS、混合云和私有化属于不同部署方案，不能视为所有个人插件的默认能力。
支持插件与独立 IDE；项目规则和企业部署权益需分别核对。
账号权限、费用与可用功能请以官方入口的当前说明为准。重要结果应先检查，再用于实际工作。
常见问题
Comate 是文心快码吗？
是。官方产品介绍使用“文心快码 (Baidu Comate)”名称，并提供插件与独立 AI IDE。
项目规则放在哪里？
存放于 .comate/rules，使用 .mdr 文件；支持始终、指定文件和手动三种生效方式。
生成单测需要退出编辑器吗？
行间命令或右键菜单可直接触发，结果仍需适配项目框架并运行验证。
为什么函数拆分按钮不能用？
先核对官方条件：函数或方法至少 20 行且少于 4500 字符；其他问题再按插件版本与当前入口排查。
