建议新增配置类型，以实现工程化的配置方式

[candy-Tong]

Problem Statement

json 的配置，可读性不高，也不好维护，挤在一行了，我希望是有 js 或者约定式目录的方式，一个规则一个文件；

Proposed Solution

json 的配置，可读性不高，也不好维护，挤在一行了，我希望是有 js 或者约定式目录的方式，一个规则一个文件；

Alternatives Considered

No response

Affected Area

Configuration

Additional Context

No response

[zephyrq-z]

感谢 @candy-Tong 提出的建议！

现状

PR #87 已经部分解决了这个问题 —— 支持通过 use_file_path 引用外部的 .md/.txt 规则文件，避免将复杂规则内联到 JSON 中。

{
  "use_file_path": true,
  "rules": [
    {
      "path": "**/*.py",
      "rule": "docs/python-rules.md"
    }
  ]
}

这样 rule.json 中只需保留路径映射，规则内容放在独立文件中维护，不再挤在一行。

[candy-Tong]

@zephyrq-z
现在是不是不支持同时命中多个 path？

例如：

1. **/*.js 是全局的配置
2. **/project-a/*.js 是项目的配置

又或者单条 path 对应一个 review 规则知识

{
  "use_file_path": true,
  "rules": [
    {
      "path": "**/*.js",
      "rule": "请求知识"
    },
   {
      "path": "**/*.js",
      "rule": "页面 UI 知识"
    }
  ]
}

[lizhengfeng101]

@zephyrq-z 现在是不是不支持同时命中多个 path？

例如：

1. **/*.js 是全局的配置
2. **/project-a/*.js 是项目的配置

又或者单条 path 对应一个 review 规则知识

{
  "use_file_path": true,
  "rules": [
    {
      "path": "**/*.js",
      "rule": "请求知识"
    },
   {
      "path": "**/*.js",
      "rule": "页面 UI 知识"
    }
  ]
}

是的，不支持，可以按优先级从上到下维护，支持命中多个 path 涉及到合并、冲突等，对效果影响很大，用户维护成本也很高，我理解目前大模型的能力还暂时不会支持这个能力，不然还不如直接提供一个大的 .md 文件了，我们内部验证过程中就是因为 .md 文件难以细粒化拆分然后影响效果不可控才提出目前方案的。

[candy-Tong]

这个 README 文档好像没体现出来，我看到这个项目的时候，第一直觉，应该是支持的。

[lizhengfeng101]

这个 README 文档好像没体现出来，我看到这个项目的时候，第一直觉，应该是支持的。

README 里我看是存在的，“在每一层内，规则按声明顺序评估 —— 首次匹配生效。”

[paul-yangmy]

现在使用上面推荐的方法进行了多rules配置，但这样相当于需要多维护一个文件。后续能不能支持在执行ocr review --format json --rule 直接指定一个目录而不是文件呢，它自动去加载下所有的规则

[lizhengfeng101]

@paul-yangmy 可以给个具体的例子演示一下你期望的程序行为吗？

[paul-yangmy]

@paul-yangmy 可以给个具体的例子演示一下你期望的程序行为吗？

谢谢大佬！我们现在项目是维护了一个资产路径，里边包含了业务知识和图谱那些，计划也将自定义的代码规则也包含进去，使用时希望能直接执行ocr review --format json --rule constitution/rules或ocr review --format json --rule constitution/rules/*这种，而不是现在的ocr review --format json --rule constitution/rules/rules_profile.json,具体的规则再在里面配置
{
"use_file_path": true,
"rules": [
{
"path": "/*.c",
"rule": "constitution/rules/rules-c.md"
}，
{
"path": "/*.c",
"rule": "constitution/rules/rules-xx.md"
}，
]
}

[yuuk]

这个 merge request 怎么关了

感谢 @candy-Tong 提出的建议！

现状

PR #87 已经部分解决了这个问题 —— 支持通过 use_file_path 引用外部的 .md/.txt 规则文件，避免将复杂规则内联到 JSON 中。

{
"use_file_path": true,
"rules": [
{
"path": "**/*.py",
"rule": "docs/python-rules.md"
}
]
}
这样 rule.json 中只需保留路径映射，规则内容放在独立文件中维护，不再挤在一行。

[lizhengfeng101]

@paul-yangmy 那 Agent 实际运行时是期望如何加载 ocr review --format json --rule constitution/rules/*，加载其中的哪个文件呢？