文件

56 行
7.3 KiB
Markdown

此文件含有模棱两可的 Unicode 字符
此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。
# 交接:大鱼硬盘拷贝
更新时间:2026-11-12,Asia/Shanghai。
## 当前目标与进展
- 11 月 12 日“大于 50GB”导入已完成:同一 Tech 4TB APFS 盘共 11 个符合门槛的顶层目录;之前 2 个比赛目录结构/大小复核一致后复用;新增 9 个目录、781417428219 字节,任务 `20261112-000934-7eab85`。50GB 按 50,000,000,000 字节,子目录结构保留。
- 其中 8 个文件原名为 272–576 字节,超过 NAS 的 255 字节限制,初始 rsync 返回 23。按用户明确选择,仅缩短这 8 个目标文件名,保留扩展名,以原相对路径哈希防冲突;8134306 字节已逐文件 SHA-256 读回核验。其余 401182 个普通文件由 rsync 传输校验,457268 个可表示的目录/文件/链接条目结构/大小/链接核对无差异,不宣称对全部 781GB 额外逐字节读回。
- 原名对照表位于目标根目录 `文件名对照-20261112-000934-7eab85.csv` 和同名 JSON,归属 UID 1000;完整文件名、清单及素材只在 NAS,不上传 Git。原始 macOS 属性额外保存在 `.dayu-diskcopy-metadata-20261112-000934-7eab85`,453582 条、约 91.5 MB,保留。
- 正式任务历史已记录人工短名恢复过程,显示“已完成”及 8 个文件更名提示;原始失败日志保留。目标已 syncfs、源分区写计数不变、挂载已释放、块设备原 RO=0 已恢复。见 `verification/2026-11-12-large-copy.json`。
- 用户指定的“火影秋决”和“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](https://dayu.media/git/dayu/fnos-apfs/releases/tag/v0.1.4),ID 432;附件 ID 71,`dayu-diskcopy-0.1.4-x86.fpk`,564939 字节。
- SHA-256:`cc761c2c62510674bbed60133ec042732dd84477806f0f6550cc97bf50205307`。当前可供分享的本机发行包在 `/Users/mac/Downloads/dayu-diskcopy-0.1.4-x86.fpk`;项目 dist 已无 FPK。已重新核对该包 564939 字节及同一 SHA-256,未另建副本。
- 私有下载需要大鱼站正常网页登录;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](RECOVERY.md)。