M5Paper 是 M5Stack 推出的一款可触控墨水屏设备,采用乐鑫 ESP32 主控 ,正面嵌入了一块分辨率为 540 x 960 的 4.7 寸 的电子墨水屏,支持 16 级灰度显示,集成了拨轮开关、温湿度传感器 SHT30 和物理按键,预留了 TF-card (microSD)接口,还集成了 FM24C02 存储芯片,可提供 2KB 容量的断电存储,内置了 1150mAh 锂电池,借助内部的 RTC(BM8563) 能够实现休眠与唤醒功能,搭配 GT911 电容式触控面板,支持两点触控以及多种手势操作,能为用户提供更优质的文本阅读体验,并且具备低功耗以及掉电图像保持等特性,同时开放了 3 组 HY2.0-4P 外设接口,能够拓展各种各样的传感器设备,为后续的应用功能开发带来了无限的可能性。
当你安装 ai-desk-card 桌面副屏 Skill 后,就可以通过Claude Code / Codex 等 AI Agent 服务推送 widget:天气、日程、todo、PR 队列、AI 状态、休息提醒等,最终显示在 M5Paper 的4.7 寸墨水屏上,把你的M5Paper墨水屏,变成Claude Code的专属物理搭档!多会话看板、硬件一键审批、不用切窗口,甚至还有会变脸的摸鱼小猫。
🖥 桌面副屏:540×960 墨水屏立在显示器旁,工作状态一目了然
🤖 AI 主动推送:Agent 决定推什么 widget、什么时候推;你不用自己开浏览器查天气

🧩 16 种插件:weather / calendar / todo / focus / inbox / pr-queue / ai-status / git-status / now-playing / break-reminder / scratch / messages / deadlines / next-meeting / system / ai-tasks
🎨 服务端渲染:daemon 用 Python + Pillow 渲染像素帧,固件只负责显示;想加新 widget 只改 Python,不用动 C++
🧩 三种供电模式自动切换:USB 常开 / USB 数据线 / 电池 + BLE 待机(几个月续航)
🌐 Wi-Fi 秒刷:本地 HTTP 直推,无云依赖
💤 关屏 0 功耗保留最后一帧:墨水屏特性,电池续航 6 个月

👆 底栏触屏:点"睡眠"推电子名片 + 深度休眠;点"设置"翻设置页。150ms 点击态反馈
⏰ 自动息屏:到 quiet hours 自动切到电子名片,daemon 不需要 Agent 在线
AI Desk Card 墨水屏共有4 个槽位,采用 2-1-1 布局
AI Desk Card 更新链路如下:
你 ──说自然语言──▶ AI Agent ──触发──▶ Skill ──自动执行──▶ M5Paper 屏上

AI Desk Card 常见使用场景
🤖 快速开始
命令行安装
npx skills add https://github.com/op7418/ai-desk-card --skill ai-desk-card
让 AI 帮你自动装

你只需要把下面这段话复制粘贴给 Claude Code / Cursor 即可。
帮我装 ai-desk-card 这个 Skill。请按下面步骤做:
1.确保 ~/.claude/skills/ 目录存在,不存在就创建
2.执行 git clone https://github.com/op7418/ai-desk-card.git ~/.claude/skills/ai-desk-card
3.验证:ls ~/.claude/skills/ai-desk-card/ 应该看到 SKILL.md、flows/、plugin/、daemon/、src/、assets/

4.装好告诉我,之后我说“帮我把卡片装上”就会触发这个 Skill
AI Desk Card Skill 是结构化工作流,Agent 会按下面顺序自动跑:
入职 (flow 01) — 探测 PlatformIO / USB 设备 → 引导你烧固件
传输诊断 (flow 02) — 设备连不上时定位问题
配 Wi-Fi (flow 03) — 把 Wi-Fi 凭证写进设备 NVS

写偏好 (flow 04) — 第一次问"你想看哪些卡片,多久刷一次"
推 widget (flow 05) — 日常推送的热路径
设定时 (flow 06) — Agent 用自己的 loop / cron 定时刷
息屏 (flow 07) — 推电子名片 + 设备深度休眠 0 功耗
AI Desk Card 完整子流程在 flows/ 目录。Skill 主路由在 SKILL.md。

🌟 外挂Agent伴侣演示
自动更新日程和待办:AI Agent 通过飞书 CLI 直接读取飞书日历,更新到墨水屏
GitHub动态更新:GitHub 开源项目有新 PR、有人在 Issue 里 at 我、CI 挂了,AI 都会把它推上去。
日常信息更新:实时天气、运动提醒、TODO List 等
🌳 写在最后

AI Desk Card 跟传统 IoT 设备最大的不同在于16 种 widget 模板预置在服务端,AI Agent 只负责往里面塞 JSON 数据,交互界面完全由 AI 决策,无需用户配置。
Claude Code/Codex重度用户:开N个会话干活的,效率至少提升30%,再也不用切窗口切到晕
桌面极客/折腾党:外挂智能副屏,比普通电子钟、天气屏酷10倍
AI编程内容创作者:直播/录屏的时候把墨水屏放旁边,不用露Claude窗口的隐私,观众还能一眼看到AI的操作状态,专业度拉满
GitHub项目:https://github.com/op7418/ai-desk-card