添加项目使用说明README.md

2026-07-21 17:41:21 +08:00
parent 4ac165a750
commit f241732d67
1 changed files with 93 additions and 0 deletions
@@ -0,0 +1,93 @@
+# 路由器管理工具
+
+基于 Python + Selenium 的路由器自动化配置工具，支持批量设置光猫/路由器的各项参数。
+
+## 功能
+
+| 功能 | 说明 |
+|------|------|
+| 自动登录 | 支持超级管理员/普通账号模式切换 |
+| PON光功率检测 | 获取光纤连接状态和接收光功率 |
+| WiFi名称设置 | 修改2.4G/5G无线网络名称，可选择是否修改 |
+| WiFi密码设置 | 修改2.4G/5G无线网络密码，可选择是否修改 |
+| WiFi启用控制 | 控制无线网络启用或禁用 |
+| 定时重启 | 设置每周定时自动重启 |
+| LOID注册 | 完成光猫设备LOID注册 |
+| 多浏览器支持 | Edge / Chrome / Firefox 可选 |
+
+## 环境要求
+
+- Windows 操作系统
+- Python 3.12+
+- Microsoft Edge / Google Chrome / Mozilla Firefox 浏览器（任选其一，推荐Edge）
+
+## 安装
+
+```powershell
+# 1. 克隆项目
+git clone https://gitea.mymoyu.top/root/gz.git
+cd gz
+
+# 2. 安装依赖
+pip install -r requirements.txt
+```
+
+## 运行
+
+### 方式一：直接运行源码
+
+```powershell
+python test.py
+```
+
+### 方式二：编译为独立 EXE
+
+```powershell
+pyinstaller --onefile --windowed --name "路由器管理工具" test.py
+```
+
+生成的 EXE 在 `dist\路由器管理工具.exe`，可拷贝到任意 Windows 电脑运行，无需安装 Python。
+
+## 使用说明
+
+1. **选择浏览器**：点击 Edge / Chrome / Firefox 单选按钮
+2. **选择账号模式**：
+   - 点击「选择超级管理员账号」自动填入管理员凭据，输入框锁定不可修改
+   - 点击「切换为普通账号」清空凭据，可手动输入
+3. **填写配置项**：
+   - LOID码（注册码）：直接显示明文
+   - WiFi名称/密码：先勾选「修改WiFi名称」或「修改WiFi密码」，输入框解锁后可填写
+   - 启用WiFi：勾选则开启无线功能
+4. **点击「开始执行」**：程序自动完成所有操作，实时日志显示进度
+5. **观察状态**：状态标签随流程变化（就绪 → 运行中 → 登录成功 → 全部完成）
+
+## 界面说明
+
+```
+┌─────────────────────────────────────────────┐
+│  浏览器:  ● Edge   ○ Chrome   ○ Firefox      │
+│  账号: [____________]  [选择超级管理员账号]     │
+│  密码: [****] [显示]                          │
+│  LOID码: [11111111]                          │
+│  ☐ 修改WiFi名称                               │
+│  WiFi名称: [____________]                     │
+│  ☐ 修改WiFi密码                               │
+│  WiFi密码: [****] [显示]                       │
+│  ☑ 启用WiFi                                  │
+│  状态: 就绪                                   │
+│  [ 开始执行 ]                                 │
+│  实时日志:                                    │
+│  ┌─────────────────────────────────────┐     │
+│  │ [14:33:55] 正在启动浏览器...          │     │
+│  │ [14:33:56] Edge驱动已安装: ...       │     │
+│  │ [14:33:57] 浏览器启动成功             │     │
+│  └─────────────────────────────────────┘     │
+└─────────────────────────────────────────────┘
+```
+
+## 注意事项
+
+- 首次运行会自动下载浏览器驱动（需联网），驱动缓存在系统临时目录
+- 电脑需通过网线连接光猫的 LAN 口
+- 未注册的光猫可能无法访问 `192.168.1.1`，需手动设置静态IP
+- 默认超级管理员账号：`CMCCAdmin`，密码：`aDm8H%MdA`