v0.22.1

Removed

• In-game Manual rail panel — Embedded manual/ help and the Manual utility tab are removed. Use the docs site or repo README instead.

---

Removed

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

v0.22.0

Changed

• STS2 v0.107.1 — KitLib requires the current game build (v0.107.1). Older versions (including 0.103.3) are not supported.

Fixed

• Mod Feedback — The log file dropdown now lists session logs from other game instances (instances/<pid>/session.log), not only the current window.
• Multiplayer — KitLib no longer breaks joining or hosting on the current game version.

Removed

• Automatic crash feedback prompts — KitLib no longer detects unhandled errors or abnormal exits and opens a feedback dialog. Use Dev Mode → Diagnostics → Mod Feedback (or the in-run dev rail) to export a report manually.
• kitlib.compat.toml sidecar — KitLib no longer reads or shows version/dependency warnings from compat sidecars in Mod settings or on the main menu. Declare requirements in the game's official mod manifest (min_game_version, dependencies) instead.

---

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）中声明依赖。

v0.21.0

Added

• In-run hotkeys panel — Open Settings → Keyboard shortcuts from a compact slide-out on the dev rail during a run, not only from the main-menu mod settings.

Changed

• Content browser layout — Card, relic, potion, power, enemy, and other pickers use a dual-column overlay (list + details). Panel width follows your viewport instead of a saved pixel width.

Removed

• In-run right context sidebar — Combat stats, enemy intent, and related context no longer appear in a separate column beside the dev rail; use the matching dev-rail tab or browser overlay instead.
• Saved dev panel width — Dual-column browser width is derived from the viewport each session, not from a stored pixel value.

Fixed

• Mod source filter (browsers) — The Mod source dropdown chip lines up with its label in card, relic, potion, and other content browsers.
• Crash recovery prompt — Quitting normally from the main menu no longer leaves a stale session marker, so the «previous session may have crashed» dialog does not appear on every launch.
• Power browser — The extension column no longer grows wider than the panel; the power detail row uses a simpler icon layout.
• Potion browser — Wider usable list column in the dual-column layout.
• Combat stats charts — Pie and per-turn damage charts stay visible while the dev panel slides in.
• Enemy browser — Map and enemy details use separate columns; map connection lines render correctly.
• Dev perf overlay — Shows reliably after startup when enabled in settings.
• Keyboard shortcuts — Rebinding and default keys work correctly with the game's input system again.

---

Added

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

Changed

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

Removed

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

Fixed

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

v0.20.0

Added

