# 交接:飞牛 APFS 只读访问 更新时间:2026-11-11(Asia/Shanghai)。 ## 当前目标 基础 APFS 只读挂载已验证。下一步用普通测试文件验证素材读取及导入,再确定应用封装方案。 ## 已确认 - SSH 已登录 `192.168.31.21:22`,管理员提权已验证;网页管理端口为 5668。 - NAS:Intel i5-12400T / x86_64;Debian 12;内核 `6.18.18.c1107-trim`。 - 有 `/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 连接。飞牛图形界面显示“未知文件系统”;独立 FUSE 挂载已成功,但尚未集成系统界面。 - 本轮 SSH 曾返回 `Exceeded MaxStartups`,等待后恢复。未修改 SSH 服务。 ## 工程与恢复 - 本机:`/Users/mac/Documents/dayu-git/repositories/fnos-apfs`。 - 私有远程:`https://dayu.media/git/dayu/fnos-apfs.git`,分支 main;首个基线 `08e7da7f237c1a21aedad17b7a259726b8182060` 已推送并回读核验。 - `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 特性的兼容性保证。 - 首次代码检查点已从远程独立克隆核验,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. 等待用户确认普通测试文件情况;建议 100–500 MB 视频,若可提供 macOS 的 SHA-256 则做独立比对。拔卡前从飞牛系统推出整张卡。 2. 继续使用 PARTUUID 和 USB 身份核对,不假设重新插入后仍为 sde2;重新格式化后 PARTUUID 也会变化。 3. 应用界面、FPK、自动识别、系统文件管理集成及真实 SSD 性能尚未实现,本阶段不是正式应用交付。