From ee3f51416da155b4b96f5e650eeb5d3a023378dc Mon Sep 17 00:00:00 2001 From: ulleo Date: Thu, 24 Sep 2026 16:58:36 +0800 Subject: [PATCH] docs(agents): clarify that integration tests may access real services --- docs/agents/testing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/agents/testing.md b/docs/agents/testing.md index 2a8976f6..e22a565c 100644 --- a/docs/agents/testing.md +++ b/docs/agents/testing.md @@ -39,7 +39,7 @@ uv run pytest -q tests/ - 测试可隔离的纯逻辑或服务函数； - 用 `Mock`、`SimpleNamespace`、SQLite 或 AST 加载方式隔离外部数据库和驱动； -- 默认单元/守卫测试不访问真实 LLM、外部数据库或互联网；需要这些依赖时遵循上面的集成验收约定； +- 单元/守卫测试保持离线可重复；确实需要真实 LLM、外部数据库或互联网的用例，按「集成与产品验收」规范编写并单独显式运行，不进入默认收集； - 命名和断言风格跟随相邻测试。 `LOG_FORMAT` 只是 `logging.Formatter` 的百分号格式串模板，代码中没有 JSON 日志实现；若本机环境把它设成了非默认格式串导致 formatter 初始化失败，先检查进程环境与 dotenv 来源；`unset LOG_FORMAT` 后 dotenv 仍可能重新加载该值。可在单次测试命令中使用 `LOG_FORMAT='%(levelname)s %(message)s'`，不要为测试覆盖共享配置。