Changelog ​

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased] ​

[0.33.0] - 2026-08-06 ​

Added ​

• Mod 测试房间传送 — 开发模式 房间传送 新增 Mod 测试 — 篝火 与 Mod 测试 — 宝箱房 入口，会额外生成与你相同角色的假玩家，便于在单人开发局中预览官方多人篝火与遗物手部 UI。
• MCP dev_add_relic — 按 model id 给本地玩家授予遗物，相当于 dev_add_card 的遗物版。传 search 可在无对局时列出 id 与稀有度。 @Elnas32 · PR #14 · 37b6d19
• MCP dev_hover — 聚焦（悬停）UI 元素以触发只在悬停时发生的行为。target 可用别名（map_node、reward_alternative、rest_option、relic、boss_icon、event_option、potion、card、creature、treasure_relic）或任意节点类型名；target: "list" 列出当前屏幕上所有可聚焦类型，"none" 取消悬停，click 在聚焦后按下，不传 index 则只列出该目标的实例。 @Elnas32 · PR #14 · 2099602

Fixed ​

• 卡牌浏览器 → 选牌界面 — 使用卡牌浏览器后，官方删牌/选牌等卡牌网格不会再出现卡牌偏小或间距错乱。感谢 OLC 反馈。
• v0.110.1 上的伪联机队友生成 — 注册模拟玩家时抛出 NullReferenceException，生成流程中途中断，队友虽然留在本局中却没有行动队列，因此它出的每张牌都会被丢弃并被强制结束回合。 @Elnas32 · PR #8 · 108b87c
• v0.110.1 上的战斗就绪状态读取 — 「准备进入敌方回合」的逐玩家检查恒为 false，导致已经就绪的模拟玩家被反复重新标记。 @Elnas32 · PR #8 · 108b87c
• Dev 面板图标 — MDI 图标集改为在构建过程中生成，而不再只由 make icons 生成（而它没有任何依赖会触发）。此前 KitLib.Panel 根本没有打包图标集：构建始终成功，运行时每次图标查找却都记录 icon '<name>' not found。 @Elnas32 · PR #13 · b78a311

[0.32.1] - 2026-08-01 ​

Added ​

• Dev Viewer AI 面板 — 输出战斗与宏观决策遥测、模拟/选项分解、卡组连招面板与宏观评分洞察。
• 模拟优先的卡组评分 — 宏观选牌结合路线战斗结果与连招选项链（含执行概率），不再仅依赖 Codex 默认值。

Changed ​

• 战斗 AI 开局与地图评分 — 安全回合优先易伤铺垫而非空挡；地图路线按路线模拟 EV 评分。

Fixed ​

• STS2 v0.110.1 — 支持最新游戏版本；联机握手、快捷键、手柄 UI 与大厅玩家列表在 v0.110.1 上恢复正常。
• 战斗 AI 护甲缩放 — 模拟中计入 Body Slam 伤害；护甲型开局延后到有收益时再出；Havoc 类出牌不再浪费已窥视的关键牌。
• 战斗 AI 碎伤 — 当受到的伤害已被完全挡住时，优先安全碎伤而非叠多余护甲。

[0.32.0] - 2026-07-26 ​

Added ​

• 多版本支持 — 同一 KitLib 安装可同时覆盖 stable 与 beta，启动时自动加载匹配构建。受个人精力所限，公开发布与日常维护仍以 beta 为主。
• Android 支持 — Android 上 KitLib 模块默认尝试加载；无法加载的模块会自动跳过，不影响其余功能。

Changed ​

• 双开 LAN 预设 — 移除开局自动套用主机/客机 preset；请在 DevPanel → AI 托管 手动点击 LAN 预设按钮。

Fixed ​

• 双开联机 — 以 1001 接入的真实 LAN 客机不再被误判为 phantom 同伴；主机不再为真实客机代点结束回合，修复双方各自出牌时的战斗不同步。

[0.31.1] - 2026-07-21 ​

Changed ​

• 开发者控制台（自启动） — 若浏览器里已有连上本地查看器的标签页，启动时不再额外打开新标签。
• 开发者控制台（日志） — 连接状态改为红黄绿圆点指示；去掉工具栏「已同步局内」提示。

Fixed ​

• 卡牌浏览器 — 在图鉴中添加卡牌时，不再整页刷新卡牌网格与右侧详情面板。
• 卡牌浏览器 — 搜索或筛选后添加卡牌、关闭再打开面板时，无需清空搜索即可再次选中筛选结果中的卡牌。
• 设置 — 切换 Dark / OLED / Light 主题后，设置面板不再卡住无法关闭。感谢 @minatowolf 反馈。

[0.31.0] - 2026-07-20 ​

Added ​

• MCP 卡牌选择 — 新增 get_selection_state 与 selection_action，让 MCP 代理读取并点选战斗内卡牌选择界面（弃牌堆/抽牌堆/消耗堆选取、手牌多选等）。combat_action 的 play_card 可传 selection_card_id 或 selection_index 在同一次调用内自动点选；若选择界面仍打开，响应会包含 pendingSelection 与 selectionState，而非立即失败。

Changed ​

• 日志查看器与开发者控制台 — KitLib 带 scope 的日志行与官方 STS2 logger 的标签间距一致（[KitLib] [Scope]，不再显示为 [KitLib][Scope]）。

移除 ​

• 内容 mod 日志 API（KitLibLog / ModLog / ModLogSettings） — 内容 mod 应使用官方 STS2 MegaCrit.Sts2.Core.Logging.Logger。KitLib.User 仍会采集所有 logger 输出供游戏内日志查看器与开发者控制台使用。
• KitLibModSettingsUiOps.BuildLogLevelRow — 请在 mod 设置中改用 Logger.SetLogLevelForType。

[0.30.0] - 2026-07-19 ​

Added ​

