enzoldhazam

🌡️ NGBS 智能家居温控助手

Go 语言开发的 NGBS iCON 温控 CLI,支持 HTTPS 加密与 macOS Keychain 安全存储,实现家庭温度智能管理。

收藏
6.2k
安装
1.8k
版本
v1.0.1
CLS 安全性认证2026-05-10
点击查看完整报告 >

使用说明

enzoldhazam 是一款专门用于控制 NGBS iCON Smart Home 温控系统的命令行工具,采用 Go 语言开发,面向 macOS 用户提供安全可靠的家居温度管理方案。

核心用法:用户需从 GitHub 克隆源码并编译安装,通过 enzoldhazam login 将凭据存储至 macOS Keychain,或配置环境变量 ENZOLDHAZAM_USERENZOLDHAZAM_PASS。主要功能包括 status 查看全屋温度、get <room> 查询特定房间、set <room> <temp> 调节目标温度,所有命令均支持 --json 输出便于自动化脚本集成。使用前需确保拥有 enzoldhazam.hu 官方账号。

显著优点:安全性表现突出,采用 HTTPS 加密通信,凭据存储整合 macOS Keychain(基于 Zalando 开源的 go-keyring 库),避免明文存储风险。代码完全透明可审计,无 eval/exec 等危险函数,无动态代码加载,具备完善的 CSRF token 验证和输入边界检查。设备端硬件级温度限制(TMin/TMax)可防止极端温度设置。CLI 界面简洁直观,错误处理机制完善,适合技术用户集成至现有工作流。

潜在缺点或局限性:平台兼容性受限,目前仅支持 macOS 系统(依赖 Keychain),Linux 与 Windows 用户无法使用。来源为个人开发者(GitHub: daniel-laszlo)维护的 T3 级开源项目,非 NGBS 官方出品,长期维护稳定性与功能更新存在不确定性。安装门槛较高,需用户自行配置 Go 环境并编译源码,缺乏官方二进制分发与代码签名验证。功能相对单一,仅支持基础温度查询与设置,缺乏能耗统计、定时任务、多设备协同等高级功能。

适合的目标群体:主要面向拥有 NGBS iCON Smart Home 温控系统的 macOS 用户,特别是具备技术背景的开发者、智能家居爱好者及注重隐私安全的保守型用户。适合需要通过脚本自动化控制家庭温度、希望将温控集成到 HomeKit 或其他自动化工作流中的场景,以及偏好本地 CLI 控制而非云端第三方服务的用户。

使用风险:尽管代码通过安全审计(A 级),仍需注意供应链风险(编译安装时需确保从官方 GitHub 仓库获取源码);环境变量配置方式可能在 shell 历史记录中留下凭据痕迹;个人维护项目存在更新停滞或 API 兼容性中断风险;频繁 API 调用可能对设备通信造成负载。建议关注上游依赖(特别是 go-keyring)的安全通告,优先使用 Keychain 存储方式并避免在公共网络环境下频繁操作。

安全解读

核心用法

enzoldhazam 是一款用于控制匈牙利 NGBS iCON 智能家庭温控系统的命令行工具。用户通过简单的 CLI 指令即可查询全屋各房间实时温度、查看设备状态,并精确设置目标温度。

主要指令

  • enzoldhazam status — 显示所有房间当前温度及状态
  • enzoldhazam set <房间名> <温度> — 设置指定房间目标温度(如 22)
  • enzoldhazam get <房间名> --json — 获取单房间详情,支持 JSON 解析

安装需从 GitHub 克隆源码后用 Go 编译,适合具备基本技术能力的用户。

显著优点

1. 凭证管理安全:优先使用 macOS Keychain 加密存储登录信息,环境变量仅作备选方案,无硬编码密钥风险
2. 代码质量可靠:Go 语言编写,结构清晰,无危险函数调用,通过静态与动态安全扫描

3. 传输加密合规:所有通信采用 HTTPS/TLS 1.2+,符合 GDPR 数据最小化与传输加密要求

4. 输出格式灵活:支持 --json 参数,便于与其他工具或自动化脚本集成

潜在局限

  • 平台限制:Keychain 集成针对 macOS 设计,其他系统体验可能受限
  • 来源可信度:T3 级别个人开发者项目,长期维护稳定性需持续关注
  • 网络依赖:必须连接 enzoldhazam.hu 官方服务,离线不可用
  • 硬件局限:仅支持 NGBS iCON 温控系统,兼容性单一

适合人群

  • 使用 NGBS iCON 智能温控系统的匈牙利家庭用户
  • 偏好命令行操作的技术爱好者
  • 需要将温控集成到自动化工作流的高级用户

常规风险

  • 环境变量配置时可能意外泄露到 shell 历史记录(建议配合 unset 清理)
  • 个人开发者维护,建议定期关注上游安全更新
  • 温控器名称含特殊字符时可能引发解析异常

enzoldhazam 内容

internal文件夹
api文件夹
config文件夹
models文件夹
手动下载zip · 5.4 kB
client.gotext/plain
请选择文件