docs/module/dos-protection.md (2)

23-23: ⚡ Quick win

“断开 5 分钟”措辞建议统一为“封禁/屏蔽 5 分钟”，避免语义歧义

前文提到是“短暂封禁它们，释放连接资源”，但这里写“该连接将被断开 5 分钟。”读者可能会疑惑这是“断开连接但可能立刻重连”，还是“在 5 分钟内被封禁/屏蔽不再建立连接”。建议统一用词（例如直接写“封禁 5 分钟”或“断开并在 5 分钟内不再允许重新连接”）以和前文语义对齐。

建议改写

-然后，该连接将被断开 5 分钟。
+然后，该连接将被封禁（或屏蔽）5 分钟。

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@docs/module/dos-protection.md` at line 23, 将文档中语句“该连接将被断开 5
分钟。”与前文“短暂封禁它们，释放连接资源”保持一致，改为明确表达为“封禁/屏蔽 5 分钟”或更完整的“断开并在 5
分钟内不再允许重新连接”；定位到包含原句（“该连接将被断开 5 分钟。”）的段落并替换为例如“该连接将被封禁 5
分钟（在此期间不允许重新建立连接）”以消除歧义并与前文语义对齐。

---

13-18: ⚡ Quick win

把“持续满足/任意条件/附加条件”写成明确的布尔逻辑（并请核对实现一致性）

目前这段描述已经表达了“连续 5 分钟满足（从先前的‘没有满足’翻转为‘满足’）”，但仍可能让读者对“持续”到底作用于哪些项、以及 AND/OR 组合关系产生误解。建议用等价的括号表达式写清楚，例如：

• 令 A=上传或下载速率 < 64B/s
• 令 B=回报的进度差异 < 0.001%
• 令 C=做种状态
• 令 D=下载状态但没有交换任务兴趣信息

则应在文档中明确为：(A OR B) 持续 5 分钟成立 AND (C OR D) 成立 才会判定为空闲。

同时请核对实际实现是否真的是这个规则（尤其是“持续”是否只针对 A/B，而不是要求 C/D 也持续 5 分钟），否则文档会直接误导用户如何判断与调参。

建议改写

-默认设置下，如果一个连接连续 5 分钟满足下列任意一个条件，将被视为空闲连接（或者叫死连接）：
+默认设置下，如果在连续 5 分钟内满足下列检测条件之一且至少一个始终成立（(A OR B) 持续成立），并且满足下列附加条件之一（(C OR D)），将被视为空闲连接（或者叫死连接）：
 
 * 上传或者下载的速率小于 64 字节每秒(64B/s)，(1KB = 1024B)
 * 回报的进度差异小于 0.001%
 
 同时，还满足了下列的附加条件的一个或多个：

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@docs/module/dos-protection.md` around lines 13 - 18,
将原文中关于“持续满足/任意条件/附加条件”的自然语言改为明确的布尔逻辑表达并核对实现一致性：在文档中定义
A=上传或下载速率<64B/s、B=回报的进度差异<0.001%、C=做种状态、D=下载状态但没有交换任务兴趣信息，然后把判定条件写成明确的表达式“(A OR
B) 持续 5 分钟成立 AND (C OR D) 成立”，并在文档中注明“持续 5 分钟”仅适用于 A/B 条件（或说明如果实现中 C/D
也需持续则同步更新文档），最后核对并备注当前实现中的实际逻辑是否与该表达式一致以避免误导。