• 单人 AI 同伴 — Mod 可通过 CompanionBridge.TrySummon 在进行中的单人局召唤第二名角色。同伴在战斗中独立出牌、镜像你的地图投票；召唤时启用非战斗 AI 时可处理奖励、事件与商店。
• AI Host 面板 — Dev Mode → AI Host 显示当前同伴数量与单人同伴模式提示。
• Dev Mode 轨道展开 — Mod 面板 → KitLib → 常规：轨道展开方式 — 悬停标签展开（默认）悬停左侧小标签展开轨道；侧边悬停展开悬停屏幕左缘展开且隐藏小标签。
• 地图预测 — Dev Mode → 作弊 → 游戏：地图预测（默认关闭）。开启作弊模式后，悬停未访问的地图节点可预览房间类型、遭遇战与事件；? 节点按与游戏相同的随机规则推算。
• 开发者控制台（浏览器） — 统一开发面板 http://127.0.0.1:9878，含 日志 与 战斗 两个标签：实时日志流、与局内日志查看器筛选同步、战斗事件时间线（每回合状态、搜索、类型筛选）及 JSON 导出。支持中英文。
• 局内日志 → 开发者面板 — 日志查看器新增 开发者面板 按钮；开启「与游戏同步」时筛选规则与浏览器面板保持一致。
• 原版错误弹窗 — 带「反馈 Bug」的弹窗在「反馈 Bug」下方新增 日志导出 (KitLib) 按钮，可一键导出诊断 ZIP。
• KitLib 快捷键 — 支持绑定组合键（如 Ctrl+Shift+M）。

Changed ​

• 仅 Steam beta — KitLib 发布包与 Steam 创意工坊上传现仅面向 public-beta 游戏分支（当前 0.109.x）。不再提供 stable/正式版 Steam 分支的独立构建；安装或更新前请确认游戏分支一致。
• Dev Mode 轨道（默认） — 左侧轨道默认改为悬停小标签展开；可在 Mod 面板 → KitLib → 常规切换为侧边悬停展开。
• 地图悬停预览 — 不再在开启作弊模式时自动显示；请在 作弊 → 游戏 中开启 地图预测。已走过的节点仍使用原版提示。
• 卡牌测试房间 — 训练假人战斗改为 KitLib 专用遭遇。卡牌测试误改了官方「战痕累累的训练假人」，这次改动一并修正，对造成困扰表示抱歉。
• 自启动开发者控制台 — KitLib 设置由原 kitlog 终端选项更名；单一开关在启动时打开浏览器开发面板（默认关闭）。
• 日志导出 ZIP — 移除 report.txt 与标题/复现步骤表单；导出始终包含 Harmony 补丁、战斗统计，以及 ZIP 根目录的完整游戏日志。
• 日志导出界面 — 并入日志查看器；点击 日志导出 滑出扩展面板（与卡牌浏览器相同模式）。移除独立 Dev 侧栏项与主菜单入口。
• 命令手册 — 命令按「官方」与各 mod 分区显示；官方命令说明支持中英文本地化。

Removed ​

• kitlog CLI — 已从仓库、构建/发布流程、GitHub/Nexus 发行包及 make deploy-tools 中移除。日常与双开调试请使用浏览器开发者控制台（http://127.0.0.1:9878/#/logs）或 tail %AppData%\SlayTheSpire2\logs\godot.log。
• 按进程 session.log — KitLib 不再镜像日志到 mod_data/KitLib/instances/{pid}/session.log。所有场景使用官方 user://logs/godot.log。
• mod_data/KitLib/instances/ — 已移除 lock 文件、按 PID 的筛选 JSON 与子目录。双开检测改为统计运行中的 STS2 进程。可选 perf-trace.log 现位于 mod_data/KitLib/ 根目录。启动时会自动删除旧的 instances/ 目录（临时迁移，后续版本移除该逻辑）。
• 战斗统计自动打开 — 移除「战斗开始时在浏览器打开战斗统计」独立选项；请改用 自启动开发者控制台。
• 战斗贡献分 — 移除加权战斗贡献分、右上角联机分数浮层及相关设置。
• 战斗统计 Dev 面板 — 移除游戏内 战斗统计 侧栏项与启动器面板。
• 战斗统计多视图 — 移除概览、按卡牌、承伤、按回合图表、扩展统计与整局累计；时间线在浏览器查看器中展示。
• 战斗统计右侧轨 — 移除局内右侧事件浮层。
• 战斗统计查看器「当前 / 上一场」 — 移除快照来源切换；查看器仅展示当前战斗。
• 开发控制台 — 已移除 KitLib dm* 命令（作弊、存档、统计、敌人、卡牌、遗物等）。请改用 DevMode 面板。
• Mod 变体包 — 移除 KitLib.ModVariantLoader 与 lib/<ModId>_<version>/ 多 DLL 布局。内容 mod 请针对当前 beta 游戏线发布单一构建。

Fixed ​

• Steam beta 上的 KitLib（0.109+） — 修复安装可选卫星模块（如作弊）或注册自定义卡牌/遗物的内容 mod 时，游戏启动报错的问题。
• 官方「战痕累累的训练假人」事件 — 安装 KitLib 后，第 3 档不再错误显示 999999999 生命值，也不会再套用卡牌测试用的无限血假人行为。
• 局内日志查看器 — 修复面板卡在旧行、或只显示引擎 backtrace 而看不到最新日志的问题。
• 局内日志查看器 — Godot 手柄输入映射报错及其 backtrace 块默认折叠，避免刷屏遮挡 mod 与 KitLib 日志。
• Dev Mode 侧栏 / 设置 — 修复主面板与侧栏标签中英文混显。
• 敌人浏览器 — 地图 — 普通局开启作弊模式后也可编辑地图遭遇战，不再仅限开发者测试运行。
• Dev Mode 轨道（悬停标签展开） — 修复悬停小标签时轨道反复展开与收起的问题。
• 地图预测 — 已预测为商店、宝箱或休息点的 ? 节点，不再在正确的房间类型标题下显示「无法预测」。
• Dev Mode 侧栏（异常后） — 过渡动画中途发生游戏错误（如房间加载失败）后，左侧轨道不再出现能悬停展开但图标点不动的情况。
• Dev Mode 面板（原版弹窗） — 原版全屏对话框弹出时（如存档损坏无法加载），侧栏滑出的面板内容可再次正常点击；此前只有侧栏能响应。
• KitLib 快捷键 — 修复快捷键绑定问题。

[0.27.0] - 2026-07-13 ​

Added ​

• Mod 面板 — 对局进行中可从 暂停 → 设置 → 常规 → 模组 (KitLib) 打开。
• Mod 面板 — Ctrl+Shift+M 可在主菜单或局内打开/关闭面板；可在 KitLib 快捷键 中改绑。
• Dev Mode 侧栏 — 为每个面板提供默认快捷键，可直接打开（例如 Ctrl+Shift+C 打开卡牌）；可在 KitLib 快捷键 → 打开面板 中改绑。

Changed ​

• 卡牌浏览器 — 筛选控件改为三行布局；移除 mod 来源筛选，库标签文案更短。
• 卡牌浏览器 — 优化卡牌浏览器滚动性能。
• 卡牌浏览器 — 性能耗时日志改为在 KitLib Performance 中可选开启（默认关闭）。
• Dev Mode 面板快捷键 — 再次按下同一快捷键可关闭已打开的面板；若侧栏仅因该快捷键而展开，关闭面板后侧栏会一并收起。

