SuperAPI AI 工具集

trmnl-plugins

通用与其它

查看项目

更新于 10-15 19:58

技能介绍

用途:构建 TRMNL 电子墨水屏(包括 TRMNL X)的自定义私有插件与仪表盘。一个插件由数据策略(数据如何到达 TRMNL)与 Liquid 标记(如何渲染,基于 Design Framework 3.1 CSS)组成。

主要能力:私有插件在 TRMNL 网页界面创建(设备下拉 → 齿轮 → Developer perks 一次性升级 → Private Plugin),标记在各布局标签页的 Edit Markup 编辑器中填写。每个插件有四个布局标签:full、half_horizontal、half_vertical、quadrant,另有 Shared 标签存放可复用标记/CSS/JS,至少需填写 full。

设备与适配:不存在单一屏幕尺寸,应针对框架响应式层级而非硬编码像素。TRMNL OG 为 800×480、1bit 两级灰、md 断点;TRMNL OG V2 为 800×480、2bit 四级灰、md;TRMNL V2 为 1024×758、4bit 十六级灰、lg;TRMNL X 为 1872×1404、10.3 英寸、4bit 十六级灰、lg。TRMNL X 为高密度十六级灰度,需先保证响应式基础适配通用,再用 lg: 与 4bit: 前缀发挥更大灰度面板,使用真实灰度(如 text--gray-50、抖动图片)。

使用方式:先选数据策略(Webhook 推送或轮询拉取),再确定模板读取的 JSON 键(合并数据保持根层扁平),为各布局编写标记(可从 assets/scaffolds/ 的 full.liquid、half_horizontal.liquid、half_vertical.liquid、quadrant.liquid、schedule-full.liquid 起步),用 Liquid 渲染数据({{ variable }}、循环、自定义过滤器),用框架类名样式化,最后在编辑器中 Force Refresh 并检查目标设备溢出。标记是视图级,TRMNL 会自动包裹外壳并注入 plugins.css 与 plugins.js,每个布局标记以 view--full 等视图修饰符匹配对应标签。TRMNL 使用标准 Liquid,文档中 ##{{ }} 的 ## 仅为转义,编辑器中直接写 {{ }}。

注意事项与本资料列出的规则:合并数据保持扁平,Webhook 负载放在 merge_variables 下,轮询 JSON 单 URL 读取根层、多 URL 读取 IDX_n;图表禁用动画(animation: false);始终处理溢出(data-clamp、data-list-limit、data-table-limit 或用 Liquid limit: 限制条目);合并数据完全相同时会跳过重渲染,需用 Force Refresh;客户端 JS 包裹在 DOMContentLoaded 事件中;限制方面 Webhook 免费 2 KB 与每小时 12 次、TRMNL+ 为 5 KB 与每小时 30 次,轮询刷新间隔为 15/60/360/720/1440 分钟。报告亦提及 references/ 下的 data-strategies.md、liquid-filters.md、framework.md、charts-and-recipes.md 等参考文件,建议按任务只读取相关文件。具体收费、价格等未提供。