本仓库构建 Debian 13 arm64 + Phosh 的独立 userdata.img，并复用已验证的
Wayne 硬件层和固定 U-Boot boot.img。项目目前属于 Alpha 阶段，刷机前必须
阅读 问题与测试状态，修改内核前必须阅读
维护者指南。
内核源码、Wayne DTS、已验证配置和构建脚本位于独立仓库：
jakecommon/linux-sdm660-xiaomi-wayne。
Debian 用户空间构建输入位于 debian/：packages.txt 记录直接请求的软件包，
rootfs-overlay/ 保存设备专用系统配置。详见 Debian 构建说明。
发布目录为 release/：
boot.img：固定且不可修改的 U-Boot 镜像。userdata.img：Debian 13、Phosh、稳定 DTB 和非默认 OTG 测试 DTB。SHA256SUMS：发布镜像校验值。README.md、KNOWN_ISSUES.md、MAINTAINERS.md：中文发布说明。experiments/README.md：OTG 测试和回滚说明。provenance/和RECOVERY-AUDIT-2026-07-28.md：中文历史审计资料。GITHUB-PUBLISHING.md：按多仓库模式公开发布的结构和授权说明。RELEASE-NOTES-v0.1.0-alpha.md：首个 Alpha 版本的 GitHub Release 正文。
- 只允许刷写
boot（p58）和userdata（p64）。 - 不得写入 modem、vendor、persist、recovery、GPT、NV/EFS 或其他分区。
wayne-gnome-uboot.img必须保持逐字节不变。- 在 SDM660 idle 问题修复并验收前，必须保留
cpuidle.off=1。 - modem 和 persist 只能只读挂载。
- 原厂无线地址必须在启动时读取，不能写入镜像。
- 展开后的 ext4 不得超过
55155060736字节。fastboot 暴露的 p64 上限为55155064320字节，比 Linux 报告的物理大小少 16 KiB。
- 用户名：
debian - 初始 PIN、登录、sudo 和 SSH 密码：
147147 - 稳定 USB 模式下：
ssh debian@172.16.42.1 - 用户自行配置 Wi-Fi 后，也可通过手机的 Wi-Fi 地址进行密码 SSH。
- root SSH 和公钥登录默认禁用；SSH host key 在首次启动时按设备生成。
- 发布镜像不包含 Wi-Fi 凭据、维护者公钥、machine-id、host key、日志或浏览器资料。
147147 是公开弱密码，首次启动后必须立即修改。开发者可以在运行
prepare-context.sh 时显式设置 SSH_PUBLIC_KEY，但由此生成的镜像不得公开分发。
extlinux 包含两个使用相同稳定内核和 initramfs 的启动项：
Debian 13 Phosh stable USB gadget：默认项，使用稳定 peripheral DTB， 保留 USB ECM/ACM 恢复能力。Debian 13 Phosh OTG test：非默认实验项。选择前必须阅读 OTG 测试说明，并确保 Wi-Fi SSH 和 recovery 可回滚。
构建前需要在本地准备固定内核、模块、固件，以及与文档哈希匹配的 rmtfs 和
diag-router。这些生成物和可能受单独许可约束的固件不进入公开 Git 仓库。
默认输入位置和可覆盖环境变量见 scripts/prepare-context.sh；源码恢复状态见
provenance/README.md。
./scripts/prepare-context.sh
./scripts/check-context.sh
USER_PIN=147147 ./scripts/build-rootfs.sh
./scripts/build-image.sh
./scripts/verify-image.sh
./scripts/package-release.sh主机上的 Waydroid Houdini binfmt 注册会与 QEMU arm64 binfmt 冲突。
prepare-context.sh 会检测该状态并拒绝继续构建。
- 从 p64 通过 extlinux 启动 Debian 13 和 Phosh。
- USB ECM
172.16.42.1/24、ACM 串口和 OpenSSH 恢复。 - WCN3990 Wi-Fi、原厂地址读取、关闭扫描地址随机化和
CN默认监管域。 - WCN3990 蓝牙 DT serdev 和
crnv21.bin。 - Qualcomm 内核 QRTR/PD mapper、TQFTP 和只读 RMTFS。
- MSS、ADSP、Adreno A512 固件和 Mesa workaround。
- 稳定 USB gadget DTB，以及独立的非默认 OTG 测试 DTB。
这里列出的是集成范围，不等于全部完成硬件验收。所有已知缺陷和待测试项目 统一记录在 KNOWN_ISSUES.md。
仓库记录了已刷写并验证的二进制基线。独立内核仓库已经公开固定源码 tree、
配置和构建环境，但自动生成的模块签名密钥以及历史稳定二进制来源仍使内核无法
逐字节复现；Debian 软件源也尚未固定到日期快照，因此目前不是完全可复现发布。
技术审计见 RECOVERY-AUDIT-2026-07-28.md，源码边界见
provenance/SOURCE-STATE.md，中文索引见 provenance/README.md。
运行 ./scripts/check-provenance.sh 可检查本地基线文件；加 --full 会读取约
74 GiB 的大型镜像数据。