# 大鱼硬盘拷贝 飞牛 fnOS 原生桌面应用,在 NAS 本机读取 APFS / NTFS 外接硬盘并复制目录,不经过电脑或 SMB 中转。 ## 使用 支持已测试的 fnOS 1.2.0701 x86_64。手动安装 FPK 后,在飞牛桌面打开“大鱼硬盘拷贝”,或访问 `/app/dayu-diskcopy`。使用管理员登录态,不增加独立网络端口。 1. 选择外接硬盘,勾选同一层级中的源目录。 2. 选择自己的 NAS 存储空间和目标目录,可新建文件夹。 3. 开始拷贝,在任务中查看进度和校验结果。关闭窗口不会终止任务。 源盘不格式化、不修复;新挂载的卷使用只读挂载。已被飞牛挂载的 NTFS 优先复用,应用只读取文件,不修改系统挂载方式。已存在的文件先保留并校验,不同版本不自动覆盖。失败或中断的应用任务可重试,已完成文件会复用,部分文件可继续传输。 普通文件保留名称、时间和链接;APFS 原始扩展属性另外保存到目标中的隐藏存档,不盲目应用机器相关安全属性。存档可能含私人元数据,不上传源码仓库。首版不承诺所有 APFS 特性或加密卷兼容,不改写剪辑工程内部引用。 APFS 可接受的部分中文长文件名会超过 NAS 文件系统单个名称 255 字节的上限。0.1.4 遇到这类文件会明确报告任务失败,不会自动改名;需选择归档或缩短目标名并保留对照表后恢复。11 月 12 日实盘导入中发现 8 个此类文件,已按用户选择人工缩短、保存对照表并逐个 SHA-256 核验。该人工恢复流程不等于当前安装包已具备自动处理功能。 ## 验证 - APFS:真实 4 TB USB 盘两目录本机复制,新增约 501 GB,既有 64 个文件校验一致,源分区写计数为零;见 `verification/2026-11-11-competition-copy.json`。 - APFS 大目录:新增 9 个目录约 781GB 已备份,8 个超长文件名人工恢复并保留对照表,详见 `verification/2026-11-12-large-copy.json`。 - NTFS:只读镜像挂载和复制 SHA-256 比对通过,尚无实体 NTFS USB 盘验证;见 `verification/2026-11-11-ntfs-image.json`。 - 网关身份、页面私有校验、跨站请求、路径/链接边界及文件系统识别测试见 `tests/`。 - 最终实机交付状态以 [HANDOFF.md](HANDOFF.md) 为准。 ## 开发与构建 - `application/`:界面、降权 Web 服务、受限设备服务、生命周期控制。 - `packaging/fpk/`:固定 appname `dayu-diskcopy` 的安装定义。 - `scripts/copy-directories.py`:后台复制、内容核验与挂载回收。 - `scripts/save-xattrs.py`:私有扩展属性存档。 - `vendor/apfs-fuse/`:包含 LZFSE 的完整源码快照及许可证,版本见 `UPSTREAM.json`,FPK 内也附对应源码。 Linux + Docker 中执行 `bash scripts/build-driver.sh` 构建 Release 驱动。验证后将两个可执行文件放入 `build/linux-bin/`。打包脚本核对本轮已验证驱动的固定 SHA-256;工具链变化后的二进制需重新验证,不能盲目绕过检查。 ```sh PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s tests -v python3 scripts/build-fpk.py /path/to/official/fnpack ``` 使用官方 fnpack 1.2.3,产物位于 `dist/`,不保存为 Git 对象或 LFS。更新通过网页应用中心“手动安装”;当前设备的 CLI install-fpk 对已安装应用只提示 installed,不能据此宣称更新成功。 恢复入口见 [RECOVERY.md](RECOVERY.md),最新状态见交接。凭据、真实文件名清单、源文件内容和私有日志不进入 Git。