用途:面向“小白安装工具时网络不通”的场景,先用低风险、可复现的探测把“网络有问题”拆成具体类别,再判断能否继续交给安装技能。默认不修改代理、DNS、证书、防火墙或 hosts。触发词包括「网络不通」「下载失败」「npm/pip 超时」「证书错误」「安装卡住」。
主要能力:记录 OS、架构、时间、网络类型与原始错误;按“基准组→目标组→镜像组”三组对照探测,先探国内基准源判断本机网络,再探目标官方入口,最后探国内镜像源。逐层分类为 dns_failed、tls_failed、timeout、http_error、proxy_required 或 reachable。基准组至少收录 2 个独立来源,任一可达即视为基准通过。
使用方式:用自然语言描述失败的工具、错误提示和系统类型,不要求先运行命令。探测脚本使用 Python 标准库,可执行:python3 scripts/probe_endpoints.py --url https://nodejs.org/en --url https://www.python.org/downloads/ --json 。官方站点清单见 providers.md。安装方式包括域级安装 claude plugin marketplace add soia-team/soia-open-skills 与 claude plugin install soia-env@soia ;单技能安装 npx skills add soia-team/soia-open-env-skills -g -a '*' -s soia-env-network-diagnose -y。
交付格式:强制输出七列状态表(技能、当前状态、当前版本、最新版本、运行状态、更新时间、处理结果),网络诊断无版本,两列版本固定填“不适用”。表格后只保留必要错误类别、受影响官方源与下一步。
限制与边界:不修改代理、DNS、证书、hosts 或包管理器源配置,换源命令仅为建议;不诊断 AI 模型服务运行时可达性;不代替安装动作;不以浏览器能打开网站代替包管理器源验证;不执行 curl | bash、未知脚本、关闭 TLS 校验或绕过安全策略;不把代理 URL、Authorization、cookie、凭据写入日志;默认不落盘,仅在客户要求时保存脱敏报告。修复后需重新探测相同源。