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