Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Oxygen Not Included

ONI-AIReview(缺氧 AI 智能复盘 MOD)

《缺氧(Oxygen Not Included)》AI 对局复盘工具:自动记录殖民地数据,游戏内一键让 AI 分析你的基地——找出隐性隐患、预判崩盘风险、给出优化方案(含空间布局与创造性工程设计),还能一键跳转到问题点位。

当前版本 v0.3.2,支持原版 + 眼冒金星(Spaced Out)DLC。

它能为你做什么

  • 自动记录:每 5 个游戏周期(可调 3~10)采集一次基地数据——资源存量与增减速率、温度、电力、病菌、复制人状态等,无需任何操作
  • AI 复盘报告:游戏内一键生成,包含高危/中危/低危问题清单、崩盘风险预判(预计剩余周期)、失误复盘、短期急救与长期重构方案
  • 空间布局调整建议:结合基地实际边界与问题点位坐标,诊断功能分区、热量隔离、管道走向、垂直分层是否合理,给出具体迁移方案
  • 创造性工程设计方案:针对最紧迫的瓶颈给出可抄作业级别的创新工程蓝图——如氧气不足时的"自循环电解制氧塔"(分层结构 + 设备清单 + 管道走向 + 前置条件)
  • 问题溯源:自动定位每类隐患第一次出现的周期,解决"不知道问题何时埋下"的痛点
  • 点位跳转:报告中的问题条目可一键跳转镜头到地图对应位置,红色闪烁高亮 3 秒
  • 高危预警:游玩途中检测到氧气枯竭、食物崩盘、电路过载等高危状态时,游戏内弹窗提醒(可选自动开始 AI 复盘)
  • 日志与报告管理:历史对局数据、全部复盘报告,可在游戏内查看、导出、删除
  • 性能友好:大基地自动降频保护帧率,每 100 周期自动内存回收

安装

  1. dist/ONIAIReview 文件夹复制到:

    C:\Users\<你的用户名>\Documents\Klei\OxygenNotIncluded\mods\Local\ONIAIReview\
    
  2. 启动游戏 → 主菜单 → Mods → 勾选 ONIAIReview → 重启游戏

进阶用户可从源码自行构建:安装 .NET SDK 后在项目根目录执行 dotnet build src/ONIAIReview/ONIAIReview.csproj -c Release,产物在 dist/ONIAIReview。默认游戏路径不符时用 -p:GameDir=你的游戏目录 指定。

快速上手

  1. 新开一局(旧存档只能记录读入之后的数据)
  2. 正常游玩,右上角「AI 复盘」悬浮按钮随时可点(也可从 ESC 暂停菜单进入)
  3. 玩一段时间(至少 2 条快照)后,打开面板 → AI 复盘 页签 → 选一个 AI(见下表)→ 开始 AI 复盘
  4. 等待 1~3 分钟(后台运行,可继续游戏),完成后游戏内通知,报告自动展示并保存

想用网页版 ChatGPT/豆包手动分析也行:「数据」页签一键导出完整 JSON,自己投喂给任意大模型。

面板功能导览

打开悬浮按钮后有五个页签:

页签 功能
状态 最近快照摘要、资源增速、隐患记录、AI 复盘报告展示
数据 立即采样一次、导出当前对局完整 JSON、打开数据文件夹
AI 复盘 配置 AI 提供商、测试连接、一键生成复盘报告(含布局建议与创造性设计)
日志 管理全部对局日志与历史报告:查看 / 导出 / 删除(当前对局自动保护)
设置 采样周期(3~10)、自动复盘模式、AI 超时与快照上限、自动降频等开关

面板打开时游戏自动暂停防误操作,关闭后恢复原速。

AI 怎么配

游戏内「AI 复盘」页签三选一:

提供商 适合谁 需要准备
Ollama(本地) 有一定电脑配置,想完全免费 安装 Ollama 后执行 ollama pull qwen2.5:7b,模型名填 qwen2.5:7b
豆包(火山方舟) 想用云端大模型、不怕小额付费 火山引擎 开通方舟 → 创建 API Key,模型名填 doubao-seed-1.6-250615
自定义(OpenAI 兼容) 已有其他服务商的 API Key 填服务商的接口地址 + 密钥 + 模型名

免费云端方案(填入「自定义」即可,注册送的额度足够用很久):

服务商 接口地址 模型名示例
硅基流动 https://api.siliconflow.cn/v1 Qwen/Qwen2.5-7B-Instruct(官网标"免费"的模型均免费)
智谱 https://open.bigmodel.cn/api/paas/v4 glm-4-flash(免费)
OpenRouter https://openrouter.ai/api/v1 :free 后缀的模型

能用 Cherry Studio 里的免费 AI 吗? 不能直连(它是聊天客户端,不提供 API),但你在里面免费用到的就是上表这些服务商的免费额度——把同样的地址、密钥、模型名填进「自定义」即可。

