v1.8.1

OSTGUI v1.8.1 —— 联机页重做与术语统一

适用版本：v1.8.1（对比 v1.8.0）
建议搭配内核 ZSteamTool v1.2.0 及以上使用（联机的宿主会话依赖内核的会话身份支持）。

新增

• 联机方式改名：DLL 注入 → 宿主会话、AppID Changer → 文件会话、内核原生 → 命令行会话。界面文案、代码注释与开发文档同步统一。
• 会话身份选择会记住：默认身份／自定义身份、以及自定义的 AppID 会写进配置，重开程序保持上次选择。
• 启动前置检查：宿主会话与文件会话各显示三项状态——Steam 是否运行、内核是否已安装、游戏是否已入库。仅作提示，不拦截启动。

修复与改进

• 前置检查的「入库」项改为仅在查询过 AppID 之后才判定，未查询时显示「未查询」，不再把半截输入当成结论。
• 前置检查改为每项一块、横排一行，并修掉上一版该区域整体空白的问题（AOT 下嵌套类型的绑定不可靠，改用顶层属性）。
• 命令行会话页补一行「更推荐使用「宿主会话」」提示，字号与修改器页副标题一致；撤掉该页多余的状态行与说明。

文档

• 精简 14 份开发文档（去过程与历史，事实、判据与数值保留）。
• REF-联机.md 按新命名重写章节；退役 UBISOFT-NOTES.md（免育碧功能已挂起）；旧版更新说明归入 v1.3.x-v1.6.x/ 子目录。

升级方式

• 覆盖旧版程序目录即可（新旧可以共存）。
• 内核按需单独更新。

---

v1.8.0

OSTGUI v1.8.0 —— 适配新版 Steam（请同步更新内核）

适用版本：v1.8.0（对比上一版本 1.7.9）

重要：只升级 GUI 不足以恢复功能，内核必须同步更新

Steam 客户端已于 2026-10-14 更新。旧版内核（ZSteamTool v1.1.3 及更早）在该版本上会导致 Steam 启动约 5 秒后自行退出，且已入库游戏全部显示未解锁。此问题与图形界面无关，只能通过更换内核解决。

• 内核下载（ZSteamTool v1.1.4，已适配新版 Steam）：https://github.com/hazjy/ZSteamTool/releases/latest
• 旧版 OSTGUI 的「检查更新」只检查自身，不会提示内核有新版本 —— 升级到本版后，GUI 与内核会一并检查。

新增

• 「检查更新」现在同时检查内核：一次比对本机 GUI、本机内核与两个仓库各自的最新发布版本，结果合并为同一条系统通知：
  • 两者均有更新：提示「发现内核新版本 vX.X.X 和 GUI 新版本 vX.X.X，当前版本 vX.X.X 和 vX.X.X」，并给出「前往内核发布页」「前往 GUI 发布页」两个按钮；
  • 仅一方有更新：单条提示与对应按钮；
  • 手动检查且均无更新：「关于」弹窗内以小字提示「已是最新」。

说明

• 内核版本取自本机已部署的 OpenSteamTool.dll 的版本信息；未安装内核时该项不参与比对。
• 自动检查仍在启动 5 秒后进行，受设置页「接收更新推送」控制；同一版本只提示一次，GUI 与内核分别记账。
• 内核与 GUI 需分别下载替换，本版不提供自动下载。

升级方式

• 覆盖旧版程序目录即可（也可以新旧共存）；内核请按上文单独更新。

v1.7.9

OSTGUI v1.7.9 更新说明

适用版本：v1.7.9（对比上一版本 1.7.8）

新增：

• 「清单源」区域新增「请求码源」：内置四个码源，按顺序自动逐个尝试，谁先给出可用的码就用谁。Steam 取不到清单请求码时（表现为「No connection」/「无法获取清单请求码」），靠它把清单拉下来
• 每个源一张卡片，右侧开关决定它是否参与级联；点「测活」可当场看这个源通不通

说明：

