# edge浏览器测速插件

**Repository Path**: laos12138/edgebrowser-wifitest-plugin

## Basic Information

- **Project Name**: edge浏览器测速插件
- **Description**: 为Edge浏览器设计的测速插件，一键检测网络速度与延迟，优化浏览体验，开源免费，支持自定义测试节点。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-03
- **Last Updated**: 2026-08-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 网络诊断助手（Edge 扩展）

主动测速并诊断网络问题：测量访问网站时的延迟（RTT、TTFB）与下载速度，自动判断是**网页/服务器问题**还是**本地网络问题**，并给出分级解决方案。全部在本地完成，无外部 AI、无 API key、零第三方依赖。

## 获取代码

克隆仓库（或到 Gitee 仓库页下载 ZIP 并解压）：

```bash
git clone https://gitee.com/laos12138/edgebrowser-wifitest-plugin.git
cd edgebrowser-wifitest-plugin
```

## 安装（本地部署）

1. 打开 Edge，地址栏输入 `edge://extensions/`
2. 打开右上角「开发人员模式」
3. 点击「加载解压缩的扩展」，选择克隆/解压后**插件代码所在的文件夹**
4. 点击浏览器工具栏的「网络诊断助手」图标打开侧边栏

> 首次打开侧边栏：若图标点击未打开，可在扩展详情里确认「在侧边栏中打开」已启用。

## 使用

1. 点击「开始测速」：对预设目标（哔哩哔哩、GitHub）并发测速
2. 查看结论徽章与摘要：本地网络问题 / 网站问题 / 混合问题 / 网络断开 / 正常
3. 查看每个目标的 RTT、TTFB、下载速度与状态灯
4. 按「解决方案」分级建议（⚠️ 必须 / 💡 建议 / 📌 参考）操作
5. 在「历史趋势」查看近 20 次测速走势

## 设置

打开侧边栏「设置」或右键扩展图标 → 选项：

- **测速目标**：增删目标；新增时浏览器会请求该域名的访问权限，拒绝则保留但测速跳过
- **阈值**：调整 RTT / TTFB / 下载速度的分界点，保存后立即生效
- **历史数据**：导出 JSON 或清空

## 工作原理

- 测速请求由 `background.js`（service worker）发起，配合 `host_permissions` 绕过 CORS
- RTT / TTFB 取 3 次中位数，下载速度按「字节数 × 8 ÷ 耗时」计算
- 规则引擎对比所有目标：全部异常 → 本地网络问题；仅一个异常 → 该网站问题；全部不可达 → 网络断开
- 历史保存在浏览器本地 `chrome.storage.local`（保留最近 100 条）

## 手动测试清单

按顺序验证：

1. **正常流程**：开始测速 → 状态到「完成」，明细与结论出现
2. **模拟断网**：断开网络再测速 → 结论为「网络断开」
3. **单目标失败**：设置里添加一个不可达目标 → 其余目标正常测出，不可达目标显示错误
4. **新增目标权限**：添加新域名 → 弹出权限申请；拒绝后列表保留、测速跳过
5. **历史图表**：测速 3 次以上 → 趋势图出现折线；测速 100 次以上自动滚动删除
6. **阈值调整**：改低 RTT 阈值后重测 → 原本「正常」的目标可变为「异常」

## 开发

自动化测试（仅测纯逻辑，需要 Node ≥ 18.13，扩展运行不依赖 Node）：

```bash
node --test
```

生成图标：

```bash
node scripts/gen-icons.js
```