鲜知贴 / Xian Zhi TieFridge Tracker · 2026

Project 001 / Fridge Tracker

让冰箱里的食材
一眼可知

鲜知贴是一套可以完整复刻的低功耗食材提醒器:手机管理食材,服务端生成画面,ESP32 定时刷新墨水屏,最后装进自己设计和打印的外壳。

Node.jsSQLiteESP32-C3 / S3E-paperPlaywrightSharpCAD3D Printing
安装在冰箱上的鲜知贴墨水屏产品概念图
Product concept / Fridge TrackerESP32 · E-paper · 3D-printed enclosure
3支持的屏幕型号
2ESP32 板卡系列
30 / 96 KB原生帧大小
5–1440 min可配置检查间隔

Section 01 / System

一条从手机到墨水屏的链路

中文排版、图标和颜色转换都在服务端完成,设备只负责可靠地下载和刷新。

鲜知贴从手机食材列表、Node.js 服务、ESP32 到墨水屏的完整数据链路
Phone → Server → ESP32 → E-paper管理食材 · 生成画面 · 定时取帧 · 低功耗显示
  1. 01手机 H5

    添加食材、设置保鲜天数、生成一次性配对码

  2. 02Node.js 服务

    保存数据、计算到期状态、生成屏幕画面

  3. 03ESP32

    定时唤醒、连接 Wi-Fi、通过 ETag 获取新帧

  4. 04电子墨水屏

    只在画面变化时刷新,完成后进入低功耗休眠

Section 02 / Server

S—01

服务端负责把数据变成“屏幕”

鲜知贴服务端不只是一个 API。它同时提供响应式 H5、账号与设备管理、SQLite 数据存储,以及三色 / 四色墨水屏的渲染管线。

服务端把中文网页转换为黑红黄像素并生成墨水屏原生帧
HTML → Playwright → Sharp → Native frame浏览器渲染 · 像素提取 · 三色 / 四色减色 · 30 / 96 KB
01

食材与到期状态

按上海时区计算保鲜期限,优先排列已经过期和即将到期的食材。

02

HTML → 原生帧

Playwright 渲染中文页面,Sharp 提取像素,再打包为 30 KB 或 96 KB 设备帧。

03

账号与设备配对

使用十分钟有效的一次性配对码绑定设备,食材、设备和访问令牌按账号隔离。

04

MCP 与文字助手

可选让 Agent 查询和管理食材;访问令牌独立授权,删除操作必须再次确认。

三种部署方式公共托管局域网电脑 / NAS自有 HTTPS 云服务器

Section 03 / Hardware

H—01

一份固件,同时支持 C3 与 S3

ESP32 首次启动创建 XianZhiTie-xxxxxx 热点;手机连接后打开192.168.4.1,完成 Wi-Fi、服务地址、配对码、方向与同步间隔配置。

ESP32-C3、ESP32-S3、墨水屏、驱动板、电池与充电模块的硬件组合
Core hardware / C3 & S3ESP32 · E-paper · Driver board · Battery · Charging module
Compact / No PSRAM

ESP32-C3 Super Mini

把四色帧先保存到 FFat,再以 20 行为一组读取并写入屏幕,避免一次申请 96 KB 连续内存。

Expandable / OPI PSRAM

ESP32-S3 N16R8

利用 PSRAM 读入完整四色帧,保留更多扩展空间;上层配网、注册、取帧和休眠流程与 C3 共用。

当前支持的屏幕与帧协议
尺寸面板分辨率颜色帧大小
4.2 寸GDEY042Z98400 × 300黑 / 白 / 红30,000 B
3.97 寸GDEM0397F81800 × 480黑 / 白 / 黄 / 红96,000 B
7.5 寸GDEM075F52800 × 480黑 / 白 / 黄 / 红96,000 B
ETag / 304食材没变化时不下载、不重复刷新
FFat cache下载失败仍保留上一幅有效画面
Deep sleep关闭 Wi-Fi、休眠屏幕与 ESP32

Section 04 / CAD & Print

从实物测量,到可打印外壳

屏幕安装槽与正面可视窗口分别约束;主板、电池、FPC、Type-C、开关和螺丝都作为独立包络参与装配检查。

Section 05 / Reproduce

想复刻?从最短路径开始

  1. 01

    先在线体验注册账号、添加几条食材,在设备页面预览不同面板与方向。

  2. 02

    搭一个 USB 供电原型选 C3 或 S3,接好 SPI 墨水屏,先验证联网与完整刷屏。

  3. 03

    最后再打印外壳确认屏幕、驱动板和接口批次尺寸后,选择 4.2 或 7.2 寸模型。