TRMNL Display

核心用法

TRMNL Content Generator 是一个专为 TRMNL 电子墨水屏设备设计的内容生成与推送工具。用户通过 trmnl CLI 将自定义 HTML 内容发送到 800x480 像素的 2-bit 灰度电子墨水屏上，实现个性化信息展示。

典型工作流程：
1. 安装 trmnl-cli 并配置 webhook 插件
2. 使用 TRMNL CSS 框架（flexbox、grid、表格、进度条等）编写 HTML
3. 通过 trmnl send --file 推送内容至设备
4. 利用 trmnl validate 验证 payload 大小（免费版 2KB，Plus 版 5KB）

关键特性：

• 10 列网格系统与垂直/水平布局引擎
• 专用排版类如 value--tnums（数字等宽对齐）、value--xxxlarge（主指标）
• 抖动灰度类（bg--gray-*、text--gray-*）替代内联颜色
• 自动文本缩放（data-fit-value）与溢出管理
• 速率限制：免费版 12 次/小时，Plus 版 30 次/小时

显著优点

• 专用优化：针对电子墨水屏的对比度、刷新率和功耗特性深度优化
• 成熟框架：提供完整的 CSS 工具类体系，无需从零设计低功耗显示样式
• CLI 原生：与开发者工作流无缝集成，支持验证、历史查询、多插件管理
• 结构约束清晰：强制单一 .layout + .title_bar 模式，降低布局出错率

潜在缺点与局限性

• 硬件门槛：需购买 TRMNL 物理设备（约 $150-250）才能使用
• payload 限制严格：2-5KB 上限对复杂可视化构成挑战
• 灰度限制：仅 2-bit（4 级灰度），不支持彩色或丰富渐变
• 速率限制：每小时 12-30 次更新，不适合实时高频数据场景
• 生态封闭：主要支持官方设备，通用性不如普通网页推送方案

适合人群

• 已拥有或计划购买 TRMNL 设备的智能家居/量化自我爱好者
• 偏好物理仪表盘而非手机 App 查看关键数据的用户
• 追求极简、低干扰信息展示的设计师和开发者
• 需要长期静态显示（日历、待办、股票、天气）而不希望屏幕常亮的场景

常规风险

• 配置失误：webhook URL 错误导致推送失败，需通过 trmnl config 核查
• 超限截断：HTML 超过 payload 限制可能被静默截断，务必先用 trmnl validate 检查
• 视觉错位：数字未加 value--tnums 类会导致表格或指标列不对齐
• 刷新残影：电子墨水屏固有特性，频繁更新会产生 ghosting，属硬件限制而非软件缺陷

核心用法

TRMNL Content Generator 是一款面向电子墨水（e-ink）显示设备的文档型工具，帮助用户生成并推送 HTML 内容至 TRMNL 终端。核心工作流程包括：安装/更新 trmnl-cli，配置 webhook 插件，根据设备参数（默认 800×480 2-bit 灰度）生成符合 TRMNL CSS 框架的 HTML，最后通过 trmnl send 命令推送至设备。

Skill 提供完整的参考文档体系：从基础 patterns、框架概览到 CSS 工具类、布局系统、组件库及 webhook API 说明。用户可快速构建包含 flexbox/grid 布局、进度条、表格、KPI 卡片等丰富的仪表盘内容，并通过 data-fit-value、data-clamp 等属性实现自适应排版。

显著优点

• 零代码执行风险：纯文档型 Skill，无可执行代码，无外部 API 调用，所有网络操作均由用户本地 CLI 完成。
• 专业框架支持：深度集成 TRMNL 官方 CSS 框架，提供 10 列栅格系统、专用灰度色板（dithered）、tabular 数字对齐等电子墨水优化特性。
• 开发体验完善：包含验证工具（trmnl validate）、历史查询（trmnl history）、多插件管理，支持 Free/Plus tier 的负载与速率限制提示。
• 隐私友好：不收集敏感数据，符合 GDPR/CCPA 合规要求。

潜在局限

• 依赖本地 CLI：必须用户自行安装 Node.js 环境与 trmnl-cli，Skill 本身无法直接推送内容。
• 设备生态局限：仅针对 TRMNL 品牌设备优化，其他 e-ink 屏幕需额外适配。
• payload 限制严格：Free tier 仅 2KB，复杂布局需精简 HTML 或升级订阅。
• 实时性受限：受 e-ink 刷新机制与 webhook 速率限制（12-30 次/小时），不适合高频实时场景。

适合人群

• 拥有 TRMNL 设备的用户，希望自定义信息看板内容
• 喜爱低功耗、常显屏幕的开发者与极客
• 需要展示天气、待办、股票、服务器状态等静态/准实时数据的场景

常规风险

• Webhook URL 泄露：若插件 URL 被他人获取，可能遭受恶意推送，建议妥善保管。
• CLI 版本兼容性：需保持 trmnl-cli 更新，旧版本可能存在 API 变动。
• 内容尺寸超限：超出 tier 限制的 payload 将被拒绝，建议发送前执行 validate 检查。