Fixed ​

• 卡牌浏览器 — 修复悬停时卡牌描述不显示的问题。

[0.26.0] - 2026-07-11 ​

Added ​

• Mod 面板 — 可在详情横幅中为每个 mod 编辑自定义显示名称。
• Mod 面板 — 选中 mod 的详情横幅中可查看 Harmony 补丁摘要与详情。

Changed ​

• Mod 面板 — 打开时默认选中 KitLib（若已加载）；版本、来源、安装大小以标签形式显示在详情横幅；点击来源标签可在文件管理器中打开安装目录。
• KitLib 模块设置 — 改为逐项开关可选模块。

Removed ​

• KitLib 模块设置 — 加载方案（精简 / 标准 / 完整）。
• Dev Mode — SpireScratch 脚本与一击必杀作弊。

Fixed ​

• 日志查看器 — 打开时自动滚动到最新日志。
• Mod 面板 — RitsuLib mod 设置 — 修复已通过 RitsuLib 注册设置页的 mod 在 Mod 面板中无法显示完整设置页的问题。

[0.25.1] - 2026-07-09 ​

Fixed ​

• ModVariantLoader — 解析 KitLib 依赖时优先使用游戏已加载的 KitLib 安装路径（Steam 创意工坊或本地 mods/KitLib/），不再仅依赖硬编码的兄弟目录。

[0.25.0] - 2026-07-09 ​

Added ​

• KitLib 模块设置（主菜单 Mods → KitLib → Modules）— 可选择加载方案（精简 / 标准 / 完整）并开关可选模块；每项显示模块 ID、功能说明、依赖关系与当前状态。
• Mod 面板侧栏 — 每个 mod 显示安装来源（Steam 创意工坊或本地）与安装目录路径。

Changed ​

• Dev Mode 主菜单 — 布局更扁平：伪联机相关选项提到顶层；已移除 LAN 调试子菜单。
• 联机作弊 opt-in — 从 Dev Mode 设置移至 Mods 面板中的 KitLib 设置。

Fixed ​

• 开发工具包 — 在模块设置中关闭可选 KitLib 模块（Cheat、AI、Dev）后，只要 modules/ 内文件齐全，开发工具包仍可正常加载。
• 离开开发局或伪联机局 — 修复退出时因战斗回放序列化导致卡住、无法回到主菜单的问题。
• 伪联机诊断 — 跟踪日志仅在伪联机会话进行中输出。

[0.24.1] - 2026-07-08 ​

Added ​

• RegisterCharacterProfile — 内容 mod 可通过 CompanionBridge 仅注册角色 AI 配置（例如非战斗自动出牌），无需引用 KitLib.AI.dll 或提供自定义决策策略；在 AI 模块已加载时，KitLib 会使用内置默认策略。

Changed ​

• Mod 安装布局 — KitLib 以薄入口 KitLib.dll + 根目录 KitLib.Core.dll 发布，卫星模块在 modules/（不再从 lib/ 按版本挑选 DLL）。若本地仍是旧目录结构，请从 Steam 创意工坊或 Nexus 重新订阅/下载。
• Steam 创意工坊 — 同一创意工坊条目可分别发布稳定版游戏分支（public）与 beta 分支（public-beta）的构建；订阅一次后，游戏会按你所在分支提供对应版本。

[0.24.0] - 2026-07-04 ​

Added ​

• ModVariantLoader NuGet 包：内容 mod 可在同一 mod 目录下同时发行 stable 与 beta 实现 DLL。
• ComposeModVariantBundle MSBuild 目标与 CLI：生成带 SHA256 校验的变体 manifest。
• 扁平变体布局 lib/<ModId>_<固定游戏版本>.dll，manifest 为 schema 2。

[0.23.1] - 2026-07-03 ​

Changed ​

• AI 托管、主机代打队友、SyncBot、幻影玩家与客机 AFK 开关改为仅本局有效：一局结束后自动关闭，不再写入 settings.json，避免下次单人或联机时莫名自动代打。
• KitLib 用户数据仅从 mod_data/KitLib/ 读取；不再在首次启动时自动搬迁旧版 mod_data/DevMode 目录 — 若仍有旧设置或快照，请手动复制或重命名。

[0.23.0] - 2026-07-01 ​

Added ​

• 卡牌测试：队列 mod 卡牌可在训练假人房间自动测试基础版与升级版。
• 卡牌测试：篝火处对队列卡牌敲牌预览升级，不打出卡牌。

Changed ​

• 开发作弊「数值锁定」改为「数值修改」。
• 数值修改：改数字立即生效，无需先勾选锁定。
• 日志：单开不再写入 session.log；日志查看器与反馈导出使用官方 godot.log，启动时会清空旧的双开日志目录。仅双开运行期间为每个窗口实时生成 session.log。

Fixed ​

• 修复联机战斗统计浮层贡献条不显示的问题。
• 修复联机战斗统计浮层不随战斗更新的问题。
• 修复联机战斗统计浮层无法拖动的问题。
• 修复卡牌浏览器在牌堆页升级或移除后详情不刷新的问题。
• 修复开发作弊面板战斗中添加能力不生效的问题。
• 修复开发模式存档界面输入的名称无法保存的问题。

[0.22.2] - 2026-06-28 ​

Fixed ​

• 联机 — 开启开发作弊同步后，主持或加入普通 Steam 联机对局不再在开局时黑屏卡死。
• 快速存读 — 在篝火、商店、宝箱或地图界面 Quick Save 后再读档不再因 ArgumentOutOfRangeException 崩溃；快照 PreFinishedRoom 与官方 Continue 一致，旧快照中非法房间类型在读档时自动忽略。
• 击杀全部敌人（作弊） — 开发作弊面板中开启后再次正常生效。
• 锁定金币（作弊） — 在开发作弊面板锁定金币后，消费或获得金币不再改变总数。
• 锁定当前生命（作弊） — 战斗中当前生命保持在锁定值。
• 锁定最大生命（作弊） — 最大生命保持在锁定值。
• 锁定当前能量（作弊） — 打出卡牌后能量保持在锁定值。
• 锁定最大能量（作弊） — 能量上限保持在锁定值。
• 锁定星辉（作弊） — 战斗中星辉保持在锁定值。

[0.22.1] - 2026-06-19 ​

Removed ​

• 游戏内 Manual 轨道 — 移除内嵌 manual/ 帮助与 Manual 工具标签；请使用 文档站 或仓库 README。

