mcpField
H
home-assistant-awtrix

home-assistant-awtrix

github.com/bradsjm其他46556 次安装16 周前更新
代码仓库

关于 home-assistant-awtrix

用于管理 AWTRIX 设备文件和图标的技能，附带 Python 脚本，并提供 HTTP 端点及 MQTT/Home Assistant 控制模式参考。

主要功能

  1. 01确定性文件系统操作
  2. 02列出、上传、重命名和删除文件
  3. 03导入 LaMetric 图标
  4. 04AWTRIX HTTP 文件系统参考
  5. 05MQTT 和 Home Assistant 控制指南

适用场景

  1. 01检查设备状态
  2. 02管理设备图标
  3. 03导入 LaMetric 图标
  4. 04应用 MQTT/Home Assistant 控制模式

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bradsjm/hassio-addons --skill home-assistant-awtrix

安装后在 Claude Code 中输入/home-assistant-awtrix确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
AWTRIX_HTTP_FILESYSTEM.md
AWTRIX.md
upstream-api.md
scripts/
awtrix_fs.py

详细介绍

AWTRIX

工作流

  • 使用随附的 awtrix_fs.py 脚本执行确定性的文件系统操作和 LaMetric 图标导入。
  • 使用设备绝对路径（以 / 开头），避免固件路径错误。
  • 查阅参考资料，了解端点行为以及 MQTT/HA 集成模式。

快速开始

所有脚本和参考文件均相对于此 SKILL.md 文件所在位置。

python3 scripts/awtrix_fs.py --host <ip> status
python3 scripts/awtrix_fs.py --host <ip> icons list
python3 scripts/awtrix_fs.py --host <ip> icons import-lametric <id>

任务

按 ID 导入 LaMetric 图标
  • 运行：python3 scripts/awtrix_fs.py --host <ip> icons import-lametric <id>
  • 阅读：references/AWTRIX_HTTP_FILESYSTEM.md，了解端点详情
列出设备上的图标
  • 运行：python3 ~/.codex/skills/home-assistant-awtrix/scripts/awtrix_fs.py --host <ip> icons list
上传 / 重命名 / 删除文件
  • 上传本地文件：... upload ./local.jpg /ICONS/9999.jpg
  • 重命名：... rename /ICONS/old.gif /ICONS/new.gif
  • 删除：... delete /ICONS/bad.gif
安全删除所有图标（避免 404 循环错误）

删除 icons list 返回的多个文件时，避免使用会折叠空白字符的命令替换循环。使用逐行安全循环，逐个删除文件名：

python3 scripts/awtrix_fs.py --host <ip> icons list \
  | awk '{print $3}' \
  | while IFS= read -r f; do
      python3 scripts/awtrix_fs.py --host <ip> delete "/ICONS/$f"
    done

参考资料

  • HTTP 端点、文件系统 API 和 LaMetric 导入详情：references/AWTRIX_HTTP_FILESYSTEM.md
  • MQTT/HA 控制模式（自定义应用、通知、设置）：references/AWTRIX.md
  • 上游 MQTT API 参考：references/upstream-api.md

评论

支持 Markdown