v1.4.5

1.4.5

代理与 TUN

• 概览右上角新增“系统代理 / TUN 模式”切换，连接时直接切换，关闭代理时仅保存模式选择。
• 修复 macOS 自动 TUN 模式下可能无法联网的问题，默认使用 gVisor；手动设置及 Windows／Linux 的协议栈选择保持不变。
• TUN 开启时使用实际生成的配置，补充数据包读取失败的诊断及切换失败后的恢复提示。

启动与账号

• 将账号凭据和辅助服务密钥改为按需读取，减少普通启动时不必要的钥匙串授权弹窗。
• 打开账号窗口时才尝试恢复已保存的登录状态；取消钥匙串授权后保留凭据，支持稍后重试。
• 修复敏感配置保存失败后仍继续切换或重启内核的问题，保留原有配置。

界面与更新

• 优化侧栏宽度、品牌文字及底部内核状态的对齐。
• 隐藏首次启动时自动弹出的引导，保留手动入口。
• 更新检查和下载地址同步到更名后的 Koala.Clash 仓库。

Download link：

Windows 10/11：

macOS 11+：

Linux：

v1.4.4

1.4.4

账号与订阅

• 新增 COOLGO 网站账号登录，在系统浏览器完成授权后自动返回 Koala。
• 账号窗口展示当前账号的可用服务，每次打开时从 WHMCS 刷新，支持直接导入订阅。
• 导入订阅后自动启用；已导入的订阅可再次启用，并显示当前使用状态。
• 改善订阅切换失败后的恢复，保留原有订阅及设置，避免退出登录或切换账号时误导入。
• 精简账号窗口，集中展示账号、订阅、到期时间和操作，统一浅色、深色及窄窗口布局。

更新与集成

• 在“关于”中新增“检查更新”，保留设置中的原有入口。
• 随版本提供 Koala Services 1.0.4 WHMCS 插件，支持 WHMCS 9+ 与 Remnawave 3.4+；按服务 domain 字段中的 Remnawave 用户 ID 获取订阅。
• 完善登录、服务查询及导入诊断，日志不记录登录令牌、密钥或完整订阅地址。

Download link：

Windows 10/11：

macOS 11+：

Linux：

v1.4.3

1.4.3

macOS 安装与更新修复

• 修复无发布证书构建启动即崩溃的问题：为临时签名的 Electron 程序补全动态库加载权限，并统一 Intel／Apple Silicon 构建的签名方式。
• 修复安装器提示成功，但“应用程序”中找不到应用的问题：固定安装到 /Applications/Koala Clash.app，禁止重定位到本地构建目录或其他副本。
• 安装后找不到应用或内核权限设置失败时明确报错，避免误报安装成功。
• 应用内更新完成后校验安装位置、应用标识、版本和可执行文件，再从“应用程序”目录重启。
• 修复更新窗口一直转圈、取消按钮无法关闭的问题；安装失败会显示错误。
• GitHub Actions 对 macOS 安装包增加安装路径、重定位、签名和动态库启动检查。

从 1.4.1／1.4.2 升级：如果旧版更新窗口卡住，或此前安装后找不到应用，请直接下载此版本的 PKG 安装，完成后从“应用程序”打开 Koala Clash。

macOS 安装包仍未公证；本次修复解决安装位置与更新流程问题。

Download link：

Windows 10/11：

macOS 11+：

Linux：

v1.4.2

1.4.2

Koala 首个正式 Release。

界面与品牌

• 重构概览、节点、订阅、连接、规则、日志、内核及设置页面，统一紧凑布局、控件比例与浅色／深色主题。
• 使用全新的考拉钥匙孔标志，统一应用、Dock、托盘、关于页面与安装包图标。
• 优化设置及内核页面的「更多设置」，减少重复卡片层级，改善留白和窄窗口布局。
• 修复内核运行状态指示，并改善运行状态与错误反馈。

订阅与代理

• 改进 Xboard 订阅请求的客户端标识，正确获取包含 AnyTLS 的 Mihomo 配置。
• 新增订阅默认每 24 小时自动更新，支持不自动更新及 12、24、48、72 小时周期。
• 将订阅主操作调整为「使用此订阅」，突出激活入口。
• 节点页面及托盘菜单在全局模式下仅显示 GLOBAL，规则模式显示分流策略组。
• 改善代理切换、内核授权及更新失败后的恢复与诊断。

更新与安装

• 应用更新统一从本仓库的正式 Release 获取，核对版本和安装包完整性。
• 通过 GitHub Actions 构建 Windows、macOS 与 Linux 的 x64／ARM64 安装包。
• macOS 安装包未公证；未配置发布证书时生成未签名安装包。

Download link：

Windows 10/11：

macOS 11+：

Linux：