From 616936fc1ee1e386f94d4f0304ae7ee4c09fcac6 Mon Sep 17 00:00:00 2001 From: mac Date: Wed, 11 Nov 2026 22:15:52 +0800 Subject: [PATCH] Record successful APFS read-only mount and metadata copy verification --- HANDOFF.md | 27 ++-- README.md | 4 + RECOVERY.md | 20 +++ verification/2026-11-11-apfs-sd.json | 48 ++++++ verification/build-packages-2026-11-11.txt | 165 +++++++++++++++++++++ 5 files changed, 255 insertions(+), 9 deletions(-) create mode 100644 RECOVERY.md create mode 100644 verification/2026-11-11-apfs-sd.json create mode 100644 verification/build-packages-2026-11-11.txt diff --git a/HANDOFF.md b/HANDOFF.md index f400097..e05912a 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -4,7 +4,7 @@ ## 当前目标 -在用户提供的 APFS SD 卡上验证 fnOS 本机只读挂载及文件读取,再确定应用封装方案。 +基础 APFS 只读挂载已验证。下一步用普通测试文件验证素材读取及导入,再确定应用封装方案。 ## 已确认 @@ -13,7 +13,7 @@ - 有 `/dev/fuse`、FUSE 3.14、Docker;未检测到 apfs-fuse 或本机编译器。 - 测试卡为约 29.7 GiB USB SD 卡;APFS 分区当前为 `/dev/sde2`,分区 GUID 类型 `7c3457ef-0000-11aa-aa11-00306543ecac`,4096 字节块大小,NXSB 标识正确。 - APFS PARTUUID:`5b255495-2ba8-4e49-8774-227d8dd8878f`。每次操作仍需核实其设备身份、USB 传输及挂载状态,不能盲用 sde2。 -- 读卡器以 USB 5000M 连接。飞牛图形界面显示“未知文件系统”,尚未挂载 APFS。 +- 读卡器以 USB 5000M 连接。飞牛图形界面显示“未知文件系统”;独立 FUSE 挂载已成功,但尚未集成系统界面。 - 本轮 SSH 曾返回 `Exceeded MaxStartups`,等待后恢复。未修改 SSH 服务。 ## 工程与恢复 @@ -23,15 +23,24 @@ - `vendor/apfs-fuse` 保存完整源码快照,含 LZFSE 子模块内容;固定版本见 `UPSTREAM.json`。apfs-fuse `66b86bd525e8cb90f9012543be89b1f092b75cf3`,LZFSE `e634ca58b4821d9f3d560cdc6df5dec02ffc93fd`。 - `packaging/Dockerfile` 在固定 Debian 12 基础镜像中编译 Release;`scripts/build-driver.sh` 导出驱动;`scripts/validate-card.py` 按 PARTUUID + USB 序列号核对设备,临时设置内核只读,测试后卸载并恢复原标志。 - 验证程序检查挂载只读、样本复制 SHA-256、APFS 分区写计数和首 MiB 内容;这不是对整盘所有文件或全部 APFS 特性的兼容性保证。 -- 代码检查点 `737773eb763046ad98d203f6578884ab44e609e0` 已推送并从远程独立克隆核验,LZFSE 源码完整。 -- NAS 验证工程路径为 `/var/tmp/dayu-apfs-validation`。首次构建因 Debian 官方源下载缓慢主动取消,容器源改为中科大镜像并保留 Debian 原有签名校验;不改 NAS 宿主机软件源。重新构建待验证。 +- 首次代码检查点已从远程独立克隆核验,LZFSE 源码完整。实际验证代码为 `d24400b492a90275d8432e63db78c61ff0ddfa09`;本阶段恢复标签为 `poc-apfs-readonly-20261111`,详见 [RECOVERY.md](RECOVERY.md)。 +- NAS 验证工程路径为 `/var/tmp/dayu-apfs-validation`,驱动只放在该目录 `build/bin`,未安装至系统路径。保留该目录和专用构建镜像供后续开发。 +- 首次构建因 Debian 官方源下载缓慢主动取消,改用容器内中科大镜像后 Release 构建成功,仍保留 Debian 原有签名校验;NAS 宿主机软件源未修改。 + +## 验证结果与边界 + +- Python/Bash 语法检查通过;实际不匹配 USB 身份测试被拒绝。 +- NAS 本机 Release 构建成功,运行库均可解析;源码的上游编译警告保留,未修改上游实现。 +- APFS 分区内核只读标志设为 1 后,以 `ro,nodev,nosuid,noexec` 挂载成功。 +- 读取并复制三个 64 KiB 系统隐藏文件,合计 196608 字节,目标 SHA-256 与读取流一致。 +- APFS 分区写入计数测试前后均为 0,首 MiB 哈希不变;测试后已卸载、删除样本副本、恢复原内核只读标志。 +- 未找到 512 MiB 以内的普通文件可作样本;尚未验证普通素材导入、独立 macOS 参考哈希、大文件速度、加密及其他 APFS 特性。64 KiB 隐藏文件的速度没有代表性,不据此承诺提速。 +- 脱敏证据见 [verification/2026-11-11-apfs-sd.json](verification/2026-11-11-apfs-sd.json),编译依赖见同目录清单。证据不包含源文件内容、文件名或凭据。 - 不使用当前聊天原工作目录“大鱼调色”,不修改 NAS 网站生产源。 - 凭据在用户指定的本机安全位置,不进入工程。 ## 待完成 -1. 首次恢复克隆核验。 -2. 在隔离的 Debian 12 容器内构建 Release 只读驱动。 -3. 核验设备身份及驱动只读实现,测试列目录、读取与复制内容校验;不写源卡。 -4. 清理临时挂载与容器,更新证据和远程检查点。 -5. 应用界面、FPK、自动识别、系统文件管理集成及真实 SSD 性能尚未实现。 +1. 等待用户确认普通测试文件情况;建议 100–500 MB 视频,若可提供 macOS 的 SHA-256 则做独立比对。拔卡前从飞牛系统推出整张卡。 +2. 继续使用 PARTUUID 和 USB 身份核对,不假设重新插入后仍为 sde2;重新格式化后 PARTUUID 也会变化。 +3. 应用界面、FPK、自动识别、系统文件管理集成及真实 SSD 性能尚未实现,本阶段不是正式应用交付。 diff --git a/README.md b/README.md index 9fe204e..a3e8f81 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,8 @@ 当前阶段为只读驱动兼容性验证,尚未制作飞牛应用安装包,也未集成系统“外接存储”界面。 +2026-11-11 实机结果:APFS SD 卡只读挂载成功,三个系统隐藏文件复制校验通过,APFS 分区写计数为零。普通素材导入与大文件速度待测试;详见交接及 `verification/`。 + ## 安全边界 - 只对核实身份的 USB APFS 测试分区执行只读访问;不格式化、不修复、不写源盘。 @@ -32,3 +34,5 @@ SD 卡只适合验证基本功能,不能代表外置 SSD 的吞吐;隐藏索 目标远程:`https://dayu.media/git/dayu/fnos-apfs.git`,分支 `main`。 克隆后查看交接及固定驱动版本。凭据、磁盘数据、编译输出和容器镜像不纳入 Git;本机账号需独立配置。 + +完整恢复入口见 [RECOVERY.md](RECOVERY.md)。 diff --git a/RECOVERY.md b/RECOVERY.md new file mode 100644 index 0000000..252ae14 --- /dev/null +++ b/RECOVERY.md @@ -0,0 +1,20 @@ +# 恢复与继续验证 + +- 私有远程:`https://dayu.media/git/dayu/fnos-apfs.git`。 +- 分支:`main`;本轮阶段标签:`poc-apfs-readonly-20261111`。 +- 已实机验证的代码提交:`d24400b492a90275d8432e63db78c61ff0ddfa09`;阶段标签还包含最终验证证据与交接。 +- 完整驱动源码和 LZFSE 依赖均为普通 Git 文件,已保存至 `vendor/`;没有 LFS 对象、Git 子模块或未上传的必要源码。 +- 先登录大鱼站并按现有指南配置 Git 凭据,再克隆项目。凭据和源盘数据不随 Git 保存。 + +```sh +git clone https://dayu.media/git/dayu/fnos-apfs.git +cd fnos-apfs +git switch --detach poc-apfs-readonly-20261111 +git rev-parse HEAD +``` + +在 x86_64 Linux + Docker 中执行 `bash scripts/build-driver.sh`;固定 Debian 12 基础镜像及上游源码版本见 Dockerfile / UPSTREAM.json。APT 依赖版本清单保留在 `verification/`;仓库未封存全部 Debian 软件包,未来源版本变化可能改变二进制哈希。若基础镜像或镜像站不可用,需要恢复对应基础镜像或选用保持 Debian 签名校验的源,不能直接称二进制逐字节可复现。 + +NAS 本机运行依赖:libfuse3、libstdc++、zlib、libbz2,以及 `/dev/fuse`。验证命令见 README;先核对真实 USB 设备、APFS 分区及 PARTUUID,不能复制旧的 `/dev/sde2` 作为永久设备路径。 + +`verification/2026-11-11-apfs-sd.json` 记录测试范围、二进制哈希及源盘只读证据。当前仅证明基础挂载及隐藏系统文件读取;普通用户文件与吞吐尚待测试。NAS 上的 `/var/tmp/dayu-apfs-validation` 是可重建验证目录,不是正式安装或网站生产源。没有发布 FPK 或正式发行安装包。 diff --git a/verification/2026-11-11-apfs-sd.json b/verification/2026-11-11-apfs-sd.json new file mode 100644 index 0000000..65dcce2 --- /dev/null +++ b/verification/2026-11-11-apfs-sd.json @@ -0,0 +1,48 @@ +{ + "date": "2026-11-11", + "platform": "Debian 12 x86_64 / Linux 6.18.18.c1107-trim", + "source_commit": "d24400b492a90275d8432e63db78c61ff0ddfa09", + "upstream": { + "apfs_fuse": { + "url": "https://github.com/sgan81/apfs-fuse.git", + "commit": "66b86bd525e8cb90f9012543be89b1f092b75cf3", + "license": "GPL-2.0-or-later" + }, + "lzfse": { + "url": "https://github.com/lzfse/lzfse.git", + "commit": "e634ca58b4821d9f3d560cdc6df5dec02ffc93fd", + "license": "BSD-3-Clause" + } + }, + "build_image": "sha256:54f96ba87499856e451ed3e8725ea326f8ff8671e622df5e30c0c3b233c426c3", + "binaries": { + "apfs-fuse": { + "bytes": 396832, + "sha256": "89a7083c42fb498b021d9f7fabbc5b754eaae503649500e4926965fdcfbcb11e" + }, + "apfsutil": { + "bytes": 351552, + "sha256": "692bbd961678c5db1a48e00cb2bc96c50e82dd77e39d87cfe11087608b4658ae" + } + }, + "dockerfile_sha256": "cc2cba6f77f03e5beaf548d198ffe4c222b74438e512531afd4293c88a155059", + "identity_guard_rejected_mismatch": true, + "apfs_mounted_read_only": true, + "block_device_was_read_only": true, + "sampled_files": 3, + "sampled_bytes": 196608, + "all_copies_match_sha256": true, + "test_file_kind": "hidden_metadata_only", + "source_writes_unchanged": true, + "source_write_count_before": 0, + "source_write_count_after": 0, + "source_first_MiB_unchanged": true, + "unmounted_after_test": true, + "original_block_read_only_flag_restored": true, + "limits": [ + "Only hidden system metadata sampled; ordinary user-file import remains unverified.", + "64 KiB samples do not support throughput conclusions.", + "Copy hashes compare the FUSE read stream with destination bytes; no independent macOS reference hashes provided.", + "No fnOS FPK or system file-manager integration delivered." + ] +} diff --git a/verification/build-packages-2026-11-11.txt b/verification/build-packages-2026-11-11.txt new file mode 100644 index 0000000..6031a90 --- /dev/null +++ b/verification/build-packages-2026-11-11.txt @@ -0,0 +1,165 @@ +adduser 3.134 +apt 2.6.2 +base-files 12.4+deb12u15 +base-passwd 3.6.1 +bash 5.2.15-2+b13 +binutils 2.40-2 +binutils-common:amd64 2.40-2 +binutils-x86-64-linux-gnu 2.40-2 +bsdutils 1:2.38.1-5+deb12u3 +cmake 3.25.1-1 +cmake-data 3.25.1-1 +coreutils 9.1-1 +cpp 4:12.2.0-3 +cpp-12 12.2.0-14+deb12u1 +dash 0.5.12-2 +debconf 1.5.82 +debian-archive-keyring 2023.3+deb12u2 +debianutils 5.7-0.5~deb12u1 +diffutils 1:3.8-4 +dpkg 1.21.23 +e2fsprogs 1.47.0-2+b2 +findutils 4.9.0-4 +g++ 4:12.2.0-3 +g++-12 12.2.0-14+deb12u1 +gcc 4:12.2.0-3 +gcc-12 12.2.0-14+deb12u1 +gcc-12-base:amd64 12.2.0-14+deb12u1 +gpgv 2.2.40-1.1+deb12u2 +grep 3.8-5 +gzip 1.12-1 +hostname 3.23+nmu1 +init-system-helpers 1.65.2+deb12u1 +libacl1:amd64 2.3.1-3 +libapt-pkg6.0:amd64 2.6.2 +libarchive13:amd64 3.6.2-1+deb12u5 +libasan8:amd64 12.2.0-14+deb12u1 +libatomic1:amd64 12.2.0-14+deb12u1 +libattr1:amd64 1:2.5.1-4 +libattr1-dev:amd64 1:2.5.1-4 +libaudit-common 1:3.0.9-1 +libaudit1:amd64 1:3.0.9-1 +libbinutils:amd64 2.40-2 +libblkid1:amd64 2.38.1-5+deb12u3 +libbrotli1:amd64 1.0.9-2+deb12u1 +libbz2-1.0:amd64 1.0.8-5+b1 +libbz2-dev:amd64 1.0.8-5+b1 +libc-bin 2.36-9+deb12u14 +libc-dev-bin 2.36-9+deb12u14 +libc6:amd64 2.36-9+deb12u14 +libc6-dev:amd64 2.36-9+deb12u14 +libcap-ng0:amd64 0.8.3-1+b3 +libcap2:amd64 1:2.66-4+deb12u3+b1 +libcc1-0:amd64 12.2.0-14+deb12u1 +libcom-err2:amd64 1.47.0-2+b2 +libcrypt-dev:amd64 1:4.4.33-2 +libcrypt1:amd64 1:4.4.33-2 +libctf-nobfd0:amd64 2.40-2 +libctf0:amd64 2.40-2 +libcurl4:amd64 7.88.1-10+deb12u15 +libdb5.3:amd64 5.3.28+dfsg2-1 +libdebconfclient0:amd64 0.270 +libexpat1:amd64 2.5.0-1+deb12u5 +libext2fs2:amd64 1.47.0-2+b2 +libffi8:amd64 3.4.4-1 +libfuse3-3:amd64 3.14.0-4 +libfuse3-dev:amd64 3.14.0-4 +libgcc-12-dev:amd64 12.2.0-14+deb12u1 +libgcc-s1:amd64 12.2.0-14+deb12u1 +libgcrypt20:amd64 1.10.1-3+deb12u1 +libgmp10:amd64 2:6.2.1+dfsg1-1.1 +libgnutls30:amd64 3.7.9-2+deb12u7 +libgomp1:amd64 12.2.0-14+deb12u1 +libgpg-error0:amd64 1.46-1 +libgprofng0:amd64 2.40-2 +libgssapi-krb5-2:amd64 1.20.1-2+deb12u5 +libhogweed6:amd64 3.8.1-2 +libicu72:amd64 72.1-3+deb12u1 +libidn2-0:amd64 2.3.3-1+b1 +libisl23:amd64 0.25-1.1 +libitm1:amd64 12.2.0-14+deb12u1 +libjansson4:amd64 2.14-2 +libjsoncpp25:amd64 1.9.5-4 +libk5crypto3:amd64 1.20.1-2+deb12u5 +libkeyutils1:amd64 1.6.3-2 +libkrb5-3:amd64 1.20.1-2+deb12u5 +libkrb5support0:amd64 1.20.1-2+deb12u5 +libldap-2.5-0:amd64 2.5.13+dfsg-5 +liblsan0:amd64 12.2.0-14+deb12u1 +liblz4-1:amd64 1.9.4-1 +liblzma5:amd64 5.4.1-1+deb12u2 +libmd0:amd64 1.0.4-2 +libmount1:amd64 2.38.1-5+deb12u3 +libmpc3:amd64 1.3.1-1 +libmpfr6:amd64 4.2.0-1 +libncursesw6:amd64 6.4-4 +libnettle8:amd64 3.8.1-2 +libnghttp2-14:amd64 1.52.0-1+deb12u3 +libnsl-dev:amd64 1.3.0-2 +libnsl2:amd64 1.3.0-2 +libp11-kit0:amd64 0.24.1-2 +libpam-modules:amd64 1.5.2-6+deb12u2 +libpam-modules-bin 1.5.2-6+deb12u2 +libpam-runtime 1.5.2-6+deb12u2 +libpam0g:amd64 1.5.2-6+deb12u2 +libpcre2-16-0:amd64 10.42-1+deb12u2 +libpcre2-32-0:amd64 10.42-1+deb12u2 +libpcre2-8-0:amd64 10.42-1+deb12u2 +libpcre2-dev:amd64 10.42-1+deb12u2 +libpcre2-posix3:amd64 10.42-1+deb12u2 +libproc2-0:amd64 2:4.0.2-3 +libpsl5:amd64 0.21.2-1 +libquadmath0:amd64 12.2.0-14+deb12u1 +librhash0:amd64 1.4.3-3 +librtmp1:amd64 2.4+20151223.gitfa8646d.1-2+b2 +libsasl2-2:amd64 2.1.28+dfsg-10+deb12u1 +libsasl2-modules-db:amd64 2.1.28+dfsg-10+deb12u1 +libseccomp2:amd64 2.5.4-1+deb12u1 +libselinux1:amd64 3.4-1+b6 +libselinux1-dev:amd64 3.4-1+b6 +libsemanage-common 3.4-1 +libsemanage2:amd64 3.4-1+b5 +libsepol-dev:amd64 3.4-2.1 +libsepol2:amd64 3.4-2.1 +libsmartcols1:amd64 2.38.1-5+deb12u3 +libss2:amd64 1.47.0-2+b2 +libssh2-1:amd64 1.10.0-3+deb12u1 +libssl3:amd64 3.0.22-1~deb12u2 +libstdc++-12-dev:amd64 12.2.0-14+deb12u1 +libstdc++6:amd64 12.2.0-14+deb12u1 +libsystemd0:amd64 252.39-1~deb12u2 +libtasn1-6:amd64 4.19.0-2+deb12u1 +libtinfo6:amd64 6.4-4 +libtirpc-common 1.3.3+ds-1 +libtirpc-dev:amd64 1.3.3+ds-1 +libtirpc3:amd64 1.3.3+ds-1 +libtsan2:amd64 12.2.0-14+deb12u1 +libubsan1:amd64 12.2.0-14+deb12u1 +libudev1:amd64 252.39-1~deb12u2 +libunistring2:amd64 1.0-2 +libuuid1:amd64 2.38.1-5+deb12u3 +libuv1:amd64 1.44.2-1+deb12u1 +libxml2:amd64 2.9.14+dfsg-1.3~deb12u6 +libxxhash0:amd64 0.8.1-1 +libzstd1:amd64 1.5.4+dfsg2-5 +linux-libc-dev:amd64 6.1.190-1 +login 1:4.13+dfsg1-1+deb12u2 +logsave 1.47.0-2+b2 +make 4.3-4.1 +mawk 1.3.4.20200120-3.1 +mount 2.38.1-5+deb12u3 +ncurses-base 6.4-4 +ncurses-bin 6.4-4 +passwd 1:4.13+dfsg1-1+deb12u2 +perl-base 5.36.0-7+deb12u4 +procps 2:4.0.2-3 +rpcsvc-proto 1.4.3-1 +sed 4.9-1+deb12u1 +sysvinit-utils 3.06-4 +tar 1.34+dfsg-1.2+deb12u1 +tzdata 2026f-0+deb12u1 +usr-is-merged 37~deb12u1 +util-linux 2.38.1-5+deb12u3 +util-linux-extra 2.38.1-5+deb12u3 +zlib1g:amd64 1:1.2.13.dfsg-1 +zlib1g-dev:amd64 1:1.2.13.dfsg-1