SurgeStatus

English | 简体中文

macOS 菜单栏工具，显示 Surge 的分流模式，并提供一个精简下拉菜单快捷操作 Surge。

功能

菜单栏图标

• 彩色胶囊图标，颜色随模式变化：规则 = 绿色，全局 = 红色，直连 = 蓝色，未知/未连接用橙/灰
• 跟随系统外观自动切换浅色 / 深色

出站模式

• 直接连接 / 全局代理 / 规则判定，一键切换

策略组

• 显示所有策略组及当前节点，支持切换
• 并发测速，逐个显示延迟徽章，超时/失败标红

临时规则（存在临时规则时显示）

• 查看、单条 / 全部抛弃、切换目标节点或策略组

网页规则（浏览器为前台应用时显示）

• 调用 Surge 原生的「为当前网页设置规则」面板

其它 Surge 功能直通

• 打开 Surge 面板 / 远程面板（Ponte 设备）
• 切换配置文件、重载配置、编辑配置文件、在访达中显示
• 设置为系统代理、增强模式、捕获 HTTP 内容、MitM、重写、脚本

设置

• Host / Port / API Key / TLS
• 开机自动启动
• Surge 意外退出时自动重新打开（默认关闭）
• 界面语言：简体中文 / English

实现方式

• 能通过 Surge 官方 HTTP API 完成的操作（切换模式、策略组、测速、功能开关）走真实接口
• 没有官方 API 的操作（打开面板、切换配置、临时规则等）通过 Accessibility API 调用 Surge 自身菜单里的对应命令
• 所有请求发往本机地址，不经过第三方服务器

安装

需要先在 Surge 配置文件 [General] 段启用 HTTP API：

http-api = your-secret-key@127.0.0.1:6171
http-api-tls = false

首次使用部分功能（读取浏览器网址、控制 Surge 菜单）会弹出「辅助功能」授权请求。

技术栈

Swift + AppKit，SwiftUI 仅用于设置窗口。无第三方依赖。最低系统要求 macOS 13。

已知限制

• 开机自动启动依赖 SMAppService，ad-hoc 签名下可能不生效，可在「系统设置 → 通用 → 登录项」手动添加
• 「Surge 意外退出时自动打开」不处理进程还在但无响应的情况