• Modular KitLib split — One in-game mod with a thin Core host (KitLib.dll) and optional satellite DLLs under modules/ (KitLib.User, KitLib.ModPanel, KitLib.Panel, KitLib.AI, KitLib.Cheat, KitLib.Dev). Satellites register dev-rail tabs and features via KitLibHost; shared runtime lives in KitLib.Features. Remove a satellite DLL (or pick a load profile) to disable that feature without uninstalling KitLib. Releases ship KitLib-Full plus per-module zips. NuGet STS2.KitLib.Abstractions is the compile-time contract for content mods.
• Main-menu Mod settings panel — Native KitLib settings in the game's mod list (RitsuLib bridge): browse and configure KitLib without the in-run dev rail.
• Mod Panel sidebar — Enable or disable loaded mods from the sidebar; each row shows a version badge and STS2-style focus cursor.
• Satellite load profiles — Choose Minimal, Standard, Full, or Custom sets of bundled KitLib modules from Mod settings.
• Mod settings: hotkeys — Rebind dev sidebar shortcuts (open/close rail, switch tabs, quick save/load, combat checkpoints) on a dedicated settings page.
• Mod settings: accent theme — Optional orange accent for KitLib UI chrome.
• Mod compatibility (kitlib.compat.toml) — Settings surface dependency and version warnings from each mod's compat manifest.
• Content mod logging (KitLibLog / ModLog) — Other mods can log through KitLib so lines appear in the log viewer with correct mod source tags and colors; reusable log-level row for mod settings pages.
• KitLog CLI — Optional kitlog tool (tools zip): tail for session.log, attach for a structured named-pipe stream, --sync-viewer to mirror in-game filters, optional auto-open in Windows Terminal when KitLib loads.
• STS2 stable/beta dual build — KitLib ships stable- and beta-targeted builds; auto-detects your Steam install profile and shows a startup banner when the installed game version does not match the mod build.
• Dev perf overlay — Optional HUD (dev rail) with preload and save-serialization timing probes.
• AI Host & StrongStrategy — Mod AI platform with an AI Host panel in the dev rail, external companion terminal APIs, and StrongStrategy solo autoplay informed by Codex priors.
• Combat simulation & beam planner — In-fight AI simulates deck EV, multi-turn lines, relic/power hooks, potion use in search, minion engagement, and enemy mechanic discovery.
• AI HUD overlay — Top-left run overlay with big/small deck forecast, win estimate, and live sim telemetry (replaces the older heuristic HUD).
• Reward, map & rest AI — Card rewards scored by marginal deck/sim value (including next-fight beam preview); map routing weighs path risk; rest sites prefer campfires when the deck needs upgrades; scored hand picks for exhaust and upgrade prompts.
• Ancient event debug (dev tools) — From Events or Room Teleport → Ancient Ones, pick any ancient in the extension panel and enter randomly or pin a listed option (Darv, Orobas, and mod ancients share one picker); dmevent force <eventId> [choice].
• MCP Nexus upload — Pipeline to publish mod packages to Nexus from the MCP tooling (see README MCP).

Changed

• Breaking: monolith → modules — DevMode's single DLL becomes Core + satellites. Install KitLib-Full (recommended) or Core + KitLib.Features + the satellite zips you need. make sync deploys Core only; make sync-full deploys the full local bundle. Existing installs migrate module toggles to Full (all satellites on); new installs default to Standard (Panel on; AI/Cheat/Dev off).
• Rebrand to KitLib — Mod id, assembly, C# root namespace, user-data path (mod_data/KitLib), and NuGet package id (STS2.KitLib) replace DevMode. Legacy mod_data/DevMode settings migrate automatically on first launch. Dependent mods should reference KitLib.dll and KitLib.* namespaces (e.g. KitLib.Companion.CompanionBridge).
• Content-mod integration — Ship a kitlib.compat.toml sidecar for version/dependency checks in Mod settings; reference STS2.KitLib.Abstractions at compile time and KitLib.dll (+ any satellite you need) at runtime.
• Mod Panel navigation — Page tabs use an LB/RB shoulder carousel; controller hints and focusable sidebar rows; opens through the official submenu stack for reliable gamepad navigation.
• Progress protection — Settings, backup list, restore flow, and startup progress-loss prompt live under Mod Panel (replacing the legacy DEVMODE menu entry).
• Log format & viewer — KitLib internal lines use [KitLib][scope] without duplicate [KitLib] prefixes; secondary scope tags render dimmer than primary mod tags in the log viewer and kitlog.
• Combat stats sidebar — Context-pane score bar uses readable scale ticks aligned to the bar height.
• Combat AI behavior — Block-first lines, sim-backed focus fire and vulnerable setup, potion scoring in beam search, weak mitigation modeling, skip-anim-safe card play, no premature end-turn with playable cards, save/load after AI combat, and reward-screen skip loops resolved.

Fixed

• Install packages — Release zips again include the required PCK after the modular packaging split.
• STS2 stable + Dev Mode — Dev bootstrap on the stable game branch no longer crashes or double-applies Harmony on the main menu.

---

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。

v0.13.0-sts2beta-v0.105.1

Requires Slay the Spire 2 Steam beta branch v0.105.1. Not for the public/stable build.

Added

