AgentPing - Diagnóstico de Rede para Agents IA
tranfu-labs/agentping-app
Diagnóstico de rede em tempo real para Agents IA travados
Ver no GitHubFerramenta de monitoramento e diagnóstico de conectividade de rede projetada para usuários de Agents IA (Codex, Claude Code, Cursor). Identifica rapidamente se o problema está na rota API, regras de proxy, nó de saída ou na própria ferramenta quando um agent fica sem resposta.
Instalação
npx convez-ai tranfu-labs/agentping-app1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Debugar conectividade de API quando Agents IA param de responder
- Verificar status de rotas de proxy e nós de saída
- Monitorar saúde de endpoints de serviços (Claude, OpenAI, etc)
- Equipes de desenvolvimento validando infraestrutura de rede
Veredito

Ferramenta prática e bem estruturada para diagnóstico de rede focada em desenvolvedores de Agents IA. Oferece CLI Python, app macOS e website com documentação clara. Solução útil para identificar gargalos de conectividade rapidamente.
README
A tradução para o português deste README ainda está na fila.
Ageng网络医生
Ageng网络医生是给 Codex、Claude Code、Cursor 等 AI Agent 使用者准备的网络状态监测与诊断工具。Agent 一直没反应时,它先帮用户判断是 API 链路、代理规则、出口节点,还是工具本身卡住。
项目内部工具名保留为 AgentPing,用于命令、macOS App 文件名和安装包文件名。
官网域名规划:
https://agentping-app.tranfu.com/
GitHub 仓库:
https://github.com/tranfu-labs/agentping-app
项目内容
website/ 官网静态页面
website/downloads/ 官网下载文件
agentping.py 命令行网络诊断工具
agentping 命令行入口
Sources/AgentPingMenu/ macOS 菜单栏工具源码
Scripts/package_app.sh macOS App 打包脚本
Scripts/verify_website.mjs 官网自动检查脚本
Assets/AgentPingIcon.icns macOS App 图标
本地预览官网
python3 -m http.server 8088 --directory website
打开:
http://127.0.0.1:8088/index.html
官网包含:
- 首页:产品完整说明。
- 工具说明页:工具介绍和下载入口。
- 团队网络页:访问验证后查看 VPN 信息和 Clash 下载渠道。
- 常见文章页:网络问题说明文章。
团队网络页当前演示访问码:
agentping-team
本地检查官网
先启动本地预览服务,再运行:
node Scripts/verify_website.mjs
如果检查线上域名:
AGENTPING_SITE_URL=https://agentping-app.tranfu.com node Scripts/verify_website.mjs
检查内容包括页面关键文案、导航、品牌图、下载文件、VPN 访问码流程和手机端横向溢出。
官网部署文档
官网是纯静态页面,部署时把 website/ 作为站点根目录即可。
Cloudflare Pages 推荐配置:
Project name: agentping-app
Production branch: main
Build command: 留空
Build output directory: website
Root directory: 留空
Vercel 推荐配置:
Framework Preset: Other
Root Directory: website
Build Command: 留空
Output Directory: .
Netlify 推荐配置:
Base directory: website
Build command: 留空
Publish directory: website
域名绑定:
- 在部署平台添加自定义域名
agentping-app.tranfu.com。 - 按平台提示在 DNS 中添加 CNAME 记录。
- 等证书签发完成后,访问
https://agentping-app.tranfu.com/。 - 运行线上检查命令确认首页、下载入口和团队网络页都能正常打开。
命令行工具
运行一次检查:
./agentping check
查看详细结果:
./agentping check --verbose
增加自定义目标:
./agentping check --target "Claude=api.anthropic.com" --target "OpenAI=api.openai.com"
也可以直接用 Python 运行:
python3 agentping.py check
macOS 菜单栏工具
开发构建:
swift build
.build/debug/AgentPingMenu
验证菜单栏程序能读取诊断结果:
.build/debug/AgentPingMenu --diagnose-once
打包成可双击启动的 App:
sh Scripts/package_app.sh
open dist/AgentPing.app
重新生成下载压缩包:
ditto -c -k --norsrc --keepParent dist/AgentPing.app website/downloads/AgentPing.app.zip
如果从浏览器下载后 macOS 提示“已损坏,无法打开”,通常是下载隔离导致。解压后运行:
xattr -dr com.apple.quarantine ~/Downloads/AgentPing.app
退出方式:点开菜单栏里的 Ageng网络医生,选择“退出 Ageng网络医生”。
发布流程
发布前先重新打包并检查:
swift build -c release
sh Scripts/package_app.sh
ditto -c -k --norsrc --keepParent dist/AgentPing.app website/downloads/AgentPing.app.zip
dist/AgentPing.app/Contents/MacOS/AgentPingMenu --diagnose-once
python3 -m http.server 8088 --directory website
node Scripts/verify_website.mjs
创建 tag 和 GitHub Release,下面的版本号按当次发布替换:
git tag -a vX.Y.Z -m "Ageng网络医生 vX.Y.Z"
git push origin main --tags
gh release create vX.Y.Z website/downloads/AgentPing.app.zip --repo tranfu-labs/agentping-app --title "Ageng网络医生 vX.Y.Z" --notes-file RELEASE_NOTES.md --latest
发布后核验:
gh release list --repo tranfu-labs/agentping-app --limit 5
gh release view vX.Y.Z --repo tranfu-labs/agentping-app --json name,tagName,isPrerelease,assets,url
产品方案
完整产品方案见:
AgentPing-产品方案.md
后续三个模块细化见:
AgentPing-后续模块细化.md