[0.22.0] - 2026-06-19 ​

Changed ​

• STS2 v0.107.1 — KitLib 需要当前游戏版本（v0.107.1），不再支持更旧版本（含 0.103.3）。

Fixed ​

• Mod 反馈 — 日志下拉列表现可看到其他游戏实例的 session 日志（instances/<pid>/session.log），不仅限当前窗口。
• 联机 — 在当前游戏版本下加载 KitLib 不再导致无法正常加入或主持联机。

Removed ​

• 自动崩溃反馈提示 — KitLib 不再检测未捕获异常或异常退出并弹出反馈对话框。请通过 开发者模式 → 诊断 → Mod 反馈（或局内 dev 侧栏）手动导出报告。
• kitlib.compat.toml sidecar — KitLib 不再读取 compat sidecar，也不在 Mod 设置或主菜单显示版本/依赖警告。请在游戏官方 mod 清单（min_game_version、dependencies）中声明依赖。

[0.21.0] - 2026-06-13 ​

Added ​

• 对局内快捷键面板 — 对局中可在开发侧栏通过紧凑滑出面板打开 设置 → 键盘快捷键，不必退回主菜单 Mod 设置。

Changed ​

• 内容浏览器布局 — 卡牌、遗物、药水、能力、敌人等选择器改为双栏 overlay（列表 + 详情）；面板宽度随视口变化。

Removed ​

• 对局内右侧上下文侧栏 — 战斗统计、敌人意图等不再在开发侧栏旁单独占一列；请使用对应侧栏 Tab 或浏览器 overlay。
• 开发侧栏宽度记忆 — 双栏浏览器宽度按当前视口计算，不再读写持久化的像素宽度。

Fixed ​

• Mod 来源筛选（浏览器） — 卡牌、遗物、药水等内容浏览器中，Mod 来源 下拉 chip 与标签垂直对齐。
• 崩溃恢复提示 — 从主菜单正常退出不再残留会话标记，避免每次启动都弹出「上次会话可能异常退出」。
• 能力浏览器 — 扩展列不再宽于面板；能力详情行图标布局更简洁。
• 药水浏览器 — 双栏布局下列表区更宽、更易浏览。
• 战斗统计图表 — 开发侧栏滑入时，饼图与每回合伤害图保持可见。
• 敌人浏览器 — 地图与敌人详情分列显示；地图连线正确渲染。
• 开发性能浮层 — 在设置中开启后，启动时更可靠地显示。
• 键盘快捷键 — 重绑与默认键再次与游戏输入系统正确配合。

[0.20.0] - 2026-06-11 ​

Added ​

• KitLib 模块化拆分 — 游戏内仍是一个 mod：轻量 Core 宿主（KitLib.dll）+ modules/ 下可选卫星 DLL（KitLib.User、KitLib.ModPanel、KitLib.Panel、KitLib.AI、KitLib.Cheat、KitLib.Dev）。卫星经 KitLibHost 注册侧栏 Tab 与功能；共享运行时在 KitLib.Features。删除卫星 DLL（或选择加载档位）即可关闭对应功能而无需卸载 KitLib。发布含 KitLib-Full 与各模块独立 zip。NuGet STS2.KitLib.Abstractions 为内容 mod 编译期契约。
• 主菜单 Mod 设置面板 — 游戏 mod 列表中的 KitLib 原生设置（RitsuLib 桥接）：无需进入对局开发侧栏即可浏览与配置 KitLib。
• Mod Panel 侧栏 — 在侧栏中开关已加载 mod；每行显示版本徽章与 STS2 风格焦点光标。
• 卫星模块加载档位 — 在 Mod 设置中选择 Minimal / Standard / Full / Custom 等 bundled 模块组合。
• Mod 设置：快捷键 — 独立页面重绑开发侧栏快捷键（展开/收起、切换 Tab、快速存读、战斗检查点等）。
• Mod 设置：强调色 — 可选橙色 KitLib UI 强调色。
• Mod 兼容性（kitlib.compat.toml） — 设置页展示各 mod 兼容清单中的依赖与版本警告。
• 内容 mod 日志（KitLibLog / ModLog） — 其他 mod 经 KitLib 输出日志，在游戏内日志查看器显示正确 mod 来源与颜色；mod 设置页可复用日志级别行组件。
• KitLog CLI — 可选 kitlog 工具（tools zip）：tail 读 session.log，attach 接结构化命名管道，--sync-viewer 同步游戏内筛选，可选 KitLib 加载时在 Windows Terminal 自动打开。
• STS2 稳定版/beta 双构建 — KitLib 分别针对稳定版与 beta 构建；自动检测 Steam 安装对应配置，版本不匹配时启动显示提示横幅。
• 开发性能浮层 — 可选 HUD（开发侧栏）显示预加载与存档序列化耗时探针。
• AI Host 与 StrongStrategy — Mod AI 平台：开发侧栏 AI Host 面板、外部伴侣终端 API，以及基于 Codex 先验的 StrongStrategy 单机自动出牌。
• 战斗模拟与 beam 规划器 — 对局内 AI 模拟牌组 EV、多回合线路、遗物/能力钩子、搜索内药水、小怪 engagement 与敌人机制发现。
• AI HUD 浮层 — 对局左上角 overlay：大小牌组预测、胜率估计与实时模拟遥测（取代旧版启发式 HUD）。
• 奖励、地图与休息点 AI — 卡牌奖励按边际牌组/模拟价值评分（含下场战斗 beam 预览）；地图选路权衡路径风险；牌组需升级时休息点优先营火；耗竭/升级选手牌按评分选择。
• 先古事件调试（开发工具） — 在 事件 或 房间传送 → 先古之民 中，从扩展面板选择任意先古，随机进入或置顶某一选项（达弗、欧洛巴斯与 mod 先古共用同一套列表）；dmevent force <eventId> [choice]。
• MCP Nexus 上传 — 通过 MCP 工具链发布 mod 包到 Nexus（见 README MCP）。

Changed ​

