Integrated Mod Manager v4.8.1

基于 v4.8.0 的 Windows x64 正式版。Windows x64 stable release based on v4.8.0.

更新内容

• 在线分类（#129）：在线页会按当前游戏显示 GameBanana 的一级分类和子分类。进入「皮肤」后，选「全部」可以看到未归到角色的 Mod，选「武器」等子分类可单独浏览，选角色子分类会保留角色栏。非角色 Mod 下载时可选择对应的分类文件夹。
• 跨页排序：「按点赞」「按下载量」「按更新时间」由 GameBanana 在所选分类内排序，翻页时保持同一排序。热度和浏览量仍按当前页排序。
• 在线页稳定性：修复列表载入后不断触发重新加载、导致窗口无响应的问题。
• 窗口与导航：修复 Windows 11 把窗口拖到屏幕顶部最大化时的大面积黑屏。切换侧栏页面时只刷新目标页，减少界面线程的工作。主程序使用 Windows App SDK 1.7。

已知问题

• GameBanana 的「按更新时间」结果可能省略从未更新过的 Mod。可切换排序查看这些条目。
• 在线分类和切换已在离线样例中验证，并在独立仓库验证了连接真实 GameBanana 时的加载。真实 Mod 下载并安装到分类文件夹的完整流程仍待验证。真实游戏与加载器的验证范围见 v4.8.0 发布说明。

What's new

