核心用法
Terminal Display(TRMNL Display)是一项用于向电子墨水屏硬件设备推送内容的技能。用户可通过自然语言指令,将标题与正文发送至绑定的 TRMNL 终端,实现物理屏幕上的信息展示。该技能基于官方 Webhook API,采用 POST 请求提交 JSON 数据,结构简单,调用门槛低。
典型使用场景包括:
- 日程提醒("下午3点会议")
- 构建状态通知(CI/CD 流水线结果)
- 天气/股价/待办清单的常驻显示
- 智能家居联动后的状态反馈
技术实现
技能封装了 curl 命令,向 https://trmnl.com/api/custom_plugins/... 端点发送包含 merge_variables 的 JSON 负载。设备端需预先配置对应模板,支持 title(主标题)与 text(正文)两个变量。电子墨水屏的特性决定了内容宜简短精悍——标题建议 30 字符以内,正文避免长篇大论,以确保在小型屏幕上的可读性。
显著优点
1. 物理存在感强:不同于手机推送或桌面通知,电子墨水屏常置于桌面或墙面,信息"始终可见",适合作为个人仪表盘。
2. 超低功耗:E-ink 仅在刷新时耗电,内容可长期静态显示无需背光,环保且适合 7×24 小时运行。
3. 接口标准化:TRMNL 提供统一的 Webhook 机制,无需处理设备底层协议,降低集成成本。
4. 隐私友好:数据仅通过 HTTPS 传输,内容本地化显示,不涉及第三方广告追踪。
潜在局限
- 延迟非实时:设备按固定周期刷新(通常数分钟一次),紧急通知不适合完全依赖此渠道。
- 无色彩与动画:黑白双色、无刷新动画,信息表现力受限,不适合复杂图表或富媒体。
- 硬件依赖:必须拥有 TRMNL 终端设备(或兼容 Webhook 的第三方墨水屏),无设备则技能无法落地。
- 字符集与排版:受限于设备固件模板,特殊字符或超长文本可能被截断或渲染异常。
适合人群
- 拥有 TRMNL 电子墨水屏的极客用户与效率工具爱好者
- 需要"物理看板"进行信息聚合的远程工作者、开发者
- 追求低干扰、低功耗显示方案的智能家居搭建者
常规风险
- Webhook URL 泄露:配置中的 UUID 若被他人获取,可能导致恶意内容推送。建议妥善保管技能配置,避免在公共仓库硬编码。
- 内容注入:若用户输入未过滤直接拼接进 JSON,存在格式逃逸风险。技能内部已做基础转义,但极端场景仍建议人工校验输入。
- 服务可用性:依赖 TRMNL 云服务端点,若官方 API 变更或宕机,推送将失败。建议关键业务保留备用通知渠道。
- 隐私暴露:推送内容会短暂经过 TRMNL 服务器,虽采用 TLS 加密,但极度敏感信息(如密码、密钥)不宜通过此渠道展示。