SuperAPI AI 工具集

trmnl-paper-screen

写作与研究

查看项目

更新于 10-16 00:29

技能介绍

用途:把已完成的 Blade/HTML markup 通过 LaraPaper 的 POST /api/screens 推送到 TRMNL 设备,并在实际发送后取回当前渲染图做视觉审查;若发现问题,整理问题清单交回 trmnl-paper-blade 修正。

主要能力:构造并发送屏幕更新请求,使用固定请求头 id + access-token,body 固定为 {"image":{"content":"...","file_name":"..."}},file_name 可选,默认 screen.blade.markup;默认 dry-run 展示完整请求体(凭据脱敏),仅在用户明确要求时才实际 POST;发送后可读取当前屏幕、下载 image_url 做审查;提供脚本 scripts/push_screen.py,从仓库根目录运行 python3 skills/trmnl-paper-screen/scripts/push_screen.py ...,在 skill 内可用 python3 scripts/push_screen.py ...。

使用方式:需四个参数——base URL(带 scheme,如 https://larapaper.example.com)、mac_address、设备级 device API key(非 APP_KEY)、markup。markup 可通过 --markup-file <path> 或 --markup-stdin 传入;发送用 --send,发送后取图用 --send --current-screen,下载图片用 --download-image <path>。

适用场景:用户明确要求推送、部署或更新 TRMNL 设备屏幕内容时使用。限制与注意:仅使用 POST /api/screens;不伪造凭据;APP_KEY 不是本技能凭据;POST 不返回 image_url,需后续当前屏幕接口获取;异步渲染或缓存可能导致图片短暂为上一版,等待重试即可;错误码 404(MAC 或 API key 不匹配)、422(缺 image.content)、500(服务端渲染失败);dry-run 不做图片审查。具体取图路径与审查标准见 references/api-screens.md 与 references/review-checklist.md。