文件
fnos-apfs/HANDOFF.md
T

6.0 KiB
原始文件 Blame 文件历史

交接:飞牛 APFS 只读访问

更新时间:2026-11-11(Asia/Shanghai)。

当前目标

基础 APFS 只读挂载已验证。当前用户要求把 4 TB APFS USB 盘的“火影秋决”和“LCQ”比赛目录复制到 NAS /vol5/1000/剪辑盘备份,正在 NAS 本机执行复制。

当前复制任务(2026-11-11 22:36 启动)

  • 新源盘:USB Tech,序列号 DD56419883A4F,容量 4096805658624 字节;APFS PARTUUID d6bd791c-7bee-486b-8fef-6cf584381a55,当前设备 sdg2。卷名 DayuMedia 4TB,未加密。
  • 只读挂载点:/var/tmp/dayu-apfs-validation/mnt-DD56419883A4F;源路径为该挂载点下 root/火影秋决 与 root/LCQ荒野乱斗。其他 AE/下载目录中名字含 LCQ 的辅助目录不在本次复制范围。
  • 目标目录:/vol5/1000/剪辑盘备份,实挂 /vol5 Btrfs,有约 3.95 TB 空闲。已有“火影秋决”约 46.8 GB。
  • 预检:7422 个条目,5881 个普通文件、1462 个目录、79 个符号链接;普通文件总逻辑大小 548102817612 字节。初步需传输 501332211263 字节,已有内容先保留不覆盖。
  • 程序:scripts/copy-directories.py,NAS 的独立后台进程执行 rsync,只复制新增内容,保留目录/文件名/时间/硬链接/符号链接,新增文件设为用户 1000、组 1001,不改 NAS 系统服务。
  • 任务记录:/var/tmp/dayu-apfs-validation/jobs/copy-20261111-223613;入口文件 current-job 指向当前任务。PID 1155511。status.json 为状态,copy.log 含实际传输进度。SSH 中断不终止任务。
  • 复制后校验先前已存在文件的完整校验和,并作目录差异核验;不同版本保留不覆盖,需按检查结果处理。新文件使用 rsync 传输校验,不声称进行了独立的全盘逐字节读回。
  • 结束时程序卸载 APFS 并恢复其内核只读标志,检查源分区写计数。错误/不一致记录在同目录日志。仅普通素材与工程的本地 NAS 备份,不把素材、文件名清单或用户数据提交到 Git。
  • 用户要求报告实际拷贝速度与剩余时间;持续在当前任务观察至完成。未实现飞牛 FPK 或系统文件管理集成。

已确认

  • 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。
  • 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,编译依赖见同目录清单。证据不包含源文件内容、文件名或凭据。
  • 不使用当前聊天原工作目录“大鱼调色”,不修改 NAS 网站生产源。
  • 凭据在用户指定的本机安全位置,不进入工程。

待完成

  1. 等待用户确认普通测试文件情况;建议 100–500 MB 视频,若可提供 macOS 的 SHA-256 则做独立比对。拔卡前从飞牛系统推出整张卡。
  2. 继续使用 PARTUUID 和 USB 身份核对,不假设重新插入后仍为 sde2;重新格式化后 PARTUUID 也会变化。
  3. 应用界面、FPK、自动识别、系统文件管理集成及真实 SSD 性能尚未实现,本阶段不是正式应用交付。