English | 中文
Important
本 Fork 专门适配 Waveshare ESP32-S3-RLCD-4.2 微雪RLCD开发板。
基于并保留对原作者项目
datascale-ai/inksight 的引用与署名。
与上游采用 Arduino/PlatformIO 的固件不同，本设备适配使用纯
ESP-IDF 5.5 开发，代码位于
firmware/esp-idf/ESP32-S3-RLCD4.2/。
当前仅完成了基础适配与初步硬件验证，并未对原项目的全部功能、 板载外设和长期运行场景进行完整测试。请将本仓库视为实验性的首版适配， 暂不代表与上游正式固件具备完全相同的功能和稳定性。
自动构建固件可从 ESP32-S3-RLCD4.2 最新测试版 下载。
一块真正适合放在桌面的电子墨水信息屏，并配有一个能一站式完成刷机、配置、预览与发现创意模式的网站。
官网主页：https://www.inksight.site
墨鱼AI墨水屏是一个面向桌面场景的电子墨水屏伴侣。 它不是另一块“会打扰你的屏幕”，而是把天气、习惯、便签、倒计时、简报和更有温度的内容，以纸面般克制的方式放到你的视线里。
- 抬头即见：天气、倒计时、便签、习惯、简报一眼可读
- 电子墨水体验：纸感显示，不刺眼，适合长时间放在桌面，超长时间待机
- 模式丰富且好看：24 个内置模式，既有实用信息，也有更适合桌面氛围的内容
- 网站一站式完成：小白友好一键配置，网页刷机、在线配置、无设备预览、模式广场都已打通
- 开源且可扩展：固件、后端、Web 配置、JSON 模式系统都可扩展，之后会开源PCB板设计图纸、外壳3D打印图纸等等
当前官网不只是展示页，而是把完整体验串在一起。 哪怕你是第一次接触电子墨水屏、ESP32 或 WebSerial，也可以跟着页面一步步完成上手；很多情况下，你几乎只需要点点屏幕，就能完成设备刷机、联网和配置。
- 在线刷机：浏览器里直接完成 Web Flasher，不需要先装复杂工具链
- 在线配置：在
/config里完成设备模式、个性化设置与常用参数调整 - 在线预览：保存前先看到墨水屏效果，减少“改了才知道不合适”的试错
- 无设备体验：没有设备也能先玩模式和预览，先理解产品体验再决定要不要做
- 模式广场：发现、分享、安装社区用户创作的模式，让灵感和玩法可以流动起来
这让墨鱼AI墨水屏不只是一个开源硬件项目，也更像一个完整产品。
当前内置 24 个模式，包括：
- 每日推荐：语录、书籍、冷知识、节气信息
- 天气看板：实时天气与趋势摘要
- 诗词 / 禅意 / 斯多葛：更适合桌面氛围的慢内容
- AI 简报：科技热点与 AI 洞察
- AI 画廊：黑白风格的上下文艺术图
- 便签 / 倒计时 / 习惯 / 健身：更偏实用的桌面工具模式
同时你还可以：
- 创建自己的自定义模式
- 把模式保存到设备
- 把创意发布到模式广场
- 安装别人分享的社区模式
最推荐的入门组合：
| 部件 | 推荐选型 |
|---|---|
| 主控 | ESP32-C3 开发板 |
| 屏幕 | 4.2寸 SPI 墨水屏 |
| 供电 | 开发期 USB，长期使用可选锂电池方案（推荐 505060-2000mAh + TP5000） |
| 成本 | DIY BOM 通常约 220 元 |
详细的硬件购买方案与淘宝链接，请参考：硬件购买清单与方案推荐
当前对外推荐统一以 ESP32-C3 + 4.2寸墨水屏 为主。
如果你是第一次上手，建议从 ESP32-C3 + 4.2寸 开始。
仓库的 firmware/esp-idf/ESP32-S3-RLCD4.2/ 中也提供了 Waveshare
ESP32-S3-RLCD-4.2 一体式反射屏的首版适配。该适配使用纯
ESP-IDF 5.5，不依赖 Arduino 或 PlatformIO；构建和烧录方法见
硬件指南与刷机指南。
如果你想先感受和了解产品，可以直接访问官网去体验：
- 官网：
inksight.site - 在线刷机：支持一键拉取我们发布的最新固件代码并部署，教程视频:
刷机视频教程 - 设备配置：当刷完设备之后，可以在这里配置显示的内容
- 模式广场：可以分享自己的大作，也可以用上大神们设计的精美模式
- 无设备体验：提供给还没有设备的朋友们一个体验的机会
如果你喜欢 DIY、想亲手组一台自己的墨鱼AI墨水屏，买到了设备之后不知道如何组装的话，可以参考 组装视频教程
我们也准备了相应的文档：
- 硬件指南：
docs/hardware.md - 组装指南：
docs/assembly.md - 刷机指南：
docs/flash.md - 配置指南：
docs/config.md
非常感谢社区开发者们为 InkSight 创作的精美外壳和定制 PCB！以下是一些优秀的社区开源硬件和 3D 打印模型：
如果你是开发者、想在本地部署一套服务，或者不仅仅满足我们提供的官网服务，准备二次开发、联调 API 和前后端流程，请从这里进入：
- 中文部署文档：
docs/deploy.md - English deployment guide:
docs/en/deploy.md - 架构设计：
docs/architecture.md - API：
docs/api.md - 插件 / 扩展开发：
docs/plugin-dev.md
ESP-IDF 版本支持 专注监听模式，允许外部 AI Agent（如 pi、Claude 等）通过 API 推送紧急告警到你的 RLCD 屏幕。
- 在 Inksight 配置页 找到你的设备
- 开启 「专注监听」 开关
- 复制弹窗中的 alert_token
通过 API 推送：
curl -X POST \
"https://www.inksight.site/api/device/AA:BB:CC:DD:EE:FF/alert" \
-H "Content-Type: application/json" \
-H "X-Agent-Token: <alert_token>" \
-d '{"sender":"紧急","message":"老板找你","level":"critical"}'告警会在设备屏幕上显示 30 秒后自动恢复。
⚠️ 专注监听开启时设备不会进入深度睡眠，功耗会增加。 不需要时可在配置页关闭。
ESP-IDF 版本代码位于 firmware/esp-idf/ESP32-S3-RLCD4.2/。
cd firmware/esp-idf/ESP32-S3-RLCD4.2
# 加载 ESP-IDF 环境后构建
idf.py build
# 刷机（替换为你的串口）
idf.py -p /dev/cu.usbmodem101 flash
# 刷机 + 看日志
idf.py -p /dev/cu.usbmodem101 flash monitor
# 进入菜单配置
idf.py menuconfig首次运行需要配网：连接 InkSight-XXXXXX Wi-Fi 后访问 http://192.168.4.1。
- Discord: https://discord.gg/5Ne6D4YNf
- QQ 群: 1026120682
- BiliBili
