简体中文 | English

原生 macOS 代理客户端
基于 Mihomo 内核 · SwiftUI 构建 · 流畅不妥协

• 原生菜单栏 — NSStatusBar 手动管理菜单栏图标，N 字母图标，弹出面板支持节点切换 / 模式切换 / 延迟测试
• Dashboard 主窗口 — 深色主题 + 光束背景，概览卡片聚合订阅/连接/日志/节点信息
• 订阅管理 — 添加 / 刷新 / 删除，定时自动刷新，流量用量仪表盘
• 并发延迟测试 — 渐变色徽章动画反馈，支持批量与单点测速
• 系统代理免密切换 — 通过 Helper Tool（XPC）免密设置，networksetup 实时读取状态
• 实时流量图 — WebSocket 推送，Canvas + TimelineView 60fps 渲染
• 日志查看器 — WebSocket 流式推送，级别过滤、文字搜索、自动滚动
• 活跃连接检视 — 可排序表格，搜索过滤，单条/批量强制断开
• 开机自启 · 暗色/浅色/跟随系统 · Sparkle 2 自动更新 · 全局错误 Toast

尚未正式发布。 可通过 GitHub Releases 下载预构建版本，或按下方 开发 章节自行构建。

# 1. 下载最新版 NekoLink-x.x.x.zip 并解压
# 2. 首次运行需绕过 Gatekeeper（因未签名）：
xattr -dr com.apple.quarantine NekoLink.app
# 3. 正常打开
open NekoLink.app

你也可以 右键 → 打开，在弹出的对话框中点击「打开」。

TUN 模式落地后，将通过 Developer ID 签名 + 公证提供正式版本，届时可直接双击运行。

• macOS 14+
• Xcode 16+（Swift 6.0）
• mihomo 通用二进制（arm64 / x86_64）

# 放入 mihomo 内核（从 GitHub Releases 获取）
curl -L -o NekoLink/Resources/mihomo \
  https://github.com/MetaCubeX/mihomo/releases/latest/download/mihomo-darwin-arm64
chmod +x NekoLink/Resources/mihomo

# 打开 Xcode 工程（已预生成，包含 extension target）
open NekoLink.xcodeproj

或者使用项目根目录的快速构建脚本（Debug 构建 + 自动重启）：

./preview.sh

优先级从高到低：

1. App Bundle 内 Resources/mihomo
2. ~/.config/nekolink/mihomo
3. /opt/homebrew/bin/mihomo
4. /usr/local/bin/mihomo

SwiftUI 视图层（菜单栏弹出面板 + Dashboard 主窗口）
        │
        ▼
AppModel（全局状态，Observation）
        │
        ▼
Service 层
├─ CoreManager          → mihomo 进程托管
├─ MihomoAPI            → RESTful HTTP 客户端
├─ TrafficMonitor       → WebSocket 流量推送
├─ LogStream            → WebSocket 日志推送
├─ ConnectionMonitor    → WebSocket 连接推送
├─ SubscriptionService  → 订阅拉取 / 解析
├─ SystemProxyService   → Helper XPC 免密代理
├─ TunnelManager        → TUN 模式
├─ MenuBarManager       → NSStatusBar 菜单栏
├─ LaunchAtLoginService → SMAppService 开机自启
├─ AppearanceService    → 主题持久化
└─ UpdaterService       → Sparkle 2 自动更新
        │
        ▼
内核层：mihomo 二进制（Resources 内置）

当前里程碑：M0–M2 已完成，M4 打磨基本完成，待 M3 TUN 模式与 M5 公证发布。详见 落地计划.md。

• 菜单栏 App（MenuBarExtra）+ 节点切换 / 模式切换 / 延迟测试
• Dashboard 主窗口（深色主题 + 光束背景 + 概览卡片）
• 订阅管理（增删改、定时自动刷新、流量用量仪表盘）
• 系统代理免密切换（Helper Tool XPC）
• 实时流量图（Canvas + TimelineView 60fps）
• 日志查看器（流式、可过滤、可搜索）
• 活跃连接管理（检视 / 搜索 / 批量强制断开）
• Dock 图标常驻 + 点击恢复主窗口
• 开机自启（SMAppService）
• 暗色 / 浅色 / 跟随系统
• 全局错误 Toast 提示
• Sparkle 2 自动更新（已接入框架，待填 SUPublicEDKey + appcast）

• TUN 模式（NetworkExtension / PacketTunnelProvider）—— M3
• 可视化规则编辑器
• 多 profile 切换 + diff 预览
• iCloud 同步订阅
• Developer ID 签名公证 & 首个 GitHub Release —— M5

App 已集成 Sparkle 2，以下是完整发布流程。

# 通过 SPM 拉到的 Sparkle 工具位于 ~/Library/Developer/Xcode/DerivedData/.../SourcePackages/artifacts/sparkle/...
# 推荐另装一份独立工具：
brew install --cask sparkle
generate_keys              # 私钥写入 Keychain；公钥打印到终端

将打印出的 EdDSA 公钥填入 NekoLink/Info.plist 的 SUPublicEDKey。

Info.plist 中 SUFeedURL 默认为 https://nekolink.app/appcast.xml。按实际 Releases 站点替换。

# 构建 Release，得到 NekoLink.app
xcodebuild -project NekoLink.xcodeproj -scheme NekoLink -configuration Release \
  -derivedDataPath build

# 用 Developer ID 签名 + 公证，产出 NekoLink-<ver>.zip
# 然后生成/更新 appcast：
generate_appcast ./releases/        # 目录里放所有历史版本 zip

将 appcast.xml 与 zip 一起上传到 SUFeedURL 指向的位置。

App 启动时会按 SUScheduledCheckInterval（默认 24h）自动检查；用户也可在 菜单栏 → 检查更新 或 设置 → 关于 → 立即检查 手动触发。

欢迎 Issue 与 PR！详见 CONTRIBUTING.md，包含开发环境、代码规范与 PR checklist。

• Mihomo — 真正干活的代理内核
• Yams — YAML 解析
• Sparkle — 自动更新框架
• XcodeGen — Xcode 工程生成

MIT © NekoLink contributors.