SuperAPI AI 工具集

router-control

通用与其它

查看项目

更新于 10-16 07:19

技能介绍

用途:面向家庭网络的发现与设备控制。它通过默认网关定位路由器,探测 SSH/HTTP,并读取 DHCP 租约来列出局域网设备,再用 devices/ 目录下的 YAML 配置文件匹配识别设备类型(如路由器、电视、红外遥控、音箱、摄像头、空调、IoT 设备等)。

主要能力:自动检测路由器并识别伪装 IP(如 Clash TUN)用于发现;建立 SSH 连接(依次尝试密钥、密码、常见默认值);列出设备并进行类型识别;查询已支持设备与某设备可执行命令;路由器健康检查。配置文件由社区维护,每份 YAML 定义设备元数据、发现规则(MAC/主机名/mDNS)、连接方式(协议/认证)与命令。

使用方式:常用命令为 python3 cli.py discover、python3 cli.py connect、python3 cli.py devices、python3 cli.py supported、python3 cli.py commands lg-webos、python3 cli.py health。需要直接操作路由器时可运行脚本,如 bash scripts/run.sh "wg show"、bash scripts/ping.sh "LGwebOSTV"、bash scripts/health.sh。新增设备可复制 _schema.yaml 创建 devices/<type>/my-device.yaml,填写发现、连接与命令后测试并提交 PR。

适用场景:家庭局域网设备清点、路由器 SSH 管理、按设备类型执行控制命令、网络排障。

限制:依赖 SSH 访问路由器与 DHCP 租约读取,可能遇到伪 IP、ISP 对 WireGuard 端口封锁、Dropbear SSH 认证失败、双重 NAT、路由器内存压力等问题;具体解决方法见参考资料。支持的设备以现有 YAML 配置为准。