# IDPS Rust 全量评审合并规则

来源：Trail of Bits、awesome-skills、BeautifulRust 的去重、中文改写与语义校正；另加明确标注的 IDPS 项目约束。来源编号分别见 [Trail of Bits](trailofbits.md)、[awesome-skills](awesome-skills.md)、[BeautifulRust](beautiful-rust.md)。版本、校正和许可见 [README](README.md)；本文件按 CC BY-SA 4.0 提供。

## 使用和判定方法

本次检查完整范围内的已有缺陷，不只检查最近 diff。优先级为：逻辑和数据正确性、资源和并发正确性、安全边界、错误处理与可维护性。先读取适用的 AGENTS.md、CLAUDE.md、Cargo.toml、工具链和模块协议。评审不授权自动修改代码。

每条发现必须给出：规则 ID、文件与行号、触发输入/执行顺序、实际影响、代码证据、最小修复建议和建议的回归场景。跨文件结论需列出关键调用者/被调用者；看不到所需上下文时标为“待验证”，不得补造代码或运行结果。只声称实际执行过的编译、测试、Miri 或 fuzz 结果。

按“已证实缺陷 / 项目规范违规 / 待验证疑点 / 改进建议”说明结论性质，并另行说明严重度。内存不安全、数据损坏、认证绕过、不可恢复的服务中断优先；缺注释、命名或没有启用某个 lint 本身不证明高危漏洞。无需为每个检查项制造发现；同一根因和修复点合并，保留不同触发路径。

以下 R01–R38 是通用规则；I01–I07 是 IDPS 约束。风格项仅在有明确维护成本或项目要求时提出建议；既有架构、协议和兼容约定优先。机器可验证的格式/lint 交给现有检查；对工具输出仍需核对适用条件。

## 一、逻辑、错误和数据正确性

- **R01 外部输入与状态机**：检查长度、范围、状态迁移、重复事件、乱序及失败后重试的业务语义。校验在分配或副作用前完成，非法/缺失状态不被默认值伪装成成功。来源：A-19、B-07、B-14。
- **R02 panic 可达性**：追踪外部输入和实际业务路径到 unwrap/expect、assert、unreachable、下标与 RefCell 借用冲突；区分线程/任务终止和 panic=abort 的进程影响。证明已有边界约束后不误报安全下标。来源：UNWRAP、ASSERTREACH、OOBIDX、REFCELLPANIC、A-15。
- **R03 数值和字符串边界**：核对溢出、截断、符号转换、除零、MIN/-1、NaN/Inf 和 UTF-8 字符边界。按业务选择 checked、饱和或回绕语义，不自动将所有 as 判错。来源：ARITHOFL、LOSSYFROM、FLOATEDGE、STRSLICE。
- **R04 错误传播和上下文**：关键 Result 不静默丢弃；错误保留原因、操作与脱敏参数，在负责层处理/记录；避免 .ok()、默认回退或 map_err 丢掉需要诊断的原因。来源：RESDISC、A-14、A-15、A-22、B-16。
- **R05 错误类型与清理**：库的可处理错误类型供调用者匹配；应用层使用项目约定的上下文错误。Drop 不依赖可失败的关键提交或 panic；需要确认成功的关闭/刷新使用显式接口并处理错误。来源：DROPPANIC、BUFFLUSH、B-15、B-16、B-17。
- **R06 类型与集合契约**：Eq/Ord/PartialOrd/Hash 语义一致；进入 Map/Set/Heap 后不改变键的比较/哈希属性。不仅凭手写/derive 组合判错；普通集合逻辑错误与 unsafe 中的 UB 分开说明。来源：ORDEQHASH、KEYMUT、B-10。
- **R07 编码与确定性**：手写 Serialize 的字段/元素数和内容一致；身份、路径、授权判断不使用有损字符串转换或错误的前缀匹配；签名、哈希和要求可复现的输出不依赖随机迭代顺序。来源：SERFIELDS、LOSSYSTR、STRCMP、NONDET。

