SuperAPI AI 工具集

card-widget

数据与分析

查看项目

更新于 10-16 02:39

技能介绍

用途:card-widget 用于把实时数据推送到用户显示器旁的 M5Paper 电子墨水副屏(540×960),一次可推送 1-4 个小组件,由守护进程渲染单帧。

主要能力:内置 16 种小组件,包括 weather、calendar、next-meeting、messages、inbox、system、git-status、pr-queue、now-playing、scratch、todo、focus、deadlines、break-reminder、ai-status、ai-tasks。布局分四个槽位:top-left/top-right 为 270×280 窄槽,middle 为 540×340 宽槽,bottom 为 540×280 宽槽,另有常驻 60px 状态栏。守护进程自动在 Wi-Fi、USB、BLE 中选择传输方式,并做脏区域差分以减少重传。

使用方式:推荐用 helper 脚本推送,例如 $CLAUDE_PLUGIN_ROOT/scripts/widget.sh push <type> <slot>,或直接调用 push_widget.py;也可用 curl POST 到 http://127.0.0.1:9877/widget,字段含 type、slot、data、ttl、stale_after、theme。无设备时可用 /widgets/preview 预览。推送前建议先运行 probe.sh --quick 检查连接。

适用场景:桌面副屏展示日程、待办、AI 任务状态、Git 状态、PR 队列等。

限制:电子墨水屏不宜频繁刷新,禁止逐键推送,亚分钟级信息最多约每 30 秒推送一次;USB 传输较慢(单区域约 1 秒、整帧约 32 秒),BLE 仅支持小命令、帧数据会挂起;数据需符合各类型 JSON schema,否则返回 HTTP 400;内容过多会被截断。睡眠名片模式通过 /card-sleep 触发,内容来自 assets/profile.yaml。部分细节(如具体安装步骤)资料未提供。