Umbrella / ecosystem repository. Implementation lives in PaxonHuang/EgoGlove. 状态：2026-08-19 仓库基线建立。当前真实实现见下方 Source of Truth，勿把规划当已实现。
EgoMotion 是一个正在形成的上层项目方向：把"人体手部 + 触觉运动数据"组织成 Physical AI / 具身智能可消费的数据基础设施——采集、标定、同步、标准化（Hand Token v2 + V8 语义层）、导出与遥操作。
本仓是 umbrella / platform 仓：承载项目定位、跨仓真相源、ADRs、研究与数据契约；不承载产品代码。产品代码、固件、relay、测试全部在 EgoGlove 实现仓。
- EgoMotion = 上层基础设施方向（本仓）。
- EgoGlove = 实现仓（ESP32-S3/P4 手部智能层，Hand Token v2 + 双表示层）。
- Demo1 = 当前硬件验证里程碑：ESP32-S3 + 11×LSM6DSV16X + 3×HKVT-M3A，统一 acquisition timeline → USB 数据流。
EchoGlove（早期挑战杯项目名）与 EgoGlove（当前实现仓）是历史/现阶段项目资产；EgoMotion 是当前正在形成的上层方向。本仓不虚构公司、产品上市或商业落地状态。
| 仓 | 角色 | 内容 |
|---|---|---|
PaxonHuang/EgoMotion（本仓） |
Umbrella | 定位、真相源、ADR、研究/数据契约、第三方索引 |
PaxonHuang/EgoGlove |
Implementation | 固件（lite/pro/shared）、relay、models、sdk、web、docs/V7、docs/V8、测试 |
冻结决策见 docs/ADR-001-repository-topology.md（EgoMotion 伞仓 + EgoGlove 实现仓，不 rename、不改 remote）。
| 阶段 | 状态 | 证据 |
|---|---|---|
| Phase 1A — HKVT-M3A minimal driver | ✅ 已完成（软件层） | EgoGlove commit f29f398；16 项 host 单测全绿 |
| Phase 1B — 单颗 LSM6DSV16X (native ESP-IDF) | 🏗️ 未开始 | — |
| Phase 1C — 11×LSM6DSV16X acquisition | 🏗️ 未开始 | — |
| Phase 1D — 3×HKVT + 11×IMU raw stream | 🏗️ 未开始 | — |
NOT HARDWARE VERIFIED（待真实硬件实测）：
- HKVT opcode 0x03/0x1A 真机有效
- 200Hz 真机行为、NACK+STOP 真机行为、sync_error <1ms
- 11-IMU 吞吐、jitter、clock drift
- 2×TCA9548A 拓扑（无 PCB pinmap，ADR-002 标记 NOT HARDWARE VERIFIED）
| 仓 | branch | HEAD | push |
|---|---|---|---|
| EgoMotion（本仓） | main | （本次治理后更新） | 本次将 push |
| EgoGlove | feature/human-motion-infrastructure | f29f398 (HKVT Phase 1A) |
未 push（2 commits 待 push） |
| third-party-deepresearch | main | f69d3d5 |
已 push（含本地未提交删除，非本次产生） |
以 Git 实际状态为准，不信任旧文档里的 commit hash。
Phase 1A 完成 → 下一阶段 Phase 1B（单颗 LSM6DSV16X driver，native ESP-IDF in EgoGlove/firmware/pro/）。
本次会话只做仓库/文档治理，不进入 Phase 1B 代码开发。
EgoMotion/
├── README.md ← 本文件（伞仓入口）
├── LICENSE ← MIT
├── docs/ ← 跨仓真相源、ADR、状态矩阵
│ └── ADR-001-repository-topology.md (见 §3)
├── firmware/pro/ ← Demo1 固件正式位置（native ESP-IDF，本轮仅占位）
├── hardware/ ← 硬件设计资料（本轮占位）
├── software/ ← 上层软件/SDK 契约占位
├── research/ ← 研究底稿索引（指向 third-party-deepresearch）
├── datasets/ ← 数据契约/数据集占位
├── tools/ ← 工具占位
└── third-party/ ← 第三方资料索引占位
最小可扩展脚手架，不为形式感建空目录。
firmware/pro/是 Demo1 确定位置，本轮不放代码。
- Source of Truth：
docs/STATUS.md（Current/Planned/Proposed/Historical/Research/Deprecated） - 文档真相矩阵：
docs/DOC_MATRIX.md - ADR-001：
docs/ADR-001-repository-topology.md（仓库拓扑冻结） - 实现仓详细文档：见 EgoGlove
docs/V7/、docs/V8/
Phase 1B：在 EgoGlove/firmware/pro/ 新建 native ESP-IDF 工程，实现单颗 LSM6DSV16X driver（WHO_AM_I、寄存器配置、accel/gyro、ODR、DRDY、timestamp/seq、错误恢复）。前提：本次仓库治理完成且 Git baseline 可复现。
- EchoGlove（挑战杯项目："基于 IMU 和柔性传感器的手语翻译·手势动作捕捉·3D 渲染物联网手套"）= HISTORICAL，作为项目演进历史保留，不作为当前产品定义。
- 早期 BP 市场数据/准确率/成本/用户数 =
HISTORICAL / CONTEST MATERIAL，不迁入技术 README。 - 历史仓库 EchoGlove-SLR-MOCAP-{Beta,Alpha,Portal-old} = 只读 archive，不直接迁入。
- 提交身份：
PaxonHuang <quenchkidney@outlook.com>，无 AI co-author。 - 真实性分级：✅ 已实现 / 🟡 工程可实现 / 🔬 需研发验证 / 🌌 长期方向。
- 事实优先级：当前真实代码 > Git 状态 > 最新架构/设计文档 > 历史文档。
- 不把 proposal 写成 implemented；不把设计目标写成已验证。
- 未经用户明确指示不 push、不 force push、不 reset/rebase/clean。
- 不可逆删除必须先经用户审阅。