文件
fnos-apfs/HANDOFF.md
T

7.7 KiB
原始文件 Blame 文件历史

交接:飞牛 APFS 只读访问

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

当前目标

当前并行目标:完成已授权的两目录 NAS 本机复制;开发可安装的飞牛桌面应用“大鱼硬盘拷贝”,支持 APFS 与 NTFS 的识别、选目录和后台复制。

  • 用户已要求停止逐条报告拷贝速度,保留内部监控,仅在完成或异常时告知。
  • 新应用沿用当前仓库与驱动,固定 appname 为 dayu-diskcopy、唯一安装入口 /var/apps/dayu-diskcopy。使用飞牛登录态网关,普通 Web 进程降权运行,设备操作由本机受限服务执行。
  • NAS 已核实为 fnOS 1.2.0701,有 ntfs-3g、mkntfs、ntfscp。NTFS 已有系统挂载时优先复用,应用只读取源文件;不强行卸载或修改系统在用盘。未挂载的新盘使用只读挂载。
  • 应用第一版代码位于 application/,FPK 定义在 packaging/fpk/,构建入口 scripts/build-fpk.py。当前版本 0.1.0;使用官方网关 Unix Socket,不开放新的网络端口。Web 进程启动后降为专用包用户,原始设备操作由本机 Socket 服务处理并核验调用 UID。
  • 已通过五项边界测试:匿名及非管理员拒绝、管理员页面可读、写请求来源校验、路径穿越和符号链接越界拒绝、系统身份拒绝;Python/生命周期脚本语法通过。FPK 构建和实机界面/NTFS 镜像验证正在进行,尚未宣称正式交付。

当前复制任务(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 或系统文件管理集成。
  • 已把原始 macOS 扩展属性另存至目标内隐藏目录 .dayu-apfs-metadata-20261111-223613:7374 条路径记录、1690603 字节;未发现 ResourceFork 属性。此存档可能包含私人元数据,禁止上传 Git。普通文件保留其数据内容;原始属性作为存档保存,不盲目应用机器相关安全属性。
  • 22:38 左右已传约 39.2 GB,实测平均约 256 MB/s、即时约 250 MB/s;动态进度以 NAS 的 copy.log 为准,不以本条历史快照判定任务完成。

已确认

  • 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. 跟进本轮约 501 GB 复制任务至结束,核验已有 64 个文件及完整目录差异;如发现不同版本,先保留旧内容再处理,不盲目覆盖。
  2. 核实任务最终状态、APFS 源盘零写入、正常卸载与只读标志恢复;检查目标用户可访问性,保存脱敏结果与源码检查点。
  3. 应用界面、FPK、自动识别、系统文件管理集成尚未实现,本阶段不是正式应用交付。后续按真实盘数据表现决定驱动与封装方案。