From 515c3d93882e37602d27dbe5f43634ee80441bd8 Mon Sep 17 00:00:00 2001 From: strepsiades Date: Mon, 9 Mar 2026 17:07:25 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E9=A1=B9=E7=9B=AE=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/auto_test_spec/agent_auto_test_method.md | 16 ++++++++-------- docs/auto_test_spec/large_scale_test_control.md | 8 ++++---- docs/operations.md | 4 ++-- 3 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/auto_test_spec/agent_auto_test_method.md b/docs/auto_test_spec/agent_auto_test_method.md index cee0e60..da314c1 100644 --- a/docs/auto_test_spec/agent_auto_test_method.md +++ b/docs/auto_test_spec/agent_auto_test_method.md @@ -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. **输出轮次结论** diff --git a/docs/auto_test_spec/large_scale_test_control.md b/docs/auto_test_spec/large_scale_test_control.md index ae99bba..3eaee07 100644 --- a/docs/auto_test_spec/large_scale_test_control.md +++ b/docs/auto_test_spec/large_scale_test_control.md @@ -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 - 用于缩小上下文，验证某个问题是否稳定复现 diff --git a/docs/operations.md b/docs/operations.md index 065f077..d9bcfbd 100644 --- a/docs/operations.md +++ b/docs/operations.md @@ -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`