伊卡洛斯·贰 / Icarus II

游戏内 AI 助手。按 R 打开终端，问机制、产线排布、存档状态； AI 能读取你当前的存档给建议，并在你确认之后执行游戏内操作。

你需要三样东西

项	说明
游戏	Dyson Sphere Program —— 0.10.30.3100 已验证，其它版本未测
框架	BepInEx 5.4.23.5（⚠️ 不是社区常用的 5.4.17，原因见下）
API Key	你自己的 DeepSeek Key；或任意 OpenAI 兼容端点（Ollama / LM Studio / vLLM…）

为什么必须是 BepInEx 5.4.23.5

当前游戏用的是 Unity 2022.3.62f3，BepInEx 从 5.4.23.x 才修掉了 get_graphicsDeviceID 缺失的问题。Thunderstore 上常见的 xiaoye97-BepInEx 还停在 5.4.17，直接拿它启动很可能根本加载不了插件（表现为"按 R 毫无反应"）。

下载：BepInEx v5.4.23.5 → 取 BepInEx_win_x64_5.4.23.5.zip，解压到游戏根目录（和 DSPGAME.exe 同级）。

用 r2modman / Thunderstore Mod Manager 的话：把 profile 里的 BepInEx 包换成 5.4.23.5，或者直接在游戏目录手动放一份 5.4.23.5。

安装

推荐（mod 管理器）

先按上面的说明准备好 BepInEx 5.4.23.5；
在 Thunderstore / r2modman 里安装本 mod（会自动落到 BepInEx/plugins/IcarusII/）；
启动游戏，按 R。

手动安装

把压缩包里的 plugins/IcarusII/ 整个文件夹复制到 <游戏目录>/BepInEx/plugins/，最终结构应为：

BepInEx/plugins/IcarusII/
├── IcarusII.dll
├── sidecar/icarus-ii-sidecar.exe
└── ui/icarusii-ui

首次使用

进游戏后按 R；
终端会提示"尚未配置 API Key"，把 Key 粘贴进去并回车（输入不会回显，也不会写进聊天记录）；
状态变成「就绪」后就能提问了。

Key 只保存在本机 sidecar 的数据目录里，不会上传到任何第三方服务。

能做什么

问游戏机制、配方、产线排布、卡关了该先修什么；
让 AI 读取你当前存档的状态（背包、电力、物流、研究…）再给建议；
在你确认之后执行游戏内操作（例如批量摆放/拆除）；
右上角 ⚙ → 模型 页签：改提供商 / 模型名 / API Key / API 地址（把地址指向本地 Ollama 就能完全离线跑）；
输入框工具条：插入游戏图标、复选框、文字颜色——和游戏原生输入框同一套弹窗。

隐私与安全

API Key 只存在本机，聊天内容只发送到你自己配置的那个端点；
sidecar 是本地子进程，只监听 127.0.0.1；
AI 执行任何游戏操作前都会先征求你的确认；
卸载：删除 BepInEx/plugins/IcarusII/ 即可（数据目录 %APPDATA%/icarus-ii 可另行删除）。

常见问题

按 R 没反应 先看 BepInEx/LogOutput.log 里有没有 Icarus II 0.1.0 已加载。没有 → BepInEx 没生效（版本不对 / 没装好）；有 → 建造模式下 R 会主动让位给游戏（旋转建筑），退出建造模式再按。

杀毒软件报毒 / 提示"未知发布者" sidecar 是用 Node.js 打包的自包含 exe，且会拉起本地进程，容易被启发式引擎误报。可用下面的 SHA256 校验文件，或把样本提交给微软误报申诉。介意的话可以先只装 .dll，不复制 sidecar/（此时聊天不可用，但界面能看）。

Linux / Steam Deck / Proton Wine 默认优先加载内置 winhttp.dll，会盖掉 BepInEx 的代理 DLL。二选一：

# Steam 启动选项
WINEDLLOVERRIDES="winhttp=n,b" %command%

或向前缀注册表写入（与安装脚本做的事相同）：

[Software\\Wine\\AppDefaults\\DSPGAME.exe\\DllOverrides]
"winhttp"="native,builtin"

设置窗口里没有「模型」页 说明 mod 没加载成功（页签是运行期注入的），先按第一条查日志。

接口报错 / 401 / 404 进 ⚙ → 模型，确认 provider、模型名、API 地址是否与你的 Key 匹配；用本地模型时地址要带 /v1（例如 http://127.0.0.1:11434/v1）。

游戏更新后不能用了 DSP 每次大版本更新都可能改动内部类型。看日志里的报错，或等本 mod 适配新版本。

文件校验（0.1.0）

icarus-ii-sidecar.exe   SHA256 181d06401c71c0278c3903e3bef0cc68232e0b98dba7b2221122bb080af66890
IcarusII.dll            SHA256 c31fa03f2faf676cfc91e22296dd23bd39dc1c6fb73d6ad8f37eac5d0d809014

English (short)

In-game AI assistant for Dyson Sphere Program. Press R, ask about mechanics, factory layouts or your save; the AI can read your save and, only after your confirmation, perform in-game actions.

Requires BepInEx 5.4.23.5 (the community's 5.4.17 is too old for Unity 2022.3.62f3) and your own DeepSeek (or any OpenAI-compatible) API key. The key is stored locally only; all traffic goes to the endpoint you configure.

MIT licensed. Bundles Node.js (MIT) and pi (MIT). BepInEx is not redistributed — install it yourself.