# 静态发布 Python 缓存清理 Gate 实施记录

## 目标

本文件落实 `ACC-051/INT-038`，防止 native/Python probes 在只读 LinuxCNC 树生成的 `__pycache__`、`.pyc`、`.pyo` 被 static build 复制进 Web 发布包。

## 实现

- `build-static.mjs` 为递归静态资产复制统一增加 filter，排除 `__pycache__` 和 Python bytecode。
- 新增 `verify_static_release_hygiene.mjs`，递归扫描完整 dist，发现任一缓存目录或字节码即失败。
- hygiene gate 位于 parity 的 static build 之后、其他 dist consumer 之前。
- manifest 单测锁定 build 先于 hygiene gate，避免检查旧 dist。

## 验证输出

```text
gmoccapy_static_build=ok
static_release_python_cache_count=0
static_release_hygiene=ok
wrapped_rotary_static_assets=ok
web_software_parity_gate=ok
```

## 结论

`ACC-051/INT-038` 完成。静态发布包不再携带由本机 Python 版本产生的缓存文件，构建结果更可复现且不泄漏主机运行残留。