asl-control

📡 业余无线电节点远程控制终端

🥥86总安装量 18评分人数 22
100% 的用户推荐

基于 AllStar Link ASL3 Agent 的业余无线电节点控制工具,支持节点监控、连接管理和审计追踪,为火腿族提供安全可靠的远程电台管理方案。

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 代码无危险函数:未使用 eval/exec/system/subprocess,无命令注入或远程代码执行风险
  • ✅ 敏感信息安全:API 密钥通过环境变量读取,无硬编码;状态文件仅存储于本地用户目录,无静默上传行为
  • ✅ 输入验证完善:使用 argparse 进行严格的类型检查(整数、选项列表等),节点号码强制验证
  • ⚠️ 依赖版本未锁定:缺少 requirements.txt,requests 库版本未固定,建议手动锁定版本
  • ⚠️ 来源可信度限制:T3 级个人开发者账号(kj5irq),虽代码质量达 A 级,但建议审查后使用

使用说明

核心用法:本 Skill 作为 AllStar Link ASL3 Agent 的 Python 客户端,通过 REST API 实现对业余无线电节点的远程监控与控制。用户需在树莓派或独立主机上部署 asl-agent 后端服务,通过配置环境变量(ASL_PI_IPASL_API_KEY)建立连接。支持节点状态实时查询、连接/断开远程节点、收藏夹快速拨号、定时网络会话管理(Net profiles)及审计日志查看,输出格式支持 JSON(机器可读)与文本(人类可读)双模式,满足自动化脚本与日常交互需求。

显著优点:代码安全性表现优异,经审计无 eval/exec/system 等危险函数,采用环境变量管理 API 密钥杜绝硬编码风险;具备完善的 argparse 参数类型验证与异常处理机制,错误信息不暴露敏感系统路径;支持 Tailscale 虚拟组网,通过内网 IP 实现安全远程访问,避免公网暴露;状态文件(收藏夹、网络配置)持久化存储于用户主目录,更新后数据不丢失;原生支持 crontab 定时任务集成,可实现自动断线保护与定时网络管理。

潜在缺点与局限性:来源属 T3 级个人开发者账号,长期维护与更新稳定性存疑;缺少 requirements.txt 导致 Python 依赖版本未锁定,可能引发环境兼容性问题;受众高度垂直,仅适用于拥有 AllStar Link 节点及 ASL3 后端服务的业余无线电爱好者;需要用户具备 Linux 基础与网络配置能力(如 Tailscale 部署);部分节点可能因 AllStar 调度器机制在断开后自动重连,需额外修改 ASL 配置才能保持断开状态。

适合目标群体:持有业余无线电执照(HAM)的爱好者、部署了 AllStar Link 节点的电台管理员、需要远程管理节点连接的用户,以及参与应急通信网络(ARES、RACES 等)需要定时会话自动管理的无线电操作员。适合具备一定技术背景、熟悉 Linux 命令行与 REST API 概念的用户。

使用风险:API 密钥需妥善保管,建议将环境变量文件权限设为 600 防止泄露;依赖后端服务可用性,若树莓派或网络故障将导致控制失效;定时任务(net tick)配置不当可能导致意外断线或持续计费连接;状态文件存储于本地磁盘(~/.openclaw/state/asl-control/),多设备使用时需手动同步,否则可能产生数据不一致;虽然支持 Tailscale,但若使用公网 IP 且未配置防火墙,可能面临未授权访问风险。

asl-control 内容

文件夹图标scripts文件夹
手动下载zip · 8.9 kB
asl-api.shtext/x-shellscript
请选择文件