功能总览
ClashBar 全部主要能力一览，并链到对应使用说明。
本页按真实产品界面与能力梳理 ClashBar 能做什么。每一项都对应菜单栏面板、设置或快捷操作中的实际入口；需要操作步骤时，请跟随右侧链接进入专题页。
范围说明：这里覆盖用户可感知的产品能力（标签页、内核、配置、网络接管、远程控制、排障与维护等），不展开私有实现细节，也不替代完整的 Mihomo YAML 参考手册。
安装推荐使用 Homebrew（brew install --cask clashbar）或 GitHub Releases；含 Core / 无 Core 构建与注意事项见 快速开始。配置目录仅识别 .yaml / .yml，并按文件名排序加载，见 配置与订阅。
| 能力 | 说明 | 文档 |
|---|
| 菜单栏面板 | 点击状态栏图标打开原生面板，集中管理配置、节点、规则、连接、日志与设置 | 日常使用 |
| 面板固定 | 将面板固定在屏幕上，切换其它应用时不自动关闭 | 日常使用 |
| 状态栏样式 | 仅图标 / 仅速度 / 图标 + 速度，展示上下行速率 | 设置与维护 |
| 外观与语言 | 跟随系统 / 浅色 / 深色；界面语言简体中文或 English | 设置与维护 |
| 项目主页入口 | 面板标题可跳转到项目主页 | — |
| 能力 | 说明 | 文档 |
|---|
| 启动 / 停止 / 重启内核 | 控制本机 mihomo 进程；状态显示运行中、启动中、已停止、异常 | 快速开始 |
| 启动前配置校验 | 启动前对当前 YAML 执行校验，失败时阻断启动并提示日志 | 配置与订阅、常见问题 |
| 内核目录 | 运行时内核位于 ~/Library/Application Support/clashbar/core/mihomo | 快速开始 |
| 在访达中打开内核目录 | 方便替换或检查二进制 | 设置与维护 |
| 升级 Core | 在内核运行中检查并更新 mihomo 内核（面板页脚） | 设置与维护 |
| 网络断开自动停核 | 检测到离线可停止内核，网络恢复后按设置自动再启动 | 设置与维护 |
| 内核自启 | 应用启动后自动拉起内核（设置开关） | 设置与维护 |
| 开机自启 | 登录 macOS 时自动打开 ClashBar | 设置与维护 |
| 能力 | 说明 | 文档 |
|---|
| 导入本地 YAML | 将本机配置复制到应用配置目录 | 配置与订阅 |
| 导入订阅链接 | 按 HTTP(S) 下载订阅并保存为 YAML；可自定义文件名 | 配置与订阅 |
| 切换配置 | 在本地 / 远程配置列表中选择当前生效配置 | 配置与订阅 |
| 刷新单个订阅 | 对订阅配置立即重新下载 | 配置与订阅 |
| 批量更新订阅 | 更新全部已保存的订阅来源 | 配置与订阅 |
| 订阅自动更新 | 按间隔（小时）自动刷新远程配置 | 配置与订阅 |
| 复制订阅链接 / 删除配置 | 右键或菜单操作订阅与本地配置 | 配置与订阅 |
| 重载配置列表 / 重新加载配置 | 重新扫描目录，或让运行中内核重读当前配置 | 配置与订阅 |
| 在访达中显示配置目录 | 打开 …/clashbar/config | 配置与订阅 |
| 目录变更监听 | 外部修改配置目录时，应用可感知并配合重启/刷新 | 配置与订阅 |
| 能力 | 说明 | 文档 |
|---|
| 代理组 | 在分组中选择节点或策略 | 日常使用 |
| 代理提供者 | 查看提供者列表，手动刷新；展示流量与到期信息（若返回） | 日常使用 |
| 延迟测试 | 对节点测延迟，可按延迟排序 | 日常使用 |
| 显示 / 隐藏 hidden 组 | 控制配置中标记为 hidden 的代理组是否展示 | 日常使用 |
| 规则 / 全局 / 直连 | 顶部模式切换，对应 Mihomo 的 rule / global / direct | 日常使用 |
| Providers 批量刷新 | 切换配置或维护流程中可更新代理/规则提供者 | 日常使用 |
| 能力 | 说明 | 文档 |
|---|
| 分流规则列表 | 查看当前规则；按目标/类型/策略搜索 | 日常使用 |
| 按策略分组 / 过滤 | 列表或按策略分组查看，统计规则与规则集数量 | 日常使用 |
| 活动连接 | 实时连接列表，搜索域名/IP，按 TCP/UDP 等筛选 | 日常使用 |
| 连接排序与关闭 | 按时间或流量排序；关闭单条或全部连接 | 日常使用 |
| 复制连接信息 | 复制 Host、连接 ID 等 | 日常使用 |
| 运行日志 | 过滤级别（信息/警告/错误）与来源（ClashBar / Mihomo） | 日常使用 |
| 日志检索与复制 | 搜索、复制单条/全部、清空日志 | 日常使用 |
| 能力 | 说明 | 文档 |
|---|
| Wi‑Fi 自动切换总开关 | 开启后可根据当前 SSID 自动切换配置 | SSID 策略 |
| 绑定 / 解绑当前 Wi‑Fi | 将当前网络绑定到某份配置，或解除绑定 | SSID 策略 |
| 定位 / Wi‑Fi 权限 | 读取 SSID 需要系统定位相关权限 | SSID 策略 |
| 能力 | 说明 | 文档 |
|---|
| 本机 / 远程切换 | 控制目标在本机内核与已保存的远程 External Controller 之间切换 | 远程机器 |
| 远程机器管理 | 添加、编辑、删除远程主机（名称、地址、端口、密钥） | 远程机器 |
| 连接状态 | 探测远程可达性与版本信息 | 远程机器 |
| 远程只读边界 | 远程模式下部分本机专属操作（如改配置文件、TUN）受限 | 远程机器 |
| 能力 | 说明 | 文档 |
|---|
| 实时上下行速率 | 状态栏与面板展示当前速度 | 日常使用 |
| 流量曲线 | 面板内速率火花图（可视化近期流量） | 日常使用 |
| 连接 / 日志 / 流量数据流 | 通过 API/WebSocket 持续拉取运行态 | 日常使用 |
| 能力 | 说明 | 文档 |
|---|
| 允许局域网 / IPv6 / TCP 并发 | 覆盖当前运行配置中的内核开关 | 设置与维护 |
| 日志级别 | 调整内核 log-level | 设置与维护 |
| 代理端口 | HTTP、SOCKS、混合、重定向、TProxy 端口编辑与应用 | 设置与维护 |
| 清理 DNS / FakeIP 缓存 | 维护类一键操作 | 设置与维护 |
| 更新 Geo 数据库 | 拉取/更新 GEO 资源（内核运行中） | 设置与维护 |
菜单命令在应用前台时可用。完整表与限制说明见 日常使用 · 键盘快捷键。
| 能力 | 说明 | 文档 |
|---|
| 复制终端代理命令 | 导出当前代理环境变量命令，供当前终端会话使用 | 日常使用 |
| 复制当前端点命令 | 按当前控制端点（本机或远程）生成命令 | 日常使用、远程机器 |
| 退出应用 | 面板头部退出 | — |
除上下行速率与连接列表外，节点页还可关注连接数、内存等运行态指标（以当前版本面板展示为准），用于快速判断「慢、断、不通」。
运行时根目录：~/Library/Application Support/clashbar
| 子目录 | 用途 |
|---|
config/ | 本地 YAML 与订阅结果（仅 .yaml / .yml，按名排序） |
core/ | mihomo 可执行文件 |
icon/ | 代理组图标磁盘缓存 |
ui/ | Mihomo External UI 静态资源（按配置由内核生成） |
logs/ | 运行与排障日志 |
state/ | 应用状态（建议由程序维护） |
发现规则与备份建议见 配置与订阅。排障见 常见问题。设计初心与体积对比见 关于。
与文档侧栏一致，按使用阶段推进：
- 入门：快速开始 → 本页（功能总览）
- 使用：配置与订阅 → 日常使用 → 系统代理与 TUN → 设置与维护
- 进阶：SSID 策略 → 远程机器
- 帮助：常见问题 → 关于