• 改动会覆盖原有的 manifest.lua（在 Steam 的 config\lua\ 下），请先自行备份
• 勾选变化即时生效，不用重启 Steam
• 四个源全部关闭时写入「短路配置」：不注入任何第三方码，清单靠入库时下载或清单投喂
• 「请求码源」与上面的「清单源」是两件事：清单源负责入库时下载清单文件，请求码源负责运行时回答 Steam 要的请求码
• 有了 manifest.lua，内核内置码源（opensteamtool.toml 的 [manifest] url）就不再被执行

升级方式

• 覆盖旧版程序目录即可（也可以新旧共存）

v1.7.8

OSTGUI v1.7.8 更新说明

适用版本：v1.7.8（对比上一版本 1.7.7）

修复：

• 虚幻引擎（UE）游戏的免 Steam 部署不再漏掉 Engine\Binaries\ThirdParty\Steamworks\Steamv<版本>\Win64\ 里的 steam_api64.dll —— 此前只处理 EXE 同目录那份，会出现「提示部署成功、游戏仍要求 Steam」
• 一键还原同步覆盖上述目录，不再残留模拟器文件
• 还原时偶发的「文件被占用、无法替换」不再需要手动再点一次：启动瞬间的短时占用会自动重试

更改：

• 脱壳与模拟器组件全部跟到上游最新：GSE 模拟器（gbe_fork）、Steamless（反汇编器已换为 Iced）、SteamAPICheckBypass —— 对较新的 SteamStub 壳与更多游戏的支持随之更新

说明：

• 免 Steam 部署后，该游戏无法再用 GUI 的 480 联机（模拟器顶掉了游戏的 Steam 接口）—— 想联机请先「一键还原」；部署后要在模拟器世界里联机可能需另找联机补丁，本项目不提供

升级方式

• 覆盖旧版程序目录即可（也可以新旧共存）

v1.7.7

OSTGUI v1.7.7 更新说明

适用版本：v1.7.7（对比上一版本 1.7.6）

修复：

• 免 Steam 部署不再会误删游戏自带的 Plugins 目录
• 入库不再改动 steamtools.lua
• 修复清单源 「上次更新时间」 显示不准确

更改：

• 侧边栏宽度点「更改」后不再清空输入框
• 免 Steam 页「部署日志」栏现在能看到全部部署细节，而且顺序正确
• 设置页日志栏改为显示全量日志（去掉 2000 行显示上限）
• 主页状态不再固定显示「就绪」，而是按实际健康状态显示

升级方式

• 覆盖旧版程序目录即可（也可以新旧共存）

v1.7.6

OSTGUI v1.7.6 更新说明

适用版本：v1.7.6（对比上一版本 1.7.5）

注意：自动检查更新是这个版本新增的特性；往期版本没有这项功能，无法接受更新推送。

新增功能

• 清单按需投喂：跟随 Steam 日志自动下载所需清单，解决部分「无互联网连接」。默认关闭。
• 「关于」弹窗：侧边栏「信息」→「关于」，从整页改为弹窗，并新增自动与手动检查更新。

修复

• 修复重复部署免 Steam 时覆盖原始 EXE 备份、导致无法还原的问题。

移除

• 移除「入库结果通知」勾选项。现在入库结果始终通知。

---

升级方式

覆盖旧版程序目录即可（也可以新旧共存）。

v1.7.5

OSTGUI v1.7.5 更新说明

适用版本：v1.7.5（对比上一版本 1.7.0）

特别说明：

需 ZSteamTool v1.1.3 及以上

本版改为原生编译（Native AOT）：程序编译为原生代码，不再依赖 .NET 运行时，解压即用。
简直既快又快！

运行方式与性能

• 原生编译：不再依赖 .NET 运行时，启动阶段无需 JIT 预热；仍为自包含、免安装，解压覆盖旧版即可。
• 内存占用下降：启动后工作集约 49 MB（上一版约 109 MB）；连续切换页面 20 次后约 254 MB（上一版约 273 MB）。
• 分发包体积减小：约 82 MB 降至约 36 MB（原生编译去掉了随包的 .NET 运行时文件）。

联机

