From 94032a1e08b3b56967367e7a0bcc48fb901ca258 Mon Sep 17 00:00:00 2001 From: anonsaber Date: Thu, 1 Oct 2026 02:38:16 +0800 Subject: [PATCH] docs: right-size test guidance and Redis wording --- AGENTS.md | 9 +++++---- README.md | 2 +- README.zh-CN.md | 2 +- 3 files changed, 7 insertions(+), 6 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 20942cd..812d655 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -168,11 +168,12 @@ ### 6.2 测试要求 -- 每个行为变更都要有测试覆盖；纯重构不得改变测试总数。 +- 测试投入与风险匹配：影响安全不变量、API 契约、持久化、重试/幂等或关键数据流的行为变更，应增加或调整能区分正确与错误行为的测试。纯文档/文案、格式化、机械重命名，以及有充分理由确认不改变行为的局部整理，不需要新增单元测试。 - **每条硬性安全不变量都要有一条测试或断言能证明它成立**，而不是只写在文档里。 -- 门禁必须全部通过才算交付：格式化检查、依赖锁校验、静态检查（warning 当错误）、测试。 -- **禁止**删除测试、跳过测试、放宽检查级别、删除访问控制来通过门禁。 -- **不得提交未验证的代码。** 门禁结果必须来自本轮实际执行，不得沿用历史结论。 +- 选最小但有判别力的验证：开发中优先跑受影响的测试；在一个关键阶段、准备提交或交付前，再运行该改动要求的完整门禁。独立且微小的编辑不要求每次重复全量测试。 +- 门禁必须全部通过才算交付：适用的格式化检查、依赖锁校验、静态检查（warning 当错误）与测试。门禁范围和严重级别不得为了变绿而缩小。 +- **禁止**删除已有测试、跳过必要验证、放宽检查级别或删除访问控制来通过门禁。 +- **不得提交未验证的代码。** 结果必须来自本轮实际执行；记录测试范围和结果，不得沿用历史结论。 ### 6.3 测试与实现同路径 diff --git a/README.md b/README.md index 4b85e4e..4f62d6f 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,7 @@ State is an architectural boundary here, not a preference. ## 2. 5-minute setup -Requires a reachable Redis 7 instance and a JMAP session plus a Telegram bot token. +Requires a reachable Redis instance and a JMAP session plus a Telegram bot token. **This is a local container smoke test.** Production deployment can use any platform that can run the backend container, inject encrypted secrets, and connect to externally managed diff --git a/README.zh-CN.md b/README.zh-CN.md index c3319f5..c000919 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -27,7 +27,7 @@ MessageWeave 位于 JMAP 邮件服务器（例如 Stalwart）与 Telegram bot ## 2. 五分钟跑起来 -需要可达的 Redis 7 实例、一个 JMAP session 与一个 Telegram bot token。 +需要可用的 Redis 服务、一个 JMAP session 与一个 Telegram bot token。 ```sh cp .env.example .env # 填写 REDIS_URL 与 CONFIG_ENCRYPTION_KEY