• Online categories (#129): Browse GameBanana's top-level categories and subcategories for the current game. Under Skins, choose All to include Mods that are not filed under a character, or select a subcategory such as Weapons. The character subcategory keeps the character rail. Downloads outside that subcategory can use a category folder.
• Sorting across pages: GameBanana sorts the selected category by likes, downloads, or last updated. Hotness and views still sort the current page.
• Online stability: Fixed a reload loop that could make the window stop responding after the list loaded.
• Window and navigation: Fixed the black area when dragging the window to the top of the screen to maximize on Windows 11. Page switches refresh the destination page only. The main app uses Windows App SDK 1.7.

Known issues

• GameBanana's last-updated sort may omit Mods that have never been updated. Change the sort to see those entries.
• Category navigation was verified with offline samples, and loading from GameBanana was checked with an isolated repository. Downloading and installing a real Mod into a category folder still needs end-to-end verification. See the v4.8.0 notes for the scope of game and loader verification.

验证记录 / Verification

Integrated Mod Manager v4.8.0

基于 v4.7.3 的 Windows x64 版本，包含 #93–#104 和 #110–#125，修复 #105–#109。Windows x64 release based on v4.7.3, covering #93–#104 and #110–#125, and fixing #105–#109.

中文

4.8 重新设计了整个界面，并修复了五处可能误删文件或留下失效链接的问题。这五个问题在 4.7.3 及更早版本中都存在，建议所有用户升级。管理 Mod 的方式、保存的数据和在线请求都与 4.7.3 相同。

数据安全修复

• 开关单个 Mod 时删除了 Mod 本身（#105）：如果 Mod 所在的文件夹和加载器的目标文件夹是同一个、一个在另一个里面，或者通过目录联接指向同一处，双击、按钮或键盘开关单个 Mod 时，可能把仓库里的 Mod 原件当成要清理的部署删掉。现在开关前先检查两边是否重叠，重叠时不做任何备份、复制或删除，并在提示里写出两个路径。组合预设原来就有这项检查。
• 启动时清理预设图片删到了外部文件（#106）：预设图片文件夹或其中的子文件夹如果是目录联接或符号链接，启动时的清理会顺着它删除别处的文件。现在清理不进入任何链接，只删除管理器自己写的预设图片和临时文件，其余文件保留，并在日志里写明跳过的原因。
• 加载器文件夹不可用时仍能删除 Mod（#109）：设置了加载器文件夹、但它暂时不可用（例如所在的磁盘没有连接）时，删除 Mod 不会检查加载器里还有没有指向它的链接，删除后这些链接就失效了。现在只要加载器文件夹不可用或链接扫描失败，单个删除和批量删除都会停下，并说明文件夹恢复后如何重试。4.7.0 已经处理了“无法确认链接”的情况，这次补上了文件夹不可用的情况。
• 复制模式恢复组合预设时删除了同名文件夹（#107）：复制模式只按文件夹名称识别已部署的 Mod，所以加载器文件夹里一个与 Mod 同名、但不是管理器复制过去的文件夹，可能在恢复预设时被删除。现在管理器会记录自己复制过去的文件夹（记录在设置文件里，不写入 Mod 文件夹），只删除自己的副本：
  • 4.8 之前复制的、没有记录的文件夹，只有文件列表和每个文件的大小都与仓库里的 Mod 一致时，才会自动认领；改动过的副本不会被认领。
  • 其他同名文件夹在恢复预览里列为“外部文件夹”，不会被删除或覆盖；需要替换它时恢复会停下。如果它其实是你以前部署后又改过的副本，可以在预览里点“接管”。
• 重命名角色后链接和保存的路径失效（#108）：重命名角色只移动了文件夹，加载器里的部署链接，以及组合预设、状态槽位、按键绑定、标签、角色跟随等保存的路径仍然指向旧名字。现在重命名会一并更新这些链接、路径和复制模式的记录；任何一步失败（包括保存设置失败），文件夹、链接和设置都会恢复原状，无法恢复的项目会列出来。新名字已被占用、加载器文件夹不可用，或者有链接读不出来时，会在开始前说明原因并停止。

新的界面

• 外观：左侧导航栏，窗口较宽时显示文字；标题栏中间是搜索框（Ctrl+K 打开命令面板，可以在设置里隐藏）；更新和下载的数量显示在导航栏上。颜色跟随 Windows 的强调色，支持浅色、深色和高对比度主题。
• 仪表盘：点仓库名就能切换仓库；“打开 Mod 管理”等常用操作改成卡片，文字不再被截断；三个路径收进一个可展开的区域，标题显示已设置和缺少的数量，缺少必需的路径时自动展开。
• 首次安装：选择游戏的对话框改为卡片；之后会依次提示“新建仓库”“设置路径”“打开 Mod 管理”三步，可以随时跳过。全新安装不会显示“新功能”对话框。
• Mod 工作区：常用命令放在命令栏里；分栏的宽度可以拖动调整，并会记住；窗口较窄时 Mod 详情以抽屉方式打开；扫描时显示进度，扫描出错时可以直接重试；删除按钮统一为红色。
• 在线：切换角色不再等待淡出动画，立即生效；详情改为更宽的抽屉，窄窗口下覆盖在结果上方，并有“返回结果”按钮；加载中显示与当前视图一致的占位，没有结果时可以一键清空筛选，列表加载失败时在工具栏下方显示错误和“重试”，不再弹出对话框；窗口很小时角色栏会收进工具栏。
• 更新：顶部显示检查状态和“立即检查”，部分 Mod 检查失败时可以只看失败的 Mod；内容分成“Mod 更新”“下载历史”“安装与恢复”三个视图，记住上次打开的视图。
• 快捷键：一列卡片，从上到下依次是发送目标、状态、按键绑定和设置；权限不足时显示提示，并可以直接以管理员身份重启；每条绑定显示按键和来源；全局快捷键改为开关，选好组合后立即生效，不再需要“应用”。
• 设置：卡片式布局；窗口较宽时分成设置和信息两栏，并尽量让两栏一样长。
• 对话框：按钮直接写明动作（删除、替换、恢复、重命名、安装……），不再是“确定”；删除、移除和覆盖使用固定的红色按钮，默认选中“取消”，按 Enter 或 Esc 都会取消；恢复预设、安装组合包和整理导入的预览按“将添加 / 将移除 / 保留 / 跳过”分组并显示数量；表单的错误显示在对应输入框下方，多步流程显示“第 n 步，共 m 步”；出错时可以查看并复制详细信息（错误类型、信息、调用栈和日志位置）。
• 命令面板：结果按页面、角色、Mod 和命令分组。

速度与修复

• 设置、仪表盘、更新和快捷键四个页面改为第一次打开时才创建，启动快约 80–120 毫秒（从进程启动到窗口显示）。
• 点击导航后，页面先显示出来，其余工作随后进行；各页面从点击到显示的时间缩短约 10–80 毫秒。
• 修复开发过程中出现的返回仪表盘时闪退（#102）：当前仓库没有文件夹时，仪表盘的角色列表反复出现和隐藏滚动条，导致布局循环。这个问题只出现在 4.7.3 之后的开发版本里，4.7.3 不受影响。
• 解压 ZIP 时在写入文件前再检查一次条目路径（#93）。原来的检查已经能阻止写到目标文件夹以外，这次只是让代码扫描能识别出来，行为不变。
• 界面内部拆分成独立的页面和服务（阶段 J0–J8 及收尾第 1–3 步），以便以后修改和测试。部署、移除、组合预设恢复、状态槽位保存、F10 时机、在线请求、下载和安装的结果都没有改变，并由自动测试在每一步核对。

升级

• 4.7.3 及更早的正式版可以在软件内更新，也可以下载完整 ZIP；旧配置可以直接使用。
• 升级后第一次启动会显示一次 4.8 新功能说明。
• 4.8 会在设置文件里新增几项：更新页的视图、是否显示标题栏搜索框、Mod 工作区的分栏宽度，以及复制模式部署的记录。降级回 4.7.3 时这些设置会被忽略，复制模式会回到按文件夹名识别的旧方式。

尚未在真实游戏中核对的功能

4.8.0 没有等这些核对完成就发布。以下 9 项只用模拟环境和自动测试核对过，还没有在真实游戏中验证。如果在游戏里遇到问题，请到 GitHub Issues 或反馈群（设置 → 诊断与问题报告）报告，并附上 startup.log 和 app-errors.log：

1. 以管理员身份和普通身份运行时，权限提示是否正确，“以管理员身份重启”是否可用。
2. 开启输入后，在页面和浮窗上点“发送”都能触发 Mod，扫描码和虚拟键两种方式都要确认。
3. 全局快捷键：关闭再打开、换一个组合，都能在游戏里立即生效。
4. 无边框窗口模式下浮窗的鼠标穿透、用快捷键找回鼠标、紧凑布局和拖动。
5. 浮窗自动对比度在明亮和昏暗场景下的表现。
6. 从浮窗热切换状态槽位（F10），以及随后的“已发送 F10，请在游戏中确认”提示。
7. 从浮窗保存组合预设和单个 Mod 预设，包括截图和不截图两种情况。
8. 角色跟随：框选 HUD 区域、保存参考图、跟随切换。
9. 修改加载器自动保存间隔前会先询问，并备份 d3dx.ini。

已知问题与验证边界

• 在线页计划中的网格布局、搜索建议、可移除的筛选标签、可搜索的角色列表和用空格键加入批量操作尚未实现；更新页还没有“全部更新”。
• 高对比度主题、讲述人和键盘 Tab 顺序没有逐页手动检查。
• 新增的俄语文字尚未经过母语者审校。
• 设置页在卡片之间切换仍需约 0.1 秒，原因尚未确认。
• 在线详情页偶发闪退（#15）仍未复现；现在界面中任何未处理的异常都会写入 startup.log，出现时日志会给出原因。
• 删除 Mod（含批量删除）是永久删除，不进回收站。
• 第三方 Mod 与加载器可能导致账号处罚。发布包按 AGPL-3.0-only 分发，见 许可证说明；验证结果见 验证记录。

English

4.8 redesigns the whole interface and fixes five problems that could delete the wrong files or leave broken links. All five are in 4.7.3 and earlier, so every user should upgrade. How Mods are managed, the data the app saves and its online requests are the same as in 4.7.3.

Data safety fixes

• Turning a single Mod on or off could delete the Mod itself (#105): when the Mod's folder and the loader's target folder were the same folder, one inside the other, or the same place through a junction, turning a single Mod on or off (double-click, button or keyboard) could treat the repository's original as a deployment to clean up and delete it. The two folders are now checked for overlap first; if they overlap, nothing is backed up, copied or deleted, and the message names both paths. Combination presets already had this check.
• The preset picture cleanup at startup could delete files elsewhere (#106): if the preset picture folder, or a folder inside it, was a junction or symbolic link, the cleanup at startup followed it and deleted files outside. The cleanup now never enters a link and deletes only the preset pictures and temporary files the manager wrote; anything else is kept, and each skip is logged with the reason.
• A Mod could be deleted while the loader folder was unavailable (#109): with a loader folder set but unavailable for the moment (for example on a disconnected drive), deleting a Mod didn't check whether the loader still had links to it, so those links broke. Single and batch delete now stop whenever the loader folder is unavailable or the link scan fails, and explain how to retry once the folder is back. 4.7.0 already covered links that couldn't be checked; this adds the unavailable folder.
• Restoring a combination preset in copy mode could delete a same-named folder (#107): copy mode recognised a deployed Mod by folder name only, so a folder in the loader folder with the same name as a Mod, but not copied there by the manager, could be deleted during a restore. The manager now records the folders it copies (in its settings file, never inside Mod folders) and only removes its own copies:
  • A folder copied before 4.8, without a record, is claimed automatically only when its file list and every file size match the repository Mod; an edited copy is not claimed.
  • Any other same-named folder is listed in the restore preview as an external folder and is never deleted or overwritten; a restore that would need to replace it stops. If it is a copy you deployed earlier and then edited, "Take over" in the preview makes it count as the Mod's deployment.
• Renaming a character left links and saved paths behind (#108): renaming only moved the folder, so the loader's deployed links and the saved paths in combination presets, state slots, key bindings, tags and character follow still pointed at the old name. A rename now updates those links, paths and copy-mode records together. If any step fails, including saving the settings, the folder, links and settings are put back as they were, and anything that couldn't be restored is listed. A rename stops before it starts, with the reason, when the new name is taken, the loader folder is unavailable, or a link can't be read.

A new interface

• Look: a navigation pane that shows labels on wide windows; a search box in the middle of the title bar (Ctrl+K opens the command palette; the box can be hidden in Settings); update and download counts on the navigation items. Colours follow your Windows accent, with light, dark and high-contrast themes.
• Dashboard: click the repository name to switch repositories; quick actions such as "Open Mod management" are cards whose text is no longer cut off; the three paths sit in one section whose header shows how many are set and missing, and which opens by itself when a required path is missing.
• First install: the game choice shows each game as a card, followed by tips that point in turn at New repository, the paths and Open Mod management; they can be skipped at any time. A new install doesn't show the "what's new" dialog.
• Mod workspace: the common commands are in a command bar; the columns can be resized by dragging and keep their widths; on narrow windows Mod details open in a drawer; scans show progress, and a failed scan can be retried in place; delete buttons are red.
• Online: switching characters no longer waits for a fade-out; details open in a wider drawer that covers the results on narrow windows, with a "Back to results" button; loading shows placeholders shaped like the current view, an empty result offers to clear the filters, and a failed list load shows an error bar with Retry under the toolbar instead of a dialog; in very small windows the character rail folds into the toolbar.
• Updates: a status area at the top with "Check now", and a filter to just the Mods whose check failed; three views (Mod updates, Download history, Install and recovery), and the page remembers the last one.
• Shortcuts: one column of cards: send target, status, key bindings, then settings. A notice appears when the manager has fewer rights than the game, with "Restart as administrator"; each binding shows its keys and where it comes from; the global hotkey is a switch, and a chosen combination applies at once with no "Apply" button.
• Settings: card layout; on wide windows a settings column and an information column, kept about the same length.
• Dialogs: buttons name their action (Delete, Replace, Restore, Rename, Install…) instead of "OK"; delete, remove and overwrite use a fixed red button with Cancel selected, so Enter and Esc both cancel; the previews for restoring a preset, installing a bundle and the organised import are grouped (will add / will remove / kept / skipped) with counts; form errors appear under their field, and multi-step flows show "Step n of m"; errors have details (type, message, stack and log location) you can view and copy.
• Command palette: results are grouped into p...

Integrated Mod Manager v4.7.3

基于 v4.7.2 的 Windows x64 版本，包含 #86 和 #91。Windows x64 release based on v4.7.2, covering #86 and #91.

中文

4.7.3 新增俄语界面，其余功能与 4.7.2 相同。4.7 的全部新功能见 v4.7.0 发布说明。

新增

• 俄语界面：在“设置 → 语言”中选择“Русский”。系统语言为俄语的电脑第一次安装时会默认使用俄语。
• 界面语言改为文件：每种语言是 Strings 里的一个文件，添加新语言不用改代码；某条文字没有翻译时显示英文。

改进

• 窄导航栏里放不下的标签会换成两行，单个长词会略微缩小，不再被截断。
• Mod 工作区工具栏的统计文字在空间不够时以省略号结尾，不再挡住最后一个按钮。
• “检查更新间隔”下拉框的提示文字跟随界面语言。

升级

• 4.7.2 及更早的正式版可以在软件内更新，也可以下载完整 ZIP；旧配置可以直接使用，原来的中文、英文设置不变。
• 4.7.3 不会再显示“4.7 新增”的说明。
• 改用俄语后再降级到 4.7.2 或更早版本，界面会显示为中文，需要在设置里重新选择语言。

已知问题与验证边界

• 俄语译文尚未经过母语者审校。角色名、Wiki 名称等在线内容在俄语界面中显示英文；终末地启动器的出错提示只有中文和英文。
• 已在应用中切换到俄语检查仪表盘、Mod 工作区、在线、更新、快捷键和设置页面；游戏内浮窗、只在下载、恢复、导入过程中出现的对话框，以及带真实数据的在线列表尚未逐一检查。
• 窗口缩得很小时部分工具栏会溢出，这与英文界面相同。
• 其余已知问题与 4.7.2 相同，见 v4.7.2 发布说明。
• 第三方 Mod 与加载器可能导致账号处罚。发布包按 AGPL-3.0-only 分发，见 许可证说明；验证结果见 验证记录。

English

4.7.3 adds a Russian interface; everything else is the same as 4.7.2. For everything new in 4.7 see the v4.7.0 notes.

New

• Russian interface: choose "Русский" under Settings → Language. A first install on a Russian system uses Russian.
• UI languages as files: each language is one file in Strings, so adding a language needs no code changes; any text a language leaves out is shown in English.

Improvements

• Labels that don't fit the narrow navigation rail wrap onto two lines, and a single long word is scaled down slightly instead of being cut off.
• The counts on the Mod workspace toolbar end with an ellipsis when space runs out instead of covering the last button.
• The placeholder of the update-interval box follows the interface language.

Upgrade

• 4.7.2 and earlier stable releases can update in the app, or download the full ZIP. Existing configuration works as is; Chinese and English settings are unchanged.
• 4.7.3 does not show the "New in 4.7" dialog again.
• After choosing Russian, going back to 4.7.2 or earlier shows the interface in Chinese; choose the language again in Settings.

Known issues and verification limits

• The Russian translation has not been reviewed by a native speaker yet. Online content such as character and wiki names stays in English in the Russian interface, and the Endfield launcher's error dialogs are Chinese or English only.
• The dashboard, Mod workspace, Online, Updates, Shortcuts and Settings pages were checked in the app in Russian; the in-game overlay, dialogs that only appear while downloading, restoring or importing, and online lists with real data were not checked one by one.
• At very small window sizes some toolbars overflow, as in English.
• The other known issues are the same as in 4.7.2; see the v4.7.2 notes.
• Third-party Mods and loaders may lead to account penalties. The package is AGPL-3.0-only; see LICENSING. Results are in the verification record.

Integrated Mod Manager v4.7.2

基于 v4.7.1 的 Windows x64 修复版，包含 #84。Windows x64 fix release based on v4.7.1, covering #84.

中文

4.7.2 修复在线角色列表有时加载不出来的问题，功能与 4.7.1 相同。4.7 的全部新功能见 v4.7.0 发布说明。

修复

• 原神、崩坏：星穹铁道、绝区零的角色列表有时加载不出来：请求米游社 Wiki 时偶尔会卡住 20 秒以上，以前既没有超时也不会重试，角色栏只剩从 GameBanana 拼出来的英文名，按字母排序。现在角色目录用到的每个请求（米游社 Wiki、终末地官网、HoYoWiki、GameBanana 分类）最多等 20 秒，超时或网络出错时自动再试一次。
• 没填 Wiki 地址的仓库加载不出 Wiki 目录：仓库没有可识别的 Wiki 地址、但对应原神、星铁或绝区零时，改用该游戏内置的 Wiki 地址。
• 重试和最终失败都会写进 app-errors.log，导出诊断报告时可以看到原因。

升级

• 4.7.1 及更早的正式版可以在软件内更新，也可以下载完整 ZIP；旧配置可以直接使用。
• 4.7.2 没有新功能，不会再显示“4.7 新增”的说明。

已知问题与验证边界

• 卡住的原因推断是米游社 CDN 轮换到连不上的节点，没能当场证实；如果更新后仍加载不出来，请在“设置 → 诊断与问题报告”导出诊断报告。
• 其余已知问题与 4.7.1 相同，见 v4.7.1 发布说明。
• 第三方 Mod 与加载器可能导致账号处罚。发布包按 AGPL-3.0-only 分发，见 许可证说明；验证结果见 验证记录。

English

4.7.2 fixes online character lists that sometimes failed to load; features are the same as 4.7.1. For everything new in 4.7 see the v4.7.0 notes.

Fixes

• Genshin Impact, Honkai: Star Rail and Zenless Zone Zero character lists sometimes didn't load: the miHoYo wiki request occasionally stalled for 20 seconds or more, with no timeout and no retry, leaving only English names gathered from GameBanana in alphabetical order. Every request the character catalog uses (miHoYo wiki, Endfield site, HoYoWiki, GameBanana categories) now waits at most 20 seconds and is retried once after a timeout or network error.
• Repositories without a wiki address never loaded a wiki catalog: when a repository has no recognisable wiki address but belongs to Genshin, Star Rail or ZZZ, the game's built-in wiki address is used.
• Retries and final failures are written to app-errors.log, so they appear in diagnostic reports.

Upgrade

• 4.7.1 and earlier stable releases can update in the app, or download the full ZIP. Existing configuration works as is.
• 4.7.2 has no new features, so the "New in 4.7" dialog is not shown again.

Known issues and verification limits

• The stall is thought to come from miHoYo's CDN rotating to an unreachable node; this was not confirmed. If lists still don't load after updating, export a diagnostic report from Settings → Diagnostics and issue reports.
• The other known issues are the same as in 4.7.1; see the v4.7.1 notes.
• Third-party Mods and loaders may lead to account penalties. The package is AGPL-3.0-only; see LICENSING. Results are in the verification record.

Integrated Mod Manager v4.7.1

基于 v4.7.0 的 Windows x64 修复版，包含 #81–#83。Windows x64 fix release based on v4.7.0, covering #81–#83.

中文

4.7.1 只改了软件自带的更新器，功能与 4.7.0 相同。4.7 的全部新功能见 v4.7.0 发布说明。

修复

• 更新器被误报为病毒：4.7.0 的 LocalUpdateAgent.exe 是用 csc.exe 编译的 .NET Framework 小程序，几家依靠机器学习的杀毒引擎把它判为可疑（VirusTotal 5/71），GameBanana 因此暂扣了 4.7.0 的上传。4.7.1 用 .NET 8 SDK 把同一份源码发布成单个程序，不再依赖 Windows Forms，VirusTotal 上只剩 1/70。更新器做的事没有变：在你确认更新后，等软件退出，校验并解压下载好的新版本，备份后替换文件，再启动新版；失败时回滚。
• 更新器现在和主程序一样只需要 .NET 8 x64 运行时，不需要另外安装 .NET Framework 或 .NET 桌面运行时。

其他

• 用户手册、快速上手、专题手册和开发文档已更新到 4.7（#81）。

升级

• 4.7.0 及更早的正式版可以在软件内更新，也可以下载完整 ZIP；旧配置可以直接使用。从 4.7.0 升级时，运行的仍是 4.7.0 的更新器。
• 4.7.1 没有新功能，不会再显示“4.7 新增”的说明；没看过 4.7 说明的用户仍会看到一次。

已知问题与验证边界

• VirusTotal 上仍有一家（DeepInstinct）把新更新器判为可疑，也是机器学习判断；已知误报，不影响使用。
• 其余已知问题与 4.7.0 相同，见 v4.7.0 发布说明。
• 第三方 Mod 与加载器可能导致账号处罚。发布包按 AGPL-3.0-only 分发，见 许可证说明；验证结果见 验证记录。

English

4.7.1 changes only the app's own updater; features are the same as 4.7.0. For everything new in 4.7 see the v4.7.0 notes.

Fixes

• The updater was flagged as malware: in 4.7.0, LocalUpdateAgent.exe was a small .NET Framework program compiled with csc.exe, and several machine-learning antivirus engines marked it as suspicious (5/71 on VirusTotal), so GameBanana withheld the 4.7.0 upload. 4.7.1 publishes the same source with the .NET 8 SDK as one file without Windows Forms, and VirusTotal shows 1/70. What the updater does is unchanged: after you confirm an update, it waits for the app to exit, checks and extracts the downloaded release, backs up and replaces the files, and starts the new version, rolling back on failure.
• Like the app, the updater now needs only the .NET 8 x64 runtime, not .NET Framework or the .NET desktop runtime.

Other

• The user guide, quick start, topic guides and development docs were updated for 4.7 (#81).

Upgrade

• 4.7.0 and earlier stable releases can update in the app, or download the full ZIP. Existing configuration works as is. Upgrading from 4.7.0 still runs 4.7.0's updater.
• 4.7.1 has no new features, so the "New in 4.7" dialog is not shown again; users who haven't seen it yet still see it once.

Known issues and verification limits

• One VirusTotal engine (DeepInstinct) still marks the new updater as suspicious, also a machine-learning verdict; it is a known false positive.
• The other known issues are the same as in 4.7.0; see the v4.7.0 notes.
• Third-party Mods and loaders may lead to account penalties. The package is AGPL-3.0-only; see LICENSING. Results are in the verification record.

Integrated Mod Manager v4.7.0

基于 v4.6.1 的 Windows x64 正式版，包含 #61–#80，取代本地预览 v4.7.0-preview.1。Windows x64 stable release based on v4.6.1, covering #61–#80; it replaces the local preview v4.7.0-preview.1.

中文

新增

• 预设图片：可选开启“在浮窗保存预设时截图”（默认关闭，开启时提示截图可能包含 UID、昵称和聊天）。主窗口的状态槽位和组合预设显示缩略图，可以从游戏截取、选择本地图片或清除；恢复确认框显示保存时的样子。
• 框选角色与图片切换：浮窗可以变成透明取景框框住角色，图片归当前槽位，可锁定大小、设为默认区域；“图片切换”把浮窗移到屏幕中央，横向列出槽位图片，点图切换。
• 浮窗：按钮和标签有独立底板，背景很透明时文字加阴影；新增紧凑布局、鼠标穿透（用显示/隐藏快捷键恢复）和清晰、平衡、极简三档外观。
• 浮窗自动对比度：快捷键页可以开启（默认关闭）。浮窗背景低于 60% 时，每 1.5 秒看一次浮窗下方画面的亮度，自动换用深色或浅色文字；保存的仍是你选的颜色。需要 Windows 10 2004 或更高版本。
• 分享方案：组合预设页的“分享方案”导出一个小文件，只记录用了哪些 Mod 和它们的参数，不含 Mod 文件。对方用“导入方案”时先看到匹配了多少、缺哪些 Mod、游戏是否一致，只为已有的 Mod 建同名槽位，不覆盖已有槽位。文件按不可信输入逐项检查，超过 4 MB 的方案不会导出。
• 其他游戏：第一次安装按系统语言选择中文或英文，并询问要管理哪个游戏，不再默认终末地。原神、崩坏：星穹铁道、绝区零的仓库可以通过 XXMI 一键启动；任何仓库都可以在编辑对话框里指定 XXMI 导入器。
• “默认”槽位：每个 Mod 都会补上一个保存 Mod 原始默认值的“默认”槽位；恢复它时读取 Mod 当前声明的默认值，会跟随 Mod 更新。
• 保存槽位：Mod 菜单的开关、页码和位置默认不保存，主窗口会列出这些变量让你选择保留；快捷键页可以调整加载器的自动保存间隔（修改前备份 d3dx.ini）。
• 批量操作：Mod 列表的“批量”可以把多个 Mod 加入组合预设、复制到文件夹、导出成组合包或删除。
• Discord：设置页“诊断与问题报告”新增 Discord 入口。

改进与修复

• 切换到源目录为空的仓库会导致软件退出，已修复。
• 管理员权限下文件选择对话框打不开（例如终末地启动设置里的“浏览”），改用系统原生对话框。
• 删除 Mod 前如果无法确认它在加载器目录里的链接，现在不会删除它，并说明原因；批量删除只删除能确认的 Mod。以前会照常删除源文件夹，留下指向已删除文件夹的链接。
• 第一次扫描时读不到默认值的 Mod，之后会重新尝试补建“默认”槽位。
• XXMI 的配置文件内容不是对象（例如数组）时不再中断启动，交给 XXMI 自己报告。
• 没有声明大小的在线图片同样受 25 MB 上限限制。
• 槽位切换在发出 F10 后立即显示状态，不再等待 3 秒的只读保持；保持期间再次切换会提示，耗时写入 startup.log。
• 浮窗动画跟随屏幕刷新，内容淡入淡出。
• 热应用提示改为“已发送 F10，请到游戏里确认”；快捷键页说明 Mod 按键需要在 INI 里修改，并提供打开 INI 的按钮。
• 配置文件会保留不认识的字段，在新旧版本之间切换时不丢设置。
• 内部整理（不改变用法）：在线请求和软件更新的下载、校验移到核心库并有单元测试；仓库页、设置页的布局改为 XAML 声明；新增界面自动化测试。

升级

• 4.6.1 及更早的正式版可以在软件内更新，也可以下载完整 ZIP；旧配置可以直接使用。
• 4.7.0-preview.1 关闭了软件自身更新，请下载 ZIP 覆盖或解压到新目录。预览版保留了你原来的更新设置，换回正式版后自动恢复。
• 首次启动会显示一次 4.7 新功能说明。

已知问题与验证边界

• 以下内容只在演示环境或测试中验证过，尚未在真实游戏里确认：XXMI 启动三个游戏、鼠标穿透在全屏游戏里的表现、恢复“默认”槽位、批量操作、自动保存间隔的修改与卡顿影响、管理员权限下的文件选择、自动对比度、分享方案的导入、保存前 F10 与按键发送。
• 在线角色目录、在线页和检查更新的请求移到核心库后，用模拟网络测试过；联网行为请以实际使用为准，有问题欢迎反馈。
• 一次槽位切换中，管理器本身约占 0.25 秒；其余时间是加载器 F10 重载全部 Mod，启用的大型 Mod 越多越慢。
• 删除 Mod（含批量删除）是永久删除，不进回收站。在线详情页偶发闪退（#15）仍未复现。
• 第三方 Mod 与加载器可能导致账号处罚。发布包按 AGPL-3.0-only 分发，见 许可证说明；验证结果见 验证记录。

English

New

• Preset pictures: optional screenshots when saving presets from the overlay (off by default, with a privacy notice). State slots and combination presets show thumbnails in the main window; set a picture from the game or a file, or clear it; restore dialogs show the saved look.
• Frame a character, pick by picture: the overlay becomes a transparent frame around the character, with a size lock and a default area; "Pick by picture" moves it to the middle of the screen and switches slots by picture.
• Overlay: buttons and labels keep their own backing and text gets a shadow when the background is very transparent; compact view, click-through (restored with the show/hide hotkey) and Clear, Balanced and Minimal looks.
• Overlay automatic contrast: an option on the Shortcuts page (off by default). With a background under 60%, every 1.5 seconds the overlay looks at how bright the screen under it is and switches to dark or light text; the color you chose is still what is saved. Needs Windows 10 2004 or later.
• Share a preset: "Share preset" on the combination presets page writes a small file with the Mods it uses and their values, without Mod files. "Import shared preset" first shows how many match, which Mods are missing and whether the game matches, then creates same-named slots for the Mods you have, never overwriting a slot. Every value is checked as untrusted input, and a preset above 4 MB is not exported.
• Other games: a first install picks Chinese or English from the system language and asks which game to manage instead of assuming Arknights: Endfield. Genshin Impact, Honkai: Star Rail and Zenless Zone Zero repositories start through XXMI; any repository can choose its XXMI importer.
• Default slots: every Mod gets a Default slot with its original defaults, and restoring it reads what the Mod declares now.
• Saving slots: a Mod menu's open state, page and position are left out by default, and the main window lists them to keep any; the Shortcuts page can set the loader's auto-save interval, with a backup of d3dx.ini.
• Batch actions: add several Mods to a combination preset, copy them to a folder, export them as a combination bundle or delete them.
• Discord link in Settings → Diagnostics.

Fixes and improvements

• Switching to a repository with no source folder no longer ends the app.
• File dialogs work when the manager runs elevated, for example Browse in the Endfield launch settings.
• When the links to a Mod in the loader folder cannot be checked, the Mod is no longer deleted and the dialog says why; batch delete only deletes the Mods it could check. Before, the source folder was deleted anyway, leaving a link to a missing folder.
• A Mod whose defaults could not be read on the first scan gets its Default slot on a later scan.
• An XXMI configuration that is not an object (an array, say) no longer stops the launch; XXMI reports it itself.
• Online images without a declared size are held to the 25 MB limit too.
• Slot switching reports as soon as F10 is sent, says when a switch is still applying, and logs its timing in startup.log.
• Smoother overlay animations; clearer hot-apply and key-binding hints; the configuration keeps fields it does not know.
• Internal work that does not change how the app is used: online requests and the update download and checks moved into the core library with unit tests; the repository and settings page layouts are declared in XAML; UI automation tests were added.

Upgrade

• 4.6.1 and earlier stable releases can update in the app, or download the full ZIP. Existing configuration works as is.
• 4.7.0-preview.1 has app self-update off: download the ZIP and extract over it or into a new folder. The preview kept your update settings, so they come back with this release.
• On first start a "New in 4.7" dialog appears once.

Known issues and verification limits

• Checked only on demo data or in tests, not yet in a real game: XXMI launches for the three games, click-through in full screen, restoring Default slots, batch actions, the auto-save interval and its effect on performance, elevated file dialogs, auto contrast, importing a shared preset, and F10 and key sending before saves.
• The online character catalogs, the online page and the update check moved into the core library and were tested against simulated network responses; please report anything that behaves differently online.
• The manager takes about 0.25 s of a slot switch; the rest is the loader reloading every Mod on F10.
• Deleting Mods, including batch delete, is permanent. The occasional online-details crash (#15) is still unreproduced.
• Third-party Mods and loaders may lead to account penalties. The package is AGPL-3.0-only; see LICENSING. Results are in the verification record.

Integrated Mod Manager v4.7.0-preview.1

v4.7.0-preview.1

基于 v4.6.1 的 Windows x64 开发预览版，包含 #61–#68。Windows x64 development preview based on v4.6.1, covering #61–#68.

中文

新增

• 预设图片：可选开启“在浮窗保存预设时截图”（默认关闭，开启时提示截图可能包含 UID、昵称和聊天）。主窗口的状态槽位和组合预设显示缩略图，可以从游戏截取、选择本地图片或清除；恢复确认框显示保存时的样子。
• 框选角色与图片切换：浮窗可以变成透明取景框框住角色，图片归当前槽位，可锁定大小、设为默认区域；“图片切换”把浮窗移到屏幕中央，横向列出槽位图片，点图切换。
• 浮窗：按钮和标签有独立底板，背景很透明时文字加阴影；新增紧凑布局、鼠标穿透（用显示/隐藏快捷键恢复）和清晰、平衡、极简三档外观。
• 其他游戏：第一次安装按系统语言选择中文或英文，并询问要管理哪个游戏，不再默认终末地。原神、崩坏：星穹铁道、绝区零的仓库可以通过 XXMI 一键启动；任何仓库都可以在编辑对话框里指定 XXMI 导入器。
• “默认”槽位：每个 Mod 都会补上一个保存 Mod 原始默认值的“默认”槽位；恢复它时读取 Mod 当前声明的默认值，会跟随 Mod 更新。
• 保存槽位：Mod 菜单的开关、页码和位置默认不保存，主窗口会列出这些变量让你选择保留；快捷键页可以调整加载器的自动保存间隔（修改前备份 d3dx.ini）。
• 批量操作：Mod 列表的“批量”可以把多个 Mod 加入组合预设、复制到文件夹或删除。
• Discord：设置页“诊断与问题报告”新增 Discord 入口。

改进与修复

• 切换到源目录为空的仓库会导致软件退出，已修复。
• 管理员权限下文件选择对话框打不开（例如终末地启动设置里的“浏览”），改用系统原生对话框。
• 槽位切换在发出 F10 后立即显示状态，不再等待 3 秒的只读保持；保持期间再次切换会提示，耗时写入 startup.log。
• 浮窗动画跟随屏幕刷新，内容淡入淡出。
• 热应用提示改为“已发送 F10，请到游戏里确认”；快捷键页说明 Mod 按键需要在 INI 里修改，并提供打开 INI 的按钮。
• 配置文件会保留不认识的字段，在新旧版本之间切换时不丢设置。

已知问题与注意

• 这是关闭软件自身更新的预览版，请解压到独立目录试用，不要覆盖正在使用的版本。
• 以下内容只在演示环境或单元测试中验证过，尚未在真实游戏里确认：XXMI 启动三个游戏、鼠标穿透在全屏游戏里的表现、恢复“默认”槽位、批量操作、自动保存间隔的修改与卡顿影响、管理员权限下的文件选择。
• 一次槽位切换中，管理器本身约占 0.25 秒；其余时间是加载器 F10 重载全部 Mod，启用的大型 Mod 越多越慢。
• 删除 Mod（含批量删除）是永久删除，不进回收站。

English

New

• Preset pictures: optional screenshots when saving presets from the overlay (off by default, with a privacy notice). State slots and combination presets show thumbnails in the main window; set a picture from the game or a file, or clear it; restore dialogs show the saved look.
• Frame a character, pick by picture: the overlay becomes a transparent frame around the character, with a size lock and a default area; "Pick by picture" moves it to the middle of the screen and switches slots by picture.
• Overlay: buttons and labels keep their own backing and text gets a shadow when the background is very transparent; compact view, click-through (restored with the show/hide hotkey) and Clear, Balanced and Minimal looks.
• Other games: a first install picks Chinese or English from the system language and asks which game to manage instead of assuming Arknights: Endfield. Genshin Impact, Honkai: Star Rail and Zenless Zone Zero repositories start through XXMI; any repository can choose its XXMI importer.
• Default slots: every Mod gets a Default slot with its original defaults, and restoring it reads what the Mod declares now.
• Saving slots: a Mod menu's open state, page and position are left out by default, and the main window lists them to keep any; the Shortcuts page can set the loader's auto-save interval, with a backup of d3dx.ini.
• Batch actions: add several Mods to a combination preset, copy them to a folder or delete them.
• Discord link in Settings → Diagnostics.

Fixes and improvements

• Switching to a repository with no source folder no longer ends the app.
• File dialogs work when the manager runs elevated, for example Browse in the Endfield launch settings.
• Slot switching reports as soon as F10 is sent, says when a switch is still applying, and logs its timing in startup.log.
• Smoother overlay animations; clearer hot-apply and key-binding hints; the configuration keeps fields it does not know.

Known issues

• A preview with app self-update off; extract into its own folder rather than over your current install.
• Not yet confirmed in a real game: XXMI launches for the three games, click-through in full screen, restoring Default slots, batch actions, the auto-save interval and its effect on performance, and elevated file dialogs.
• The manager takes about 0.25 s of a slot switch; the rest is the loader reloading every Mod on F10.
• Deleting Mods, including batch delete, is permanent.

The package as a whole is AGPL-3.0-only; see LICENSING.md. / 整个运行包按 AGPL-3.0-only 分发，见 LICENSING.md。

---

• SHA-256 (Integrated_Mod_Manager-v4.7.0-preview.1-win-x64.zip): 0D47E124441FF27D9DDD6E4349326FF0146888A5CD7F47BA8629091312FB738E
• CI: https://github.com/uyujkk/Integrated_Mod_Manager/actions/runs/41578126238
• 从 v4.6.1 升级和回退已用合成数据验证 / Upgrade from v4.6.1 and rollback were checked with synthetic data.

Integrated Mod Manager v4.6.1

中文

4.6.1 是 4.6 的修复版：新 Mod 自动获得默认槽位，浮窗保存不再因为加载器没有新写入而失败，并修复一批排版和显示问题。4.6 的全部新功能见 v4.6.0 发布说明。

新增与改进

• 新 Mod 自动建默认槽位：仓库扫描到新加入、并且声明了 global persist 参数的 Mod 时，会自动为它建一个名为“默认”（英文界面为 “Default”）的状态槽位，内容是 Mod 自己 INI 里的默认值，没写值的按 0。加载器还没写过参数的 Mod 也能直接得到一份可恢复的预设。
  • 升级后的第一次扫描只记录已有的 Mod，不会给它们补建；删除这个槽位后不会再自动建回；已有槽位的 Mod 不会再加。
  • 槽位名称随界面语言变化，重命名后保持不变。
• 浮窗保存更灵活：保存预设前发送 F10 后，如果 5 秒内参数文件没有变化（通常是参数自上次保存后没有改动，新 Mod 常见），浮窗会询问是读取现有文件保存还是取消，而不是直接报错。缺少参数值时仍然不保存，也不会用默认值顶替。

修复

• 仪表板“常用操作”的文字被截断；三个按钮高度不一致。
• 详情里的部署按钮在 Mod 已部署时仍显示“部署 Mod”，现在显示“从目标文件夹移除”。
• 允许多个 Mod 的角色仍提示“部署会替换某个 Mod”，部署区说明也写成会替换；现在说明不会替换已启用的 Mod。
• Mod 列表只有部分 Mod 显示按键数量；现在每个 Mod 都显示，英文单数写作 “1 shortcut”。
• 设置页：按钮间距不均；说明文字被省略号截断；开源组件名称被截断；窄窗口中的分区标签被截断；在线分类表的标签折行。
• 快捷键页：模块摘要被截断；没选窗口时所有游戏都显示终末地专用的权限说明；发送开关没有读屏名称。
• 更新页：中文的日期标签使用半角冒号；下载历史最后一行被截掉一半；运行中切换语言后“打开组合预设工作区”按钮不跟着变。
• 英文界面仪表板的启动器占位文字过长。

升级

• 4.6.0 及更早的正式版可以在软件内更新，也可以下载完整 ZIP；旧配置可以直接使用。
• 首次启动会显示一次 4.6.1 新功能说明。

已知问题与验证边界

• 已在中文和英文、深色和浅色主题、1600 DIP 和 860 DIP 宽窗口中用演示数据检查；侧栏“更新”入口的可更新数量徽标需要联网检查出更新才会出现，未检查。
• 浮窗“读取现有文件”的流程已用不处理按键的测试窗口验证，尚未在真实游戏中验证；真实导出的变体文件仍未验证；在线详情页偶发闪退（#15）仍未复现。
• 第三方 Mod 与加载器可能导致账号处罚。发布包按 AGPL-3.0-only 分发，见 许可证说明；验证结果见 验证记录。

English

4.6.1 is a fix release for 4.6: new Mods get a default slot automatically, overlay saves no longer fail when the loader writes nothing new, and a set of layout and display issues are fixed. For everything new in 4.6 see the v4.6.0 notes.

New and improved

• Default slot for new Mods: when a repository scan finds a newly added Mod that declares global persist values, it creates a state slot named "Default" ("默认" in the Chinese UI) holding the defaults from the Mod's own INI files, with 0 where none is written. A Mod the loader has never written still gets a preset to return to.
  • The first scan after upgrading only records the Mods you already have; deleting the slot does not bring it back; a Mod that already has slots gets none.
  • The name follows the UI language until you rename it.
• More flexible overlay saves: if the parameter file doesn't change within 5 seconds after F10 (usually nothing changed since the loader last saved, common for a new Mod), the overlay asks whether to save from the existing file or cancel instead of failing. Missing values still stop the save, and defaults are never substituted.

Fixes

• Dashboard quick-action labels were cut off, and the three buttons had different heights.
• The details deploy button said "Deploy Mod" on a deployed Mod; it now says "Remove from target".
• For a character that keeps several Mods enabled, the hint said deploying would replace another Mod, and the link-mode note said so too; the note now says enabled Mods are not replaced.
• Only some Mod rows showed a key count; every row does now, and English says "1 shortcut" for one.
• Settings: uneven button spacing; descriptions cut off with an ellipsis; open-source component names cut off; section tabs cut off in narrow windows; a wrapping label in the online table.
• Shortcuts: module summaries cut off; without a selected window every game showed the Endfield privilege note; the send switch had no screen-reader name.
• Updates: half-width colons after Chinese date labels; the last download-history row cut in half; "Open Combination Workspace" kept the old language after a language switch.
• The English launcher placeholder on the dashboard was too long.

Upgrade

• 4.6.0 and earlier stable releases can update in the app, or download the full ZIP. Existing configuration works as is.
• On first start a "New in 4.6.1" dialog appears once.

Known issues and verification limits

• Checked on demo data in Chinese and English, dark and light themes, and 1600 DIP and 860 DIP windows. The Updates navigation badge needs an online check that finds updates and was not checked.
• The overlay's "read existing file" flow was verified with a test window that ignores keys, not yet in a real game. Real exported variant files remain unverified, and the occasional online-details crash (#15) is still unreproduced.
• Third-party Mods and loaders may lead to account penalties. The package is AGPL-3.0-only; see LICENSING. Results are in the verification record.

Integrated Mod Manager v4.6.0

中文

4.6 重新设计了全部页面，并修复本地预览版关闭软件更新检查后无法恢复的问题。4.5 系列的功能见 v4.5.2 发布说明。

导航

• 侧栏可以折叠成图标栏，选择会保存。
• 命令面板（Ctrl+K）：一个搜索框覆盖六个页面、导入 Mod 与刷新仓库两个命令，以及当前仓库的角色和 Mod；方向键选择，Enter 打开，Esc 关闭。侧栏顶部的搜索框也会打开它。
• 下载入口固定在侧栏底部、设置上方，显示进行中的数量和进度，点击打开任务列表。
• 窗口较矮时导航按钮变紧凑，所有入口都能显示。

各页面

• 总览：当前仓库一栏显示状态、角色和 Mod 数量；下方是路径（显示是否存在）、角色概览、仓库卡片和快捷操作（在线浏览、检查 Mod 更新、运行启动器）。点击角色直接打开它的 Mod。
• Mod 仓库：
  • Mod 列表显示缩略图、标签、按键数量、大小和部署状态，可以按“全部、已部署、未部署”筛选。
  • 详情信息表显示来源、位置、标签和大小：来源和标签可以直接编辑，位置可以复制。预览图按 16:9 显示，不再占满整栏。
  • 新仓库显示三步设置：选择游戏预设、设置 Mod 仓库目录、设置部署目标。
  • Mod 列表为空时说明原因（未选角色、还没有 Mod、搜索无结果），并给出导入和在线浏览入口。
  • 部署提示会写出将被替换的 Mod。
• 在线：标题、状态和视图切换在一行，搜索、排序和筛选在一行，翻页在底部。列表和网格使用同一种卡片。详情在右侧抽屉中打开，可以切换上一个、下一个。
• 快捷键：顶部工具栏；按键以键帽样式显示；右侧功能分成可折叠的模块，折叠时显示当前状态。
• 更新：两栏或三栏并排时页面不再整体滚动，各列表在卡片内滚动。
  • 已追踪 Mod 改为紧凑行，可以按“全部、有更新、检查失败、已是最新”筛选并搜索；有更新的排在最前。
  • 下载历史改为紧凑行，可以按“全部、已完成、失败、已取消”筛选。
  • 两个列表只创建屏幕上的行，条目很多时也流畅。
  • 侧栏的更新入口显示可更新数量。
• 设置：两栏总览；语言、主题和密度改为下拉框，主题新增“跟随系统”。

修复

• 本地预览版不再把“启动时检查软件更新”和“软件更新频率”保存为关闭。以后从预览版换回正式版时，会恢复原来的设置。
• 在线详情：Mod 简介里出现单独的“Key”或“Arrow”时，详情加载失败的问题。
• 在线翻页按钮误显示为“下一步”。
• 选中旧仓库的 Mod 时切换仓库会报错；从卡片删除其他仓库时会切换当前仓库。

从本地预览版恢复更新检查

本地预览版（例如 4.5.0-preview、4.5.2-preview.1）关闭了软件自身更新，不能在软件内升级。它们还把更新设置保存成了关闭，所以换回正式版后也要手动打开一次：

1. 下载 4.6.0 完整 ZIP。
2. 完全退出管理器（包括托盘图标）。
3. 把 ZIP 解压到预览版所在的文件夹并覆盖。安装包不含配置、仓库和备份，这些都会保留。
4. 启动 4.6.0，打开“设置”→“项目链接与软件版本”：打开“启动时检查软件更新”，选择“软件更新频率”，或者直接点“检查软件更新”。

此后可以正常在软件内更新。4.6.0 起，即使再用预览版，也不会改写这两项设置。

升级

• 4.5.2 及更早的正式版可以在软件内更新，也可以下载完整 ZIP；旧配置可以直接使用。
• 使用手册中的截图和部分位置说明仍按 4.5.2 的界面编写，后续更新。

已知问题与验证边界

• 已在中文界面、浅色主题下检查各页面；英文界面、深色主题下的部分新页面，以及窄于 900 像素时的更新页堆叠布局尚未逐一检查。
• 真实游戏中的保存前 F10 和真实导出的变体文件导入仍未验证；在线详情页偶发闪退（#15）仍未复现。
• 第三方 Mod 与加载器可能导致账号处罚。发布包按 AGPL-3.0-only 分发，见 许可证说明；验证结果见 验证记录。

English

4.6 redesigns every page and fixes update checks staying off after a local preview build. For the 4.5 series see the v4.5.2 notes.

Navigation

• The navigation collapses to an icon rail, and the choice is saved.
• Command palette (Ctrl+K): one search over the six pages, two commands (import Mod, refresh repository), and the current repository's characters and Mods. Arrow keys choose, Enter opens, Esc closes. The search box at the top of the navigation opens it too.
• Downloads sit at the foot of the navigation above Settings, with the running count and progress; clicking opens the task list.
• On short windows the navigation buttons get more compact, so every entry stays visible.

Pages

• Dashboard: one strip for the current repository's status, character and Mod counts, then paths (showing whether each exists), a character overview, repository cards and quick actions (browse online, check Mod updates, run the launcher). Clicking a character opens its Mods.
• Mod repository:
  • Mod rows show a thumbnail, tags, the number of key bindings, size and deploy state, with All Mods, Deployed only and Not deployed filters.
  • The details table shows source, location, tags and size: edit the source and tags in place, copy the location. The preview keeps 16:9 instead of filling the column.
  • A new repository shows three setup steps: choose the game, set the Mod repository folder, set the deploy target.
  • An empty Mod list says why (no character selected, no Mods yet, no search match) and offers import and browse online.
  • The deploy hint names the Mod that will be replaced.
• Online: title, states and view switch share a row, search, sort and filters share another, paging sits at the bottom. List and grid use one card style. Details open in a drawer on the right with previous and next.
• Shortcuts: a toolbar at the top, key-cap bindings, and the right-hand features in collapsible modules that show their state when collapsed.
• Updates: with two or three columns the page no longer scrolls as a whole; each list scrolls inside its card.
  • Tracked Mods are compact rows with All, Updates, Check failed and Up to date filters and a search box; updates come first.
  • Download history is compact rows with All, Completed, Failed and Canceled filters.
  • Both lists only build the rows on screen, so they stay smooth with many entries.
  • The Updates entry in the navigation shows how many updates there are.
• Settings: a two-column overview; language, theme and density are drop-downs, and the theme can follow Windows.

Fixes

• Local preview builds no longer save "Check for app updates at startup" and "App update interval" as off. Moving from a preview back to a stable build keeps your earlier choice.
• Online details failed to load when a Mod description contained a bare "Key" or "Arrow".
• The online next-page button read "Next step" in Chinese.
• Switching repositories while a Mod of the old one was selected threw an error; deleting another repository from its card switched the current one.

Getting update checks back after a local preview

Local preview builds (for example 4.5.0-preview and 4.5.2-preview.1) have app self-update off, so they can't update in the app. They also saved the update settings as off, so turn them on once after moving back to a stable build:

1. Download the full 4.6.0 ZIP.
2. Quit the manager completely, including the tray icon.
3. Extract the ZIP over the preview's folder. The package has no configuration, repositories or backups, so those are kept.
4. Start 4.6.0 and open Settings → Project Links and App Version. Turn on "Check for app updates at startup" and pick an "App update interval", or click "Check App Updates".

In-app updates then work as usual. From 4.6.0 on, running a preview build no longer changes these two settings.

Upgrade

• 4.5.2 and earlier stable releases can update in the app, or download the full ZIP. Existing configuration works as is.
• The user guides' screenshots and some directions still describe the 4.5.2 layout and will be updated later.

Known issues and verification limits

• The pages were checked in the Chinese UI with the light theme; some new pages in English or the dark theme, and the stacked Updates layout below 900 px, have not each been checked.
• Real-game F10 before saving and real exported variant files remain unverified; the occasional crash on the online details page (#15) is still unreproduced.
• Third-party Mods and loaders may lead to account penalties. The package is AGPL-3.0-only; see LICENSING. Results are in the verification record.

Integrated Mod Manager v4.5.2

中文

4.5.2 改进置顶浮窗的保存、刷新和多按键 Mod 的响应速度，并调整功能名称与标记。4.5 系列的其他功能见 v4.5.1 发布说明。

新增与改进

• 保存前自动发送 F10：浮窗的“保存预设”和“保存单 Mod 预设”会先向游戏窗口发送 F10，等参数文件写入、且连续两次读取一致后再保存；5 秒内没有检测到写入就不保存，避免存到旧参数。发送不了 F10 时（未选游戏窗口、发送未开启或权限不足），可以取消，或明确选择只读取现有文件。没有设置 d3dx_user.ini 时，组合预设只保存 Mod 组合。
• 浮窗刷新：新增“刷新”按钮；启用、停用、切换链接或恢复组合成功后也会自动刷新。当前 Mod 被替换时跟随新的 Mod，停用且没有替代时清空旧按键。
• 多按键 Mod 更快：缓存 INI 扫描结果、复用按钮，浮窗或页面隐藏时不重绘，状态变化只更新文字。
• 缺少参数时的提示改为中英文语言文件中的文字。

名称与功能标记

• 变体导入改为中性名称，并标注“待验证”。
• 目录联接部署、恢复到加载器和 Mod 组合预设去掉“实验”标记，作为已验证的稳定功能。F10 热应用和在线自动翻译仍为实验功能。

其他

• 源码整理为 src/、tests/、tools/，文档移入 docs/ 和 .github/；安装包的目录结构不变。
• 主页更新 4.5 的说明和截图。

升级

• 4.5.1 及更早版本可以在软件内更新，也可以下载完整 ZIP；旧配置可以直接使用。
• 保存预设时会发送 F10，游戏画面会短暂重载。终末地需要以管理员身份运行管理器才能接收按键。

已知问题与验证边界

• 保存前发送 F10 已用模拟加载器验证，尚未在真实游戏中自动化验证；导入变体文件尚未用真实导出的文件验证。
• 在线详情页偶发闪退（#15）仍未复现。第三方 Mod 与加载器可能导致账号处罚。发布包按 AGPL-3.0-only 分发，见 许可证说明；验证结果见 验证记录。

正式发布验证

1312 项测试通过，0 失败、0 跳过，四组覆盖率门槛通过，Release 构建 0 警告、0 错误。4.5.1 旧更新器隔离升级到 4.5.2 通过，配置、仓库和备份保留，旧版目录副本回退哈希一致。精确提交 CI。

English

4.5.2 improves saving and refreshing in the overlay and the response of Mods with many bindings, and adjusts feature names and labels. For the rest of the 4.5 series see the v4.5.1 notes.

New and improved

• F10 before saving: the overlay's Save preset and Save single-Mod preset first send F10 to the game window and save only after the loader file has changed and two reads match. If no write is detected within 5 seconds nothing is saved, so stale values are never stored. If F10 can't be sent (no game window selected, input off, or not enough permission), you can cancel or explicitly read the existing file. Without a d3dx_user.ini, a combination preset saves the Mod combination alone.
• Overlay refresh: a new Refresh button; successful enable, disable, link switch or combination restore also refreshes the overlay. A replaced Mod is followed by its replacement; a disabled Mod with no replacement has its old buttons cleared.
• Faster Mods with many bindings: INI scan results are cached, buttons are reused, nothing is redrawn while the overlay or page is hidden, and status changes only update text.
• The missing-value message now comes from the Chinese and English language files.

Names and labels

• Variant import uses a neutral name and is marked unverified.
• Directory-link deployment, loader state restore and Mod combination presets drop the experimental label and are treated as verified, stable features. F10 hot apply and online auto-translation remain experimental.

Other

• Source moves to src/, tests/ and tools/; documents move into docs/ and .github/. The package layout is unchanged.
• The homepage has updated 4.5 text and screenshots.

Upgrade

• 4.5.1 and earlier can update in the app, or download the full ZIP. Existing configuration works as is.
• Saving a preset sends F10, which briefly reloads the game scene. Endfield needs the manager to run as administrator to receive keys.

Known issues and verification limits

• Sending F10 before saving was verified with a simulated loader, not yet automatically in a real game; variant import has not been checked with a real exported file.
• The occasional crash on the online details page (#15) is still unreproduced. Third-party Mods and loaders may lead to account penalties. The package is AGPL-3.0-only; see LICENSING. Results are in the verification record.

Stable release verification

1312 tests passed, with 0 failures and 0 skips. All four coverage gates passed; Release builds completed with 0 warnings and 0 errors. An isolated upgrade from the 4.5.1 updater to 4.5.2 preserved configuration, repositories and backups, and the restored old-version copy matched its runtime hash. CI for the exact commit.