前言¶
排查網絡問題時，開發者往往要在瀏覽器打開測速站，或單獨裝 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
