修改项目文档

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)
- 流水线测试配置:[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/run_auto_test.py](scripts/run_auto_test.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)
- 测试总配置:[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)
- 初始化脚本:[scripts/auto_test_init.py](../../scripts/auto_test_init.py)
- 统一运行脚本:[scripts/run_auto_test.py](../../scripts/run_auto_test.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)
## 3. 配置管理
@@ -330,7 +330,7 @@
- 一类后端读写不一致问题。
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. **定位并修复一类根因**
@@ -343,7 +343,7 @@
- 记录这轮减少了多少失败 case。
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 状态污染。
6. **输出轮次结论**
@@ -58,27 +58,27 @@ large_scale_test:
## 使用方式
- 控制入口:调整本文档 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`
## 设计约束
- 默认使用 `fresh` 初始化,优先保证每轮从干净环境开始。
- `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 掩盖;应在轮次记录里明确分类。
## Runner 约定
### `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 污染
### `domains`
- 调用 [scripts/run_auto_test.py](scripts/run_auto_test.py)
- 调用 [scripts/run_auto_test.py](../../scripts/run_auto_test.py)
- 适合复核单个或少量 domain
- 用于缩小上下文,验证某个问题是否稳定复现
+2 -2
View File
@@ -59,8 +59,8 @@
- `auto_bind=false`
- 症状:MISSING 节点更容易进入 `WARNING`,不会走自动创建识别。
- `skip_sync=true`
- 症状:该类型只加载不执行 bind/create/update,常被误以为“没生效”。
- `local_orphan_action=none` + `remote_orphan_action=none` + `update_direction=none`
- 症状:该类型会被整体跳过,常被误以为“配置没生效”。
- `load_mode=persisted_only`
- 症状:数据只来自持久化,不主动拉取新数据。
- `update_direction=none`