# 公开报告阅读与复算 / Public report reading and reproduction

版本 / Revision: `convergence-2026-11-03`。

## 阅读与下载 / Read and download

- 中文：[报告](report.html)、[可直接阅读的数据与计算说明](methods.html)、[原始方法 Markdown](FINAL_METHODS.md)。
- English: [report](report.en.html), [readable methods and calculations](methods.en.html), [methods Markdown](FINAL_METHODS_EN.md).
- [下载数据包 / Download aggregate data](packages/Variational_Oct2026_Data.zip)：43份公开汇总 CSV/JSON 及其 `DATA_MANIFEST.json`，不包含 HTML、原始事件或逐地址记录。Contains 43 public aggregate CSV/JSON files and their manifest; no HTML, raw events or per-address records.
- 完整报告包包含双语报告、方法页、图表、汇总输入、生成脚本和上述数据包。解压后保持目录结构，直接打开 `report.html` 或 `report.en.html`。The full report package includes both languages, methods pages, charts, aggregate inputs, generation code and the data ZIP. Preserve its directory structure after extraction, then open either report HTML.

图表的“查看数据 / Data”和“计算说明 / Calculation notes”分别直接打开对应数据和方法章节；方法页可返回原图。完整报告包不嵌套自身；独立 HTML 的下载按钮指向随包提供的数据 ZIP。The chart links open their direct data and matching methods section; methods pages link back to the chart. The full report ZIP does not contain itself. Standalone HTML downloads point to the included data ZIP.

已有 `RUNBOOK.md` 保留为上一版运行说明，本页补充当前版本的方法页生成与分包流程。The previous `RUNBOOK.md` is retained; this page describes the current methods-page and packaging workflow.

## 文件核验 / Verify supplied files

只校验分发文件，无需安装图表依赖： / Check distributed file sizes and SHA-256 hashes without chart dependencies:

```sh
python3 scripts/rebuild_public.py --verify-only
```

[PUBLIC_MANIFEST.json](PUBLIC_MANIFEST.json)覆盖全部公开分发文件及数据 ZIP，不包含清单自身或外层报告 ZIP。[DATA_MANIFEST.json](DATA_MANIFEST.json)只覆盖43份汇总数据，不包含自身或 ZIP。这样避免循环哈希。The public manifest covers approved payload files and the data ZIP, excluding itself and the enclosing report ZIP. The data manifest covers only the 43 aggregate files, excluding itself and ZIP containers. These separate scopes avoid circular hashes.

## 离线复算 / Rebuild offline

环境：Python 3.12+、Node 22+、ECharts 6.1.0。Python仅使用标准库。先安装固定版本的图表依赖，再运行复算： / Requirements: Python 3.12+, Node 22+, ECharts 6.1.0. Python uses only its standard library. Install the fixed chart dependency, then rebuild:

```sh
npm install --prefix site --no-audit --no-fund echarts@6.1.0
python3 scripts/rebuild_public.py
```

依赖安装可能联网；复算本身不联网，也不需要生产服务器、数据库、私有目录或历史工程包。脚本先核对公开清单，再依次生成双语图表、报告和方法 HTML，最后逐文件核对与分发版本一致。真实执行结果写入本地 `evidence/public-reproduction.json`。Installing the dependency may access npm. Reproduction itself is offline and needs no production server, database, private directory or internal history package. It verifies the manifest, rebuilds bilingual charts, reports and methods HTML, then compares all approved distributed files. The actual local result is written to `evidence/public-reproduction.json`.

复算从已保存的公开汇总输入开始，不重新证明原始事件分类、地址映射、采集完整性或链上索引。历史校验见[数据验证结果](DATA_VALIDATION.json)，覆盖与限制见[中文方法](methods.html#coverage)或[English methods](methods.en.html#coverage)。Reproduction starts from the supplied aggregates. It does not independently reconstruct raw-event classification, address mapping, collection completeness or chain indexing. See the recorded validation and language-specific methods for coverage and limitations.

## 重新打包 / Repackage

生成内容稳定后可重新构建两个 ZIP： / Once generated assets are final, build both ZIPs:

```sh
python3 scripts/package_candidate.py --check-only
python3 scripts/package_candidate.py
python3 scripts/package_candidate.py --verify
```

打包只使用代码内明确列出的公开文件，不收录历史目录、私有证据、网站工程、依赖目录或原始事件。文件时间固定以便稳定复现；清单先覆盖汇总数据，再覆盖含数据 ZIP 的报告文件。The packager uses an explicit allowlist. It excludes internal history, private evidence, the website project, dependencies and raw events. Fixed ZIP timestamps enable deterministic packaging. The data manifest is built first; the report manifest then includes the data ZIP.

维护者可加 `--sync-site`，仅同步当前目录下 `site/public/research/variational/2026-10`；不会部署或上传。For maintainers, `--sync-site` also synchronizes only this local October public-asset folder. It does not deploy or upload anything.

双语报告的“打印 / Print”提供白底正文；方法页可单独打印，R3附篇保持独立。取消或完成打印后应恢复原折叠状态。The reports print as white-background core documents. Methods and the R3 appendix remain separate; closing the print dialog restores the previous disclosure state.
