Calculet NPU 研究资料归档
本仓库是 2026-08-01 至 2026-08-02 从测试样机采集并在本地验收的 Calculet NPU 研究资料入口，供内网团队持续分析 Runtime、驱动、llama.cpp、算子优化、多模型调度和新模型适配。
状态：八个权威主归档完整，合计 21,078,519,107 字节；源码历史、Git bundle、模型文件清单和研究报告均已纳入。原始内容的 SHA-256 不因本仓库的分片方式而改变。
快速开始
仓库使用 Git LFS。首次使用前安装 Git LFS，然后克隆：
git lfs install
git clone git@192.168.10.248:cogito/calculet-npu-research-archive.git
cd calculet-npu-research-archive
./scripts/verify-repository.sh
只想先看报告和源码、不立即下载约 21 GiB 原始归档时：
GIT_LFS_SKIP_SMUDGE=1 git clone git@192.168.10.248:cogito/calculet-npu-research-archive.git
随后可按需执行 git lfs pull --include='archives/<路径>'。
从当前网络追加 LFS 大文件
Gitea 当前对 SSH LFS 上传返回的内部地址是 http://gitea/...。匿名克隆和 LFS 下载通过上面的 IP 地址已经验收；如果贡献者电脑不能解析主机名 gitea，SSH 推送 LFS 时可在另一个终端启动仅监听本机回环地址的临时转发：
python3 scripts/lfs-host-proxy.py --port 18765
然后在仓库终端执行：
http_proxy=http://127.0.0.1:18765 \
HTTP_PROXY=http://127.0.0.1:18765 \
no_proxy= NO_PROXY= git push
推送完成后用 Ctrl-C 关闭转发器。长期方案是在 Gitea 服务端把 ROOT_URL/LFS 外部地址改成团队实际可解析的 IP 或 DNS 名称。
目录
| 路径 | 内容 | 用途 |
|---|---|---|
reports/ |
30 份研究报告、JSON 和校验工具 | 研究导航、接口契约、调优与实施规格 |
documentation/ |
Runtime API 与 VPN 原始 PDF | 官方接口和接入资料 |
source/ |
去除嵌套 .git 后的可浏览源码快照 |
直接检索、代码阅读和修改起点 |
history/ |
Git bundle、精确仓库 tar、patch、reflog 和主题索引 | 恢复完整提交历史与失败/调优路径 |
archives/ |
八个权威主归档；大文件为 512 MiB 可逆分片 | 灾备、重新解包、原始证据保全 |
checksums/ |
原始归档、分片、模型和 Git 资产校验值 | 完整性复核 |
provenance/ |
原始索引、传输 manifest、日志和完成标记 | 采集与传输审计 |
scripts/ |
重组、校验和 bundle 恢复脚本 | 复现与长期维护 |
权威主归档
| 归档 | 字节数 | SHA-256 |
|---|---|---|
00-critical-context-20260801.tar.zst |
8,942,525 | 2ad543697861a386b36604f863acdc161fbfd6552c9cd1e959b1fbe540b524ed |
01-model-runtime-no-weights-20260801.tar.zst |
11,253,912 | 5414d91cb4bc3c0e64bf29f7e86fc9cef2e2963ff0c5a5ca6488f008053630b8 |
llama.cpp-full-no-exclusions-fd9bd632.tar.gz |
264,921,801 | 55d28eb0b72eb8e22627028965912b3a274b76314f8d726f67427a42ee0b2d25 |
baseline-analysis-export-20260801.tar |
436,398,080 | ba39aee991c8655324db4326c49a1f32af20ae450a8d07d51f9eac1c60186a4c |
calculet-container-home-v0.4.8-release.tar.gz |
740,994,223 | 54fe26018983d293c404b2963db7eb90f70bf9d367eefe64ab36003cc9f9530c |
calculet-llama-v0.4.8-release.oci.tar |
1,646,166,016 | 1ad4aba68c6a96cf7f592fdcd8e0c801bf022845aaf71cd49b909abd60365bf3 |
user2-live-home-complete-20260801.tar.zst |
1,684,911,580 | 581202c7c9fb732baaae3b7c5bd8aa595ac5e4d8a5c155749811cb282ce2afa1 |
calculet-models-complete-20260801.tar.zst |
16,284,930,970 | ebb143415bc44456599265d07e0b0057497d8708ebafb23f53435d0c189622d8 |
小于等于 512 MiB 的归档直接位于 archives/。更大的归档位于同名 .parts/ 目录，运行以下命令可重组并核对整包哈希：
./scripts/reassemble-archives.sh /path/to/output
恢复 Git 历史
source/ 是便于 Gitea 在线浏览的工作树，不把嵌套仓库的 .git 目录直接嵌入本仓库。完整对象、分支、标签、reflog 证据和不可达提交保存在 history/ 的 bundle 与精确仓库 tar 中。
从 bundle 建立独立仓库：
./scripts/clone-bundle.sh history/llama.cpp/llama.cpp-all-refs-20260802.bundle /path/to/llama.cpp
完整性与已知例外
- 八个主归档在发布前重新核对过 SHA-256 和格式。
- 七个恢复仓库通过
git fsck --full --no-reflogs，五个 bundle 通过git bundle verify。 - macOS 普通工作树不能精确表达 Linux 大小写碰撞路径及 7 个 overlay whiteout 设备节点；它们在权威 tar 中完整保留。
- baseline 自带清单对一个 depth500 包含一条过期重复哈希，实际文件匹配其第二条记录；baseline 主归档整包哈希通过。
user2-live-home含采集时的 shell 历史、用户配置、测试目录和 rootless Podman 状态。发布前未检出 SSH 私钥、OpenVPN 配置、口令、访问令牌或授权头，但仓库仍应仅在获准的内网团队范围使用。
详细验收依据见 provenance/完整性验收报告.md 和 reports/Calculet-NPU-全部数据下载与验收摘要-20260802.md。