修改项目文档

This commit is contained in:
strepsiades
2026-03-09 17:07:25 +08:00
parent 4ce4004cdb
commit 515c3d9388
3 changed files with 14 additions and 14 deletions
@@ -32,12 +32,12 @@
目前已经先实现了一版最小骨架: 目前已经先实现了一版最小骨架:
- 测试总配置:[tests/fixtures/auto_sync/auto_test_config.yaml](tests/fixtures/auto_sync/auto_test_config.yaml) - 测试总配置:[tests/fixtures/auto_sync/auto_test_config.yaml](../../tests/fixtures/auto_sync/auto_test_config.yaml)
- 流水线测试配置:[run_profiles/jsonl_to_api.test.yaml](run_profiles/jsonl_to_api.test.yaml) - 流水线测试配置:[run_profiles/jsonl_to_api.test.yaml](../../run_profiles/jsonl_to_api.test.yaml)
- 初始化脚本:[scripts/auto_test_init.py](scripts/auto_test_init.py) - 初始化脚本:[scripts/auto_test_init.py](../../scripts/auto_test_init.py)
- 统一运行脚本:[scripts/run_auto_test.py](scripts/run_auto_test.py) - 统一运行脚本:[scripts/run_auto_test.py](../../scripts/run_auto_test.py)
- 公共工具:[scripts/auto_test_lib.py](scripts/auto_test_lib.py) - 公共工具:[scripts/auto_test_lib.py](../../scripts/auto_test_lib.py)
- 第一个 domain 用例:[tests/fixtures/auto_sync/domains/contract.yaml](tests/fixtures/auto_sync/domains/contract.yaml) - 第一个 domain 用例:[tests/fixtures/auto_sync/domains/contract.yaml](../../tests/fixtures/auto_sync/domains/contract.yaml)
## 3. 配置管理 ## 3. 配置管理
@@ -330,7 +330,7 @@
- 一类后端读写不一致问题。 - 一类后端读写不一致问题。
2. **先单 domain 复现** 2. **先单 domain 复现**
- 用 [scripts/run_auto_test.py](scripts/run_auto_test.py) 只跑目标 domain。 - 用 [scripts/run_auto_test.py](../../scripts/run_auto_test.py) 只跑目标 domain。
- 目的不是求“全绿”,而是先确认问题是否稳定复现。 - 目的不是求“全绿”,而是先确认问题是否稳定复现。
3. **定位并修复一类根因** 3. **定位并修复一类根因**
@@ -343,7 +343,7 @@
- 记录这轮减少了多少失败 case。 - 记录这轮减少了多少失败 case。
5. **再跑聚合回归** 5. **再跑聚合回归**
- 用 [scripts/run_auto_test_all_domains.py](scripts/run_auto_test_all_domains.py) 执行全量聚合; - 用 [scripts/run_auto_test_all_domains.py](../../scripts/run_auto_test_all_domains.py) 执行全量聚合;
- 当前聚合模式是“**每个 domain 独立初始化并单独执行**”,用于避免跨 domain 状态污染。 - 当前聚合模式是“**每个 domain 独立初始化并单独执行**”,用于避免跨 domain 状态污染。
6. **输出轮次结论** 6. **输出轮次结论**
@@ -58,27 +58,27 @@ large_scale_test:
## 使用方式 ## 使用方式
- 控制入口:调整本文档 frontmatter 中的 `rounds` - 控制入口:调整本文档 frontmatter 中的 `rounds`
- 执行脚本:[scripts/run_large_scale_auto_test.py](scripts/run_large_scale_auto_test.py) - 执行脚本:[scripts/run_large_scale_auto_test.py](../../scripts/run_large_scale_auto_test.py)
- 默认命令:`python scripts/run_large_scale_auto_test.py` - 默认命令:`python scripts/run_large_scale_auto_test.py`
## 设计约束 ## 设计约束
- 默认使用 `fresh` 初始化,优先保证每轮从干净环境开始。 - 默认使用 `fresh` 初始化,优先保证每轮从干净环境开始。
- `aggregate` runner 适合大规模基线回归;它内部会对每个 domain 独立初始化。 - `aggregate` runner 适合大规模基线回归;它内部会对每个 domain 独立初始化。
- `domains` runner 适合小范围复核;它会按 [scripts/run_auto_test.py](scripts/run_auto_test.py) 的语义执行。 - `domains` runner 适合小范围复核;它会按 [scripts/run_auto_test.py](../../scripts/run_auto_test.py) 的语义执行。
- 失败不应靠 fallback 掩盖;应在轮次记录里明确分类。 - 失败不应靠 fallback 掩盖;应在轮次记录里明确分类。
## Runner 约定 ## Runner 约定
### `aggregate` ### `aggregate`
- 调用 [scripts/run_auto_test_all_domains.py](scripts/run_auto_test_all_domains.py) - 调用 [scripts/run_auto_test_all_domains.py](../../scripts/run_auto_test_all_domains.py)
- 适合建立全量基线 - 适合建立全量基线
- 最能避免跨 domain 污染 - 最能避免跨 domain 污染
### `domains` ### `domains`
- 调用 [scripts/run_auto_test.py](scripts/run_auto_test.py) - 调用 [scripts/run_auto_test.py](../../scripts/run_auto_test.py)
- 适合复核单个或少量 domain - 适合复核单个或少量 domain
- 用于缩小上下文,验证某个问题是否稳定复现 - 用于缩小上下文,验证某个问题是否稳定复现
+2 -2
View File
@@ -59,8 +59,8 @@
- `auto_bind=false` - `auto_bind=false`
- 症状:MISSING 节点更容易进入 `WARNING`,不会走自动创建识别。 - 症状:MISSING 节点更容易进入 `WARNING`,不会走自动创建识别。
- `skip_sync=true` - `local_orphan_action=none` + `remote_orphan_action=none` + `update_direction=none`
- 症状:该类型只加载不执行 bind/create/update,常被误以为“没生效”。 - 症状:该类型会被整体跳过,常被误以为“配置没生效”。
- `load_mode=persisted_only` - `load_mode=persisted_only`
- 症状:数据只来自持久化,不主动拉取新数据。 - 症状:数据只来自持久化,不主动拉取新数据。
- `update_direction=none` - `update_direction=none`