HypoMux v2.5.0 更新日志

QQ群：1002583295

v2.5.0 是 HypoMux 完成全面重构后的首个正式版本。经过一天的集中测试，目前核心功能、安装升级、网络生命周期与新版桌面端均表现正常；但重构涉及网络引擎、权限模型和桌面框架，仍不能完全排除少数环境下出现问题的可能。

如果遇到 Bug、兼容性问题或异常网络状态，请通过 [GitHub Issues](https://github.com/Hypostasis-Cat/HypoMux/issues) 提交反馈，并尽量附上复现步骤、系统版本、网络环境和支持日志。每一份反馈都会帮助我们把这个新起点打磨得更稳。

本次重构

从 v2.2.0 开始，我们没有只对旧代码做局部修补，而是完成了一次从网络核心到 Windows 桌面端的整体重建：

• 网络核心和桌面服务统一迁移到 Go；不再依赖 Python、Qt、asyncio 或 .NET/WPF 运行时。
• 桌面端迁移至 Wails v3、React、TypeScript、Vite 与 Fluent UI，重新建立了 Windows 11 风格的交互、视觉和无障碍基础。
• UI 与高权限网络操作彻底分离：桌面界面始终以普通用户权限运行，TUN、WFP、路由、DNS 和网络恢复由独立的 HypoMuxCore Windows 服务负责。
• 重建了 Core 与桌面端之间的协议、状态管理、配置迁移、安装升级和异常恢复链路。

这意味着更清晰的职责边界、更少的运行时依赖，以及更安全、更可维护的网络控制路径。后续无论是修复问题、适配新的 Windows 环境，还是继续扩展功能，都可以在不牵动整套桌面程序的前提下更稳定地推进。

更新内容

核心与网络架构

• 完成 Go 网络引擎正式切换，普通代理、TUN TCP/UDP 出站、DNS/DoH、双栈源地址与网卡接口绑定、连接级调度均已纳入统一 Core。
• 新增自适应网卡健康调度：根据网卡状态动态调整可用性与调度决策，降低异常链路对整体连接的影响。
• 重构 TUN 生命周期管理：启动前统一检查网卡、第三方 TUN、路由和 WFP 条件；启动失败、停止、崩溃或升级时均通过受控流程回滚 HypoMux 自身创建的网络资源。
• 新增窄范围网络恢复入口，仅处理 HypoMux 创建的默认路由、Wintun 设备和系统代理快照，避免影响用户其他网络配置。
• 重构 WFP/DNS 兼容处理：支持动态 DNS 豁免、受控兼容降级与环境指纹记忆，减少重复失败和不必要的网络改动。

更安全的权限与进程模型

• 正式版新增 HypoMuxCore Windows 服务；安装、升级和卸载时统一管理服务的创建、更新、启动、停止与移除。
• Wails/WebView2 界面保持普通用户权限，不再要求整个桌面程序长期以管理员身份运行。
• Core 通信改用仅限本机访问的命名管道，并增加 ACL、服务/客户端 PID、活动会话和令牌校验。
• 优化 Core 服务的启动、连接与可取消关闭流程，减少启动卡顿、退出阻塞和残留进程风险。
• 新增启动时的遗留进程清理，降低异常退出后旧进程干扰下一次启动的可能。

全新桌面端与体验改进

• 完成桌面端从 Python/Qt 与过渡期 WPF 到 Wails v3 + React + Fluent UI 的正式迁移。
• 全面重做 Windows 11 Fluent 视觉、交互动效、键盘操作和无障碍细节；高 DPI、深浅主题和窗口材质体验同步收敛。
• 新增“活动连接”页面，实时展示进程、目标域名、远端地址、实际出口网卡、策略、流量和连接时长，支持搜索与自动刷新。
• 新增加速引擎随应用启动自动恢复运行的能力，减少重复操作。
• 优化首次启动、窗口材质、外观设置与背景保存流程，修复透明度、背景图、Mica 默认状态及跨升级持久化等问题。

配置、升级与交付

• 新增 v2.2.0 配置的一次性迁移、备份与回滚机制，尽量保证升级后原有使用习惯和数据可以安全延续。
• 重建更新与安装交接流程：下载在隔离临时目录中进行，完成网络清理后再启动安装器，并支持文件大小与可用 SHA-256 校验。
• Windows 安装器完成简体中文本地化，并完善覆盖升级、卸载、WebView2 检查及网络恢复流程。
• 持续集成与打包链路已适配 Wails、NSIS 和 SignPath 签名流程，正式构件的生成与签名更加可追溯。

修复与稳定性改进

• 修复若干 Core 服务启动、关闭和 IPC 通信边界问题。
• 修复首次启动时可能出现的窗口材质异常、视觉损坏和设置覆盖问题。
• 修复个性化设置在保存或升级后可能丢失、背景图无法正确加载、部分 JPEG 格式无法识别等问题。
• 优化 IPC 负载，避免大尺寸背景数据影响设置持久化。
• 优化窗口拖动、标题栏交互、卡片材质、控件焦点和页面布局细节。

特别感谢 SignPath

感谢 [SignPath.io](https://signpath.io/) 为 HypoMux 提供 Windows 代码签名服务，并感谢 [SignPath Foundation](https://signpath.org/) 为开源项目颁发证书。正是这份支持，让我们能够为 Windows 用户提供更安全、更可信的正式安装包。

官方发布包均由 GitHub Actions 构建并提交至 SignPath 签名。请始终从 [官方 Releases 页面](https://github.com/Hypostasis-Cat/HypoMux/releases/latest) 下载，并确认签名发布者为 SignPath Foundation。

写在最后

这次重构耗费了大量的时间、精力和财力。我们非常感谢每一位关注、使用、提交反馈、Star、分享或赞助 HypoMux 的朋友——你们的支持让这个项目能够持续前进。

如果 HypoMux 帮到了你，欢迎继续关注、Star、提交 Issue 或参与贡献；也欢迎在力所能及的范围内支持项目。无论以哪种方式参与，我们都由衷感谢。