存档求解器回归基线与当前改动

纳管 AMESim 对齐基线、发布锁、回归测试及当前物理门禁调整。

更新日志仅记录已完成成果，并注明当前 HEAD 尚待真实 production 复跑与远端 workflow 验证。

README.md

@@ -6,9 +6,9 @@ ReactFlow 系统建模与 `app.simulation` 仿真后端。
 
 后端统一使用 Python 3.12；仓库根目录的 `.python-version` 记录本轮参考补丁版本
 `3.12.3`。`requirements.txt` 保留支持范围，
-`constraints/python312-direct.txt` 固定应用直接依赖的参考版本。普通开发、性能复测和
-CI 应同时使用两者，以避免同一代码在不同时间解析到不同的 NumPy、SciPy 或 Web
-框架版本。
+`constraints/python312-direct.txt` 固定跨平台开发环境的直接依赖参考版本；
+`constraints/python312-linux-x86_64.lock` 则完整固定发布与 CI 所用的 Linux x86_64
+wheel、全部传递依赖及其 SHA-256。
 
 Windows：
 
@@ -25,20 +25,21 @@ Linux：
 ```bash
 python3.12 -m venv .venv
 ./.venv/bin/python -m pip install \
-  -r requirements.txt \
-  -c constraints/python312-direct.txt
+  -r constraints/python312-linux-x86_64.lock
 ./.venv/bin/python -m pip check
 ```
 
-约束文件只固定代码直接导入或启动的 `fastapi`、`lxml`、`numpy`、`pydantic`、
-`scipy` 和 `uvicorn`。`uvicorn[standard]` 的可选传递依赖包含平台差异，因此仍由 pip
-按目标平台解析；这套方案固定求解器和接口层的主要版本，但不是带 wheel 哈希的逐位
-相同发布锁。若要测试 `requirements.txt` 声明的兼容范围，可显式省略 `-c`，但这类
-结果不应与受约束环境的性能数据直接比较。
+Linux 发布锁仅适用于兼容 manylinux_2_28 的 Linux x86_64 和 CPython 3.12。它启用
+`--only-binary=:all:` 与 `--require-hashes`，因此不会静默改用源码包或未审计 wheel；
+CI 和正式性能复测必须直接以 `-r` 安装该文件。Windows 或其他平台的开发环境继续
+使用 `requirements.txt` 加 `constraints/python312-direct.txt`。若要测试
+`requirements.txt` 声明的兼容范围，可显式省略约束，但这类结果不应与锁定环境的
+性能数据直接比较。
 
-升级参考版本时，应在干净的 Python 3.12 虚拟环境中同时安装范围文件和约束文件，
-运行 `pip check` 与后端测试，再更新约束；不要从单个平台的 `pip freeze` 直接复制
-所有传递依赖。
+升级参考版本时，应在干净的 Python 3.12 Linux x86_64 虚拟环境中解析范围文件，
+仅下载兼容 wheel，逐个记录 wheel 的 SHA-256，再从空环境安装发布锁并运行
+`pip check`、依赖契约测试与后端测试。不能只复制 `pip freeze`，因为它既不证明
+依赖来源，也不校验安装产物。
 
 前端使用 Vite 8，需要 Node.js `20.19+` 或 `22.12+`。首次启动前安装前端依赖。