• Dev sidebar keyboard shortcuts — Toggle the sidebar, close the active panel, switch tabs, or lock the rail from the keyboard. Rebind under Settings → Keyboard shortcuts (conflicts with in-game shortcuts are rejected).
• Quick save / load — F5 quick-saves and F9 quick-loads the current run (slot 0) during a run; rebind in Settings → Keyboard shortcuts. The Save / Load panel shows a dedicated Quick Save row at the top.
• Combat checkpoint nodes — During combat, DevMode auto-saves checkpoints at combat start and each player turn start (with a .combat.bin sidecar for in-fight restore of HP, piles, etc., without a full LoadRun). F8 replays from combat start, F6 from the current turn start (rebind in Settings → Keyboard shortcuts). The Save / Load panel lists This combat nodes separately from quick save.
• MCP bridge — Connect MCP clients (Cursor, Claude Desktop, etc.) to a running session on port 9877 for automated testing and agent workflows: game state, combat/map actions, save slots, cards, monsters, and cheats. See README MCP; bootstrap with make dev-session.
• MCP combat observability — During combat, MCP get_game_state includes your active powers (stack counts and mod power ids), combat phase, and indexed enemies. Playing a card via MCP returns an after-play snapshot for assertions without guessing from HP alone.

Fixed

• Crash recovery prompt — Exporting a feedback ZIP or dismissing the dialog no longer leaves a stale pending report, so the main-menu prompt does not reappear every launch. Normal game quit now clears the session marker more reliably.
• STS2 Steam beta — Mod dependency metadata loads correctly on the beta game branch again.

---

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 依赖信息。

v0.13.0

Added

• Dev sidebar keyboard shortcuts — Toggle the sidebar, close the active panel, switch tabs, or lock the rail from the keyboard. Rebind under Settings → Keyboard shortcuts (conflicts with in-game shortcuts are rejected).
• Quick save / load — F5 quick-saves and F9 quick-loads the current run (slot 0) during a run; rebind in Settings → Keyboard shortcuts. The Save / Load panel shows a dedicated Quick Save row at the top.
• Combat checkpoint nodes — During combat, DevMode auto-saves checkpoints at combat start and each player turn start (with a .combat.bin sidecar for in-fight restore of HP, piles, etc., without a full LoadRun). F8 replays from combat start, F6 from the current turn start (rebind in Settings → Keyboard shortcuts). The Save / Load panel lists This combat nodes separately from quick save.
• MCP bridge — Connect MCP clients (Cursor, Claude Desktop, etc.) to a running session on port 9877 for automated testing and agent workflows: game state, combat/map actions, save slots, cards, monsters, and cheats. See README MCP; bootstrap with make dev-session.
• MCP combat observability — During combat, MCP get_game_state includes your active powers (stack counts and mod power ids), combat phase, and indexed enemies. Playing a card via MCP returns an after-play snapshot for assertions without guessing from HP alone.

Fixed

• Crash recovery prompt — Exporting a feedback ZIP or dismissing the dialog no longer leaves a stale pending report, so the main-menu prompt does not reappear every launch. Normal game quit now clears the session marker more reliably.
• STS2 Steam beta — Mod dependency metadata loads correctly on the beta game branch again.

---

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 依赖信息。

v0.12.0-sts2beta-v0.105.1

Requires Slay the Spire 2 Steam beta branch v0.105.1. Not for the public/stable build.

Added

• Crash recovery prompts — When an unhandled error occurs in-game, DevMode shows a dialog to view logs or export a feedback ZIP (prefilled with crash summary). If the game exits abnormally, the main menu offers the same on next launch. Toggle under Settings → Crash recovery. Session markers live under mod_data/DevMode/instances/{pid}/.
• Progress protection — On mod set fingerprint change, DevMode backs up the active profile's progress.save (and optional related saves) under mod_data/DevMode/profile_backups/ before vanilla save filtering can run. Optional warn-only log when progress still references unloaded mods. Toggle under Settings → Progress protection or the title-screen DEVMODE → Progress protection panel (status + recent backups + one-click restore). Each backup row has a Details button to inspect account progress, per-character stats, epochs, compendium counts, and backup metadata.
• Progress protection startup prompt — On main menu load, if mod character stats were filtered but a recoverable backup exists, DevMode offers a Restore / Not now dialog (toggle under Progress protection settings).
• Content browsers (mod source) — Card, relic, potion, power, and event pickers include a Mod source filter to include or exclude game content and loaded mods. Detail views show Source: for the selected entry. The card browser remembers your mod-source filter across sessions.

