应提前在本地开发阶段发现代码风险而非依赖CI报错；需上传单篇规范文档至Comate知识集，再通过右键或快捷键触发审查，支持单文件、Diff模式及AI建议采纳与忽略。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在本地开发阶段就发现java文件里隐藏的空指针风险、go代码中未处理的error分支、或是typescript接口定义与实现不一致的问题，而不是等ci流水线报错后才去排查。配置审查知识库并启用规范检查
登录Comate后台管理页→进入「知识集」→点击「新建知识集」→上传你公司内部的《Java开发手册_v3.2.md》或《前端编码规范.pdf》。注意：必须确保该知识集中仅包含一篇规范文档，多篇混传会导致规则解析失败，审查结果不可信。
上传成功后，在VSCode或IDEA中打开待审查文件，右键→「Baidu Comate」→「代码审查」→勾选「启用自定义规范」→选择刚上传的知识集名称。
对单个文件执行深度审查
方法一：右键菜单触发（推荐新手）
在编辑器中打开目标.java/.py/.ts文件→光标置于任意位置→右键→「Baidu Comate」→「审查当前文件」→等待5～12秒（取决于文件行数）→审查结果自动以侧边面板形式展开。
方法二：快捷键直达（适合高频用户）
Windows/Linux按 Ctrl+Alt+C，macOS按 Cmd+Option+C，无需选中文本即可启动审查。
审查结果默认按严重等级排序：Error > Warning > Info。每个问题都带定位行号、问题类型图标、修复建议和「采纳修改」按钮。点击「采纳修改」会直接在原位置插入修正后的代码片段，例如将if (user != null) { ... }自动补全为if (Objects.nonNull(user)) { ... }。
批量审查多个文件差异（diff审查）
第一步：在Git插件中打开「Changes」视图，勾选你要审查的3个改动文件（如 user-service/src/main/java/OrderService.java、api-models/src/main/java/OrderDTO.java、pom.xml）；
第二步：右键任意一个已勾选文件→「Baidu Comate」→「审查所选文件变更」；
第三步：审查启动后，面板顶部显示「Diff审查模式」标签，所有问题均标注来源是「新增行」还是「修改行」；
第四步：逐条查看问题，对关键Error项点击「采纳」，对Warning类问题可先折叠再统一处理。
调用百度PaddleOCR‑VL大模型API，支持PDF、Word、PPT、图片等多格式文档解析，精准识别印刷体、手写体、表格、公式、图表、印章等复杂元素，支持100+语言，可处理不规则布局和跨页长文档。触发词：文档解析、VLM解析、大模型OCR、PaddleOCR、多模态文档、手写识别、公式识别、复杂版面。
这一步操作起来很简单，但要注意：如果勾选了超过5个文件，系统会自动截断只审查前5个，剩余文件需重新分批操作——这是硬性限制，不是界面卡顿。
查看并应用AI给出的修改建议
当审查结果中出现「建议将for循环替换为stream().filter().map()链式调用」这类优化项时，不要直接点「采纳」。先点击右侧的「展开详情」，查看AI对比前后的性能差异说明和兼容性提示（例如“JDK版本需≥1.8”或“可能影响调试断点位置”）。
对于标记为【Error】级别的问题，比如「Go函数返回error但未做判断」，点击「采纳修改」后，Comate会在调用处自动插入if err != nil { return err }或log.Fatal(err)，具体策略取决于上下文语义。
若某条建议明显不符合项目现状（例如强制要求用Lombok而你团队禁用），可点击该条目右上角的「忽略」图标，它会被加入本次审查的临时白名单，不会重复提醒。