• 破坏性：单体 → 模块 — 原 DevMode 单 DLL 拆为 Core + 卫星。请安装 KitLib-Full（推荐）或 Core + KitLib.Features + 所需卫星 zip。make sync 仅部署 Core；make sync-full 部署完整本地 bundle。已有安装迁移为 Full（全部卫星开启）；新安装默认 Standard（Panel 开；AI/Cheat/Dev 关）。
• 更名为 KitLib — mod id、程序集、C# 根命名空间、用户数据路径（mod_data/KitLib）及 NuGet 包 id（STS2.KitLib）取代 DevMode。首次启动会自动迁移旧版 mod_data/DevMode 设置。依赖本 mod 的其他 mod 请改为引用 KitLib.dll 与 KitLib.* 命名空间（如 KitLib.Companion.CompanionBridge）。
• 内容 mod 对接 — 随 mod 发布 kitlib.compat.toml sidecar，在 Mod 设置中做版本/依赖检查；编译期引用 STS2.KitLib.Abstractions，运行时需要 KitLib.dll（及所依赖的卫星 DLL）。
• Mod Panel 导航 — 分页标签改为 LB/RB 肩键轮播；显示手柄提示与可聚焦侧栏行；经官方子菜单栈打开以保证手柄导航可靠。
• 进度保护 — 设置、备份列表、恢复流程与启动时进度丢失提示均移至 Mod Panel（取代旧版 DEVMODE 主菜单入口）。
• 日志格式与查看器 — KitLib 内部日志为 [KitLib][scope]，session 日志不再重复 [KitLib]；游戏内查看器与 kitlog 中次级 scope 标签比主 mod 标签更暗。
• 战斗统计侧栏 — 上下文面板分数条按条高显示可读刻度。
• 战斗 AI 行为 — 优先挡牌线路、模拟驱动集火与易伤铺垫、beam 搜索内药水评分、虚弱减伤建模、跳过动画下出牌不卡死、有牌可出时不提前结束回合、AI 战斗后可正常存读、奖励界面跳过循环已处理。

Fixed ​

• 安装包 — 模块化打包拆分后，发布 zip 再次包含所需的 PCK 文件。
• STS2 稳定版 + Dev Mode — 稳定版游戏分支上打开开发工具不再在主菜单崩溃或重复应用 Harmony。

[0.13.0] - 2026-06-02 ​

Added ​

• 开发侧栏快捷键 — 可用键盘展开/收起侧栏、关闭当前面板、切换 Tab 或锁定侧栏。可在 设置 → 键盘快捷键 中重绑（与游戏快捷键冲突时会被拒绝）。
• 快速存读 — 对局中 F5 快速存档、F9 快速读档（slot 0）；可在 设置 → 键盘快捷键 中重绑。存档/读档 面板顶部有独立的 快速存档 行。
• 本场战斗多节点存档 — 战斗中自动在战斗开始、每个玩家回合开始时写入检查点（含 .combat.bin 侧车快照，战斗内原地恢复 HP/牌堆等，无需整局 LoadRun）。F8 重打本局，F6 重回本回合（可在 设置 → 键盘快捷键 中重绑）。存档/读档 面板单独列出 本场战斗 节点，与快速存档分开。
• MCP 桥接 — 在端口 9877 将 MCP 客户端（Cursor、Claude Desktop 等）连接到运行中的游戏，用于自动化测试与 Agent 工作流：游戏状态、战斗/地图操作、存档槽、卡牌、怪物与作弊等。详见 README MCP；可用 make dev-session 一键部署、启动并等待桥接就绪。
• MCP 战斗可观测性 — 战斗中 MCP get_game_state 会列出玩家当前能力（层数与 mod 能力 ID）、战斗阶段与带索引的敌人。通过 MCP 出牌会返回出牌后快照，便于断言 mod 效果，无需仅从 HP 间接推断。

Fixed ​

• 崩溃恢复提示 — 导出反馈 ZIP 或点「暂不」后会清除待处理记录，主菜单不再每次启动都重复弹出；正常退出游戏时也更可靠地清除会话标记。
• STS2 Steam beta — 在 beta 游戏分支上可再次正确加载 mod 依赖信息。

[0.12.0] - 2026-06-02 ​

Added ​

• 进度保护 — mod 集指纹变化时，在 vanilla 存档过滤写盘前，将当前 profile 的 progress.save（及可选相关存档）备份到 mod_data/KitLib/profile_backups/；可选在 progress 仍含已卸载 mod 数据时仅写日志警告。可在 设置 → 进度保护 或标题画面 DEVMODE → 进度保护 面板中开关、查看状态与最近备份，并一键恢复 progress。每条备份可点 详情 查看账号进度、各角色统计、epochs、图鉴数量及备份元数据。
• 崩溃恢复提示 — 游戏内发生未捕获异常时，DevMode 弹出对话框，可查看日志或导出预填崩溃摘要的反馈 ZIP；若游戏异常退出，下次进入主菜单时同样提示。可在 设置 → 崩溃恢复 中开关。会话标记位于 mod_data/KitLib/instances/{pid}/。
• 启动时 mod 角色进度丢失提示 — 进入主菜单时，若检测到 mod 角色统计被过滤且存在可恢复备份，弹出 恢复 / 暂不恢复 对话框（可在 进度保护 设置中关闭）。
• 内容浏览器（Mod 来源） — 卡牌、遗物、药水、能力、事件选择器新增 Mod 来源 筛选，可按游戏本体或已加载 mod 包含/排除；详情区显示 来源：。卡牌浏览器会记住 Mod 来源筛选设置。

Changed ​

• DEVMODE 主菜单 — 日志 与 Mod 反馈 合并为 诊断 子菜单；新增 进度保护 主菜单入口。
• AI Host（开发侧栏） — 图标改为机器人，不再与 Scripts 共用拼图图标。

Fixed ​

• DEVMODE 主菜单 — 在 Mod 反馈与读档后再次进入标题画面 DEVMODE 子菜单时，不再出现原版主菜单按钮与开发项叠在一起；退出时会一并清理浮层。（感谢 @Crimson707707 反馈）
• 添加敌人到战斗 — 遭遇战/怪物列表可在面板内正常滚动到底；切换到 单体怪物 时不再出现大片空白滚动区域。
• 敌人意图浮层 — 战斗中开启意图浮层后存档退出或离开战斗，不再崩溃或黑屏；战斗结束时浮层会正常隐藏。（感谢 @Crimson707707 反馈）

[0.11.2] - 2026-06-01 ​

Fixed ​

• 安装包 — 官方 release zip 与 NuGet 包重新包含所需的 PCK 文件，Mod 加载器不再报 PCK 缺失，游戏内 Mod 列表可正常显示预览图。

[0.11.1] - 2026-05-27 ​

Fixed ​

• 战斗中加怪 — 首次添加某种敌人时不再长时间卡住。
• 战斗中加遭遇（联机） — 主机同步添加整组遭遇时，各客户端能正确收到全部怪物。
• 战斗奖励 — 打开 Dev 侧栏时不再导致战斗结束奖励界面消失。
• 地图调试跳转 — 修复地图点击无反应；跳转到先古房间时正确进入先古遭遇（不再误进普通事件）；「全图可点」仅在地图界面打开时生效，关闭地图后恢复原版路线规则。

