必须配置Rules才能让文心快码生成符合团队规范的代码；Rules仅在工作区根目录生效，文件名须为.wenxinrules.json且为标准JSON格式，包含version和rules字段，支持禁止硬编码、警告提示、自动补全注释及排除路径扫描。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让文心快码生成的代码更贴合团队规范、避免硬编码、自动补全注释或跳过特定文件扫描，必须用好Rules配置功能。不配置Rules，AI生成的代码可能和项目实际要求脱节，后期要花大量时间手动修正。
理解Rules配置的作用边界
Rules不是全局指令开关，它只在当前工作区根目录下生效，且仅影响文心快码的代码生成与补全行为，不影响已有代码的运行逻辑。配置文件名必须是 【.wenxinrules.json】，大小写敏感，放错位置或命名错误会导致整个Rules失效。
该文件不支持YAML格式，只接受标准JSON语法——哪怕多一个逗号，文心快码启动时就会静默忽略Rules，不会报错提示。
编写基础Rules结构
第一步：在项目根目录新建空文件，命名为 .wenxinrules.json。
第二步：填入最小可用结构，至少包含 version 和 rules 两个顶层字段：
{
"version": "1.0",
"rules": []
}
version 字段必须为字符串类型，目前仅支持 "1.0"；rules 必须是数组，即使暂时不写任何规则也不能为空对象 {}，否则解析失败。
添加禁止硬编码规则
方法一：用 pattern + action 精准拦截
在 rules 数组中插入对象：
{"pattern": "process.env.(\w+)", "action": "deny", "message": "禁止直接访问环境变量，请使用 config.ts 封装"}
这个正则会匹配所有形如 process.env.NODE_ENV 的写法，触发 deny 动作后，文心快码将拒绝生成含该模式的代码行，并显示自定义提示。
方法二：用 filePattern 限定作用范围
{"filePattern": ["*.service.ts", "*.controller.ts"], "pattern": "console.log\(", "action": "warn", "message": "生产环境禁用 console.log，请改用 logger.info()"}
这条规则只对 service 和 controller 文件生效，遇到 console.log( 就标黄提醒，但不阻止生成——适合过渡期逐步收敛。
启用自动注释补全
在 rules 数组中添加：
{"pattern": "^function\s+\w+\(", "action": "append", "content": "/** * @description TODO: 补充函数用途 * @param {any} params - 参数说明 */"}
注意：content 中的换行符必须用
表示，不能直接回车；如果函数名带泛型如 function fetchData
这一步操作起来很简单，直接把上述 JSON 片段粘贴进 rules 数组即可生效。
排除指定路径不扫描
第一步：确认需要排除的目录真实路径，例如 node_modules、dist、mock 数据目录。
第二步：在 rules 数组顶部添加 exclude 规则：
{"exclude": ["node_modules/**", "dist/**", "mock/**"]}
exclude 是独立于 pattern 规则的特殊字段，必须作为 rules 数组中的一个独立对象存在，不能嵌套在其他 rule 里。路径通配符用 ** 表示递归匹配，单个 * 只匹配当前层文件名。
