# 测试与运维脚本规则 本文件适用于`scripts/`;其他目录修改代码时,按根规则来此查测试入口。 ## 单测隔离 - `run_tests.py`逐批调用`unit_test_guard.py`,清除业务环境变量,在无`.env`的临时目录运行并阻断套接字。只跑一批也必须走同一隔离入口;新增可直接运行的测试沿用现有安装护栏方式。 - 新增服务调用需补`test_wiring.py`中的`install_fakes`或对应内存桩;真实连接尝试即失败,不能靠业务层吞异常让测试通过。 - 新增`test_batch*.py`同时登记`run_tests.py`的`SUITES`和例数说明。缺失测试文件必须失败,不能当跳过。 - DDL、调度、API、密钥、动作求值顺序及仓储签名变化,检查`run_tests.py`顶部哨兵位置清单及实际断言,不照抄历史表数或测试总数。 - 合并分支时检查测试文件是否重名,不能让一批测试覆盖另一批;缺项不能靠删登记解决。 开发机在安装了项目依赖的独立虚拟环境中、从仓库根目录执行: ```bash python scripts/run_tests.py python scripts/unit_test_guard.py scripts/test_batch48_units.py ``` 全量预期末行为`ALL SUITES PASS`。单批编号按改动选择,不固定只跑微盘。纯文档修改不要求全量回归。页面三道护栏由全量入口覆盖,也可分别经隔离入口运行。 ## 运行脚本 `make help`是命令目录,不能把每个目标都当只读探针。`make test`用于部署服务器,发布前还须对匹配的候选镜像断网验证,步骤见[pms-release](../.agents/skills/pms-release/SKILL.md)。 新脚本应区分只读检查和实际写入,并验证重复执行及失败后的状态。`tick`、回放、建表、清账和重建账本都有业务副作用,不在活跃交易账户上当作普通单测。隔离演练使用独立数据库与前缀,不使用会认领真实成交的shadow路径。历史探针文件和文档中的日期不自动构成今天的执行授权。