[0.11.0] - 2026-05-25 ​

Added ​

• LAN 主机托管 + AFK 双开测试 — 同一台电脑开两个游戏实例：主机手打，AFK 客户端由 AI 代操作；含结束回合与敌人回合 Ready 同步、盟友目标卡牌支持，以及战斗中关闭主机 AI 时的状态清理。
• DEVMODE 主菜单 — 标题画面合并为单个 DEVMODE 入口；日志、Mod 反馈 与 联机（伪联机、LAN 测试场景）均在该子菜单内。

Changed ​

• 对局右侧栏 默认 关闭 — 在 设置 → 游戏 中开启 对局右侧栏 后，才会显示战斗右侧轨（统计、敌人意图预览、战斗工具等）。
• 敌人意图悬浮面板 默认 关闭 — 需要时在 Enemy intents 面板中开启可拖动的意图预判浮层。
• 已从 DEVMODE 主菜单移除无法使用的 卡牌图鉴 与 遗物图鉴 入口。
• 设置 — 游戏相关选项（对局右侧栏、速度、跳过动画）移到侧边栏布局区块上方；显示隐藏卡牌 不再出现在设置中（卡牌浏览器内仍可开关）。

Fixed ​

• 日志查看器 — 通过标题栏关闭后再次打开时，在绕过轨道标签状态的情况下也能正常恢复。
• STS2 Steam beta — 在 beta 游戏分支上的额外 API 兼容性修复。

[0.10.0] - 2026-05-24 ​

Added ​

• 主菜单 DevMod 快捷入口 — 标题画面可直接打开 日志 (DevMod) 与 Mod 反馈 (DevMod)（无需进 run）；开发模式 (DevMod) 子菜单中新增 解锁全部进度（二次确认），可解锁存档中的时间线节点、进阶 A10 与图鉴内容。
• 游戏内手册 — Manual 轨道面板内嵌各开发工具说明（替代原先独立的 Valaxy 文档站）。
• 卡牌浏览器 — 可选 显示隐藏卡牌 并更安全地预览事件专用卡；Mod 角色卡池改为下拉选择；筛选 chip 右键排除；卡池筛选分行更清晰。
• 卡牌附魔选择器 — 编辑卡牌附魔时可展开卡牌网格挑选。
• 日志 — 查看器可从磁盘游戏日志载入更早记录；Mod 与游戏来源配色更易区分；轨道有新 Warn/Error 时会提醒；peek 标签在首次悬停前会闪烁提示。
• 敌人意图工具 — 战斗中可拖动的意图预测浮层；Enemy intents 开发面板标签与下回合预览侧栏；在敌人浏览器中按回合编辑意图。
• 战斗 Context Pane 上多条意图徽章会纵向堆叠显示。
• Rooms 面板 — 侧滑子菜单可传送到远古商店节点。
• AI Host 面板 — 开发轨道托管 AI 战斗；SyncBot 在单人开发时模拟联机 ACK。
• 伪联机（主机） — 开发者模式主菜单一键建房：可选幻影玩家、地图投票镜像与战斗 AI 队友。
• 联机作弊同步 — 主机开启联机作弊 opt-in 后：作弊项、卡牌/遗物/药水修改、战斗敌人工具、能力与按玩家标志可在客户端同步。
• 战斗敌人 Context Pane — 战斗中，游戏右侧 Context Pane 显示紧凑图标：添加遭遇/怪物、逐个击杀或击杀全部；搜索与选择在 overlay 中完成。
• 战斗统计面板 — 基于游戏 CombatHistory 的实时单场战斗数据（输出/承伤/格挡/出牌，按卡牌/来源/回合分组）。扩展统计（溢出/格挡、能量、药水、Debuff、能力伤害、事件时间线）、整局累计、当前 vs 上一场对比、JSON 导出与 dmstats 控制台命令。HUD、联机细化等待办见 TODO.md。
• 战斗统计游戏右侧轨 — 战斗进行中，游戏画面右侧会出现窄条实时贡献柱或紧凑分数分解，无需打开完整统计面板即可随战斗更新；统计浏览器拉至接近全宽时可与右侧轨视觉合并。
• 战斗统计饼图分解 — 统计面板右侧栏提供分类饼图（总览、卡牌、进攻、辅助、承伤）与彩色图例；默认分类会随当前视图标签切换。
• 支持 STS2 Steam beta — DevMode 可在《杀戮尖塔 2》Steam beta 分支上使用，含施加能力、战斗中添加卡牌、敌人/战斗相关作弊与开发工具。请在 beta 游戏安装上使用 beta 版 mod 包，勿与正式版/公开版混用。
• 可自定义开发侧栏 — 在 设置 → 侧边栏 中拖动调整轨道面板顺序，取消勾选即可隐藏不需要的入口；布局会跨会话保存。Harmony 分析、脚本、框架 默认隐藏，需要时在设置中重新勾选显示。
• 联机战斗统计浮层 — 多人战斗中，画面右上角会出现可拖动的实时贡献面板（横向条长度按最高分缩放，悬停可看分项）；单人仍使用游戏右侧轨的竖条。

Changed ​

• 敌人面板地图中心化 — 合并全局、按类型与地图三个标签为单一地图编辑器：左侧为 run 地图与悬停预览；右侧为本局规则（全部战斗 / 普通 / 精英 / Boss，仅本局生效）、选中节点编辑与内嵌遭遇选择器。战斗中的击杀/添加敌人操作在右侧 Context Pane 窄轨中，不再占用敌人浏览器顶部 chip。
• RitsuLib 现为可选依赖。 DevMode 不再将 RitsuLib 列为必需依赖 mod，未安装时也能正常加载运行；框架桥接面板在 RitsuLib 缺失时显示「—」，而不会导致 DevMode 无法加载。
• 普通对局 Dev Mode 偏好 — 开发者模式主菜单中的 普通对局 循环（关闭 / Dev Mode / 作弊模式）默认 Dev Mode，并会写入设置供下次启动沿用。
• 打开开发浏览器面板时，联机战斗统计浮层不再被挡住，会保持在面板上方可见。

Fixed ​

