Commit Graph
5 Commits
Author SHA1 Message Date
admin 01b8bb44aa docs: 更新 OP-TEE 实跑状态,纠正文档里 storage 默认路径的错误认知
- docs/INDEX.md / ARCHITECTURE_SYSTEM.md / README.md:
  「OP-TEE QEMU 实跑未做(缺 SDK)」改为已做,但明确标注是 QEMU 模拟
  (dna = 编译期 sha256 种子、HUK = 模拟值),不能当真板设备绑定证据。
- docs/OPTEE_VERIF_PLAN.md:补第 4 条实跑证据表与破坏实验表;
  新增坑 ⑦⑧⑨(storage 默认路径 / 落点检查时机 / QEMU 不退出);
  状态表判据用例 15 → 19;步骤 3 状态改为完成。
- 更正 §3 里「storage 默认在 /data/tee,所以不用改 tee-supplicant 启动参数」
  这句错误认知 —— 实测默认是 /var/lib/tee,必须显式 -f /data/tee。
- ARCHITECTURE_SYSTEM.html 由 tools/render-share-html.py 重新生成,--check 同步通过。
- CLAUDE.md 补集群调度面与 OP-TEE 实跑结论。
2026-11-09 13:20:35 +08:00
admin 660e5712c3 feat(tee): 真机双机实跑复验,固化 /opt 物料基线与本机重建条件
用户要求「跑一遍,确保本地资源能用,别两台机器重启就找不到了」。
按固化的三步重跑(env 样例 → 预检 → e2e)在两台真机上实跑:

- 正向 e2e 全绿:从源码重编 musl mpc → 重新导出 alpine rootfs → 重新打
  initrd → 分发 → 双 KBS → 双 guest,TEE_PAIR_OK + TEE_ATTEST_GATE_OK
  + TEE_PAIR_ATTEST_OK,两侧还原 35.000000(2m05s)。
- 负向矩阵全绿:篡改度量 pin ⇒ 403 拒证明、guest fail-closed 拿不到密钥;
  恢复 pin ⇒ 又拿到(TEE_ATTEST_NEGATIVE_OK,exit=0)。
  ★ 修掉旧版单独跑报「缺少 MPC_TEE_MANIFEST」:负向脚本现在自动从
    ${MPC_TEE_WORK}/image 用同一份 oci-image.py verify 重算并断言 64 hex,
    不手抄;两个构造样例验证非法值 / 无产物都 exit=2。

持久化保障(回答「重启就找不到」):
- 实测两台真机 / 是 ext4 / xfs 持久根盘、无独立 /tmp tmpfs;远端三个
  /tmp 运行时目录本来全为空,e2e 每次重铺 ⇒ 丢了不影响重跑。
- 新增 host-materials.sh + nodes/host-materials.sha256(入仓基线 18 条:
  AMD 3 / 海光 15,sha256 + size):--verify 逐台比对,缺文件/被替换/
  被升级一律 FAIL 并打印 diff;--self-test 6 个构造样例证明非恒绿;
  另用「篡改清单一条 hash」端到端破坏验证(精确判红 exit=1)。
  ★ 清单只记路径/大小/哈希,不搬 69MB qemu / 78MB initrd 进仓库;
  清单本身由 git 保护。换机/升级后 --collect 重采。
- 预检新增「本机重建条件」检查:alpine:3.18 镜像、musl target、
  oci-image.py、guest/init.sh、fixtures、物料基线;缺一项即 FAIL。
  完整预检 29/0(含远端),离线 25/0 SKIP=1,自测 7/0,
  lint-shell-vars 34 脚本无隐患。

文档:真机 README 增「机器重启 / 换机后怎么办」分工表与症状速查一条;
INDEX §2/§3/§6 登记新资产与第 11 条纪律;CLAUDE.md 部署段加指针;
env 样例 H 段写明 manifest 两处都不许手抄。
校验:ci.sh 语法、判据零依赖自测 22/0、diff --check、密钥扫描全过。
门禁条数仍为 22(未改 ci.sh)。
2026-11-08 20:01:22 +08:00
admin fc0dcec93b feat(tee): 固化真机双机重跑环境,补齐预检与症状速查,避免每次从零探索
核实结论:这两天 AMD / 海光真机测试内容**早已在仓库** —— 36 个脚本、
288 行复现 README、630 行 FINDINGS、nodes 真机路径样例、fixtures 真实
CSV/SNP 报告与证书链。真正导致「每次重跑重新拼」的只有三处缺口:
参数散在 5+ 个脚本头部、没有预检、踩坑结论按探索时间组织不好按症状查。

