# utools_wifi_analysis

**Repository Path**: fancy171101034/utools_wifi_analysis

## Basic Information

- **Project Name**: utools_wifi_analysis
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-30
- **Last Updated**: 2026-05-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WiFi 分析工具

基于 uTools 的 WiFi 信号分析和信道优化工具，支持实时监控信号强度，自动分析信道冲突并给出优化建议。

## 功能特性

- 📶 **当前 WiFi 连接信息**
  - 显示频道号
  - 实时信号强度 (dBm)
  - 协议模式 (802.11 a/b/g/n/ac/ax)

- 📈 **信号强度实时监控**
  - 弹窗显示实时信号强度折线图
  - 每 100ms 采样一次，持续 5 秒
  - 支持手动开始/停止监控
  - 可视化信号波动情况

- 📊 **信道占用统计**
  - 统计各信道的 AP 数量
  - 可视化信道占用程度
  - 高负载信道高亮警告

- ⚠️ **信道冲突分析**
  - 自动检测信道重叠冲突
  - 区分严重/中等/轻微三个等级
  - 推荐最优信道建议

- 🔍 **周围 WiFi 扫描**
  - 扫描附近所有 WiFi 热点
  - 按信号强度排序
  - 显示频道、协议模式等信息

## 技术栈

- **框架**: Vue 3
- **构建工具**: Vite
- **UI 组件**: Element Plus
- **图表库**: ECharts
- **平台**: uTools

## 开发说明

### 安装依赖

```bash
npm install
```

### 开发调试

```bash
npm run dev
```

### 构建打包

```bash
npm run build
```

构建产物输出到 `dist/` 目录。

### uTools 插件打包

1. 完成构建后，打开 uTools 开发者工具
2. 选择 `public/plugin.json` 作为插件配置文件
3. 选择 `dist/` 目录作为资源目录
4. 打包生成 `.upx` 插件文件

## 项目结构

```
.
├── public/
│   ├── preload/
│   │   └── services.js      # 预加载脚本，系统 WiFi 能力封装
│   └── plugin.json           # uTools 插件配置
├── src/
│   ├── index/
│   │   ├── App.vue          # 根组件
│   │   ├── index.html       # HTML 入口
│   │   └── index.vue        # 主页面组件
│   └── main.js              # Vue 入口文件
├── .gitignore               # Git 忽略配置
├── package.json             # 项目依赖配置
├── vite.config.js           # Vite 配置
└── README.md               # 项目说明文档
```

## 平台支持

### macOS
- 使用 `system_profiler SPAirPortDataType` 命令获取 WiFi 信息
- 无需额外权限，稳定可靠

### Windows
- 使用 `netsh wlan show interfaces` 命令获取 WiFi 信息
- 使用 `netsh wlan show networks mode=bssid` 扫描热点

### Linux
- 使用 NetworkManager (`nmcli`) 命令
- 依赖 NetworkManager 服务

## 更新日志

### v1.0.0
- 初始版本发布
- 支持当前 WiFi 信息显示
- 支持信号强度实时监控
- 支持信道占用统计和冲突分析
- 支持周围 WiFi 扫描

## 许可证

MIT