# Network Switcher

**Repository Path**: mzy666666/network-switcher

## Basic Information

- **Project Name**: Network Switcher
- **Description**: # 网络切换工具 (Network Switcher)
这是一个简单的 Windows 网络环境切换工具，支持一键切换网络适配器、WiFi 连接和系统代理设置。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-30
- **Last Updated**: 2025-12-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 网络切换工具 (Network Switcher)

这是一个简单的 Windows 网络环境切换工具，支持一键切换网络适配器、WiFi 连接和系统代理设置。

## 功能特点
- **方案管理**: 创建、编辑、删除多种网络方案。
- **网卡控制**: 自动启用指定网卡，禁用其他网卡。
- **WiFi 连接**: 自动连接指定的 WiFi 热点（支持选择系统已保存的网络）。
- **代理切换**: 一键开启或关闭系统代理，设置代理服务器及例外列表。
- **托盘运行**: 支持最小化到系统托盘，右键菜单快速切换方案。

## 使用说明
1. **运行程序**  
   - 双击 `dist/NetworkSwitcher/NetworkSwitcher.exe` 运行（无控制台窗口）。  
   - 程序启动时会请求管理员权限，用于修改网络配置。
2. **新建方案**  
   - 左侧点击“➕ 新建方案”，在弹窗中输入名称（实时校验重名与必填）。  
   - 新建后右侧显示卡片式工作流视图，可添加动作。
3. **添加动作**  
   - 点击右侧“+ 添加新动作”，在弹窗左侧选择动作类型（支持搜索过滤），右侧填写参数。  
   - 动作支持预览与必填校验，完成后点击“添加”即可写入当前方案。
4. **执行方案**  
   - 顶部点击“▶ 立即执行”，弹出执行进度窗口，显示进度条与实时日志；同时卡片背景会随状态高亮。
5. **方案管理**  
   - 顶部支持“✏ 重命名”与“🗑 删除方案”。  
   - 托盘图标支持快捷切换方案。

## 依赖
- Python 3.x
- 第三方库: `pystray`, `pillow` (用于托盘图标)
  ```bash
  pip install pystray pillow
  ```
- Windows 系统 (PowerShell 支持)

## 注意事项
- WiFi 连接功能依赖系统已保存的配置文件。
- 修改代理设置会直接影响系统全局 IE 代理设置。

## 更新日志
- 新增“侧边栏 + 卡片式工作流”主界面，方案一目了然、操作直观
- 动作系统全面升级，支持：网卡控制、连接 Wi-Fi、代理设置、运行命令、等待、打开程序（管理员）、结束进程（可强制）
- 新版“添加新动作”弹窗：类型搜索、动态表单、预览与必填校验
- 新版“新建方案”弹窗：卡片式样式、实时校验、最小尺寸保护，按钮固定底部
- 执行进度反馈：进度条与实时日志、卡片高亮显示当前与结果状态
- 图标统一：窗口标题与托盘图标加载 `icon.png`
- 支持导入配置文件（JSON），自动跳过重名方案
- 打包脚本支持一键 PyInstaller 构建与 Inno Setup 安装包（需本机安装 ISCC）