• 修复：查不到已安装游戏的主程序。原规则只检查游戏目录顶层，遇到主程序位于子目录（如 bin64\）或程序名与目录名不一致的游戏，会直接判定「未找到」。现按可信度分三档定位：与目录同名的主程序 → 目录顶层体积最大的可执行文件 → 四级子目录内体积最大的可执行文件（已排除崩溃处理器、卸载器与运行库安装器）。
• 启动失败会说明原因：宿主进程启动后立即退出时，提示会给出退出码与具体原因，并指明日志位置；不再出现「界面提示成功、实际未生效」的情况。

日志

• 「日志文件保留行数」现在真正生效：日志超过设定行数时直接裁剪文件、只保留最近内容，不再出现设置不生效、文件持续增大的情况。
• 日志栏只渲染尾部 2000 行：长时间运行不再因日志栏累积内容而占用内存（内部仍保留完整内容，可随时复制）。
• 「复制全部」复制完整日志，并回报已复制的行数。
• 取消「诊断 / 流水账」两条通道：日志文件与日志栏显示同一份内容（上一版将日常流水账移入设置页，本版回到一处，便于对照）。

提示与文案

• 即时反馈改用应用内通知：复制、切换、绑定、启动，以及「请先填写游戏 AppID」这类校验提示，改为窗口顶部的一条通知，不再进入 Windows 通知中心。失败与耗时操作的结果仍使用系统通知，便于窗口不在前台时也能看到。
• 通知浮层改为不透明底色，并移至窗口右上角：压在大号标题上时不再透出底下的文字。
• 界面文案全面书面化：通知、校验提示、控件说明与日志用语统一为书面表述（统一「未／无法／不能」、「已 + 动词」、「请先 + 动词」等口径）。

修复

• 入库管理：游戏名称、AppID、来源标签变化后卡片不刷新的问题。
• 联机：主程序位于子目录的游戏无法定位（例如红色沙漠，AppID 3321460）。
• 清理若干已失效的界面资源与死代码。

注意事项

• 覆盖升级前请先退出正在运行的程序，避免文件被占用导致替换失败。
• 配置与缓存位于 %LOCALAPPDATA%\OSTGUI，升级不影响。

---

升级方式

下载新版解压覆盖旧版程序文件即可。配置与缓存位于 %LOCALAPPDATA%\OSTGUI，升级不影响。

v1.7.0

OSTGUI v1.7.0 更新说明

适用版本：v1.7.0（对比上一版本 1.6.2）

特别说明：

需 ZSteamTool v1.1.3 及以上

修改器（新增页面）

• 搜索风灵月影修改器：走站点官方 RSS 取结果，只列正文条目，不会混进侧栏的推荐 / 热门。
• 一键下载：自动跟随跳转、带上防盗链所需来源，压缩包自动解压；下载进度显示在状态行。
• 「已下载」列表：按索引管理，可过滤。
• 一键更新：直接取官方最新版覆盖，并同步索引；已是最新会明确提示，不会白下一遍。
• 「更多」菜单：复制名称（exe 完整文件名）/ 更新 / 删除（红字，删除会连带移除指向它的绑定）。

进程绑定（新增）

• 随游戏启停：游戏主程序一启动就自动运行对应修改器，游戏退出就结束它。
• 按名称绑定：绑定记录的是修改器名称，实际文件按名称查索引——更新换了文件名也不会失效。
• 后台监控进程：GUI 关掉后绑定仍然生效；页面上的「运行 / 停止」两个按钮控制它，状态实时跟随。

成就

• 成就编辑：左侧列表 = 入库档（lua）+ 正版，两者可分别勾选（按页记住）；选中游戏后可编辑成就解锁状态，先写本地留底，再手动「保存到 Steam」写回。
• 按名称 / 描述过滤成就列表；页头「刷新」可重读当前游戏。
• 写入失败有诊断：失败会给出 E1 / E2 / E3 提示，日志里有具体原因。
• 左侧列表加缓存：重开应用秒开，也不再每次启动都起一次查询子进程；lua 档或 appinfo.vdf 有变化会自动重扫，「刷新」可强制重扫。

界面

• 应用内通知：窗口顶部一条细提示（例如「更多 → 复制名称」会给出反馈），不再只依赖系统通知。
• 修改器页文案精简；成就页左侧列表宽度与修改器页对齐。

其它

