# xtee-storage

**Repository Path**: openkylin/xtee-storage

## Basic Information

- **Project Name**: xtee-storage
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-03
- **Last Updated**: 2026-10-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# xtee-storage 文档索引

Rust 重实现 Trusty Storage TA 的设计与实施文档。

Trusty / xtee-storage 本机根路径见 [handoff §路径约定](./storage-rust-ta-handoff.md#路径约定本机默认)。

## 文档列表

| 文档 | 用途 | 读者 |
|------|------|------|
| **[storage-rust-ta-handoff.md](./storage-rust-ta-handoff.md)** | **5 分钟交接**；新 Chat 入口 | 所有人 |
| [storage-rust-ta-design.md](./storage-rust-ta-design.md) | 架构、trait、兼容性 L1–L4、恢复、生命周期、Golden、迁移 | 实现者、Architect review |
| [storage-rust-ta-plan.md](./storage-rust-ta-plan.md) | 里程碑 M0–M7、PR 切分、**§12 Dashboard**、门禁 | 排期、执行 |
| **[storage-rust-ta-m1-plan.md](./storage-rust-ta-m1-plan.md)** | **M1 / PR2 已关档**（`block_host_test` 120/120） | 实现者 / 考古 |
| **[storage-rust-ta-m2r-plan.md](./storage-rust-ta-m2r-plan.md)** | **M2r / PR3r 已关档**（L2 flush failing、fault 注入） | 实现者 / 考古 |
| **[storage-rust-ta-m2g-plan.md](./storage-rust-ta-m2g-plan.md)** | **M2g / PR3g 已关档**（Golden L1、upgrade、Golden-A、baseline） | 实现者 / 考古 |
| **[storage-rust-ta-m2d-plan.md](./storage-rust-ta-m2d-plan.md)** | **M2d / PR3d 已关档**（Differential harness、C oracle） | 实现者 / 考古 |
| [storage-rust-ta-m2m-design.md](./storage-rust-ta-m2m-design.md) | M2m 挂载元数据模糊测试设计与 C 兼容判定矩阵 | 实现者、Architect review |
| **[storage-rust-ta-m2m-plan.md](./storage-rust-ta-m2m-plan.md)** | **M2m 已关档**（checked parser、mount fuzz；`dd36fba`） | 实现者 / 考古 |
| **[storage-rust-ta-m3-plan.md](./storage-rust-ta-m3-plan.md)** | **M3 / PR4 已关档**（NO_RPMB commit_gen、tee_counter） | 实现者 / 考古 |
| **[storage-rust-ta-m4-plan.md](./storage-rust-ta-m4-plan.md)** | **M4f 已关档**（Trusty 薄壳 + android-port 51/51；`80b1692`） | 实现者 / 考古 |
| **[storage-rust-ta-m6-design.md](./storage-rust-ta-m6-design.md)** | **M6-N 关档定案**（NO_RPMB wiring/reboot+wipe-persist；**non-product rollback root**） | Architect、M6 实现者 |
| **[storage-rust-ta-m6-plan.md](./storage-rust-ta-m6-plan.md)** | **M6-N 切片已关**（M6a–M6f；证据 [`pr-m6`](./evidence/pr-m6/)） | M6 实现者 |
| **[storage-rust-ta-m7-design.md](./storage-rust-ta-m7-design.md)** | **M7 Phase 2 架构定案**（crate 拆分、rust-libtipc、reconnect） | Architect、M7 实现者 |
| **[storage-rust-ta-m7-plan.md](./storage-rust-ta-m7-plan.md)** | **M7-B / PR9 已关档**（PoC-0～3、A9–A11；证据 [`pr9c`](./evidence/pr9c/)） | M7 实现者 / 考古 |
| **[libtrusty-host-linux-design.md](./libtrusty-host-linux-design.md)** | **libtrusty x86 host + VSOCK** 架构、强制代码改动、NS 桥契约（post-review v2） | M7 联调、libtrusty 实现者 |
| **[libtrusty-host-linux-plan.md](./libtrusty-host-linux-plan.md)** | **libtrusty host**：**阶段 A/B/CI 已关**；O2 未关 | libtrusty / M7 实现者 |
| **[xtee-ca-ta-dev-guide.md](./xtee-ca-ta-dev-guide.md)** | **dev**：host+QEMU x-kernel 上 CA→TA 调试；unittest 语义矩阵；**≠** android-port 51/51 | 开发调试 |
| [kylin100-storageproxyd-startup-and-device-validation-20260824.md](./kylin100-storageproxyd-startup-and-device-validation-20260824.md) | Kylin 100 `storageproxyd` 开机服务、DTA CA 和真机 TP/TDEA/TD 验证流程 | 真机联调、验收 |
| **[xkernel-storage-unittest-plan-b-design.md](./xkernel-storage-unittest-plan-b-design.md)** | **方案 B**：x-kernel storage 语义矩阵、真机集成、身份边界与 evidence 设计 | Architect、测试实现者 |
| **[xkernel-storage-unittest-plan-b-implementation-plan.md](./xkernel-storage-unittest-plan-b-implementation-plan.md)** | **方案 B 实施计划**：U1–U8、B0 三件套、阶段门禁 | 实现者 |
| [../tools/client-harness/schemas/storage-result-record-v1.md](../tools/client-harness/schemas/storage-result-record-v1.md) | **U2 第一步**：runner 机器结果行协议 v1（协议定稿草稿） | 实现者 / 协议评审 |
| **[xtee-ca-ta-three-gaps-plan.md](./xtee-ca-ta-three-gaps-plan.md)** | 三缺口竖切：代码已落；**待 fresh guest live** | 实现 / 关门 |
| **[xtee-ca-ta-review-brief.md](./xtee-ca-ta-review-brief.md)** | 外审开场词 / 复审要点 | 外审 / 交接 |
| [CONTEXT.md](../CONTEXT.md) | 领域术语表（Phase 1/2、adapter、NS 桥接） | 所有人 |
| [docs/adr/](./adr/) | 架构决策记录（Phase 2 crate 拆分、rust-libtipc） | Architect |
| [review-checklist.md](./review-checklist.md) | PR Review：layout、padding、零 Panic、**unsafe 规约**、Golden、Reconnect | 作者、Reviewer |

## 快速导航（设计文档章节）

| 主题 | 设计 § |
|------|--------|
| 兼容性 L1–L4 + **Contract** | [§11.5](./storage-rust-ta-design.md#115-compatibility-contract兼容性契约) |
| 崩溃恢复 / checkpoint | [§12](./storage-rust-ta-design.md#12-recovery--crash-consistency恢复与崩溃一致性) |
| TIPC / proxy reconnect | [§13](./storage-rust-ta-design.md#13-connection-lifecycle连接生命周期) |
| BlockDevice 持久化契约 | [§3.1.1](./storage-rust-ta-design.md#311-persistencecontract持久化契约采纳) |
| block_cache 时序（P0） | [§6.3](./storage-rust-ta-design.md#63-block_cache-兼容性关键路径p0采纳) |
| 协议 Serialization Contract | [§6.2.3](./storage-rust-ta-design.md#623-protocol-serialization-contractadr-31采纳) |
| 性能门禁 | [§18](./storage-rust-ta-design.md#18-performance-gate性能门禁) |
| Golden Image + Fuzz | [§14](./storage-rust-ta-design.md#14-golden-image-test-framework) |
| x-kernel Phase 1→2→3 | [§15](./storage-rust-ta-design.md#15-migration-pathx-kernel-演进) · **[M7 design](./storage-rust-ta-m7-design.md)** |
| 三轮评审回应 | [§9](./storage-rust-ta-design.md#9-架构评审回应) |

## 里程碑速查

| 阶段 | 焦点 |
|------|------|
| M0–M3 | layout → FS → Golden/Diff/L2/fuzz → commit_gen · **✅** |
| M4 / M4e / M4f | Trusty 薄壳；android-port 51/51 + soak · **✅** |
| M6-N / M7-B | TDP wiring；Phase 2 ephemeral · **✅** |
| M5 / M6-P / M6-R | RPMB；产品 rollback；RPMB-TDP · **⏸** |

## 门禁与看板

| 资源 | 用途 |
|------|------|
| [plan §10 门禁](./storage-rust-ta-plan.md#10-m4-前兼容性门禁compatibility-gate) | M4e 前 L1/L2 条件 |
| [design §19 Dashboard](./storage-rust-ta-design.md#19-compatibility-dashboard兼容性看板) | 门禁定义 + CI 模板 |
| [plan §12 Dashboard](./storage-rust-ta-plan.md#12-compatibility-dashboard兼容性看板) | 每周状态 |
| [design §18](./storage-rust-ta-design.md#18-performance-gate性能门禁) | M2g baseline → M4e 趋势 → M5 硬门禁 |

## 外部参考（Trusty 树）

- C TA：`trusty/user/app/storage/`
- 协议：`trusty/user/base/interface/storage/include/interface/storage/storage.h`
- NO_RPMB handoff：`trusty/docs/storage-no-rpmb-dev-handoff.md`