docs

文档索引与事实边界

本项目的文档按“先知道能做什么，再追溯证据，最后规划实现”的顺序组织。事实以带有来源和 时间的信息为准；计划、假设和待验证项不应被当成已完成工作。

当前基线

• 设备：Xiaomi Pad 7（uke）；硬件目标为 SM7675，厂商 BSP 以 cliffs/SM8635 兼容族 命名。
• 固件：OS3.0.302.0.WOZCNXM，Android 14，stock kernel 为 6.1.138-android14-11-g0c3d559bcd85-ab14529422。
• 实现基线：linux/ 固定为 upstream v6.12；stock 6.1.138 和厂商 6.1 源码仅作为 启动格式、设备树和驱动依赖的参考。
• 已完成：固定公开源码子模块；保存派生 DTS、模块清单和镜像元数据；完成线刷包 DT 与运行时 FDT 的交叉验证。
• 已完成：首次最小启动实验已刷入三份实验镜像；用户观察到后置闪光灯按预期闪烁三次。
• 已完成（2026-09-11）：ABL framebuffer 定位后接入上游 simplefb/fbcon，用户反馈“完美启动”， 屏幕控制台启动通过实机验收；保留供电、时钟和电源域调试参数。
• 待补齐：本地候选与 stock 哈希已保存，仍需绑定实际刷入文件、目标 slot 和完整运行日志； 完整 DRM、休眠恢复、长期稳定性及 USB 功能不因本轮显示启动成功而自动视为通过。
• 设备基线：slot a 是唯一确认可工作的 stock Android；slot b 未验证，不能假设其 内容可启动或与工厂包相符。

阅读路径

文档	用途
UKE_KERNEL_PATCHES.md	当前 v6.12 派生内核补丁、DTBO/config 配套项和功能边界。
UKE_SIMPLEFB.md	已确认 ABL framebuffer 的 simplefb/fbcon 配置、成功启动反馈和后续验证边界。
UKE_DEVICE_STATE.md	实机只读状态、已知 slot 边界与任何人工测试前必须补齐的证据。
UKE_LINUX_PORTING_REFERENCE.md	线刷包内容、可获得的证据、不可触碰分区和只读提取方法。
UKE_FDT_DEVICE_LIST.md	运行时 FDT 驱动清单、公开源码覆盖度与实现优先级。
UKE_BOOTSTRAP_ROADMAP.md	从 stock userspace bring-up 到个人 upstream kernel 的阶段性目标。
../artifacts/README.md	派生资料和原始输入的存放/版本控制规则。

原始镜像、解包、日志和完整运行时采集位于被忽略的 ../artifacts/raw/ 与 ../uke_images_*/，不属于可分发的项目文档。具体节点和哈希应引用 artifacts/ 中的派生 DTS、清单和说明，而不是重新复制原始二进制内容。