# 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.md` 和 `reports/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.cpp`、`calrt`、`fmt`、`systemc` 完整仓库、历史性能材料和驱动证据全部展开到 `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 自带 `SHA256SUMS` 对 `llama.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 证据清单验证。