diff --git a/CLAUDE.md b/CLAUDE.md index dc2c1f3..24c285a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -22,7 +22,7 @@ nax(**N**-arty **A**rithmetic e**X**ecution)的 Rust 重写:隐私计算 ## 快速验证 ```bash -cargo test --workspace --features secure # 450 用例(不带 secure 只有 415,漏 35 条) +cargo test --workspace --features secure # 462 用例(不带 secure 只有 415,漏 47 条) cargo build -p nax-core --no-default-features # no_std 守线 cargo check --workspace --target armv7-unknown-linux-gnueabihf # 交叉编译守线 cargo build --release -p nax-cli && ./target/release/nax selftest diff --git a/README.md b/README.md index b7f8f59..646c386 100644 --- a/README.md +++ b/README.md @@ -32,21 +32,21 @@ | `nax-fl` 联邦聚合 + DP + FedAvg | ✅ 安全聚合责任链(Clip/Zero/SecureSum/Mean/GaussianNoise)+ 差分隐私(RDP 记账)+ 横向 FedAvg(local_train/metrics/加权均值/收敛轨迹),12 测含 4 逐位 golden;`--features secure` 另有 2 方 Vault 密态加权均值端到端 1 测 | | `nax-ml` 纵向 LR + MLP + 分箱 | ✅ sigmoid 奇多项式 + Beaver SGD(明文对照 >0.95);MLP 4 测;异构分箱 + WOE/IV + 互补抑制 6 测;密文 `Mᵀ@y` 箱计数 1 测 | | `nax-data` 数据层 | ✅ Frame(选择/矩阵/列和)+ 明文统计(均值/方差/协方差/相关)+ mock(确定性主键/schema 合成/DP)+ CSV,16 测 | -| `nax-sql` SCQL 引擎 | ✅ 手写解析器 + 掩码式 WHERE + 聚合/GROUP BY/k-匿名/投影约束/JOIN/HAVING/ORDER BY,15 测;`--features secure` 另有密态 WHERE/复合谓词(AND/OR/NOT)/IN/**列 vs 列**/GROUP BY/k-匿名 9 测 + **JOIN×PSI 端到端 6 测**(PSI → 按键字节序对齐 → 密态聚合,对拍明文 JOIN)+ **n 方竖向列交换 2 测** + **迁移对拍 6 测**(手写协议序列留作 oracle:`COUNT`/`SUM`/`MIN`/`MAX` 逐位相同、轮数不增)。协议序列已改由 `nax-ir` 编译,`nax sql-plan` 可查轮数 | +| `nax-sql` SCQL 引擎 | ✅ 手写解析器 + 掩码式 WHERE + 聚合/GROUP BY/k-匿名/投影约束/JOIN/HAVING/ORDER BY,15 测;`--features secure` 另有密态 WHERE/复合谓词(AND/OR/NOT)/IN/**列 vs 列**/GROUP BY/k-匿名 9 测 + **JOIN×PSI 端到端 6 测**(PSI → 按键字节序对齐 → 密态聚合,对拍明文 JOIN)+ **n 方竖向列交换 2 测** + **迁移对拍 6 测**(手写协议序列留作 oracle:`COUNT`/`SUM`/`MIN`/`MAX` 逐位相同、轮数不增)+ **整数分组码 12 测**(前缀和路径与逐组比较对拍、越界/非整数码契约、8 组 162→92 轮)。协议序列已改由 `nax-ir` 编译,`nax sql-plan` 可查轮数 | | `nax-policy` 策略/审计 | ✅ 出域守卫(exec/transfer/fetch)+ Label 六档 + 审计日志(过滤/汇总/裁剪),9 测 | | `nax-runtime` 执行模式 | ✅ dry_run / real_run(线程局部 + RAII 嵌套恢复),4 测 | | `nax-ir` 算子图与轮次规划 | ✅ `Vis`(公开/秘密)与**定点尺度 `k`** 都挂在值上 + 强制 `Lift` 节点 + `base/end` 排程 + 同阶段 open 合并;`nax plan` / `nax sql-plan` 可查。36 测含**两方真 Vault 端到端**、调用序验证、`cmp` 轮数实测(`CMP_ROUNDS=9`),见 `docs/IR.md` | | `nax-he` Paillier/OLE | ✅ 无可信发牌方 Beaver 物料 + PIR,50 条 Python 逐位对照 + 13 语义测试 | | `nax-tee` HAL | ✅ trait + Mock 实现;`TrustPlan` 是 **n 方计算函数**(`for_parties` + `TrustPolicy`,L0–L3),`nax trust` 可查;OP-TEE 待接 | -| `nax-cli` | ✅ 单二进制,`selftest` / `trust` / `plan` / `node` / `psi` / `lr` / `lr-vertical` / `fl` 子命令;`--features secure` 另加 `nax sql`(in-process)、`nax sql-plan`(把聚合查询编成计划报轮数,不联网不需要数据)与 `nax sql-join`(真 TCP 两进程 JOIN×PSI×密态 SQL) | +| `nax-cli` | ✅ 单二进制,`selftest` / `trust` / `plan` / `node` / `psi` / `lr` / `lr-vertical` / `fl` 子命令;`--features secure` 另加 `nax sql`(in-process)、`nax sql-plan`(把聚合查询编成计划报轮数,不联网不需要数据;`--group-mode coded` 走整数码前缀和,8 组 162→92 轮)与 `nax sql-join`(真 TCP 两进程 JOIN×PSI×密态 SQL) | | `nax-orch` 编排 | ✅ 661 行纯 std,PLAN 协议 + 两阶段提交,7 单测;本机三进程跑通 | | `nax-ray` Ray C++ 内核 | ✅ 链接 `_raylet.so` 接入真实集群(拿到 raylet 分配的 node id),见 `docs/RAY_CORE.md` | | Ray 1.0.1 跨架构 | ✅ x86_64 原生 + armv7(qemu) 同集群,两端各自注册成 driver,跨架构 MPC 结果一致,见 `docs/RAY_CORE_101.md` | | armv7 交叉编译 | ✅ **真出二进制**:musl 静态 687 KB,`file` 显示 `ARM, EABI5, statically linked` | ```bash -cargo test --workspace --features secure # 450 用例(含 n 方:vault 三方算子 / 真 TCP 三方会话与 PSI / 列交换 / 纵向 LR;nax-ir 36 条含两方真 Vault 端到端) -cargo test -p nax-sql --features secure # 38 用例(含 JOIN×PSI 端到端 + 列 vs 列 + n 方列交换 + 迁移对拍) +cargo test --workspace --features secure # 462 用例(含 n 方:vault 三方算子 / 真 TCP 三方会话与 PSI / 列交换 / 纵向 LR;nax-ir 36 条含两方真 Vault 端到端;nax-sql 的 coded 12 条对拍整数分组码) +cargo test -p nax-sql --features secure # 50 用例(含 JOIN×PSI 端到端 + 列 vs 列 + n 方列交换 + 迁移对拍 + 整数分组码对拍) cargo build --release -p nax-cli && ./target/release/nax selftest cargo check --workspace --target armv7-unknown-linux-gnueabihf ``` @@ -368,7 +368,8 @@ crates/ ├── nax-policy/ 出域守卫(exec/transfer/fetch)+ 审计日志 ├── nax-runtime/ 执行模式:dry_run / real_run(线程局部 + RAII 嵌套恢复) ├── nax-ir/ 算子图 IR:Vis + 定点尺度 k(都挂在值上)+ 强制 Lift + base/end 排程 -│ `nax plan`(纵向 LR)/ `nax sql-plan`(掩码聚合)报交互轮数 +│ `nax plan`(纵向 LR)/ `nax sql-plan`(掩码聚合)报交互轮数; +│ 分组可选 `--group-mode coded`(整数码前缀和,8 组 162→92 轮) ├── nax-fl/ 联邦聚合 + 差分隐私 + 横向 FedAvg(聚合责任链 + RDP 记账 + fedavg/linear/metrics,对齐 ml/aggregators, privacy/dp, ml/fedavg) ├── nax-tee/ TEE HAL:seal / unseal / attest / sign ├── nax-proto/ 帧编解码(手写,不引 protobuf)