- 新增 real-machines.env.example:2026-11-08 证明门控 + 双 guest 会话合流
  跑通那组值的脱敏快照。28 个变量与脚本 ${VAR:-default} 逐字一致(已自动
  核对,无一处笔误);凭据只放 xop 键名;区分组级与编排层实例级变量,
  运行时生成项明确标注「不要手填」。
- 新增 preflight-real-machine.sh:本地工具 / xop 键 / 参数一致性 / SSH /
  远端物料一次性报缺;缺环境显式 SKIP 或 FAIL,不静默通过;
  --self-test 用 6 个构造样例逐条破坏参数判据(7/7),证明非恒绿。
  只查环境,不产生 TEE_PAIR_OK 之类业务结论。
- README 增「重跑前先看」:三步重跑、参数真相源、17 条症状→根因→处置
  速查表、/tmp 60+ 探索脚本处置说明(过程产物,结论已沉淀,不许重跑确认)。
- INDEX §2/§3/§6 与 CLAUDE.md 登记;.gitignore 屏蔽本地实际 env 配置。

校验:bash -n、lint-shell-vars 33 脚本无隐患、预检自测 7/0、离线实跑
ok=15 SKIP=1 FAIL=0、判据零依赖自测 22/0、diff --check、路径与密钥扫描
全过。未改 tools/ci.sh,门禁条数仍为 22。
2026-11-08 19:41:31 +08:00
admin c51190b20c docs: 拆解决策文档形成系统架构文档,附可分享 HTML
- 新增 docs/ARCHITECTURE_SYSTEM.md(活真相源):组件清单、双层控制面、
  会话主键、端到端数据流、部署拓扑、平台矩阵、判定治理、诚实边界。
  用 [实证]/[桩验]/[设计]/[禁用] 区分实证与蓝图 —— `mpc site` 等
  决策角色不再被写成已部署服务,避免照着文档敲不存在的命令。
- 新增 tools/render-share-html.py 与 docs/ARCHITECTURE_SYSTEM.html:
  自包含单文件分享页,md 是唯一真相源、HTML 是派生产物勿手改;
  --check 校验两者同步,生成幂等无 diff 噪音。
- INTEGRATION_ANALYSIS.md 文首加「架构结论已抽出」指针,正文决策取证链
  保持不变;INDEX.md(§0/§2/§3/§6)、CLAUDE.md、README.md 登记新文档
  与第 9 条更新纪律。与原 ARCHITECTURE.md(计算分层)明确分工。
- 校验:HTML 与 md 同步、ci.sh 语法、判据自测 22/22、diff 空白、
  23 个引用路径与密钥扫描全过;纯文档改动未跑全量门禁。
2026-11-08 19:29:18 +08:00
admin c1ae7d7473 docs: 系统性更新项目文档至 2026-11-08 当前状态,新增文档总索引
- 新增 docs/INDEX.md:文档分类(活真相源/专题设计/历史阶段快照)、
  当前状态总览、权威入口表、旧结论对照表、诚实边界与 8 条更新纪律。
- README.md 现状改为「2026-10-30 算子基线 + 2026-11-08 增量」,补齐真机
  TEE、国密链真交易、合约实证、k8s 持久化、22 条门禁与目录树。
- CLAUDE.md 纠正三处失效结论(门禁 20→22 条、3.x eth_ 兼容端点、
  flush 只发规范字节/不宣称能上链),文档章节改为分组索引。
- INTEGRATION_ANALYSIS.md 等历史阶段文档加「当时→当前」状态锚点与对照表,
  保留取证链不改写历史;真机文档第 7/9.4 节指向第 10 节合流结论。
- 修正两处事实错误:k8s README 把本机写成节点 IP、复现文档把
  20200/30300 标反;链复现入口统一指向 deploy/k8s/fisco/README.md。
- 诚实边界保持:软件签名器密评不可过、真 bcos-rpc TLCP 未通、hostd
  执行面仍在真机、OPA 未进 guest、链上撤销与 decision 上链未做。
2026-11-08 19:11:39 +08:00