## 二、异步、并发和资源

- **R08 执行器阻塞**：检查同步 I/O、睡眠、锁竞争和长 CPU 工作是否阻塞 executor。按场景使用异步 API、专用线程或有并发上限的 spawn_blocking；考虑阻塞任务开始后通常不能通过 abort 停止。来源：ASYNCBLOCK、A-06、B-22。
- **R09 锁范围和顺序**：追踪 guard、DashMap 引用和临时值的实际生命周期，核对重复锁、ABBA、读升级写及回调重入。避免同步锁跨 await；Tokio Mutex 可跨 await，但仍须证明无循环依赖并控制持锁时长。来源：DLOCK、ABBA、REENTRANT、A-07、B-21。
- **R10 同步原语与通知**：条件变量谓词受锁保护并处理虚假唤醒；Once/Lazy 初始化不重入；通道保留的 sender 不得使接收端永久等待；普通 Tokio 信号任务不误判为 POSIX 信号处理函数。来源：CONDVAR、ONCEREENTRY、CHANSTARVE、REENTRANT。
- **R11 原子性和线程边界**：load/store 组合是否需要 CAS、锁或单写者保证；检查内存序、static mut、跨进程共享映射和 unsafe Send/Sync 的真实契约。编译器已经拒绝的调用不描述成可运行漏洞。来源：ATOMICRACE、UNSAFESYNC、SENDSYNCBOUND、SHMRACE、STATICMUT。
- **R12 取消与部分进度**：检查 select、timeout、abort、连接断开处每个 await 前后的状态和消息所有权。部分读写、取出后待发送、ACK 与提交之间须可恢复、回滚或幂等重试。pin 和“事务”命名本身不是证明。来源：CANCELSAFETY、A-09、A-10、A-11。
- **R13 帧读取和公平性**：read_exact/write_all 被取消时核查进度保存；换成 read 仍需维护帧边界和偏移。select 的默认/biased 选择按退出时限和公平性判断，避免持续就绪的工作饿死 shutdown 或反过来饿死必要收尾。来源：SELECTBIAS、CANCELSAFETY、A-10。
- **R14 任务生命周期**：每个长期 spawn 任务有 owner、退出信号、JoinError 和业务 Result 处理；丢弃 JoinHandle 通常是脱离管理，不是停止任务。等待、abort、超时和资源清理有可执行的顺序。来源：A-12、A-13、A-21、B-22。
- **R15 背压和资源预算**：检查输入长度、队列、缓存、去重表、重试、任务并发和日志量是否有上限及满载策略；评估 O(n²) 放大、失败重试风暴、内存/CPU/磁盘耗尽。来源：RESEXHAUST、A-21、B-28；磁盘与重试语义同时按 IDPS 运行约束核对。
- **R16 深度和栈消耗**：外部可控的递归结构在解析、Debug/Display/Serialize、日志和 Drop 各阶段都需检查深度；先核实库已有保护，再判断是否需要限深或迭代实现。来源：RECURSEDES、RECURSEFMT、RECURSEDROP。
- **R17 资源所有权和落盘**：文件描述符、连接、外部句柄有唯一明确的释放责任；exit/forget/ManuallyDrop 不绕过必要清理；重要 BufWriter 输出检查 flush 错误。flush 不等于断电持久化，按业务契约核查文件同步、原子替换和恢复。来源：RAWFD、DROPSKIP、BUFFLUSH、B-17、B-19；持久化要求见 I04。

## 三、unsafe、FFI 和系统边界

