e-ink 墨水屏内容推送专家

基于 TRMNL 官方 CSS 框架的 e-ink 墨水屏内容生成工具，支持通过 CLI 向电子纸设备推送自定义仪表盘与通知，适合极客用户打造低功耗信息展示终端。

基本信息

• 技能名称?trmnl
• 中文名称?e-ink 墨水屏内容推送专家
• 作者?peetzweg
• 分类?开发
• 版本?v1.0.3
• 标签?iot, hardware, productivity, automation, frontend, development-engineering

使用方法

使用说明
核心用法
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. 透明可审计 ：纯文档型资产，无隐藏代码，所有操作均需用户显式授权和配置，安全可控。
   潜在缺点与局限性
6. 硬件依赖性强 ：必须拥有 TRMNL 物理设备并配置 webhook 插件才能使用，无设备用户无法验证效果。
7. 外部工具依赖 ：需用户自行安装 Node.js 环境和 trmnl-cli npm 包，对非技术用户存在门槛。
8. 速率与容量限制 ：免费用户仅 12 请求/小时、2KB 单条限制，不适合高频实时数据场景；复杂布局需精心优化 HTML 体积。
9. 静态内容为主 ：e-ink 特性决定其适合信息展示而非交互，无法支持动画、视频或复杂用户输入。
10. T3 来源风险 ：虽本次审查通过，但来源为社区/个人仓库，长期维护更新存在不确定性。
    适合的目标群体
    TRMNL 设备持有者 ：已购买 TRMNL OG 或其他型号 e-ink 显示屏的极客用户
    智能家居/IoT 爱好者 ：希望构建低功耗信息看板（天气、股价、待办、GitHub 统计等）
    开发者与设计师 ：熟悉前端技术，愿意通过代码定制专属显示内容的用户
    极简主义追求者 ：偏好电子纸显示效果，需要减少屏幕蓝光干扰的场景
    使用风险
11. CLI 环境配置风险 ： npm install -g 可能因权限问题失败，建议使用 nvm 或检查 Node.js 版本兼容性。
12. Webhook 配置错误 ：插件 URL 配置不当会导致发送失败，需通过 trmnl config 和 trmnl history --failed 排查。
13. 内容超限截断 ：超出 tier 限制的 payload 将被拒绝，重要信息可能无法完整显示，务必使用 trmnl validate 预检。
14. 速率限制触发 ：高频调用可能触发 429 错误，需合理规划更新频率或升级至 TRMNL+。
15. 临时文件残留 ：虽使用标准 /tmp 目录，但异常中断时可能遗留 HTML 文件，建议定期清理。