NetXD

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #typescript #go #machine-learning #deep-learning #cli #kubernetes #awesome-list #pytorch #security #mcp

(★ 14)

Native macOS menu bar network status, Wi-Fi switching, and cellular monitoring.

NetXD Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">NetXD</h1>

<p align="center">
  用一个原生、轻巧的 macOS 菜单栏工具，统一查看 Wi‑Fi 与 LTE 网络。
</p>

<p align="center">
  <a href="https://github.com/Trouwlikesnow/NetXD/releases/latest">下载</a> ·
  <a href="docs/INSTALL.md">安装说明</a> ·
  <a href="#从源码构建">从源码构建</a>
</p>

## 为什么做 NetXD

[DJOneHub](https://github.com/ZenGeekLabs/DJOneHub) 让大疆第一代 4G 模块能够在
Apple Silicon Mac 上作为 LTE 网卡使用，但查看蜂窝信号、运营商和连接状态需要
打开独立管理页面；macOS 自带菜单栏又只关注 Wi‑Fi。

NetXD 正是为解决这个割裂体验而生：它基于 DJOneHub 提供的本地能力，把
**当前实际使用的网络、Wi‑Fi、LTE、实时网速和网络切换**统一放进一个菜单栏入口。

> LTE 功能依赖大疆第一代 4G 模块。没有该设备时，NetXD 仍可作为 Wi‑Fi 状态、
> 实时网速和网络选择工具使用。

## 它能做什么

### 一眼识别当前网络

NetXD 读取 macOS 默认路由，而不是简单判断某个接口是否连接，因此展示的是系统
**当前实际承载流量**的网络：

| 当前网络 | 菜单栏显示 |
| --- | --- |
| Wi‑Fi | macOS 原生 Wi‑Fi 图标，随 RSSI 改变 |
| LTE | 蜂窝信号图标与 LTE，随模块信号改变 |
| 无可用网络 | 飞行模式图标 |

### Wi‑Fi

- 显示当前 Wi‑Fi 名称
- 菜单打开时实时显示当前网络的上下行速度（Wi‑Fi 或 LTE），自动换算 KB/s、MB/s 和 GB/s
- 扫描附近网络并按信号排序
- 标记当前网络与受密码保护的网络
- 直接切换 Wi‑Fi；未知网络使用原生密码对话框
- 关闭菜单后立即停止测速和扫描相关工作

### LTE 与 DJOneHub

- 自动发现并启动 App 内置的 DJOneHub
- 显示 4G 模块是否在线
- 显示运营商、LTE 制式、信号 dBm 和注册状态
- 显示短信/上网模式及本次会话流量
- 一键打开 DJOneHub 本地管理页面
- 已有 DJOneHub 运行时直接复用，避免重复服务
- 睡眠前释放 USB 控制句柄，唤醒后自动恢复 DJOneHub、蜂窝连接与默认路由
- 未检测到模块时自动隐藏无意义详情，只保留一行 4G 状态

## 原生、轻量、融入 macOS

NetXD 使用 **原生 Swift** 编写，界面基于 AppKit：

- 没有 Electron、WebView 或额外运行时
- 使用 `NSStatusItem` 与 `NSMenu`，菜单、字重、快捷键和交互遵循 macOS
- 使用 SF Symbols，图标能自动适配浅色、深色与系统强调效果
- 使用 Network、SystemConfiguration 和 CoreWLAN 系统框架
- 不显示 Dock 图标，不常驻窗口

在开发机的空闲实测中，NetXD 通常约占 **12–14 MB 内存，CPU 约 0.0%**。
实际数值会因 macOS 版本、权限状态及菜单是否展开而略有变化。

低占用来自按需工作：

- 默认路由变化由系统通知驱动，不做高频全量轮询
- Wi‑Fi 活跃时才低频读取 RSSI
- LTE 为主网络时才每 10 秒读取一次蜂窝信号
- 完整 DJOneHub 状态只在打开菜单或手动刷新时读取
- 实时网速只在菜单展开期间采样，关闭后立即停止
- 回调使用弱引用，退出时取消监测、计时器与网络请求

## 快速安装

1. 从 [Releases](https://github.com/Trouwlikesnow/NetXD/releases/latest) 下载
   `NetXD-macOS-arm64.dmg`。
2. 打开 DMG，将 NetXD 拖入“应用程序”。
3. 首次运行请右键 NetXD，选择“打开”。
4. 如需 LTE，插入大疆第一代 4G 模块。DJOneHub 已内置，无需另外安装。
5. 首次打开 Wi‑Fi 列表时，允许定位权限，以便 macOS 返回附近网络名称。

当前发行版使用临时签名，未经 Apple 公证。完整步骤见
[安装说明](docs/INSTALL.md)。

## 系统要求

- Apple Silicon Mac
- macOS 13 Ventura 或更高版本
- LTE 功能：大疆第一代 4G 模块

## 从源码构建

先安装 Xcode Command Line Tools：

```sh
xcode-select --install
```

然后克隆并构建：

```sh
git clone https://github.com/Trouwlikesnow/NetXD.git
cd NetXD
chmod +x build-app.sh build-dmg.sh
./build-app.sh
open dist/NetXD.app
```

生成可分发 DMG：

```sh
./build-dmg.sh
```

产物位于 `dist/`。`Vendor/DJOneHub` 会自动嵌入 App，使发行包开箱即用。

## 隐私

- 所有网络状态均在本机处理
- DJOneHub API 仅监听 `127.0.0.1`
- 不收集、上传或展示 IMEI、IMSI、ICCID
- 定位权限仅用于 CoreWLAN 返回附近 Wi‑Fi 名称

## 已知限制

- 当前发行包仅支持 Apple Silicon
- LTE 能力仅适配大疆第一代 4G 模块
- Wi‑Fi 发射热点时通常无法同时作为普通 Wi‑Fi 客户端
- 未经 Apple Developer ID 公证，首次运行需要右键打开

## 许可证

NetXD 源码采用 [MIT License](LICENSE)。

内置 DJOneHub 使用 **PolyForm Noncommercial 1.0.0**，仅允许非商业用途，
不属于 MIT 授权范围。详情见 [第三方声明](THIRD_PARTY_NOTICES.md)。

## 致谢

- [ZenGeekLabs/DJOneHub](https://github.com/ZenGeekLabs/DJOneHub)

NetXD

NetXD Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

NetXD

NetXD Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README