- **R18 安全封装的健全性**：建立安全入口到 unsafe 的调用路径。安全接口通过类型、封装或实际检查保障前置条件；unsafe fn 明确调用者义务。安全函数不能只写 Safety 注释就转嫁义务。来源：URAPI、SAFETYDOC、A-04、B-23。
- **R19 release 下的安全条件**：不能依赖会被关闭的 debug_assert、只在测试成立的范围或只在某 feature 下存在的检查保护 unsafe。来源：DEBUGSAFETY、A-05。
- **R20 初始化、容量和析构**：核对 MaybeUninit、set_len、from_raw_parts、ptr::write/read；所有被当作 T 访问/析构的元素已初始化，len 不超过有效元素。防止向未初始化槽位赋值触发旧值析构。来源：UNINITREAD、SETLEN、INVFREE、BOF。
- **R21 指针与表示**：核对存活期、分配来源、别名、对齐、复制重叠、访问范围、transmute、枚举判别值和 union 有效位模式；胖指针元数据不能在后续操作需要时丢失。指针转换本身不等于 UB。来源：TRANS、RAWPTR、PTRCAST、REPRC、ENUMUB、UNIONUB、PACKEDREF。
- **R22 释放与 unwind 安全**：裸指针不悬垂，同一资源不重复释放；用户闭包 panic 或容器更新中断后，已初始化计数和析构路径仍正确。安全 trait 返回的不可信长度不能直接驱动 unsafe 访问。来源：UAF、DFREE、PANICUNWIND、TRAITADV、CLOSUREPANIC。
- **R23 FFI 契约**：Rust/C ABI、布局、宽度、目标平台和库版本一致；CString/opaque handle/回调捕获持续有效；分配与释放配对；不直接传不稳定 trait object ABI 或对象 padding 作为协议字节。来源：ABIMISMATCH、CSTRDANGLE、OPAQUEPTR、FOREIGNDROP、DYNFFI、REPRCPAD。
- **R24 FFI panic 和回调退出**：明确跨边界的 unwind/abort 策略，不能假定 catch_unwind 捕获 abort。回调注销、在途调用和对象释放顺序可证明，无已释放状态的迟到访问。来源：CLOSUREFFI、B-24。
- **R25 路径和文件竞态**：外部路径不能通过绝对路径、..、符号链接越界；检查后使用的路径不被替换，结合原子创建、目录/文件句柄和权限设计。来源：PATHJOIN、TOCTOU。
- **R26 敏感信息和地址暴露**：日志、Debug、错误、序列化输出不泄露密钥、token、敏感载荷；运行时地址输出按接收方权限和可利用性评估。来源：PTREXPOSE、A-23、B-09、B-20。

## 四、API、维护成本、构建和测试

