Qoder通过规则引擎自动执行团队编码规范，支持四种规则类型：始终生效、手动触发、文件指定和模型决策规则，需在设置中启用Rule Engine插件后配置，涵盖匹配模式、响应动作与作用域绑定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让Qoder在写代码时自动遵守团队规范、禁用危险语法、统一API调用方式，而不是每次都要手动检查或反复修改AI输出——这需要通过设置编程规则来实现，而不是依赖口头约定或事后Review。
打开Qoder规则配置界面
按下 ⌘⇧,（macOS）或 Ctrl+Shift+,（Windows/Linux）打开全局设置，点击左侧导航栏中的「规则」选项卡，进入规则管理主界面。此时你看到的是一个空列表，所有规则都需手动创建，系统不预置任何业务相关规则。
注意：若左侧无「规则」菜单项，说明当前版本未启用Rules模块，请先在设置→扩展中启用「Rule Engine」插件并重启Qoder。
创建四种类型规则中的任意一种
规则按触发机制分为四类，选择与你需求匹配的类型，点击右上角「+ 新建规则」按钮后，在弹窗中选择对应模板：
方法一：始终生效规则（Always Active Rules）
适用于基础安全红线，例如“禁止使用eval()”“SQL必须参数化”。这类规则一旦启用即后台常驻，对所有打开文件实时扫描，无法临时关闭。
方法二：手动引入规则（Manual Trigger Rules）
适合重型检查，如“分析Controller层是否符合RESTful设计规范”“检测微服务间Feign调用是否缺少fallback”。需在命令面板输入Qoder: Run Rule并手动选择执行。
方法三：指定文件生效规则（File-Specific Rules）
精准控制作用域，例如仅对src/main/java/com/example/**/controller/**.java生效，或限定于*.vue文件强制使用Composition API。支持glob通配符和正则路径匹配。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
方法四：模型决策规则（Model-Based Decision Rules）
由AI动态判断是否启用，例如当上下文含“支付”“订单”关键词时，自动插入PCI-DSS合规检查步骤；当检测到遗留Java 7代码时，提示升级至Optional替代null返回。该类型需绑定已训练的轻量级分类模型。
编写规则内容（以Always Active Rules为例）
第一步：填写规则名称与描述
名称必须唯一且语义明确，如“禁止硬编码数据库密码”，描述字段用于说明违反后果，例如“可能导致凭证泄露至Git历史”。
第二步：定义匹配模式
在Pattern字段中输入AST节点路径表达式，例如：
【Java】node.type === "Literal" && node.value.includes("@jdbc:mysql")
该表达式会捕获所有包含MySQL连接字符串的字面量节点。错误写法是直接写正则匹配文本，这会导致误报或漏报。
第三步：设置响应动作
选择“高亮警告”“阻止保存”或“自动修复”。若选自动修复，必须在Fix Template中提供合法的替换模板，例如将${password}替换为env("DB_PASSWORD")。
第四步：绑定作用域与优先级
勾选“项目级”则规则仅对当前工作区生效；勾选“用户级”则全局应用。优先级数字越小越先执行，多个冲突规则中，优先级为1的规则覆盖优先级为5的规则。
第五步：保存并验证
点击「保存」后，规则立即加载。打开一个含违规代码的文件，观察编辑器是否出现波浪线提示——若无反应，检查状态栏右下角是否显示“Rules Engine: Active”，未激活需执行Qoder: Reload Rules命令。
