文件

42 行
3.6 KiB
Markdown

此文件含有模棱两可的 Unicode 字符
此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。
# 恢复:大鱼硬盘拷贝 0.1.4
## 优先恢复正式安装包
私有 [Release v0.1.4](https://dayu.media/git/dayu/fnos-apfs/releases/tag/v0.1.4),附件 ID 71:`dayu-diskcopy-0.1.4-x86.fpk`,564939 字节。
SHA-256:`cc761c2c62510674bbed60133ec042732dd84477806f0f6550cc97bf50205307`。
使用自己的大鱼站正常网页登录下载。当前 API 令牌请求私有网页下载返回 404,正常已登录 Edge 下载已实测成功;不要为下载修改仓库可见性或扩大令牌权限。安装到已测试的 fnOS 1.2.0701 x86_64,在网页应用中心使用“手动安装”。唯一 appname 为 `dayu-diskcopy`,不要同时安装改名副本。
## 恢复源码
远程:`https://dayu.media/git/dayu/fnos-apfs.git`,分支 main;正式代码标签 `v0.1.4` 对应完整提交 `72d678fa03dc730e44d4e53988ea86a88aec6a0f`。最终交付与发布后的验证记录在 main,标签保持当时实际构建源码,不移动。
```sh
git clone https://dayu.media/git/dayu/fnos-apfs.git
cd fnos-apfs
git switch --detach v0.1.4
```
完整 APFS 驱动与 LZFSE 源码都在 vendor,为普通 Git 文件,无 LFS 对象或 Git 子模块。固定版本、许可证和容器构建入口见 `UPSTREAM.json`、`packaging/Dockerfile`、`scripts/build-driver.sh`。
构建 FPK 需要官方 fnpack 1.2.3,以及已验证的两个 Linux 驱动置于 `build/linux-bin/`。可从已校验 Release 的外层 gzip/tar 中读取 `app.tgz`,再只提取 `bin/apfs-fuse`、`bin/apfsutil` 到受控目录。不要对未校验的未知归档盲目 extractall。
驱动 SHA-256:
- apfs-fuse:`89a7083c42fb498b021d9f7fabbc5b754eaae503649500e4926965fdcfbcb11e`
- apfsutil:`692bbd961678c5db1a48e00cb2bc96c50e82dd77e39d87cfe11087608b4658ae`
执行 `python3 scripts/build-fpk.py /path/to/official/fnpack`。本轮已从远端独立克隆代码、从真实下载附件恢复驱动并重新打包,恢复的应用载荷与正式安装一致。归档时间戳及 Git 文本换行规范化可能改变整体 FPK 哈希,不声称未来编译容器或完整归档可逐字节复现;新包必须重新安装验证,不沿用旧包的验收值。
若重编驱动,需重新验证;Debian APT 精确依赖清单在 verification/build-packages-2026-11-11.txt,仓库未封存全部系统软件包,不盲目更新构建脚本的固定二进制哈希检查。
## NAS 数据与任务
- 唯一安装入口 `/var/apps/dayu-diskcopy`;实际载荷位于 `/vol3/@appcenter/dayu-diskcopy`,配置、数据由飞牛各自的 etc/var 路径管理。
- 真实媒体位于用户选择的 NAS 目标目录,不在应用安装目录内;卸载应用不应删除这些外部备份。
- 本轮真实任务在 `var/jobs/imported-20261111-223613`;对应两目录在 `/vol5/1000/剪辑盘备份`。隐藏元数据存档与媒体一起保留,不上传 Git。
- 11 月 12 日额外导入任务 `var/jobs/20261112-000934-7eab85` 已完成。8 个目标文件名按用户选择缩短,目标根目录的同名 CSV/JSON 对照表必须和媒体一起保留;恢复到 Mac 时可按表改回原名。对应 `.dayu-diskcopy-metadata-20261112-000934-7eab85` 保存原名下的扩展属性。0.1.4 安装包没有自动短名功能,不能直接重试来解决同一长度限制。
- 正在执行任务时不要卸载。窗口关闭或 Web 服务重启不会主动终止后台复制;断电后确认原盘身份并使用重试功能。不要把 sdg2 当永久磁盘身份。
- 凭据、真实素材和私有清单不随源码仓库保存。Git/Release 保存范围及服务端备份限制沿用用户的全局规则,不承诺 NAS 与本机同时损坏仍可恢复媒体。