• 日志系统重做：日志文件只留崩溃 / 诊断（启动退出、异常全栈、外部失败、关键状态变化），日常流水账移到设置页「运行时日志」；文件按大小轮转，多个子进程同时写不再丢行；崩溃钩子补全（UI 线程 / AppDomain / 任务异常）。

修复

• 多个进程同时写日志时的静默丢行。

注意事项

• 修改器是第三方程序（来自 flingtrainer.com），杀软可能误报；只有你点「启动」或绑定生效时才会运行。
• 首次进成就页仍会完整扫一遍并写入缓存，之后重开才是秒开。

---

升级方式

下载新版解压覆盖旧版程序文件即可。配置与缓存位于 %LOCALAPPDATA%\OSTGUI，升级不影响。

v1.6.2

OSTGUI v1.6.2 更新说明

适用版本：v1.6.2（对比上一版本 1.6.1）

特别说明：

需 ZSteamTool v1.1.3 及以上

入库管理

• 新增「网格视图」：页头可切换列表 / 网格；网格卡片是封面 + 游戏名 + AppID + 版本状态 + 同一组操作按钮（都居中排列），宽度固定、自动换行，不随窗口拉伸。
• 卡片悬浮反馈：鼠标移上去整张卡片轻微放大、浮起一层投影并高亮，移开复原。
• 视图选择按页记住，重开软件保持上次选的那档。

搜索入库

• 同步支持列表 / 网格两档：与「入库管理」同款切换控件、同尺寸卡片、同一套悬浮反馈，搜索结果也带封面缩略图（仅用于显示，不写缓存）。
• 同样记住上次选的视图。

界面

• 进出页面带上浮 + 淡入动画：系统原生页面过渡，跟随系统"减少动画"设置。
• 浅色主题下卡片补了细描边，卡片边界更清楚。

修复

• 无

---

升级方式

下载新版解压覆盖旧版程序文件即可。配置与缓存位于 %LOCALAPPDATA%\OSTGUI，升级不影响。

v1.6.1

OSTGUI v1.6.1 更新说明

适用版本：v1.6.1（对比上一版本 1.6.0）

特别说明：

需 ZSteamTool v1.1.3 及以上

搜索入库

• 新增「取消任务」按钮：点了入库才会出现；点下即中止，已下载的临时清单会一并清理，再点一次入库即可重来。取消期间按钮变「取消中…」并禁用，同一时间只跑一个入库任务。
• 搜索结果卡片改版：与「入库管理」卡片同构，带封面缩略图（仅用于显示，不写缓存）。
• 「入库」按钮改为纯图标

封面图

• 「入库管理」卡片开始显示封面：优先读本地缓存，缺了按官方 appdetails 兜底拉取；滚动到可见才加载，不会一次性全拉。
• 封面按显示尺寸重编码后落盘（240×112），封面缓存体积约为原来的 1/5。

模拟器页

• 新增「一键还原」：撤掉部署进游戏目录的模拟器产物，回到部署前状态——递归删 SteamAPICheckBypass.json 及它带出的 version.dll / winmm.dll / winhttp.dll、删 steam_interfaces.txt / local_save.txt / steam_settings 目录、把 *.bak 换回原名。只动游戏目录，不碰别处；有文件被占用时如实报「还原未完成」，不报假成功。存档 %APPDATA%\GSE Saves\<appid> 只提示、不删。

界面

• 入库数量不再显示在窗口标题栏，改到「入库管理」页标题：入库管理 「40」；数量为 0 时不显示括号。

修复

• 最大化 / 最小化后关窗，下次启动窗口尺寸与状态错乱（启动成一条细条，或尺寸超出屏幕）已修。
• 启动初始化偶发失败（内容区空白、Steam 路径与 DLL 状态为空）已修复，每次启动只初始化一次。
• OnlineHost 现在会写运行日志，联机相关出问题时便于排查。

性能

• 入库时的内存占用下降：读取密钥缓存不再整份展开，单次入库的额外内存从上百 MB 降到几 MB 量级；入库结束后会主动整理一次内存。
• 去掉了一个每 5 秒遍历整个游戏库的后台扫描。

---

升级方式

下载新版解压覆盖旧版程序文件即可。配置与缓存位于 %LOCALAPPDATA%\OSTGUI，升级不影响。