文件
fnos-apfs/README.md
T

42 行
2.9 KiB
Markdown

# 大鱼硬盘拷贝
飞牛 fnOS 原生桌面应用,在 NAS 本机读取 APFS / NTFS 外接硬盘并复制目录,不经过电脑或 SMB 中转。
## 使用
支持已测试的 fnOS 1.2.0701 x86_64。手动安装 FPK 后,在飞牛桌面打开“大鱼硬盘拷贝”,或访问 `/app/dayu-diskcopy`。使用管理员登录态,不增加独立网络端口。
1. 选择外接硬盘,勾选同一层级中的源目录。
2. 选择自己的 NAS 存储空间和目标目录,可新建文件夹。
3. 开始拷贝,在任务中查看进度和校验结果。关闭窗口不会终止任务。
源盘不格式化、不修复;新挂载的卷使用只读挂载。已被飞牛挂载的 NTFS 优先复用,应用只读取文件,不修改系统挂载方式。已存在的文件先保留并校验,不同版本不自动覆盖。失败或中断的应用任务可重试,已完成文件会复用,部分文件可继续传输。
普通文件保留名称、时间和链接;APFS 原始扩展属性另外保存到目标中的隐藏存档,不盲目应用机器相关安全属性。存档可能含私人元数据,不上传源码仓库。首版不承诺所有 APFS 特性或加密卷兼容,不改写剪辑工程内部引用。
## 验证
- 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) 为准。
## 开发与构建
- `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。