C内核按库功能拆解，编译结果缓存区构建，编译过程与已有缓存结果对照功能实现

native/README.md

@@ -66,15 +66,18 @@ BDF 默认使用结构着色差分，无需环境变量或网页选项。修正
 - 网页和 Python CLI 默认 `rtol=1e-8`；生成的状态绝对误差限为质量 `1e-14 kg`、内能 `1e-8 J`、速度/位移 `1e-12`（各自 SI 单位）。独立 C 程序默认 `rtol=1e-6`，对照时应显式传入。CLI 可覆盖 rtol；本版不支持自定义 atol 或 first_step。不同积分器相同局部容差不保证全局曲线误差完全相同。
 - 时间信号显式分段，塑性/反弹端挡用稠密插值定位并重启。试探 RHS 不修改已接受状态。柔性接触沿用现有分段力公式，不改变刚度或阻尼来提速。
 - 每任务独立进程，支持进度、取消及超时。进程崩溃不会作为成功返回，受控失败保留最后接受状态。
-- 编译缓存位于 `app/data/native-builds/`，校验模型、组件合同、源码、编译选项及依赖哈希。本版参数特化入 C，修改模型数值参数会重新编译；修改时间、步长、rtol、采样选项可复用 EXE。
+- 编译缓存位于 `app/data/native-builds/`：`models/<SHA>/` 保存完整模型，`objects/<SHA>/` 保存可跨模型复用的模块目标文件。按当前模型使用的元件函数及其依赖选择模块，最多并行编译 4 个缺失单元。预处理后的实际 C 内容、工具链和编译选项组成对象键；完整模型键另含生成源码、组件合同及链接依赖。模型数值参数仍特化入 C，但仅重编受到影响的单元；时间、步长、rtol、采样选项仍是运行参数。
+- 完整模型默认预算 256 MiB、对象预算 128 MiB，可分别设置非负整数环境变量 `SIMULATION_NATIVE_MODEL_CACHE_MB`、`SIMULATION_NATIVE_OBJECT_CACHE_MB`。按目录最近使用时间执行 LRU；活跃构建/运行及最后一个单独超额的条目保留并报告超额，因此是安全软上限。预算计算受管理文件的逻辑字节，不含旧版根级缓存、锁及文件系统元数据。
+- 缓存读写带跨进程使用锁，命中时核验工件和身份，损坏缓存明确失败。对象复制到构建私有目录后再链接；模型使用锁一直保留到进程退出和结果读回。失败正常清理临时文件；进程被杀遗留的新格式构建目录在下一次清理时按锁状态回收。旧格式缓存保留，不自动迁移或删除，避免影响旧服务。
+- Python 调用者若长期保留 `NativeBuild`，需在最后一次执行/打包后调用 `build.close()` 释放使用保护并触发清理；网页 runner 自动处理。返回的 `buildDetails` 区分完整命中、目标文件命中/编译次数、预处理、并行编译墙钟、编译任务耗时之和、链接和容量清理结果。
 
 ## 代码职责
 
 - `app/simulation/native_codegen/input.py`：CLI 输入适配。
 - `contracts.py`：逐组件 C 实现版本白名单，新增模型或版本不会自动视为已支持。
 - `compiler.py` / `extended.py`：能力检查、状态/输出布局、连接分组、常系数约束消元、C 生成。保留已验证的简单拓扑快速生成路径，两条路径均只运行 C 数值代码。
-- `build.py` / `runner.py`：编译缓存、依赖打包、隔离执行与结果适配。
-- `native/components/kernels.c`：空气/氦气物性、阀与管路流量、信号、摩擦接触和端挡原语。
+- `build.py` / `modules.py` / `cache_storage.py`：按需模块、两层编译缓存、完整性校验与有界 LRU；`runner.py`：隔离执行、使用保护与结果适配。
+- `native/components/modules/`：物性、孔口、管路、机械和信号模块。`kernels.c` 仅供诊断的聚合入口，生产构建不再将聚合入口与模块重复编译。
 - `native/runtime/`：RK45、CVODE 适配、事件定位、采样与 CLI。
 - `app/simulation/backends.py` / `results.py`：共用执行入口与结果合同。