Isp Throttle Detective
/install isp-throttle-detective
ISP Throttle Detective
Scripts live in scripts/. Log and config default to ~/.isp-throttle-detective/. See references/setup-guide.md for full setup, scheduling, and interpretation guidance.
Workflow
Run a single test and log it
python3 scripts/speedtest.py | python3 scripts/log_result.py
Analyze patterns (needs ≥5 tests across multiple hours/days)
python3 scripts/analyze.py
python3 scripts/analyze.py --days 30 --json # machine-readable
Generate evidence report
python3 scripts/report.py --days 30 --out ~/report.md
Scripts
| Script | Purpose |
|---|---|
speedtest.py |
Download from 3 endpoints + upload to Cloudflare. Outputs JSON to stdout. |
log_result.py |
Append speedtest JSON to JSONL log with hour, day_of_week enrichment. |
analyze.py |
Detect peak vs off-peak, CDN discrimination, trend, anomalies. |
report.py |
Generate markdown evidence report with tables and plain-English conclusion. |
Configuration
Copy assets/config.example.json to ~/.isp-throttle-detective/config.json. All scripts auto-detect it. Key fields:
log_file— where the JSONL log livesendpoints— add/remove test targets; setcategory: "cdn"vs"general"to enable CDN discrimination detectionpeak_hours— list of hours (0–23) considered peak
Pass --config /path/to/config.json to any script to override.
Scheduling
See references/setup-guide.md for launchd (macOS) and cron (Linux) snippets. Recommended: every 30 minutes for meaningful data within a day or two.
Throttling Signals
- Peak-hour drop >20% vs off-peak → time-based throttling
- CDN speed \x3C75% of general internet → destination-based throttling
- Declining trend slope → infrastructure degradation
- Multiple low-speed anomalies at the same hour → systematic, not random
Using the Evidence Report
report.py produces a markdown file with a peak/off-peak comparison table, per-endpoint breakdown, hourly chart, trend analysis, and a plain-English conclusion. Share it directly with ISP support or use it to evaluate whether upgrading your plan would actually help (if CDN throttling is confirmed, a faster plan won't fix it).
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install isp-throttle-detective - 安装完成后,直接呼叫该 Skill 的名称或使用
/isp-throttle-detective触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Isp Throttle Detective 是什么?
Run speed tests to multiple endpoints, log results, and detect ISP throttling patterns. Use when the user mentions speed test, internet slow, ISP throttling,... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 122 次。
如何安装 Isp Throttle Detective?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install isp-throttle-detective」即可一键安装,无需额外配置。
Isp Throttle Detective 是免费的吗?
是的,Isp Throttle Detective 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Isp Throttle Detective 支持哪些平台?
Isp Throttle Detective 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Isp Throttle Detective?
由 New Age Investments(@newageinvestments25-byte)开发并维护,当前版本 v1.0.0。