免费模型名单随服务商调整,以各官网为准。7B 级免费模型即可稳定输出结构化复盘;想要高质量的布局推演与工程蓝图,建议用 14B 以上模型。

填写后先点「测试连接」,成功即可使用。本地小模型建议在「设置」里把发送快照上限调到 20~30 条。

能提前预判风险吗?

能,分两层,且预判后都会给出可落地的建议:

  • 趋势预判(真·事前):MOD 记录每项资源的净变化速率,本地规则引擎会算出"藻类还剩 43 周期耗尽"这类结论;AI 复盘也会输出"预计 6 周期后断电"的风险预判——都是崩盘发生前的预警
  • 状态预警(刚出问题时):氧气过低、电路过载、复制人昏迷等高危状态一出现,立刻游戏内红色通知(每 5 周期检测一次,非逐秒监控)

预判后给什么建议? AI 复盘报告包含五类建议:

  1. 短期急救方案——针对当前风险的立即止损操作
  2. 长期重构方案——系统性的运营优化
  3. 空间布局调整建议——结合你的基地实际边界与问题点位坐标,诊断功能分区(生活/工业/农业/电力)、热量隔离(高温源是否逼近生活区)、管道走向、垂直分层是否合理,给出"把高温工业链迁到基地下方并隔温"这类具体迁移方案,涉及位置的还可一键跳转镜头查看
  4. 创造性工程设计方案——不止给常规方案,还针对最紧迫的瓶颈给出可抄作业级别的创新工程蓝图:氧气不足→"自循环电解制氧塔"(分层结构/设备清单/管道走向);食物危机→"全自动养殖-屠宰冷链产线";电力瓶颈→"双燃料电站"。每个设计含设计理念(数值依据)、结构蓝图、前置条件(科技/材料/电力)
  5. 问题解决方案——每个问题条目自带针对性方案与点位定位

局限:只能预判"渐变型"崩盘(资源枯竭、温度累积、电力缺口),无法预测突发事件(火山喷发、管道瞬间爆管)。预警默认弹窗提示,可在「设置」改为高危时自动开始 AI 复盘。

数据在哪

C:\Users\<你>\AppData\LocalLow\Klei\Oxygen Not Included\ONIAIReview\
├── config.json   # 配置(游戏内设置面板可改,含 API Key,勿外传)
├── logs\         # 对局时序数据
├── exports\      # 导出的 JSON
└── reports\      # 复盘报告(.md 可读版 + .json 结构化版)

常见问题

  • 报告说有问题但找不到位置? 点问题条目的「定位」按钮,镜头直接跳过去并高亮
  • AI 输出乱七八糟? 换更强的模型(14B 以上),或减少发送快照数;结构化解析失败时 MOD 会降级展示原始回复,功能不受影响
  • 会卡游戏吗? 不会。AI 分析在后台线程运行;采样若变慢(大基地)会自动拉大采样间隔保护帧率,可在设置中关闭该行为
  • 和其它 MOD 冲突吗? 纯读取式采集,不修改游戏数据,理论可与任意 MOD 共存
  • 旧存档能用吗? 只记录 MOD 启用后的新数据,旧存档从读入时的周期开始记
  • 换存档/多殖民地会混数据吗? 不会,日志按殖民地 GUID 分文件记录,读档自动切换
  • API Key 安全吗? 明文存在本机 config.json,仅本 MOD 调用,别把配置文件发给别人

已知限制

  • 大气/液体资源只统计已探索区域
  • 眼冒金星 DLC 跨星球点位无法跳转(会提示不在当前世界)
  • AI 复盘需自备模型服务,MOD 不内置任何密钥
  • AI 给出的坐标与设备数值来自日志真实数据,但布局建议与工程蓝图的质量依赖模型能力——免费小模型的方案建议对照游戏内实际数据校验后再抄作业

更新日志

  • v0.3.2:新增创造性工程设计方案(可抄作业级别的创新工程蓝图,含结构/设备/管道/前置条件)
  • v0.3.1:新增空间布局调整建议(基于基地边界与问题点位的分区/热量/管道诊断,支持点位跳转)
  • v0.3.0:地图点位高亮与镜头跳转、高危自动复盘(弹窗/自动两档)、日志管理页签、大基地自动降频与内存回收
  • v0.2.0:游戏内 AI 复盘(Ollama 本地 / 豆包 / 任意 OpenAI 兼容端点)、结构化分级报告、问题首现周期溯源
  • v0.1.0:数据采集与时序日志

许可

MIT License — 可自由使用、修改、分发

About

A zero-delay, low-performance-cost AI review mod for Oxygen Not Included, filling the community blank of intelligent colony playback and fault diagnosis.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages