chg_0011: pm 报告 — 196/0 + 32% 复用 + 建议合并

This commit is contained in:
xstudio agent committed 2026-09-29 16:00:25 +08:00
1 parent 2a228a5f51
commit 650ef34b43
1 file changed
+15 -102
+15 -102
View File
@@ -1,106 +1,19 @@
# chg_0010 federated_risk_control — 完成报告
=== chg_0011 vehicle_cloud_compliance ===
PASS
> 2026-09-29 · owner: pm@team · status: **建议合并**
完成时间:2026-09-29(dispatch 派单 + self-takeover)
改动文件清单:
- openspec/changes/chg_0011_vehicle_cloud_compliance/{proposal,spec,tasks,testcases,testcases.map.yaml,.xstudio-report}.md
- docs/dth/vc/scenario.md(6 步流程 + 6 算子映射 + 出域 PII 清单 + 复用矩阵)
- tests/e2e/dth_vc.test.sh(10 case / 24 assertion / 26s)
## 改动文件清单
门禁结果(T4):
- gate gap=0 ✅
- tsc 0 新错 ✅
- 7 回归 + 1 新 = 8 套 e2e 同 backend 实例,全 196/0 ✅
| 文件 | 行数 | 一句话 |
|---|---:|---|
| `openspec/changes/chg_0010_federated_risk_control/proposal.md` | (existing) | 业务动因 + acceptance |
| `openspec/changes/chg_0010_federated_risk_control/spec.md` | 1 行修正 | PSI 三方黑名单 → A∩B∩C = [f01,f02,f03] |
| `openspec/changes/chg_0010_federated_risk_control/tasks.md` | (existing) | DAG(T1~T5) |
| `openspec/changes/chg_0010_federated_risk_control/testcases.md` | 1 行修正 | C4 PSI 输入同步 |
| `openspec/changes/chg_0010_federated_risk_control/design.md` | 5 件套设计主文件(与 proposal 平级) |
| `docs/dth/frc/scenario.md` | 新增 197 行 | 6 步 mermaid 流程 + 8 算子映射 + 9 不变性 + 复用矩阵 |
| `tests/e2e/dth_frc.test.sh` | 新增 ~470 行 | 12 case 端到端串联(C1~C12 = S1~S12)|
算子复用矩阵:
- 6/19 = 32%(chg_0011 独占:data-masking / horizontal-fedavg)
- 与 chg_0010 互补(共有 4 算子 / chg_0011 独占 2 / chg_0010 独占 4)
## 门禁结果(T4)
| 门禁 | 结果 |
|---|---|
| `PROJECT_ROOT=. bash openspec/scripts/check_spec_coverage.sh` | **gap = 0** ✅ |
| `cd src/backend && npx tsc --noEmit` | **0 新错**(仅 chg_0002 vertical-lr.ts:52 预存 TS2352)✅ |
| `bash tests/e2e/dth_frc.test.sh` | **pass=37 fail=0**(12 case 37 assertion)✅ |
| 6 回归 + 1 新 = 7 套 e2e 同 backend 实例 | **全 172/0** ✅ |
### 7 套 e2e 成绩
| 套件 | case | pass | fail | 来源 |
|---|---:|---:|---:|---|
| dth_experiment | 16 | 16 | 0 | chg_0002 |
| dth_experiment_extend | 27 | 27 | 0 | chg_0005 |
| dth_lms | 17 | 17 | 0 | chg_0006 |
| dth_lite_demo | 33 | 33 | 0 | chg_0007 |
| dth_operator_real | 15 | 15 | 0 | chg_0008 |
| dth_sp1_more | 27 | 27 | 0 | chg_0009 |
| **dth_frc** | 37 | 37 | 0 | **chg_0010** |
| **总计** | **172** | **172** | **0** | — |
## 算子复用矩阵(chg_0010 → 既有 19 算子)
| 算子 | 来源 chg | FRC 复用 | 步骤 |
|---|---|:---:|---|
| `did-identity` | chg_0009 | ✅ | S1 / S2 |
| `tds-connector` | chg_0009 | ✅ | S1 / S3(mismatch 路径) |
| `psi` | chg_0009 | ✅ | S3 / S4 |
| `paillier-he` | chg_0009 | ✅ | S6 |
| `threshold-sig` | chg_0009 | ✅ | S7 / S8 |
| `data-watermark` | chg_0009 | ✅ | S10 |
| `abac-policy` | chg_0009 | ✅ | S9 |
| `compliance-audit` | **chg_0008** | ✅ | S11(v1 已带 schema v2) |
| `data-masking` | chg_0009 | ❌ | 字段级脱敏,PSI 已覆盖 |
| `model-watermark` | chg_0009 | ❌ | 模型分发,FRC 不涉及 |
| `mpc-beaver` | chg_0009 | ❌ | 通用 MPC 三元组,Paillier 已覆盖 |
| 其他 8 算子(hello-mpc / pir / vertical-lr / scql / horizontal-fedavg / secure-mlp / tee-inference / prompt-defense) | chg_0002/0005/0008 | ❌ | FRC 不需要 |
**复用率**:
- chg_0009 新增 10 算子 → **复用 8 = 80%** ✅(≥ 80% 阈值)
- chg_0008 真算法算子 → **复用 1 = 100%** (合规审计)
- 19 算子总体 → **复用 9 ≈ 47%**
## FRC 内 4+1+1+1 关键覆盖
| 类型 | 断言 | 结果 |
|---|---|---|
| **不变性 1** | PSI 交集正确 = [f01,f02,f03] | ✅ C4_psi_ABC_intersection |
| **不变性 2** | PSI 不泄露非交集元素 | ✅ C5_psi_no_non_intersection_leak |
| **不变性 3** | Paillier 跨行同态求和 = Enc(600) | ✅ C6_paillier_sum_invariant |
| **不变性 4** | 水印 roundtrip 严格一致 | ✅ C10_watermark_extract_roundtrip |
| **篡改检测** | DID 篡改 → verify_with_wrong_secret | ✅ C2_did_tamper_detected + C2_did_bad_secret_rejected |
| **拒绝路径** | TDS hash 不匹配 → contract-mismatch | ✅ C3_tds_mismatch_*(3 断言) |
| **E2E 串联** | 1 shell 跑 C1~C11 全过 | ✅ C12_e2e_full_flow_pass |
## 实施取舍
1. **PSI 三方求交**:psi operator 仅支持两两求交。FRC 走两步串接
`(A∩B) ∩ C`,与 spec 等价且与算子 v2 行为一致。
2. **DID 篡改检测语义**:did-identity operator 每次都重建 doc + HMAC,
无 store/verify 分离模式。FRC 用「不同 identifier 同 secret」或
「同 identifier 但 verify_with=篡改 secret」两种方式触发 verify failure,
语义上等价于「doc 被改」+「密钥被改」两类篡改。
3. **审计链构造**:python heredoc 在 bash 变量内插复杂 JSON 时易触发
`JSONDecodeError`。FRC 用「python 文件 + json.load(prior_file)」+
`export ADMIN_TOKEN` 给子进程,**POST 后跟 GET /runs/:id 拿 output_json**
(与 chg_0009 一致)。
4. **场景拒绝路径**:C3 显式校验 `tds.error == "contract-mismatch"` 且
`access_token is None` —— 此步直接断言 FRC 流程在此被拦截。
5. **spec 输入修正**:原 testcases/spec 写 A=[f01..f04] / B=[f02,f03,f05] /
C=[f01,f03,f06,f07],但实际 A∩B∩C=[f03] ≠ 文档声明的 [f01,f02,f03]。
改为 A=[f01..f04] / B=[f01..f03,f05] / C=[f01..f03,f06,f07],
A∩B∩C=[f01,f02,f03],与文档输出对齐。
## 是否建议合并
**是。** 理由:
- 0 新代码 / 0 新依赖 / 0 新接口(与 proposal "不做" 段完全一致)
- 5 件套完整 + 门禁 gap=0 + tsc 0 新错 + 7 套 e2e 172/0 全 PASS
- 算子复用率 80%(chg_0009)满足 handoff §2 的「证明算子能组合」目标
- 场景测试 < 3s,不拖累回归套件
## 下一步建议
- 归档 chg_0010:`mv openspec/changes/chg_0010_federated_risk_control → archive/2026-09-29-chg_0010_federated_risk_control`
- handoff §2 优先级 2(chg_0010 设计)关闭;§2.3 框架文档化(dispatch-helpers 收口)
可作为 chg_0011 候选——文档化为开箱即用的 helper / prompt 模板,避免后人重复踩坑。
— chg_0010 闭环 —
是否建议合并:是(详见 openspec/changes/chg_0011_vehicle_cloud_compliance/.xstudio-report.md)