• 敌人地图悬停预览 — 节点悬停 tooltip 重新正确显示在地图面板内（修复因 TopLevel 层级导致的不可见问题）。
• 设置、存档槽、预设与脚本现存储在游戏用户数据目录（SlayTheSpire2/steam/<id>/mod_data/KitLib/）而非 mod 文件夹内 — Steam Workshop 更新 mod 后数据不再丢失。
• 设置与存档槽文件改为原子写入，游戏崩溃时不会产生损坏的文件。
• 在 正式版/公开版 STS2 上再次可用：施加能力、战斗中添加卡牌、加载预设等开发工具（不仅限于 Steam beta）。
• 战斗统计面板拉至接近全宽并与游戏右侧轨合并时，饼图侧栏布局不再错乱。
• 战斗统计 Timeline 标签页的事件文本区不再出现刺眼的白色焦点框。

[0.6.0] - 2026-05-17 ​

Added ​

• Mod 反馈面板 — 填写问题说明并导出 ZIP 报告包，可发给任意 Mod 作者：降噪后的游戏内日志、已加载 Mod 列表、Harmony 补丁转储与框架桥接快照。可从 logs 目录附加游戏日志（默认当前会话的 godot.log，取末尾 512 KB）。隐私模式（默认开启）会将用户数据路径替换为 <user-data>。
• Harmony 分析 — 按 owner id 排除补丁（支持通配符；默认排除 DevMode 与 RitsuLib），智能报告排版更清晰，大型转储浏览更顺畅（类型列表与详情分栏、刷新时更少卡顿）。
• 游戏内日志查看器 — 新增默认噪音规则，隐藏窗口失焦/聚焦时的常规 FPS 限帧 INFO 日志。
• 游戏内模组列表现已显示 DevMode 的预览图。
• 卡牌浏览器（全卡库）：在添加前可设置基础能量费用，该数值作用于你获得的那张新实例，而非图鉴条目本身。
• 卡牌浏览器会记住类型/稀有度/费用/卡池筛选、排序、搜索文案以及查看升级开关（跨会话）。
• 在全卡库开启查看升级时，升级预览展示更清晰、对齐更好。
• 从开发房间进入地图后，当前地图界面上更多节点可点选移动（原本灰掉的路线会放开），便于测试时快速跳转。
• 独立 作弊 侧栏标签 — 在作弊模式开启时，玩家/敌人/奖励/地图/数值锁定等玩法修改项集中在一个面板。

Changed ​

• 设置 现仅包含外观与工作流（游戏速度、跳过动画）；玩法作弊项已移至 作弊 标签，不再混在设置里。
• 作弊 面板更宽，并按宽度自动排成 一列、两列或三列，列间距加大，选项更易浏览。
• 开发面板侧栏悬停提示仅显示标签名称（不再附带 Dev/Cheat 后缀）。
• 卡牌浏览器的卡池筛选默认跟随当前角色，不再默认全卡池。
• 浏览器内卡牌的数字与文本编辑在修改时或离开输入框时即时生效，无需单独确认步骤。
• 开发模式存档快照读/写全屏界面（主菜单与开发面板入口）现与 DevMode 外观主题一致：遮罩、面板、分隔线、按钮、名称输入与统计徽章会随 Dark / OLED / Light / Warm 切换。
• 局内 Save / Load 的存档列表改为在菜单旁侧滑展开的浏览器列中打开（与其他开发面板一致的侧栏风格），不再单独弹出全屏对话框。
• 主菜单 Load Save 全屏读档界面在大分辨率下会随窗口变高（高度随显示区域缩放）。

Removed ​

• 第三方面板注册接口：DevPanelModApi、RegisterPanelWhenReady 及相关延迟注册队列已全部移除，DevMode 不再支持外部模组注册自定义侧栏面板。

Fixed ​

• 作弊 面板新增条目在中文环境下会正确显示中文，不再退回英文占位文案。
• 无限能量 作弊合并为一项：开启后每帧保持满能量，不再与多余的「运行时」条目重复。
• 游戏模组列表中 DevMode 现以正确的显示名称出现在清单里。
• 开发模式读/写存档列表：再次点击同一存档槽时，右侧详情区不再闪一下。
• 局内读/写存档列表不再只占扩展列顶部一条窄带，现已铺满该列可用高度。
• 描述文本含动态占位符的卡牌，在开发模式卡牌界面或预设流程中不再触发格式化错误。
• 对已拥有卡牌（牌组或战斗牌堆中）的能量费用修改更稳定；全卡库列表上的费用不可直接改写，会在添加卡牌时按你设定的费用生效。

[0.5.0] - 2026-04-26 ​

Added ​

• 开发轨道的浏览器面板现支持拖拽调整宽度，并会按面板分别记住宽度（跨会话生效）。

Changed ​

• 浏览器面板的轨道过渡更顺滑：打开时从侧栏起点滑入，关闭时对应滑出。

Fixed ​

• 切换面板时，轨道边缘不再在过渡过程中闪回圆角。
• 面板动画结束后拖拽调整宽度，不再出现与侧栏分离的问题。

[0.4.2] - 2026-04-11 ​

Fixed ​

• 通过 DevMode 延后注册界面的其他模组，现会在全部模组加载完成后再挂载，避免面板不出现。
• 在地图上右键替换遭遇后，进入该战斗时不再崩溃（含按楼层覆盖等情况）。

[0.4.1] - 2026-04-10 ​

Added ​

• SpireScratch 可视化脚本 — 内置 Blockly 积木编辑器编写规则，导出为 JSON 存放于模组 scripts 目录，文件变更后自动重载；与钩子系统共用触发点、条件与动作模型。新增 脚本 面板可查看已加载脚本、单独启用/禁用、打开脚本目录或编辑器，并可将现有钩子规则迁移为脚本文件。
• SpireScratch 脚本现支持 WebSocket 实时热重载：编辑器保存后直接推送到运行中的游戏，脚本面板自动刷新，无需重启。
• 消耗牌堆 目标 — 卡牌浏览器的「添加目标」下拉菜单与导航标签页现已包含消耗牌堆（与手牌、抽牌堆、弃牌堆、牌组并列）。dmcard add 控制台命令同样支持 exhaust 参数。
• 卡牌浏览器「添加目标」默认值改为 手牌（原为牌组）。
• 角色 / 卡池筛选芯片 — 卡牌浏览器（全部卡牌标签页）新增一排筛选芯片：铁甲战士、静默猎手、故障机器人、储君、亡灵契约师、无色（角色组）以及先古之民、状态、诅咒、事件、任务、衍生牌（特殊组），可与现有的类型、稀有度、费用筛选自由组合；自动识别 Mod 新增角色并追加对应芯片。

Fixed ​