- **R27 领域类型和构造**：需要区分的单位/ID 使用明确类型；enum/Option 表达状态；集中校验跨字段约束。多个 bool、公开可变字段或复杂构造仅在易误用/破坏不变量时提出具体建议。来源：A-20、B-07、B-11、B-12。
- **R28 所有权和借用**：参数与返回值符合只读、修改、保存的需求；评估重复 clone、Arc/RefCell 和复杂生命周期的真实成本。共享 actor 状态、缓冲复用、明确的拥有结果不因写法偏好被重构。来源：A-01、A-02、A-03、B-04、B-05、B-06。
- **R29 公共 API 演进**：检查可见性、trait 契约、第三方类型暴露、返回类型和 non_exhaustive/sealed 的兼容影响；更改前搜索调用者、协议和持久化消费者。来源：B-08、B-09、B-12、B-14。
- **R30 抽象与重复逻辑**：指出有实际错误风险或同步维护成本的重复；trait/泛型/dyn/宏按实际多态和编译体积需求取舍，不为消除所有重复新增框架层。来源：A-18、B-01、B-13、B-18；跨仓复用见 I07。
- **R31 性能建议需要依据**：核对热路径的 collect、分配、clone、每条日志和逐项加锁；优先解释复杂度或提供测量证据，再建议批量、缓冲复用或容量优化。不要一律替换分配器/hasher 或把循环改迭代器。来源：A-16、A-17、B-20、B-28。
- **R32 文档与可理解性**：文档说明错误、Safety、取消、所有权及副作用；说明不变量为何成立。命名、导入、Builder 与语法偏好归为建议，不掩盖真实缺陷。来源：SAFETYDOC、A-20、B-18、B-20、B-26。
- **R33 Cargo 和 MSRV**：edition、rust-version、编译器、依赖 API 与 features 一致；核对 host/Android 差异和 workspace 继承，不因本机新编译器通过就声称 MSRV 通过。来源：MSRV、A-08、B-25。
- **R34 lint 与依赖配置**：读现有 Cargo/Clippy/CI 设置后判断安全 lint 是否被错误关闭；已有 unsafe 的边界 crate 不强制 forbid(unsafe_code)，未开 pedantic 不判缺陷；核查有实际风险的弃用/不稳定 API。来源：CARGOLINT、DEPRECAPI、B-02、B-03、B-25。
- **R35 失败和边界测试**：检查非法输入、零/最大长度、溢出、超时、断连、队列满、磁盘失败、任务退出和取消后恢复；回归场景应在旧实现暴露缺陷，而非复述实现。来源：A-20、A-21、B-27。
- **R36 可重复测试和性质**：时间、随机、网络、路径可控制；测试不互相污染。对编解码、持久化状态和重复事件检查往返、幂等和不变量，避免用固定 sleep 假设完成。来源：B-27；测试隔离同时遵循 IDPS 既有测试规范。
- **R37 按风险选工具**：格式/lint/测试使用现有 Makefile；解析器考虑 fuzz，unsafe 考虑 Miri，跨平台代码检查目标配置。未运行或不支持时明确写出限制；这些工具不能证明业务语义全部正确。来源：B-02、B-24、B-27。
- **R38 报告可操作性**：每项引用规则、位置和证据；解释触发条件与影响并给最小修复及回归场景。合并同根因重复，不强行固定发现数量；区分确定性和严重度。来源：B-29、Trail of Bits 各检测器的条件与误报排除说明。

## 五、IDPS 项目规则

以下来自当前工作区规范及 idps-server 运行契约，不宣称来自上述三个上游仓库。

- **I01 生产错误处理**：生产代码禁止 unwrap/expect；应用层使用 anyhow/context，需结构化匹配的领域错误使用 thiserror。测试中的 unwrap/expect 按测试用途判断。
- **I02 actor 生命周期**：沿用现有 cloud/config/listener/register/report/rule 分工，以受控任务和消息传递表达长期子系统；检查启动失败、断连重连、退出、残留发送者和在途消息，不新增平行顶层架构。
- **I03 本地与云端语义**：本地接受/回应与云端确认分开，不能用云端暂时不可达阻断既定本地响应，也不能把本地接受冒充云端交付。保持组件与 VSOC 的字段、帧、鉴权和消息语义兼容。
- **I04 持久化与重试**：/etc/idd 为配置/随包资产，/data/idd 为运行状态；检查失败、重启和重复上报下的落盘、ACK、重试、去重及规则切换一致性，防止先删后发或错误确认造成数据丢失。
- **I05 日志和安全边界**：使用 tracing，敏感载荷/密钥不进日志；TLS、身份和密钥轮换符合已有契约；不要提出绕过 Android SELinux neverallow 的修复。
- **I06 工具链和验证范围**：根自动化使用 rustup run 1.93.0，仍需尊重各 Cargo.toml 的 MSRV；idps-server 的根入口为 make check project=server。协议或 idps-base 公共 API 变化需覆盖下游，并按影响选择集成/设备验证；本清单的提取本身不代表已执行扫描或这些检查。
- **I07 共享逻辑与维护**：跨组件核心行为优先复用 idps-base；保留明确产品差异和协议兼容处理。只在证实重复维护成本或正确性风险时建议提取，避免无必要的重构。

项目来源：工作区根 `AGENTS.md`/`CLAUDE.md`，`idps-server/AGENTS.md`/`CLAUDE.md`、`idps-server/docs/architecture.md`、`idps-server/docs/detailed-design.md`，以及既有 [Rust 代码审查规范](../rust-code-review.md)。扫描时以目标分支实际文件为准。
