TRMNL墨水屏推送

技能简介

该技能用于为TRMNL电子墨水屏设备生成HTML内容，并通过trmnl CLI推送到指定设备。支持使用TRMNL CSS框架构建富文本布局，包括弹性盒、网格、表格、进度条和排版工具。

业务背景

TRMNL墨水屏推送技能让企业无需开发即可将关键信息投放到电子墨水屏。适合会议室状态看板、仓库作业指示、门店促销信息、工位待办提醒等场景，低功耗屏幕可长期常显，替代纸质标牌降低运维成本。

落地案例：某零售门店运营人员每日需更新入口处的促销信息。通过该技能，只需输入今日特价商品和折扣数据，系统自动生成适配墨水屏的排版布局，经CLI推送到门店TRMNL设备。屏幕即时显示图文海报，顾客远距离清晰可见，运营人员无需到店即可远程刷新内容。

能做什么

• 生成适配800×480分辨率2位灰度屏幕的HTML内容
• 通过Webhook将内容推送到TRMNL设备
• 创建数据仪表盘、通知消息、状态看板
• 自动处理文本缩放、溢出管理和数字等宽字体

使用说明

1. 安装CLI工具

npm install -g trmnl-cli@latest

2. 配置Webhook插件（首次使用）

trmnl plugin add home "https://trmnl.com/api/custom_plugins/{uuid}"
trmnl plugin  # 验证配置

3. 生成并发送内容

# 创建HTML文件
cat > /tmp/trmnl-content.html << 'EOF'
<div class="layout layout--col gap--space-between">
  <div class="item">
    <span class="value value--xlarge value--tnums">Hello TRMNL!</span>
  </div>
</div>
<div class="title_bar">
  <span class="title">My Plugin</span>
</div>
EOF

# 验证并发送
trmnl validate --file /tmp/trmnl-content.html
trmnl send --file /tmp/trmnl-content.html --plugin home

4. 查看发送记录

trmnl history --today

输入与输出

见下方输入与输出表格。

风险提示

• Free套餐单条限制2KB，Plus套餐5KB，超限会导致发送失败
• 速率限制：Free每小时12次，Plus每小时30次
• 每个视图只能包含一个.layout元素
• 数字必须使用value–tnums类以保证对齐
• 避免使用内联颜色，改用bg–gray-*系列抖动灰度类

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/peetzweg/trmnl/SKILL.md
来源类型：GitHub仓库