文件
fnos-apfs/HANDOFF.md
T

6.4 KiB
原始文件 Blame 文件历史

交接:大鱼硬盘拷贝

更新时间:2026-11-12,Asia/Shanghai。

当前目标与进展

  • 11 月 12 日新增任务:用户明确要求同一 Tech 4TB APFS 盘顶层大于 50GB 的目录全部复制到 /vol5/1000/剪辑盘备份,保留子目录结构;已完成只读统计:符合门槛 11 个,之前 2 个目录结构/大小核对一致后复用;新增 9 个目录,计划复制 781417428219 字节。正式应用后台任务 20261112-000934-7eab85 已启动并在界面显示,尚待完成/校验/释放源盘。50GB 按 50,000,000,000 字节。完整盘点与素材清单仅在 NAS 应用数据中,不上传 Git。

  • 用户指定的“火影秋决”和“LCQ荒野乱斗”已完成 NAS 本机复制及核验,目标 /vol5/1000/剪辑盘备份,没有向 APFS 源分区写入。

  • 原生飞牛应用已实现 APFS / NTFS 识别、只读访问、目录勾选、目标目录/新建目录、后台复制、进度和校验、失败/中断任务重试。0.1.4 已正式安装运行,实机界面复制/续传/校验通过,Release 已发布并完成草稿及正式附件的浏览器全量下载校验。

  • 用户已要求停止逐条播报拷贝速度;仅告知完成或异常。

  • 用户已明确同意飞牛针对本应用的第三方免责提示并授权继续更新;同一提示无需重复询问,不适用于其他软件或不同条款。

工程与正式位置

  • 本机:/Users/mac/Documents/dayu-git/repositories/fnos-apfs;私有远程 https://dayu.media/git/dayu/fnos-apfs.git,分支 main,仓库 ID 61。
  • 固定 appname dayu-diskcopy,显示名“大鱼硬盘拷贝”;唯一安装入口 /var/apps/dayu-diskcopy,实际 target 在 /vol3/@appcenter/dayu-diskcopy,不是两份安装。
  • 访问:飞牛桌面图标,或 https://192.168.31.21:5668/app/dayu-diskcopy。仅管理员,经飞牛官方网关登录态,不增加 TCP 端口。
  • NAS:fnOS 1.2.0701 / Debian 12 / x86_64 / i5-12400T;Python 3、FUSE、rsync、ntfs-3g 为已有运行组件。
  • Web 服务实际为专用用户 UID 985;受限设备服务为 root。网关与设备两个 Unix Socket 都为 0660。源设备仅枚举 USB APFS/NTFS,路径/链接越界拒绝。
  • 核心代码 application/;FPK 定义 packaging/fpk/;构建入口 scripts/build-fpk.py。完整上游源码与 LZFSE 已含在 vendor 和 FPK;许可证及版本见 UPSTREAM.json。

当前验证

  • 九项权限、网关校验、路径边界、文件系统识别和准备中任务可见性测试通过。Python/生命周期脚本语法及官方 fnpack 格式检查通过。
  • 0.1.3 已实机从界面新建目标目录、选 APFS 目录并复制成功;预置 100000 字节不完整文件,rsync 实际复用 99400 字节,完整结果 SHA-256 一致。已存在且 mtime 不同的文件也正确保留并通过内容校验。见 verification/2026-11-11-app-ui.json。
  • 0.1.4 已核对正式安装的全部应用载荷 SHA-256,实际复制与选择框状态正确;准备中任务可见性、有活动任务时禁止卸载的边界测试通过。见 verification/2026-11-11-final-install.json。
  • NTFS:独立 64 MiB 镜像只读挂载,1 MiB 文件复制 SHA-256 一致;没有实体 NTFS USB 盘验证。见 verification/2026-11-11-ntfs-image.json。
  • APFS SD 基础验证见 verification/2026-11-11-apfs-sd.json。首版不承诺加密卷或全部 APFS 特性兼容。
  • 原始 macOS 扩展属性作为私有存档保存在拷贝目标,不盲目应用机器相关安全属性。真实文件名清单、数据、私有日志和凭据绝不上传 Git。

已完成的比赛目录备份

  • 新增 501332211263 字节;复制用时 2197.872 秒;已有 64 个文件完整校验无差异,目录核对无差异,目标已 syncfs,源写计数为零,源已卸载并恢复原只读标志。见 verification/2026-11-11-competition-copy.json。
  • 复制时源盘 Tech / DD56419883A4F,APFS PARTUUID d6bd791c-7bee-486b-8fef-6cf584381a55;不能将设备名 sdg2 当永久身份。
  • 真实任务记录已校验后迁移至 /var/apps/dayu-diskcopy/var/jobs/imported-20261111-223613,应用重启后可正常显示。原型目录 /var/tmp/dayu-apfs-validation 已清理。
  • 目标隐藏目录 .dayu-apfs-metadata-20261111-223613 为对应元数据存档,约 1.7 MB,7374 条记录;保留,不清理。

安装与后续

  • 当前设备 CLI install-fpk 对已有应用只提示 installed,不能宣称升级。更新要走网页应用中心“手动安装”,先点“从电脑上传”,再选择 FPK;窗口加载是异步的。
  • 原生网关改写 upstream Host,不能直接严格比较 Origin/Host;现用私有页面随机校验值、跨站请求限制和管理员 Header。匿名、非管理员和缺少校验值的写请求都被拒绝。
  • 本轮界面测试目录与三条测试任务已清理,真实比赛目录、元数据存档和任务记录保留。NAS 原型驱动、测试镜像、上传暂存与专用构建镜像标签已清理;Docker 共享缓存不作全局清理。本机已删除可重建 build 暂存与原型私有测试输出,保留唯一当前发行 FPK。
  • 桌面打开反馈已复查:单击/双击桌面图标及应用中心“打开”正常,用户确认现在可打开;服务正常、网关 HTTP 200、两盘/真实任务可见,无需改代码。见 verification/2026-11-12-launch.json。实体 NTFS USB 盘尚未测试。

正式发行与恢复

  • 代码标签 v0.1.4 → 72d678fa03dc730e44d4e53988ea86a88aec6a0f;标签不移动。后续 main 提交仅补齐验证与交付记录。
  • Release,ID 432;附件 ID 71,dayu-diskcopy-0.1.4-x86.fpk,564939 字节。
  • SHA-256:cc761c2c62510674bbed60133ec042732dd84477806f0f6550cc97bf50205307。本机唯一保留发行包在项目 dist/。
  • 私有下载需要大鱼站正常网页登录;API 令牌访问网页下载 URL 返回 404。已使用原有 Edge 登录态分别完整下载草稿与正式附件、核对字节数与 SHA-256,再回读 API 版本/附件及远程标签。见 verification/release-0.1.4.json,不能把脚本的网页下载 404 当作附件未上传而重复 POST。
  • 已独立从远端克隆标签,使用下载的 Release 恢复驱动并重新构建 FPK,恢复载荷与正式安装逐文件哈希一致,临时 clone 已清理。见 verification/recovery-0.1.4.json 和 RECOVERY.md。