ClashBar Releases
ClashBar Releases 是 ClashBar 所有版本发布的存档页面,在这里可以下载到最新版的 ClashBar 及历史版本 ClashBar 下载。
ClashBar Releases
最新版本
| 文件 | 大小 | 下载 |
|---|---|---|
| macOS · Apple Silicon · DMG 安装镜像 · 不含内核 | 1.57 MiB | 官方镜像 |
| 文件校验和(用于校验下载文件) | 107 B | 官方镜像 |
| macOS · Apple Silicon · DMG 安装镜像 | 21.16 MiB | 官方镜像 |
| 文件校验和(用于校验下载文件) | 99 B | 官方镜像 |
| macOS · x86_64 · DMG 安装镜像 · 不含内核 | 1.64 MiB | 官方镜像 |
| 文件校验和(用于校验下载文件) | 99 B | 官方镜像 |
| macOS · x86_64 · DMG 安装镜像 | 22.28 MiB | 官方镜像 |
| 文件校验和(用于校验下载文件) | 91 B | 官方镜像 |
更新说明
更新内容
> 本次更新是针对 v0.3.5 的 系统代理 Helper 安装修复:修复从 .dmg 下载安装的场景下,管理员授权装入的 Helper 二进制与 LaunchDaemon plist 仍带 com.apple.quarantine 隔离属性、被系统以「Launch Constraint Violation / Refusing to execute quarantined file」拒绝加载,导致「Helper 已授权但系统代理开关开了不生效」的问题;同时修正安装脚本吞掉 bootstrap / kickstart 失败却照样写入「已安装」版本标记、使坏状态无法自动重试的缺陷。Helper 版本号一并升到 2,老的坏安装会被强制重装恢复。
📝 更新日志 (Changelog)
🚀 优化改进 (Improvements)
- 安装失败不再写入成功标记:安装脚本在
set -e下把launchctl bootstrap(失败时先bootout再重试一次)与kickstart改为硬失败,版本标记echo放在最后一步——任何一步加载失败都会以非零退出并把stderr原文透传回 App,不再写入版本文件,保证下次启动能重新触发安装恢复,而不是被永久锁死在「已安装但不生效」的状态。 - 安装现状检查纳入隔离属性:
installedHelperIsCurrent()除比对版本、校验二进制可执行与 plist 存在外,新增对两个目标文件com.apple.quarantine属性的检查;只要任一文件仍带隔离属性即视为「未正确安装」,自动重新走授权安装流程。
🐞 修复问题 (Bug Fixes)
- Helper 安装后仍带隔离属性导致系统代理不生效:修复 v0.3.5 中经管理员授权装入
/Library/PrivilegedHelperTools/com.clashbar.helper与/Library/LaunchDaemons/com.clashbar.helper.plist的文件仍残留com.apple.quarantine的问题。根因是由带隔离标记的.app(下载安装场景)创建的文件会被内核重新盖上隔离属性,仅靠cp -X不拷贝源 xattr 并不足够;现在拷贝后显式xattr -c+xattr -d com.apple.quarantine清除隔离属性,并在bootstrap前校验,若仍残留则直接失败退出,不再让被系统拒绝加载的 Helper 静默留下「已安装」标记。
What's Changed
- Add changelog page and update documentation structure by @Sitoi in https://github.com/Sitoi/ClashBar/pull/103
Full Changelog: https://github.com/Sitoi/ClashBar/compare/v0.3.2...v0.3.6
历史版本
ClashBar 0.3.5
更新内容
> 本次更新聚焦 系统代理 Helper 安装方式重构与 TUN 协议栈记忆:系统代理 Helper 从 SMAppService 登录项方式改为「管理员授权直装」——首次开启系统代理输入一次管理员密码,Helper 即被安装到系统目录 /Library/PrivilegedHelperTools,之后更新 App 不再失效、无需重新批准后台项目;同时 TUN 协议栈选择改为持久记忆,退出 / 重启 App、重启或启停内核后都会自动恢复到上次选择的栈,而不再回落 mixed。此外状态栏图标改为离屏合成单张模板图,渲染路径更简洁;资源包定位与图标加载逻辑进一步收敛。
📝 更新日志 (Changelog)
✨ 新增功能 (New Features)
- 系统代理 Helper 管理员授权安装:系统代理 Helper 不再走
SMAppService登录项注册与「后台项目批准」链路,改为通过osascript ... with administrator privileges一次性授权后,用cp -X将 Helper 二进制与 plist 安装到/Library/PrivilegedHelperTools及/Library/LaunchDaemons,并写入版本文件、launchctl bootstrap+kickstart拉起。首次开启系统代理时输入一次管理员密码即可,之后 更新 App 不会导致 Helper 失效,也不需要再去「系统设置 → 登录项」重复批准;仅当版本文件与当前 Helper 版本不一致时才会重新请求授权安装。 - TUN 协议栈记忆持久化:记住用户在 Proxy 快捷区选择的 TUN 协议栈;退出 / 重启 App、重启或启停内核后,开启 TUN 会自动恢复到上次选择的栈,而不再无条件回落
mixed。仅当配置文件本身未声明 stack 时才使用保存值,本地目标才写入记忆(远程目标不持久化),启动时若运行态栈与偏好一致则跳过多余 PATCH。
🚀 优化改进 (Improvements)
- 状态栏图标离屏合成:
StatusItemContentView不再继承NSView,改为纯@MainActor类,把图标与速率文字离屏合成为单张模板图直接赋给statusItem.button.image,移除子视图、AutoLayout 约束、透明占位图与 layout 逻辑,渲染路径更短、状态栏刷新更直接。 - 系统代理 Helper 状态精简:围绕新的安装方式重整 Helper 健康检查与错误分支,移除「后台项目授权 / 签名不匹配 / 需批准」等旧登录项相关状态,统一为「已安装 / 授权取消 / 安装失败」等更贴合实际的诊断与提示;
TunPermissionService也复用同一套AdministratorShell授权封装。 - 资源包定位与图标加载简化:收敛
AppResourceBundleLocator与BrandIcon的资源查找逻辑,减少冗余分支,避免打包环境下的资源定位问题。 - 文档与打包脚本更新:文档站同步系统代理排障步骤(首次授权、取消后需再开一次、更新 App 无需重复批准),并补充删除 App 前手动卸载 Helper 的命令;README 增补 Linux DO 社区致谢,图标预处理脚本一并优化。
🐞 修复问题 (Bug Fixes)
- 更新 App 后系统代理 Helper 失效:修复此前经
SMAppService注册的 Helper 在 App 更新后需要重新批准后台项目、否则系统代理开关「开了不生效」的问题;Helper 现直装到系统目录并带版本标记,App 更新不再影响已安装的 Helper。
What's Changed
- Dev by @Sitoi in https://github.com/Sitoi/ClashBar/pull/116
Full Changelog: https://github.com/Sitoi/ClashBar/compare/v0.3.4...v0.3.5
- macOS · Apple Silicon · DMG 安装镜像
ClashBar-21.16 MiB官方下载0. 3. 5- apple- silicon. dmg - macOS · x86_64 · DMG 安装镜像
ClashBar-22.28 MiB官方下载0. 3. 5- intel. dmg
ClashBar 0.3.4
更新内容
> 本次更新在 架构瘦身与窗口行为收敛 的基础上,补齐了一批日常可感知的体验改进:TUN 协议栈支持双击直接切换(含新的 mips 栈选项)、日志面板新增等级切换、状态栏流量曲线保留后台历史、远程订阅内容未变化时跳过重载。工程侧删除了 Repositories 与 UseCases 两层「单一实现」的间接抽象,把逻辑收敛回 Services 与 AppViewModel,减少约 500 行冗余胶水代码而不改变外部行为;同时新增窗口抑制逻辑,彻底禁用 macOS 的窗口状态恢复,避免这个纯菜单栏 App 在启动或系统恢复会话后弹出多余的空白窗口。
📝 更新日志 (Changelog)
✨ 新增功能 (New Features)
- TUN 协议栈双击切换:Proxy 快捷区的 TUN 协议栈 chip 新增双击入口,无论当前 TUN 是否已开,双击某个协议栈即以该栈开启 TUN(
enable+stack原子 PATCH,不再回落mixed);同栈且已开则跳过,关闭仍由行尾开关负责,切换成功后写入「TUN 协议栈已切换为 %@」日志并附悬停/无障碍提示。协议栈选项新增mips(system/gvisor/mixed/mips)。 - mips 协议栈内核版本守卫:
mips协议栈需要 Mihomo v1.19.31 及以上内核;当前内核低于该版本(或版本无法解析)时,mipschip 自动置灰、悬停提示「需升级内核」,点击不会真正下发切换,运行中的 TUN 协议栈保持不变,仅弹出状态栏横幅并记录一条 warning 日志引导升级。 - 日志面板等级切换:Logs 页新增日志等级切换——客户端侧提供按等级筛选的多选 chip(不选即显示全部),仅过滤面板展示内容;同时提供直接调整 Mihomo 内核
log-level的菜单(ConfigLogLevel全部取值,当前值打勾),从源头控制内核输出的日志详细程度。
🚀 优化改进 (Improvements)
- 流量曲线保留后台历史:状态栏流量 sparkline 改为后台持续采样、面板关闭时不再清空历史曲线(仅重置累计总量);重新打开菜单时直接显示已有趋势曲线,不再每次从零开始爬升。
- 远程订阅内容未变时跳过重载:远程配置下载后按内容比对,若与磁盘现有文件完全一致则不写盘、也不刷新状态或重载内核(
writeConfigData返回是否真正写入,仅在写入时触发 reload),避免相同订阅内容触发无意义的内核 reload。 - 移除 Repositories / UseCases 间接层:删除全部只有单一实现的 Repository 与 UseCase 包装类型,把对应逻辑内联回 Config / Core / MihomoAPI / SystemProxy / Tun 等 Services 以及 AppViewModel 各扩展;净减约 500 行胶水代码,调用链更短,外部行为保持不变。
- 窗口状态恢复关闭:注册
NSQuitAlwaysKeepsWindows=false、applicationSupportsSecureRestorableState=false,并对applicationShouldOpenUntitledFile/reopen做拦截,杜绝这个菜单栏 App 因系统会话恢复而残留的无用窗口。 - 日志来源筛选文案精简:日志来源筛选项「全部来源」精简为「全部」(英文对应
All),与其它筛选 chip 的措辞长度对齐。 - 品牌图标资源更新:重新导出运行 / 休眠 / TUN 状态品牌图标与文档站 Logo 资源。
🐞 修复问题 (Bug Fixes)
- 启动/恢复后弹出空白窗口:新增窗口抑制逻辑,在启动、激活及窗口成为 key/main 时排除非面板窗口(跳过
NSPanel、StatusBar / MenuBar / Popover / Alert / 全屏过渡窗口与 sheet),把系统会话恢复或 SwiftUISettings场景产生的空白窗口即时orderOut+close,不再有多余窗口一闪而过或停留。 - 打包脚本
format_bytes静默失效:修复打包脚本中 awk 字节格式化误用保留字index作为循环变量、在部分 awk 实现下不报错也不换算单位的问题,改用idx变量。
What's Changed
- Add changelog page and update documentation structure by @Sitoi in https://github.com/Sitoi/ClashBar/pull/103
- ✨ feat: 更新 README,感谢 Linux DO 社区支持;优化图标处理脚本 by @Sitoi in https://github.com/Sitoi/ClashBar/pull/112
- ✨ feat: 优化图标加载逻辑,简化资源包定位 by @Sitoi in https://github.com/Sitoi/ClashBar/pull/114
Full Changelog: https://github.com/Sitoi/ClashBar/compare/v0.3.2...v0.3.4
- macOS · Apple Silicon · DMG 安装镜像
ClashBar-21.15 MiB官方下载0. 3. 4- apple- silicon. dmg - macOS · x86_64 · DMG 安装镜像
ClashBar-22.28 MiB官方下载0. 3. 4- intel. dmg
ClashBar 0.3.3
更新内容
> 本次更新集中在 内核日志洪泛治理与菜单栏快捷键可用性:修复 mihomo TUN 句柄失效后日志刷屏导致 ClashBar 内存涨到 3.2 GB、CPU 占用 230% 的问题,在日志管道源头加入限流与重复折叠;同时修复菜单命令状态冻结(⌘E 永久灰掉)和大写快捷键被隐式附加 ⇧ 的问题,补齐 ⌃⌘1/2/3 模式切换,并为所有快捷键操作补上状态栏横幅反馈。此外菜单栏图标在 TUN 模式下有了独立形态,代理页新增延迟历史显示开关,文档站也上线了自动生成的更新日志页面。
📝 更新日志 (Changelog)
✨ 新增功能 (New Features)
- 模式切换快捷键:新增
⌃⌘1/⌃⌘2/⌃⌘3分别切换到 Rule / Global / Direct 模式,内核不可用时自动置灰。 - 快捷键操作横幅反馈:菜单栏快捷键在面板关闭时触发也会给出确认——系统代理开关、TUN 开关、模式切换、内核启动/重启/停止、复制终端代理命令成功后都会弹出状态栏横幅,不再出现「按了没反应」的错觉。
- 菜单栏 TUN 图标:新增 BrandTun 品牌图标,内核运行且 TUN 开启时替换为 TUN 形态图标,一眼区分当前是否走 TUN;缺图时回退到运行图标,避免品牌图与 SF Symbol 互跳。
- 延迟历史显示开关:代理组标题栏新增开关,可在「最近 4 次延迟信号条」与「仅最新一次延迟」之间切换,状态本地持久化;代理组行与节点弹窗同步生效。
- 文档站更新日志页:文档站新增 Changelog 页面,直接解析仓库
CHANGELOG.md生成版本时间线,无需手工同步两份内容。
🚀 优化改进 (Improvements)
- 移除「重新加载配置」菜单项:删除快捷操作菜单中的重载配置入口与
⌘R快捷键,配置变更已由文件监听自动处理,文档同步更新。 - 状态栏渲染去重简化:删除与
MenuBarDisplay逐字段重复的StatusItemRenderKey,渲染键直接复用显示模型,仅在使用品牌图标时忽略 symbolName,减少一层等价类型。 - 品牌图标资源瘦身:重新压缩运行 / 休眠状态图标资源,单张体积减少约 60%。
- 文档站工程重构与部署:文档站迁移到
src/目录结构、改用 OpenNext + Cloudflare Workers 部署,移除自定义 MDX loader 与 shim,补充站点图标、缓存头与中间件配置。
🐞 修复问题 (Bug Fixes)
- 核心日志洪泛导致内存与 CPU 失控 (#102, #88):修复 mihomo TUN 文件描述符失效后以约 16 万行/秒重复输出
batch read packet错误,日志管道逐行回调、逐行创建主线程任务,导致任务队列与字符串无限堆积、ClashBar 占用 3.2 GB 内存和 230% CPU 的问题;现在在日志管道源头加入背压闸门(1 秒窗口内折叠连续重复行并限流 200 行,丢弃数量随下一条日志一并报出),下游日志缓冲与写盘队列随之自动有界,写盘频率从约 4000 次/秒降至约 5 次/秒。 - 菜单命令状态冻结、
⌘E永久不可用:修复菜单命令内联在App中导致不观察应用状态,.disabled(...)与按钮标题被冻结在启动时刻的问题;此前 TUN 开关与内核启停命令会一直保持启动瞬间的禁用状态,与面板中实际可用的开关互相矛盾。 - 快捷键被隐式附加
⇧:修复快捷键使用大写字母定义时系统会把输入该字符所需的⇧折进组合键的问题(⌘R实际变成⌘⇧R),现统一使用小写字符定义。 - 内核重启期间系统代理恢复报错:修复内核重启时写入配置目录触发的文件事件会取消正在执行的防抖任务,导致系统代理恢复流程抛出
URLError.cancelled的问题。 - 延迟信号条显示错位:修复关闭延迟历史时保留的是最矮的一根信号条而非代表最新延迟的那根的问题。
What's Changed
- docs(README): 修复失效的 Star 趋势图表 by @FaintFlower in https://github.com/Sitoi/ClashBar/pull/101
- Add changelog page, update documentation, and enhance proxy features by @Sitoi in https://github.com/Sitoi/ClashBar/pull/104
New Contributors
- @FaintFlower made their first contribution in https://github.com/Sitoi/ClashBar/pull/101
Full Changelog: https://github.com/Sitoi/ClashBar/compare/v0.3.2...v0.3.3
- macOS · Apple Silicon · DMG 安装镜像
ClashBar-17.53 MiB官方下载0. 3. 3- apple- silicon. dmg - macOS · x86_64 · DMG 安装镜像
ClashBar-18.65 MiB官方下载0. 3. 3- intel. dmg
ClashBar 0.3.2
更新内容
> 本次更新集中在 延迟趋势可视化与官方文档站上线:节点延迟从「单次结果」升级为保留最近 4 次样本,代理组列表与节点弹窗以信号条形式展示近期趋势;本地测速与 API/提供者历史会合并保留,刷新后不再轻易丢掉刚测出的结果。同时新增完整的 ClashBar 文档站(快速开始、功能总览、排障等),并重写 README 入口与站内链接。
📝 更新日志 (Changelog)
✨ 新增功能 (New Features)
- 延迟趋势信号条:代理组当前节点行与节点弹窗的延迟展示由单色块改为最多 4 根信号条,按时间对齐最近若干次延迟样本并着色;最新一次延迟仍以等宽数字显示,超时继续显示「超时」文案而非 0。
- 官方文档站:新增基于 Fumadocs 的文档站点,覆盖快速开始(含 Core / 无 Core)、配置与订阅、日常使用、系统代理与 TUN、SSID 策略、远程机器、设置维护、常见问题与关于页;README 同步指向 clashbar.sitoi.cn。
🚀 优化改进 (Improvements)
- 延迟样本链路重构:接口与模型由「仅最新延迟」改为最近 4 次样本序列;组测速 / 单节点测速写入同一套样本,并与 Mihomo API 返回的 history 合并,避免面板刷新后本地测量结果被覆盖。
- 提供者与嵌套组回填:解析代理提供者节点的类型与延迟历史,补充展示用类型信息;延迟查询沿选择链回退到实际叶子节点样本,嵌套代理组展示更准确。
- 文档入口与链接维护:精简主 README 安装与上手说明,统一官网与 Releases 链接;文档站内链改为
/docs/*绝对路径,避免无尾斜杠路由下相对链接失效。
- macOS · Apple Silicon · DMG 安装镜像
ClashBar-16.45 MiB官方下载0. 3. 2- apple- silicon. dmg - macOS · x86_64 · DMG 安装镜像
ClashBar-17.51 MiB官方下载0. 3. 2- intel. dmg
ClashBar 0.3.1
更新内容
> 本次更新集中在 代理组图标展示与长期运行稳定性:代理组现在可展示 Mihomo 配置返回的远程图标,并通过内存与磁盘缓存减少重复下载;同时重构配置文件监听、网络恢复、远程主机探测、日志写入与菜单栏状态刷新,提升配置编辑、网络切换和应用退出等场景下的可靠性与响应效率。
📝 更新日志 (Changelog)
✨ 新增功能 (New Features)
- 代理组远程图标:支持读取并展示 Mihomo 代理组返回的图标地址,在代理组列表和节点弹窗标题中呈现对应图标;图标采用内存与磁盘双层缓存,并限制单文件大小、缓存总量与文件数量,减少重复请求和长期磁盘占用。
🚀 优化改进 (Improvements)
- 配置文件监听升级:使用文件系统事件监听配置目录与当前选中的 YAML 文件,替代持续轮询;新增、删除、重命名及直接编辑配置后可及时刷新列表,并仅在当前配置实际变化时重启本地内核。
- 网络恢复流程简化:网络状态监控改为始终启用,断网时自动暂停内核与轮询、网络恢复后自动继续运行,并移除不再需要的「断网停核」开关,减少状态分支和恢复失败风险。
- 菜单栏刷新性能优化:拆分代理、流量、日志与状态栏数据的观察范围,仅在数据真正变化时触发对应界面刷新,降低实时流量、日志和代理状态更新造成的无关重绘。
- 远程主机连接检测优化:复用网络会话并统一管理连接探测任务,新的检查会取消旧请求,避免过期结果覆盖当前状态;删除或修改远程主机时也会同步清理相关任务。
- 应用生命周期与日志处理增强:统一应用依赖和后台任务的启动、取消流程,退出前等待 ClashBar 与 Mihomo 日志写入完成,并保持日志轮转顺序,减少任务残留与日志丢失。
🐞 修复问题 (Bug Fixes)
- 修复直接编辑配置未被发现的问题:补充对当前配置文件本身的监听,可识别编辑器原地写入以及原子替换文件等保存方式,避免修改后配置列表或内核未刷新。
- 修复远程图标缓存异常:合并同一地址的并发下载,校验 HTTP 状态与图片数据,并使用原子写入和缓存清理,避免无效响应、损坏文件或重复请求影响图标显示。
- 修复远程连接状态被旧请求覆盖的问题:为探测任务增加取消与代次校验,防止慢请求在目标切换、配置修改或主机删除后写回过期状态。
- 修复版本信息缺失时的请求标识:无法读取 Mihomo 版本时使用默认版本作为 User-Agent 回退值,不再发送包含
unknown的请求标识,提高远程配置请求兼容性。
- macOS · Apple Silicon · DMG 安装镜像
ClashBar-16.57 MiB官方下载0. 3. 1- apple- silicon. dmg - macOS · x86_64 · DMG 安装镜像
ClashBar-17.64 MiB官方下载0. 3. 1- intel. dmg
ClashBar 0.3.0
更新内容
> 本次更新集中在 Geo 数据库一键更新与延迟显示、菜单栏交互细节打磨:System 维护区新增「更新 Geo 数据库」按钮,内核运行时可直接调用 mihomo /upgrade/geo 接口刷新 GeoIP / GeoSite 数据,并带进行中 / 成功 / 失败状态反馈与日志,无需重启内核或手动替换数据库文件;代理组路由行与节点弹窗的延迟徽章改为「迷你色块 + 等宽数字」呈现,纵向对比更整齐、可读性更好,超时节点直接显示「超时」文案而不再展示无意义的 0;顶部品牌图标也变为可点击入口,一键打开项目主页。
📝 更新日志 (Changelog)
✨ 新增功能 (New Features)
- Geo 数据库一键更新:在 System 设置页「系统维护」区域新增「更新 Geo 数据库」按钮,内核运行时可直接触发 mihomo
/upgrade/geo接口刷新 GeoIP / GeoSite 数据库;更新过程中按钮展示进行中状态,完成后给出成功 / 失败反馈并写入日志,约 4 秒后自动恢复,无需重启内核或手动替换数据库文件。 - 点击顶部图标访问项目主页:菜单栏顶部的 ClashBar 品牌图标改为可点击入口,单击即可在浏览器打开项目 GitHub 主页,并补齐悬停提示与无障碍标签。
🚀 优化改进 (Improvements)
- 延迟徽章视觉重做:代理组路由行与代理组节点弹窗的延迟显示统一改为「迷你色块 + 等宽数字」徽章,色块按延迟高低着色、数字使用等宽字体,多节点纵向对比时更整齐易读;同时移除组路由行末尾冗余的箭头图标并微调列宽,为延迟列留出更多空间。
- 超时延迟显示文案而非 0:延迟徽章在节点超时(延迟为 0)时直接显示「超时 / Timeout」文案,不再展示无意义的「0」,节点状态更直观。
- macOS · Apple Silicon · DMG 安装镜像
ClashBar-16.30 MiB官方下载0. 3. 0- apple- silicon. dmg - macOS · x86_64 · DMG 安装镜像
ClashBar-17.34 MiB官方下载0. 3. 0- intel. dmg
ClashBar 0.2.9
更新内容
> 本次更新集中在 规则页面的筛选检索体验与菜单栏快捷键重构:分流(Rules)页面新增按类型 / 策略筛选、关键字搜索与按策略分组折叠展示,分组状态本地持久化,规则数量再多也能快速定位;菜单栏命令菜单整合为统一的「快捷操作」菜单,把系统代理、TUN、复制代理命令、重载配置等常用动作集中并补齐快捷键。同时把规则保留上限大幅提升以适配大型规则集,并修复状态栏 M/s 量级速率文本被截断的问题。
📝 更新日志 (Changelog)
✨ 新增功能 (New Features)
- 规则筛选、搜索与分组:分流页面新增类型(域名 / IP / 规则集 / 其他)与策略 chip 筛选、关键字搜索,类型 chip 实时显示命中计数;支持按策略分组折叠展示,分组开关状态本地持久化,规则较多时能更快定位目标规则。
- 菜单栏快捷操作菜单:将原有 Core / Actions 命令菜单整合为统一的「快捷操作」菜单,集中系统代理开关、TUN 模式开关、复制本地 / 当前控制端代理命令、重新加载配置等常用动作,并补齐
⌘S/⌘E/⌘C/⌘⌥C/⌘R等快捷键。
🚀 优化改进 (Improvements)
- 规则保留上限提升:规则保留上限从 100 条提升至 20,000 条(等效无限制),适配大型规则集;该上限仅用于防止异常配置撑爆内存。
- 筛选组件复用:提取共享的筛选 chip 组件,日志页改为复用同一实现,筛选交互在规则页与日志页保持一致。
🐞 修复问题 (Bug Fixes)
- 状态栏速率文本截断:修复状态栏在 M/s 量级速率下文本被截断的问题,将速率显示宽度从 38 调整为 43。
- macOS · Apple Silicon · DMG 安装镜像
ClashBar-16.29 MiB官方下载0. 2. 9- apple- silicon. dmg - macOS · x86_64 · DMG 安装镜像
ClashBar-17.34 MiB官方下载0. 2. 9- intel. dmg
ClashBar 0.2.8
更新内容
> 本次更新集中在 日志文件体积治理、软链接配置的完整支持、配置校验报错体验与 UI 主题统一:磁盘日志改为基于大小的滚动归档(单文件 10MB、保留 5 份),彻底告别无限膨胀;软链接配置现在能正确出现在列表中、用自身目录作为内核工作目录并参与外部改动检测;配置校验失败弹窗支持滚动查看长报错、一键复制详情,并针对 GEO 相关错误给出排查提示;同时把全局 UI 收敛到统一主题常量与系统原生配色。
📝 更新日志 (Changelog)
✨ 新增功能 (New Features)
- 配置校验错误可滚动查看与复制:配置校验失败弹窗改为可滚动视图,支持完整查看超长错误信息并一键“复制详情”,便于反馈问题;同时针对 GEO 数据库等常见配置错误补充了智能排查提示。
🚀 优化改进 (Improvements)
- 日志策略简化:移除可配置的“最大日志条目数”设置,应用内 Logs 面板改用固定 5,000 条视窗;磁盘日志体积统一交由基于大小的滚动归档管理,配置项更精简。
- UI 主题统一:将菜单栏界面收敛到统一的主题常量与布局 token,使用系统原生配色替代自定义主题色,字号对齐 macOS HIG,整体观感更一致、维护成本更低。
🐞 修复问题 (Bug Fixes)
- 日志文件无限膨胀 (#78):修复磁盘日志文件持续增长无上限的问题;现在采用基于大小的滚动归档(单文件超过 10MB 即滚动,最多保留 5 份历史),避免日志占满磁盘。
- 软链接配置处理修正:修复软链接配置文件不出现在配置列表、内核工作目录被错误指向链接目标父目录、以及外部编辑无法触发变更检测的问题;现在按解析后的目标类型列出配置,并以配置自身所在目录作为工作目录。
What's Changed
- fix(logs): prevent mihomo.log from growing without bound by @xccduck in https://github.com/Sitoi/ClashBar/pull/78
New Contributors
- @xccduck made their first contribution in https://github.com/Sitoi/ClashBar/pull/78
Full Changelog: https://github.com/Sitoi/ClashBar/compare/v0.2.7...v0.2.8
- macOS · Apple Silicon · DMG 安装镜像
ClashBar-16.29 MiB官方下载0. 2. 8- apple- silicon. dmg - macOS · x86_64 · DMG 安装镜像
ClashBar-17.31 MiB官方下载0. 2. 8- intel. dmg
ClashBar 0.2.7
更新内容
> 本次更新集中在 日志管理、订阅配置验证、配置文件软链接支持与 macOS 26.5.1 兼容性修复:新增可配置的日志容量设置,默认无限制,用户可根据需要选择 1K 到 50K 条限制;订阅更新现在会验证配置内容,拒绝过期提示等非法内容,避免内核崩溃和日志爆炸;配置目录支持软链接指向外部配置文件,方便跨设备同步;同时修复 macOS 26.5.1+ 菜单栏图标不可见的问题,并优化菜单栏显示逻辑。
📝 更新日志 (Changelog)
✨ 新增功能 (New Features)
- 可配置的日志容量:在 System 设置页面新增"最大日志条目数"选项,默认无限制,可选择 1,000 / 5,000 / 10,000 / 20,000 / 50,000 条限制,替代原有硬编码的 200 条上限。
- 订阅配置内容验证 (#80):订阅更新时会验证返回内容是否为合法的 Clash 配置,拒绝纯文本提示、HTML 页面等非法内容,防止错误配置覆盖导致内核 reload 失败和日志风暴。
- 配置文件软链接支持 (#74):配置目录现在支持软链接(symlink)指向外部配置文件,方便使用 mackup 等工具进行跨设备配置同步,兼容其他 Clash 客户端的使用习惯。
🚀 优化改进 (Improvements)
- 菜单栏行为优化:改进菜单栏打开/关闭时的状态清理逻辑,避免代理组信息在重新打开时闪烁;停止内核时清除代理展示状态,避免停止后仍显示过期信息。
- 远程机器状态管理:优化远程机器验证会话的失效处理,在切换或断开时正确清理验证状态。
🐞 修复问题 (Bug Fixes)
- macOS 26.5.1+ 菜单栏图标不可见 (#82):修复在 macOS 26.5.1 及更高版本上菜单栏图标无法显示的问题;通过设置透明占位图片确保 ControlCenter 识别 status item 有内容并正确渲染。
- 订阅过期导致日志爆炸 (#80):修复订阅过期后服务器返回错误提示文本被当作配置写入,导致内核反复 reload 失败、触发 TUN 句柄错误、CPU 占用 100% 和日志文件在短时间内膨胀到数十 GB 的问题。
- 配置软链接无法识别 (#74):修复配置目录中的软链接文件无法被识别为有效配置的问题;现在安全检查会验证软链接本身是否在安全目录内,而不是解析到真实路径进行检查。
What's Changed
- fix(menu-bar): avoid proxy group flicker on reopen by @MacbClarke in https://github.com/Sitoi/ClashBar/pull/72
New Contributors
- @MacbClarke made their first contribution in https://github.com/Sitoi/ClashBar/pull/72
Full Changelog: https://github.com/Sitoi/ClashBar/compare/v0.2.6...v0.2.7
- macOS · Apple Silicon · DMG 安装镜像
ClashBar-16.28 MiB官方下载0. 2. 7- apple- silicon. dmg - macOS · x86_64 · DMG 安装镜像
ClashBar-17.30 MiB官方下载0. 2. 7- intel. dmg
ClashBar 0.2.6
更新内容
> 本次更新集中在 菜单栏窗口固定、Proxy 页面操作密度与流量曲线显示稳定性:Header 新增固定按钮,可让主窗口在切换应用或点击外部时继续保持显示;Proxy Providers 区域支持折叠并记住状态,代理组标题也补上了快捷延迟测试入口;同时流量 Sparkline 改为固定 60 点滑动窗口,避免短序列被拉满整段宽度导致趋势判断失真。
📝 更新日志 (Changelog)
✨ 新增功能 (New Features)
- 菜单栏窗口固定模式:Header 新增固定 / 取消固定按钮;固定后主窗口会保留在所有 Space 中,并且点击外部区域不会自动关闭,适合需要持续观察代理状态、连接列表或日志的场景。
- Proxy Providers 折叠控制:Proxy 页面中的 Providers 区域新增展开 / 折叠按钮,并通过本地偏好保存折叠状态,订阅较多时可以减少页面占用。
- 代理组快捷延迟测试:代理组弹出面板标题区新增延迟测试按钮,可以直接对当前代理组触发测速,不必再进入更深层级寻找操作。
🚀 优化改进 (Improvements)
- 流量曲线固定窗口:状态栏流量 Sparkline 改为固定 60 点滑动窗口,最新数据从右侧推进,历史点按固定间距保留,短数据序列不再被强行铺满整个图表。
- 流量面积填充对齐真实数据:Sparkline 面积闭合改为使用首尾真实数据点的横坐标,避免数据不足时填充区域延伸到不存在的时间段。
- 本地化文案补齐:补充展开、折叠、固定和取消固定的中英文文案,让新增控件的无障碍标签与悬停提示保持一致。
What's Changed
- feat(ui): improve UX with Pin mode, scrollable alerts, and sparkline enhancements by @TakahashiMinato in https://github.com/Sitoi/ClashBar/pull/70
New Contributors
- @TakahashiMinato made their first contribution in https://github.com/Sitoi/ClashBar/pull/70
Full Changelog: https://github.com/Sitoi/ClashBar/compare/v0.2.5...v0.2.6
- macOS · Apple Silicon · DMG 安装镜像
ClashBar-15.92 MiB官方下载0. 2. 6- apple- silicon. dmg - macOS · x86_64 · DMG 安装镜像
ClashBar-16.93 MiB官方下载0. 2. 6- intel. dmg
ClashBar GitHub 仓库列表
- ClashBar GitHub
- ClashBar 官网 Github 仓库:https://github.com/Sitoi/ClashBar
- ClashBar 专题:https://github.com/topics/clashbar
- ClashBar 搜索:https://github.com/search?q=clashbar


