前言¶
排查网络问题时，开发者往往要在浏览器打开测速站，或单独装 CLI，再把结果贴回对话里。若你已经在 Cursor、Claude Code 等环境里用 Skill 扩展能力，更省事的做法是让 Agent 按固定流程跑测速、读公网 IP 与运营商信息，并输出可复制的文本结果。下面介绍 SkillHub 社区 Skill「测网速」（@user_29dc410e/speedtest-online-skill），它把常见测速项封装成零第三方依赖的 Python 脚本，供 Agent 调用或本地执行。
这是什么¶
「测网速」是 SkillHub 上的社区 Skill，坐标 @user_29dc410e/speedtest-online-skill，当前版本 1.0.0，分类为 it-ops-security，发布者为 user_29dc410e。官方简介说明：支持下载、上传网速测试，Ping 延迟测试，公网 IP 与运营商识别、宽带测速，并面向多运营商网络测速场景。页面标签标明 requires_api_key=false，安装后无需单独配置 API Key。
Skill 包内说明其为 SkillHub 平台可直接运行的零依赖网速测试技能；skill_info.txt 中入口函数为 skillhub_main，依赖项为 none。
核心功能¶
以下能力来自 SkillHub 页面简介与包内 SKILL.md、skill_info.txt 的说明，并与脚本实现一致：
- 下载速度测试：向可配置的测速节点拉取数据，在固定时长内统计吞吐并格式化为 bps / Kbps / Mbps。
- 上传速度测试：向配置的 HTTP 端点 POST 随机数据，计算上传速率。
- Ping 延迟测试：对配置的主机建立 TCP 连接，多次采样后给出平均、最小、最大延迟（毫秒）。
- 公网 IP 与运营商识别：通过
ipinfo.io获取 IP、城市、地区与运营商（org）字段。 - 所在城市等信息：与 IP 信息一并返回。
- 纯文本 ASCII 测速图表：在结果中附带条形图式文本可视化。
- 多测速节点支持：配置中预置 Cloudflare、CacheFly、百度等节点名称与 URL；默认跑测时使用列表中的第一个节点。
脚本使用 Python 标准库（urllib、socket 等），不声明第三方 pip 依赖。
安装与启用¶
通过 SkillHub CLI 安装¶
若尚未安装 skillhub，可先按官方安装文档检查版本：
command -v skillhub && skillhub --version
未安装时，可使用文档中的完整安装命令（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。SkillHub 文档给出的常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
针对「测网速」，搜索索引给出的安装方式为：
skillhub install speedtest-online-skill --namespace user_29dc410e --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 换成你当前客户端对应目录即可。SkillHub 技能页也提供面向 AI 的安装提示：请根据 https://skillhub.cn/install/skillhub.md ，安装 @user_29dc410e/speedtest-online-skill。
启用方式¶
- 将 Skill 安装到上述 skills 目录后，按你所用客户端的要求刷新或重启 Agent，使
SKILL.md被加载。 - 在对话中说明需要测速、查延迟或查看公网 IP 与运营商时，Agent 应读取 Skill 指引并调用包内入口逻辑（
skillhub_main）。
官方未在页面中区分 Cursor 与 Claude Code 的额外配置项；二者差异主要体现在 skills 目录路径，安装命令中的 --dir 需与当前环境一致。
典型用法¶
在 Agent 对话中使用¶
安装并启用后，可直接用自然语言描述需求，例如：测试当前网络的下载与上传速度、Ping 延迟，并展示公网 IP 与运营商。Agent 按 Skill 说明执行测速逻辑，返回 JSON 或 Skill 内格式化的图表文本。
本地命令行执行（可选）¶
包内 SKILL.md 给出的运行方式为：
python speedtest_skill.py
run.sh 使用：
python3 speedtest_skill.py
经 skillhub install 拉取的 1.0.0 包中，实际存在的 Python 文件为 web_speedtest_skill.py；以 __main__ 运行时会把测速结果打印为 JSON。若按 SKILL.md 执行时找不到 speedtest_skill.py，可改为在 Skill 目录下执行：
python3 web_speedtest_skill.py
测速会访问配置中的公网 URL（如下载节点、上传端点、IP 信息接口与 Ping 主机），需保证运行环境能访问这些地址。
适用场景与注意¶
适合谁
- 需要在 IDE / Agent 会话里快速确认本机或运行环境的上下行与延迟，而不想切换浏览器测速页。
- 希望结果带 IP、城市与运营商字段，便于写运维记录或排障备注。
- 偏好零 pip 依赖、仅用标准库即可跑通的轻量脚本。
限制与注意
- 测速方法：下载测速依赖对 HTTP 资源的拉取时长统计，上传测速依赖对指定 URL 的 POST，与运营商官方测速或 Ookla 等专用 CLI 的算法和节点不同，数值仅供相对参考。
- 外网依赖：IP 信息使用
https://ipinfo.io/json；默认节点包含 Cloudflare、CacheFly、百度等 URL。内网、离线或严格出站策略环境可能失败或超时（脚本内配置了timeout等参数）。 - 包内文件名：当前 1.0.0 包中
skill_info.txt的entry与SKILL.md、run.sh均引用speedtest_skill.py，但安装目录内仅有web_speedtest_skill.py，本地执行时需以实际文件为准。 - 平台数据：SkillHub 页面显示本 Skill 评分 100000、下载 1711 次、安装 1 次（统计随平台更新变化）。
结尾¶
「测网速」把下载、上传、Ping、IP/运营商识别和文本图表收敛到一个社区 Skill 里，适合在 Agent 工作流里做轻量网络自检。安装与优先源说明以 SkillHub 文档为准；Skill 详情与安装入口见：
- SkillHub 页面：https://www.skillhub.cn/skills/user_29dc410e/speedtest-online-skill
- API 坐标页：https://api.skillhub.cn/user_29dc410e/speedtest-online-skill