Changed

• DEVMODE main menu — Logs and Mod Feedback are grouped under Diagnostics; Progress protection opens a dedicated panel from the title screen.
• AI Host (dev rail) — Uses a robot icon instead of sharing the Scripts puzzle icon.

Fixed

• DEVMODE main menu — Re-entering the title-screen DEVMODE submenu after Mod Feedback and save/load no longer stacks stock menu buttons with dev entries; overlays are torn down on hide. (Thanks @Crimson707707 for the report.)
• Add enemies to combat picker — The encounter and monster lists scroll correctly within the panel; switching to Monsters no longer leaves a large blank scroll area.
• Enemy intent overlay — Saving and exiting or leaving combat mid-fight with the intent overlay enabled no longer crashes or leaves a black screen; the overlay hides cleanly when combat ends. (Thanks @Crimson707707 for the report.)

---

Added

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

Changed

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

Fixed

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

v0.12.0

Added

• Crash recovery prompts — When an unhandled error occurs in-game, DevMode shows a dialog to view logs or export a feedback ZIP (prefilled with crash summary). If the game exits abnormally, the main menu offers the same on next launch. Toggle under Settings → Crash recovery. Session markers live under mod_data/DevMode/instances/{pid}/.
• Progress protection — On mod set fingerprint change, DevMode backs up the active profile's progress.save (and optional related saves) under mod_data/DevMode/profile_backups/ before vanilla save filtering can run. Optional warn-only log when progress still references unloaded mods. Toggle under Settings → Progress protection or the title-screen DEVMODE → Progress protection panel (status + recent backups + one-click restore). Each backup row has a Details button to inspect account progress, per-character stats, epochs, compendium counts, and backup metadata.
• Progress protection startup prompt — On main menu load, if mod character stats were filtered but a recoverable backup exists, DevMode offers a Restore / Not now dialog (toggle under Progress protection settings).
• Content browsers (mod source) — Card, relic, potion, power, and event pickers include a Mod source filter to include or exclude game content and loaded mods. Detail views show Source: for the selected entry. The card browser remembers your mod-source filter across sessions.

Changed

• DEVMODE main menu — Logs and Mod Feedback are grouped under Diagnostics; Progress protection opens a dedicated panel from the title screen.
• AI Host (dev rail) — Uses a robot icon instead of sharing the Scripts puzzle icon.

Fixed

• DEVMODE main menu — Re-entering the title-screen DEVMODE submenu after Mod Feedback and save/load no longer stacks stock menu buttons with dev entries; overlays are torn down on hide. (Thanks @Crimson707707 for the report.)
• Add enemies to combat picker — The encounter and monster lists scroll correctly within the panel; switching to Monsters no longer leaves a large blank scroll area.
• Enemy intent overlay — Saving and exiting or leaving combat mid-fight with the intent overlay enabled no longer crashes or leaves a black screen; the overlay hides cleanly when combat ends. (Thanks @Crimson707707 for the report.)

---

Added

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

Changed

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

Fixed

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

v0.11.2-sts2beta-v0.105.1

Requires Slay the Spire 2 Steam beta branch v0.105.1. Not for the public/stable build.

Fixed

• Install packages — Official release zips and NuGet packages again include the required PCK file, so the mod loader no longer reports a missing PCK and the in-game mod list shows the preview image.

---

Fixed

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

v0.11.2

Fixed

• Install packages — Official release zips and NuGet packages again include the required PCK file, so the mod loader no longer reports a missing PCK and the in-game mod list shows the preview image.

---

Fixed

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