trmnl

核心用法

TRMNL Content Generator 是一款面向 TRMNL 系列 e-ink 墨水屏设备的专用内容生成技能。用户通过安装 trmnl-cli 命令行工具，配置 webhook 插件后，即可利用该技能生成符合 TRMNL CSS 框架规范的 HTML 内容，并推送至电子纸设备显示。核心工作流包括：安装/更新 CLI、检查插件配置、确认设备型号（默认 TRMNL OG 800×480 2-bit 灰度）、读取参考文档、生成 HTML、写入临时文件并通过 trmnl send 命令发送。技能内置完整的布局系统（flexbox、10 列网格）、排版工具（等宽数字 value--tnums、自动缩放 data-fit-value）和组件库（标题栏、分隔线、数据项），支持构建从简单通知到复杂数据仪表盘的各类界面。

显著优点

1. 专业 e-ink 优化：针对电子纸显示特性设计，提供 2-bit 灰度专用的 dithered 背景类（bg--gray-*），避免传统 CSS 颜色在墨水屏上的显示问题。

2. 完善的框架支持：涵盖布局、排版、组件、数据属性等完整设计系统，参考文档结构清晰（patterns、framework-overview、css-utilities、layout-systems、components 等），降低学习成本。

3. 严格的边界控制：内置 payload 大小验证（Free 2KB / TRMNL+ 5KB）、速率限制提示（12/30 请求每小时）和 trmnl validate 预检机制，帮助用户避免发送失败。

4. 极简交互设计：遵循"最小确认"原则，发送成功后仅返回简短确认，不冗余回显内容，符合终端用户的使用习惯。

5. 透明可审计：纯文档型资产，无隐藏代码，所有操作均需用户显式授权和配置，安全可控。

潜在缺点与局限性

1. 硬件依赖性强：必须拥有 TRMNL 物理设备并配置 webhook 插件才能使用，无设备用户无法验证效果。

2. 外部工具依赖：需用户自行安装 Node.js 环境和 trmnl-cli npm 包，对非技术用户存在门槛。

3. 速率与容量限制：免费用户仅 12 请求/小时、2KB 单条限制，不适合高频实时数据场景；复杂布局需精心优化 HTML 体积。

4. 静态内容为主：e-ink 特性决定其适合信息展示而非交互，无法支持动画、视频或复杂用户输入。

5. T3 来源风险：虽本次审查通过，但来源为社区/个人仓库，长期维护更新存在不确定性。

适合的目标群体

• TRMNL 设备持有者：已购买 TRMNL OG 或其他型号 e-ink 显示屏的极客用户
• 智能家居/IoT 爱好者：希望构建低功耗信息看板（天气、股价、待办、GitHub 统计等）
• 开发者与设计师：熟悉前端技术，愿意通过代码定制专属显示内容的用户
• 极简主义追求者：偏好电子纸显示效果，需要减少屏幕蓝光干扰的场景

使用风险

1. CLI 环境配置风险：npm install -g 可能因权限问题失败，建议使用 nvm 或检查 Node.js 版本兼容性。

2. Webhook 配置错误：插件 URL 配置不当会导致发送失败，需通过 trmnl config 和 trmnl history --failed 排查。

3. 内容超限截断：超出 tier 限制的 payload 将被拒绝，重要信息可能无法完整显示，务必使用 trmnl validate 预检。

4. 速率限制触发：高频调用可能触发 429 错误，需合理规划更新频率或升级至 TRMNL+。

5. 临时文件残留：虽使用标准 /tmp 目录，但异常中断时可能遗留 HTML 文件，建议定期清理。