# 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 编排入口
