ecm_sync_system/run_profiles/README.md

Run Profiles

• 路径：项目根目录 run_profiles/
• 命名：建议使用 *.local.yaml（该目录下 YAML 默认会被 git 忽略）

当前约定：

• 仓库里跟踪的配置文件只写必要字段，不重复抄默认值。
• pipeline 启动时会打印 Resolved Full Config，把省略字段补齐。
• 如果你要看完整字段和字段含义，不看模板，直接看 docs/runtime_config_guide.md。

模板来源：

• run_profiles/preset/jsonl_to_jsonl.default.yaml
• run_profiles/preset/jsonl_to_api.default.yaml
• run_profiles/preset/jsonl_to_jsonl.multi_project.default.yaml

推荐流程：

1. 从模板复制到本目录，例如：
   • run_profiles/jsonl_to_jsonl.local.yaml
   • run_profiles/jsonl_to_api.local.yaml
2. 按需修改后运行：
   • ecm-sync-run --config_path=run_profiles/jsonl_to_jsonl.local.yaml

兼容旧入口：

• python run.py --config_path=run_profiles/jsonl_to_jsonl.local.yaml

多项目示例：

• run_profiles/jsonl_to_jsonl.multi_project.yaml
• run_profiles/jsonl_to_jsonl.multi_project.global.yaml
• run_profiles/jsonl_to_jsonl.multi_project.project.yaml

支持占位符：

• ${PROJECT_ROOT}：运行时替换为项目根目录绝对路径。

现成示例：

• run_profiles/jsonl_to_api.yaml：单项目 JSONL -> API 联调示例
• run_profiles/jsonl_to_api.test.yaml：auto-test 使用的 JSONL -> API 示例
• run_profiles/jsonl_to_jsonl.multi_project.yaml：多项目 JSONL -> JSONL 编排入口