• 通过 DevMode 添加卡牌后，抽牌堆、弃牌堆（及消耗牌堆）的数量标签不再显示旧值：对绕过飞行动画 VFX 的静默添加路径手动触发 CardAddFinished 事件。同样修复了应用含战斗快照的预设时，这些牌堆数量不刷新的问题。
• 地图遭遇预览 现已对所有节点显示正确的怪物：当前战斗楼层直接读取正在运行的遭遇数据（不再从计数器推算），未来楼层使用地图 DAG 广度优先搜索路径走到目标节点时经过的同类型房间数来计算队列偏移量。已绕过的分支节点则显示「若此刻传送进入将遭遇」的怪物。
• 在地图节点上右键替换遭遇的功能现已对当前战斗位置禁用——战斗已经开始，无法在途中更换敌人。

[0.4.0] - 2026-04-08 ​

Added ​

• 钩子系统 — 新增「钩子」面板，支持定义「触发 → 条件 → 动作」自动化规则（例如每次战斗开始时施加某个能力、每回合开始时添加卡牌等）。
  • 触发点：战斗开始/结束、回合开始/结束、抽牌时、造成伤害时、受到伤害时、使用药水时。
  • 条件：HP 低于/高于百分比、楼层高于/低于、拥有/未拥有能力。
  • 动作：施加能力、添加卡牌、使用药水、保存存档。
  • 规则持久化，可单独启用/禁用。
• 自动施加快捷按钮 — 在能力、药水、卡牌浏览器中新增「添加到自动施加」按钮，一键创建战斗开始时执行的钩子规则。
• 可复制 ID — 所有浏览器详情面板（能力、药水、卡牌、遗物、敌人）现在在 ID 旁边显示「复制」按钮，方便快速复制到剪贴板。
• ID 选择弹窗 — 钩子规则编辑器的 ID 输入框旁新增「…」浏览按钮，可在搜索弹窗中直接从完整列表选取 ID，无需手动输入。
• 钩子规则编辑器中的触发点、动作类型、条件类型、目标类型均改为下拉菜单（OptionButton），不再需要反复点击切换。

[0.3.0] - 2026-04-08 ​

Added ​

• 对局内 存档/读档：指定种子重开，可将卡牌、遗物、金币（可选）带入新对局并指定新种子。
• 主菜单开发者模式：指定种子新建。
• 存档管理 改版：动态槽位、新建/删除槽位、更清晰的槽位列表与详情（含可滚动的卡牌、遗物、Mod 信息）。
• 存档详情展示 对局种子 与 已加载 Mod（名称与版本）。
• dmsave 控制台：新增 list、delete 子命令。

Changed ​

• 存档界面为统一槽位列表（不再单独突出快速存档行）；「指定种子重开」的卡牌/遗物携带默认 关闭。

[0.2.0] - 2026-04-08 ​

Added ​

• 动态主题系统，支持深色、浅色、OLED 和暖色四种颜色模式。
• 开发侧边栏新增房间传送面板。
• 卡牌浏览器新增编辑模式，支持预设。

Changed ​

• 能力面板重新设计为双栏浏览器布局。
• 药水浏览器重建为视觉网格样式。
• 预设管理器新增作用域保存/读取与战斗快照支持。
• 使用自绘 RelicBrowserUI 替代原生遗物选择界面。
• 卡牌浏览器顶部栏替换为自定义 CardBrowserUI，含轨道滑动指示器。
• 统一所有 DevMode 面板为轨道拼接浏览器-面板布局。

Fixed ​

• 修复能力面板中能力应用不生效的问题。
• 修复添加药水 API 不正常的问题。
• 修复 MDI 图标 tree-shaking 回退导致构建后图标丢失的问题。

[0.1.0] - 2026-04-07 ​

Added ​

• 侧边栏面板分类：玩家、物品栏、状态、敌人、游戏。
  • 玩家：无敌、无限护盾/能源/星辉、防御倍率。
  • 物品栏：编辑金币、金钱倍率、商店免费购买、编辑能量上限、编辑药水槽数量。
  • 状态：始终奖励药水、始终升级卡牌奖励、最大卡牌奖励稀有度、最高分数、分数倍率。
  • 敌人：冻结敌人、一击必杀、伤害倍增。
  • 游戏：未知节点→宝藏、游戏速度。
• 运行时状态修改器：上帝模式、击杀全部敌人、无限能量、始终玩家回合、抽牌至上限、每回合额外抽牌、友方怪物自动行动、清除负面效果。
• 数值锁定：锁定金币、当前/最大 HP、当前/最大能量、星辉、宝珠槽位。
• 地图改写：强制所有房间为宝箱/精英/Boss，可保留最终 Boss。
• 能力选择面板，支持 4 种目标模式（自身、全体敌人、指定、友方）。
• 药水选择面板和事件选择面板。
• 卡牌编辑器：编辑基础费用、重放次数、伤害、格挡、消耗、虚无、不可打出、附魔。
• 预设管理器：保存/加载/导出/导入配装预设。
• 控制台命令手册 UI，支持搜索、原生命令和 DevMode 命令分区。
• 新增 10 个控制台命令模块（卡牌、作弊、敌人、事件、游戏、药水、能力、遗物、运行时、存档）。
• 重新设计 DevPanel 为 Apple 风格图标栏，统一覆盖层系统与滑入动画。
• Iconify MDI 适配器，构建时 tree-shaking；所有文字图标替换为真实 MDI 图标。
• 侧边栏面板点击锁定切换。
• 新增常驻开启 DevMode 开关，支持普通（非开发）对局使用。
• 存档/读档面板新增测试按钮。
• 多人游戏兼容补丁（过滤 mod 签名、规范化 ModelDb 哈希）。
• 资源预热服务，支持帧预算纹理/场景预加载。
• 跨版本 API 兼容层（Sts2ApiCompat）。

Changed ​

• 移除 StartingGold 覆盖，改用游戏默认金币。

Fixed ​

• 修复无限护盾在失去后未正确恢复的问题。
• 修复药水槽移除及数值锁定值未实时更新的问题。
• 修复切换标签页时覆盖层叠加而非关闭的问题。
• 修复 changelog 读写编码导致中文乱码的问题。

[0.0.1] - 2026-04-06 ​

Added ​

• 主菜单新增开发者模式面板。
• 支持自定义遗物、卡牌、金币及遭遇战，便于测试。
• 敌人遭遇战系统，含统一选择界面、战斗怪物生成及待机动画预览。
• 国际化支持，提供英文与简体中文本地化。
• 集成 STS2AI 模组，支持 AI 控制面板、速度与动画控制。