docs: 补命名沿革与兼容约定,明确 nax 字面量的保留边界

- README 新增沿革小节:改名映射、三个 tag、两类刻意保留项、部署迁移清单
- CLAUDE.md 加硬约束,避免后续把协议域分隔常量与 refs/nax 当漏改清理
- OPT_PLAN 标注握手 label 沿用历史域分隔常量
This commit is contained in:
admin committed 2026-11-05 15:11:59 +08:00
1 parent 2d062f501b
commit f36217c36a
3 files changed
+23 -2

No files matched your search

+5 -1
View File
@@ -3,7 +3,11 @@
## 项目是什么
ssw-mpc(尚数网-多方安全计算 / Secure Multi-Party Computation):Rust 实现的隐私计算框架,单二进制、低依赖、TEE 可编入。
参考实现在 `refs/nax/`(Python/numpy/Ray,独立 git 仓库),**只读,不参与构建**,仅作行为基线与性能对照组。
参考实现在 `refs/nax/`(Python/numpy/Ray,独立 git 仓库,目录名沿用前身未改),**只读,不参与构建**,仅作行为基线与性能对照组。
> **改名约定(前身 `nax-rs` → `ssw-mpc`)**:crate `mpc-*`、二进制 `mpc`、环境变量 `MPC_*`。
> 协议域分隔常量(`nax/...`、`nax-psi-v1` 等)与 `refs/nax/` 路径是**兼容契约,禁止改名** ——
> 前者决定密钥/分片派生,后者是独立仓库的真实目录。详见 README「命名沿革与兼容约定」。
## 三条铁律(优先级高于一切)
+16 -1
View File
@@ -2,7 +2,22 @@
Rust 实现的隐私计算框架,单二进制、低依赖、可编进 TEE。
参考实现(Python/numpy/Ray)在 `refs/nax/`,只作为**行为基线与性能对照组**,不参与构建。
参考实现(Python/numpy/Ray)在 `refs/nax/`(独立只读仓库,目录名沿用前身、未随本次改名),只作为**行为基线与性能对照组**,不参与构建。
## 命名沿革与兼容约定
前身 `nax-rs`(N-arty Arithmetic eXecution),2026-11-05 改名为 `ssw-mpc`:
18 个 crate 与目录统一 `mpc-*`、主二进制 `mpc`、环境变量 `MPC_*`。
改名前基线 tag `nax-rs-final`,改名提交 tag `ssw-mpc-rename`,CI 全绿首版 tag `ssw-mpc-v0.1.0`。
代码与文档里仍有少量 `nax` 字面量,是**刻意保留的兼容契约,不要顺手清理**:
| 类别 | 例子 | 原因 |
|---|---|---|
| 协议域分隔常量 | `nax/tee/dev/v1`、`nax-psi-v1`、`nax-v1/derive` | KDF/HMAC 标签参与密钥与分片派生,改了会与已部署节点、Python golden 向量逐位不一致 |
| 参考实现路径 | `refs/nax/...` | 独立只读仓库的真实目录(`.gitignore` 已排除),改了文档就指向不存在的路径 |
部署迁移:`NAX_*` → `MPC_*`、`libnax_ray.so` → `libmpc_ray.so`、远端 `ssw/nax-rs.git` → `ssw/ssw-mpc.git`。
---
+2
View File
@@ -53,6 +53,8 @@ Python 算法层、BFIA 互操作(有对接需求才做)。
A → B : OK {tag_a = HMAC(psk, "nax/v1/client" ‖ A ‖ B ‖ na ‖ nb)}
```
> label 沿用前身的域分隔常量 `nax/v1/*`,是兼容契约,不随改名调整(见 README「命名沿革与兼容约定」)。
两个 tag 用不同 label,防「把对方 tag 原样打回来」。
`connect_mesh(...)` 保持原签名,内部转调 `psk = None`(存量测试不受影响);
有 PSK 时对端没有 PSK 会被拒(**不静默降级**)。