# Wifi Health Report

> 生成脱敏的 Windows Wi-Fi 网络体检 SVG 或动态 HTML 报告，报告中的数字来自确定性检测，不使用图片模型改写。

- Skill: `1ecc/wifi-health-report` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add 1ecc/wifi-health-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/1ecc/wifi-health-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: 1Ecc (https://skillmd.com/u/1ecc)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/1ecc/wifi-health-report

---


# Wi-Fi 网络体检报告 Skill

## 目的

当用户希望查看、保存或分享 Wi-Fi 检测结果时，生成网络体检报告。普通联网问题仍使用 `wifi_diagnosis`；只有用户需要图片、动态报告、体检卡或分享材料时加载本 Skill。

## 主要工具

- `wifi_generate_report`：快速生成静态 SVG 图片；
- `wifi_generate_html_report`：采样一段时间并生成动态 HTML；
- `network_monitor`：用户只想观察实时波动、不需要报告文件时使用。

报告工具内部复用：

- `wifi_get_status`
- `wifi_diagnose`

不要为了生成报告再次重复调用相同检测工具。

## 工作流程

1. 用户需要快速图片或方便分享时，调用 `wifi_generate_report`。
2. 用户提到动态、波动、上传/下载、延迟趋势或详细界面时，调用 `wifi_generate_html_report`；未指定时使用默认 30 秒。
3. HTML 报告采样期间向用户说明正在检测，不要重复启动另一次采样。
4. 将返回的 SVG 图片或 HTML 资源链接直接展示给用户。
5. 用一两句话说明总体状态和最重要建议，不重复抄写整份报告。
6. 如果工具返回 `partial`，说明缺失字段或采样限制；返回 `unsupported/error` 时改为文字说明，不编造曲线。

## 图片内容边界

报告只展示：

- 当前总体状态；
- Wi-Fi 网卡 → 无线连接 → 网关 → DNS → Internet 链路；
- 信号、链路速率和网关延迟；
- 根据检测结果生成的保守建议；
- 检测时间和快照限制。

HTML 报告还可以展示：

- 5～60 秒的上传/下载吞吐变化；
- 网关延迟、抖动和丢包；
- 采样数据对应的异常时段。

默认隐藏 SSID、IP、DNS 和网关地址。不要在图片外补充这些字段，除非用户明确提出并理解隐私影响。

## 诊断原则

- 网关、DNS 或外网异常不等于无线网卡损坏；
- 当前正常不代表历史上没有偶发问题；
- 上传/下载曲线表示 Wi-Fi 网卡实际吞吐，不等于宽带测速；
- 信号低于 40% 只标记为“信号较弱”，不判断硬件故障；
- 不自动建议重置网络、修改 DNS 或付费维修；
- 只有持续的设备侧异常且普通排查无法解释时，才转入服务推荐。

相关 Wi-Fi 判读资料位于本 skill 的 `references/`，只在报告结果需要解释时读取。