13 lines
2.4 KiB
Markdown
13 lines
2.4 KiB
Markdown
# 2026-09-12：按需编译与分层缓存
|
||
|
||
后续 Windows 修复：用户实际运行报 `utime: follow_symlinks unavailable on this platform`。根因是缓存最近使用时间更新无条件传入可选参数，与数值求解无关。按 [Python 平台能力接口](https://docs.python.org/3.12/library/os.html#os.supports_follow_symlinks) 改为能力检测后选择调用，保留目录/reparse 校验和真实权限错误。新增回归在修复前复现同一异常；修复后构建/存储 40 项通过（8.174 s，Linux 环境）。新增真实工具链的跨平台缓存集成入口，本机 1 项完整序列通过（1.399 s），已加入 Windows CI。修正八路在模拟不支持该参数的条件下完成 0～10 s BDF 求解，1,790,486 个 binary64 值与已接受参考逐位一致，随后完整缓存命中成功；[修复摘要](../other/assets/2026-09-12/native-cache-windows-utime-fix.json) 保留证据，原始记录在 `test/windows-cache-utime-20260912/`。并将 [跨平台交付约定](../standard/跨平台交付约定.md) 写入仓库。本机没有 Windows 运行环境，本次不能声称 Windows 实机已验收；下文为此前优化阶段的记录。
|
||
|
||
|
||
原生构建改为按实际引用选择功能模块，复用内容校验的目标文件，保留完整模型缓存。两池默认预算分别为 128 MiB 和 256 MiB，按最近使用时间清理；跨进程使用锁保护活跃构建/运行，超大单条目和在用内容允许暂时超额。旧根级缓存单独保留，新代码不继续追加旧格式。
|
||
|
||
冻结原版本同机对照，八路首次构建 3.7742→2.4875 s（-34.09%）、修改一个管长参数 3.9009→2.4838 s（-36.33%）、切四路 2.4908→1.1109 s（-55.40%）。完整模型命中检查增加约 0.13 s，已披露。八路原生 1,790,486 个 binary64 值逐位一致；网页三次中位可查看 3.7586 s、保存 3.8605 s、CSV 1.0348 s，四轮完整结果/下载/刷新一致。
|
||
|
||
93 项后端回归、收尾 37 项缓存专项（部分重叠）、前端构建和 12 项超时/看门狗测试通过。Windows 换行做了模拟回归，未实机验证 Windows 锁实现。正常 5173/8000 服务保持停止，临时验证服务已停止；传输压缩仍仅归档备份。本轮未安装环境、提交或推送 Git。
|
||
|
||
实现、缓存目录、容量边界、阶段成本和原始记录见 [完整报告](../other/按需编译与分层缓存优化-2026-09-12.md)。
|