oni-harness
使用 OniHarness 测试缺氧 Mod，选择不启动游戏的原生物理用例，或通过 Steam 启动无窗口、无图形设备的真实游戏，并可选观看 AI 的同一份文本地图。用于无头测试、性能迭代和文本观看。
Source facts
- Repository
- LIghtJUNction/OniMods
- Last source activity
- October 19, 2026 at 03:14
- Detected SKILL.md language
- Chinese
- Stars
- 21
- Forks
- 11
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- oni-harness
- description
- 使用 OniHarness 测试缺氧 Mod，选择不启动游戏的原生物理用例，或通过 Steam 启动无窗口、无图形设备的真实游戏，并可选观看 AI 的同一份文本地图。用于无头测试、性能迭代和文本观看。
# OniHarness 无头测试
先读取子项目中的[配套技能](../../../tools/OniHarness/.agents/skills/oni-harness/SKILL.md)，
按其中流程选择原生物理测试、C# 用例或明确启动游戏的验证流程。
子模块未初始化时，从 OniMods 根目录运行：
```sh
rtk git submodule update --init tools/OniHarness
```
技能里的命令从 `tools/OniHarness` 运行。需要完整游戏行为时，读取子项目的
`docs/runtime.md`，通过 Steam 启动真实 ONI，保留原生模拟。
默认无头启动必须验证 batch mode、Null 图形设备、零相机绘制；失败不能改为图形启动。
`normal/reduced` 是显式选择的图形模式。
文本观看开关和游戏渲染设置分开；它展示 AI 记录的原始地图，不读取截图。
游玩仍遵守 ONI 控制技能的暂停、观察、行动、短步运行和验证规则。
性能迭代使用子项目的 `scripts/measure_steps.py`，保持存档、Mod、速度和更新上限一致。
同时检查原生时间推进、CPU、驻留/交换内存、换页次数和控制等待。
CycleTrim 探针用 `launch --game-arg=--cycletrim-perf-probe` 显式开启；测量时检查日志标记，
避免把未加载 Mod、零推进或换页差异算成提速。控制确认更快不能等同于游戏模拟更快。
物理实验的图像来自数值状态回放，
不是游戏画面，也不代表已实现复制人、建筑生命周期或完整殖民地游玩。
保持原生模拟、独立 .NET 宿主、静态元数据和游戏内运行的证据边界。
View on GitHub