Files
calculet-npu-research-archive/provenance/本地统一归档README.md
T

5.8 KiB
Raw Blame History

Calculet NPU 本地资源统一归档

归档状态:PASS(含 2 项已解释例外)

整理与复验时间:2026-08-02 11:10:18 +0800

这是后续持续研究的统一入口。原始数据仍保存在 Calculet-NPU-analysis-bundle-20260801,本目录主要使用相对符号链接组织数据,不复制 20 GiB 模型、主归档或传输分片。新增的实际数据只有两份 PDF 副本、索引/报告,以及约 5.4 GiB 的大小写敏感 APFS 稀疏映像。

建议从这里开始

  1. 阅读 完整性验收报告.md,确认本次数据边界和两个例外。
  2. 查看 资源总清单.tsv,按“用途”列选择资料。
  3. 总体研究先读 reports/Calculet-NPU-研究导航-20260802.mdreports/Calculet-NPU-总体研究报告-20260802.md
  4. 代码修改从 source-history/repositories-complete/ 开始;这里是带完整 .git 的可浏览仓库。
  5. 驱动分析从 source-history/driver-source/ 开始。
  6. 当前模型和双芯粒产物从 extracted/08-models-complete/ 开始。
  7. 远端现场、容器和历史测试状态从 extracted/07-live-user2-home-complete/ 开始。

目录说明

目录 内容 主要用途
archives/ 8 个权威原始归档 灾备、重新解包、证据保全
extracted/ 8 个规范解包视图和步骤 1-4 ZIP 视图 直接浏览、检索、差异分析
source-history/ 完整 Git 仓库、bundle、提交主题索引、驱动源码、baseline 内层包 算子优化、调度改造、历史决策追踪
documentation/ Runtime API 与 VPN 原始 PDF 副本 接口契约、接入说明
reports/ 既有 30 份研究报告、JSON 和校验工具 结论复用、实验设计、实施规格
transfer-materials/ 2,516 个正式分片、5 个断点/尾部文件、manifest、传输日志和完成标记 传输审计、故障追溯、重新拼包
checksums/ 主归档、模型、Git 证据和特殊节点清单 快速复验
disk-image/ 大小写敏感 APFS 稀疏映像链接 精确保存 Linux 大小写路径
scripts/ 挂载、卸载、主归档复验、索引重建脚本 长期维护

解包完成范围

  • 8 个采集级主归档全部存在规范解包视图。
  • 1-4step.zip 已额外展开到 extracted/09-priority-1-4-zip-view/,保留 __MACOSX 元数据。
  • baseline 中 6 个顶层 SDK/源码/构建复现包全部展开到 source-history/baseline-expanded/
  • Git 证据中的 llama.cppcalrtfmtsystemc 完整仓库、历史性能材料和驱动证据全部展开到 source-history/repositories-complete/
  • .git 仓库保持完整,未扁平化;Git bundle 保持原格式并通过验证。

没有递归展开 Conda 包缓存、Debian 包、OCI blob、Git bundle、ELF、内核模块和容器 overlay 中的包文件。这些文件本身是供应链或取证对象,递归展开会破坏包边界、制造路径冲突并产生大量无意义重复。其外层采集归档和可研究的源码层均已展开。

大小写敏感视图

普通 macOS 文件系统会合并 Linux 中仅大小写不同的路径。为避免内容在查看层被覆盖,本次新增 Calculet-NPU-Linux-case-sensitive-views.sparsebundle,其中保存:

  • container-home-complete/41,820/41,820 个归档路径完整落盘。
  • live-user2-home-complete/:62,448 个普通路径落盘;原归档中的 7 个 Linux whiteout 设备节点保留在 tar 内并列入 checksums/linux-whiteout-special-nodes.txt
  • baseline-expanded/source-history-repositories/:高价值内层包的精确解包视图。

当前映像已挂载。重启或手动卸载后,如果 extracted/05-*extracted/07-*source-history/*complete 链接不可访问,双击 scripts/挂载大小写敏感视图.command 即可恢复固定挂载点。

完整性结论

  • 8 个主归档合计 21,078,519,107 字节,重新计算 SHA-256 全部通过。
  • 4 个 Zstandard、2 个 gzip、2 个 tar/OCI 格式测试全部通过。
  • 关键上下文 115/115、无权重运行时 66/66、完整模型 68/68、Git 证据 147/147 个文件哈希通过。
  • 7 个解包 Git 仓库全部通过 git fsck --full --no-reflogs
  • 5 个 Git bundle 全部通过 git bundle verify,均记录完整历史。
  • 1-4step.zip 的 10,958 个条目通过 unzip -tq,解压成功。

两个已解释例外:

  1. live-user2-home 的 7 个 overlay whiteout 字符设备无法作为普通用户文件落到 APFS;它们在权威 tar 中完整保留,并有精确路径清单。
  2. baseline 自带 SHA256SUMSllama.cpp-analysis-repo-depth500.tar.gz 留有一条过期重复哈希;实际文件匹配第二条,且 baseline 主 tar 的权威 SHA-256 通过。数据没有损坏。

保密与操作边界

live-user2-home 包含 shell 历史、用户配置、测试目录和 rootless Podman 存储,可能带有环境敏感信息。该目录和原始归档不应直接发布到公共仓库。远端清理和现场恢复结果以 reports/Calculet-NPU-远端与本机清理完成记录-20260802.md 为准,不要依据旧的传输期 README 判断当前远端状态。

机器索引

  • 主采集包全文件索引.tsv:普通文件系统中的主采集包,不递归进入稀疏映像。
  • 大小写敏感视图全文件索引.tsv:稀疏映像挂载后的全部研究视图。
  • 统一目录链接清单.tsv:本入口的每个符号链接、相对目标和当前解析状态。

索引可用 scripts/重新生成全文件索引.command 重建。主归档可用 scripts/复验八个主归档.command 重新验收。

本目录实际新增文件的 SHA-256 位于 checksums/catalog-files.sha256。该清单不跟随符号链接计算 20 GiB 目标内容;链接目标分别由主归档、模型和 Git 证据清单验证。