diff --git a/README.md b/README.md index a3e8f81..4c9495f 100644 --- a/README.md +++ b/README.md @@ -1,38 +1,41 @@ -# 飞牛 APFS 只读访问验证 +# 大鱼硬盘拷贝 -目标:将 APFS 移动存储直接连接 fnOS,在 NAS 本机读取并导入文件,绕过千兆网络。 +飞牛 fnOS 原生桌面应用,在 NAS 本机读取 APFS / NTFS 外接硬盘并复制目录,不经过电脑或 SMB 中转。 -当前阶段为只读驱动兼容性验证,尚未制作飞牛应用安装包,也未集成系统“外接存储”界面。 +## 使用 -2026-11-11 实机结果:APFS SD 卡只读挂载成功,三个系统隐藏文件复制校验通过,APFS 分区写计数为零。普通素材导入与大文件速度待测试;详见交接及 `verification/`。 +支持已测试的 fnOS 1.2.0701 x86_64。手动安装 FPK 后,在飞牛桌面打开“大鱼硬盘拷贝”,或访问 `/app/dayu-diskcopy`。使用管理员登录态,不增加独立网络端口。 -## 安全边界 +1. 选择外接硬盘,勾选同一层级中的源目录。 +2. 选择自己的 NAS 存储空间和目标目录,可新建文件夹。 +3. 开始拷贝,在任务中查看进度和校验结果。关闭窗口不会终止任务。 -- 只对核实身份的 USB APFS 测试分区执行只读访问;不格式化、不修复、不写源盘。 -- 不安装内核模块,不改飞牛存储服务、启动配置、系统软件包或现有 Docker 服务。 -- 编译与测试使用独立目录及容器;不使用 NAS 网站生产目录。 -- 账号密码只从用户指定的本机文件读取到内存,不进入源码、参数或记录。 -- 默认不启用 apfs-fuse 的 lax 模式,不记录加密调试数据。 +源盘不格式化、不修复;新挂载的卷使用只读挂载。已被飞牛挂载的 NTFS 优先复用,应用只读取文件,不修改系统挂载方式。已存在的文件先保留并校验,不同版本不自动覆盖。失败或中断的应用任务可重试,已完成文件会复用,部分文件可继续传输。 -## 工程入口 +普通文件保留名称、时间和链接;APFS 原始扩展属性另外保存到目标中的隐藏存档,不盲目应用机器相关安全属性。存档可能含私人元数据,不上传源码仓库。首版不承诺所有 APFS 特性或加密卷兼容,不改写剪辑工程内部引用。 -- [HANDOFF.md](HANDOFF.md):当前状态与下一步。 -- 驱动来源:[sgan81/apfs-fuse](https://github.com/sgan81/apfs-fuse),只读 FUSE 实现;固定源码版本及许可证见下文。 +## 验证 -## 构建与验证 +- APFS:真实 4 TB USB 盘两目录本机复制,新增约 501 GB,既有 64 个文件校验一致,源分区写计数为零;见 `verification/2026-11-11-competition-copy.json`。 +- NTFS:只读镜像挂载和复制 SHA-256 比对通过,尚无实体 NTFS USB 盘验证;见 `verification/2026-11-11-ntfs-image.json`。 +- 网关身份、页面私有校验、跨站请求、路径/链接边界及文件系统识别测试见 `tests/`。 +- 最终实机交付状态以 [HANDOFF.md](HANDOFF.md) 为准。 -完整驱动快照及 LZFSE 源码位于 `vendor/`,版本见 `UPSTREAM.json`,许可证保留在各自目录内;不需要从上游重新下载源码。 +## 开发与构建 -在 x86_64 Linux + Docker 中,于工程根执行 `bash scripts/build-driver.sh`。仅容器内安装编译依赖;输出 `build/bin/apfs-fuse`、`apfsutil` 及依赖版本清单。NAS 本机需有 libfuse3、libstdc++、zlib、libbz2 的运行库。 +- `application/`:界面、降权 Web 服务、受限设备服务、生命周期控制。 +- `packaging/fpk/`:固定 appname `dayu-diskcopy` 的安装定义。 +- `scripts/copy-directories.py`:后台复制、内容核验与挂载回收。 +- `scripts/save-xattrs.py`:私有扩展属性存档。 +- `vendor/apfs-fuse/`:包含 LZFSE 的完整源码快照及许可证,版本见 `UPSTREAM.json`,FPK 内也附对应源码。 -验证入口为 `scripts/validate-card.py --partuuid --serial --workdir <工程根目录>`,需管理员运行。它会暂时挂载、读取最多三个 512 MiB 以内样本、将副本写入工程测试目录并比对 SHA-256,然后删除副本及卸载。不会尝试写 APFS 源盘。结果保存在工作目录 `result.json`。 +Linux + Docker 中执行 `bash scripts/build-driver.sh` 构建 Release 驱动。验证后将两个可执行文件放入 `build/linux-bin/`。打包脚本核对本轮已验证驱动的固定 SHA-256;工具链变化后的二进制需重新验证,不能盲目绕过检查。 -SD 卡只适合验证基本功能,不能代表外置 SSD 的吞吐;隐藏索引文件的读取也不能当作素材导入测试。 +```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,不能据此宣称更新成功。 -目标远程:`https://dayu.media/git/dayu/fnos-apfs.git`,分支 `main`。 - -克隆后查看交接及固定驱动版本。凭据、磁盘数据、编译输出和容器镜像不纳入 Git;本机账号需独立配置。 - -完整恢复入口见 [RECOVERY.md](RECOVERY.md)。 +恢复入口见 [RECOVERY.md](RECOVERY.md),最新状态见交接。凭据、真实文件名清单、源文件内容和私有日志不进入 Git。 diff --git a/packaging/fpk/manifest b/packaging/fpk/manifest index 6e9d697..0beb0ec 100644 --- a/packaging/fpk/manifest +++ b/packaging/fpk/manifest @@ -1,5 +1,5 @@ appname=dayu-diskcopy -version=0.1.2 +version=0.1.3 display_name=大鱼硬盘拷贝 desc=直接读取 APFS、NTFS 外接硬盘,在飞牛 NAS 本机后台拷贝目录、查看进度和校验结果。 source=thirdparty diff --git a/scripts/copy-directories.py b/scripts/copy-directories.py index 013ba35..c560bab 100644 --- a/scripts/copy-directories.py +++ b/scripts/copy-directories.py @@ -94,7 +94,9 @@ def main(): mismatch_log=str(job / 'existing-check.log')) return save('verifying_tree') - result = run_to_log(['rsync', '-rltHni', '--out-format=%i %n%L', '--protect-args', + # Existing files keep their original metadata. Their contents were fully + # checksum-checked above, so a different mtime alone is not a copy failure. + result = run_to_log(['rsync', '-rlHni', '--size-only', '--out-format=%i %n%L', '--protect-args', *source_args, str(destination) + '/'], 'tree-check.log') if result or (job / 'tree-check.log').read_text().strip(): raise RuntimeError('Final directory comparison found differences; see tree-check.log.')