# menu-board-note4 **Repository Path**: gu-yajing/menu-board-note4 ## Basic Information - **Project Name**: menu-board-note4 - **Description**: NOTE4 墨水屏每周菜单看板:周一至周五菜单 + 采购清单,当天高亮 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-16 - **Last Updated**: 2026-11-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 家宴看板 Menu Board > ZECTRIX NOTE4 本地推送应用 · 参赛作品 让「今天吃什么」一直摆在桌边。运行在电脑上的小程序,把一周家庭菜单 (周一~周五,每天一荤一素一汤)和按类别汇总的采购清单推到 NOTE4 墨水屏上, **今天那一行自动黑底高亮**,上下键翻页、确认键刷新。 ![本周菜单](docs/demo-menu.png) ![采购清单](docs/demo-shopping.png) ## 功能 - **第 1 页 · 本周菜单**:周一~周五,每天一荤一素一汤;**当天整行黑底白字高亮**, 常驻跨过午夜会自动按新日期重渲染并刷新 - **第 2 页 · 采购清单**:按水产 / 肉禽 / 蛋奶 / 蔬菜 / 干货 / 调味分类汇总本周食材 - **按键交互**:上/下键翻页,确认键重新读取并刷新当前页(改了图不用重启程序) - **自动排菜**:`weekly_gen.py` 读学校「一餐两点」菜单 + 冰箱现有食材, 避开与学校同类的主料、优先用掉已买食材,一周五天不重样,周四自动排一道高蛋白(游泳课日) - **截图识别**:配套网页工具支持上传学校菜单截图,浏览器内 OCR 识别后自动生成(可选,纯本地运行) - **稳**:断线按 10s→20s→40s→60s 退避自动重连,设备休眠回来画面自动恢复; Ctrl+C 退出会调用 `close()` 释放设备租约;十六灰阶输出 ## 更新记录 **v1.1.0** - 新增「本周特殊情况」:直接写「游泳课改到周三」,高蛋白主菜自动跟着换到那一天(Python 端 `--swim 周三`) - 指定排期容错解析:`星期四` / `周4` / 顿号空格分隔 / 菜名写简称都能认,认不出的条目会红字提示而不是静默失效 - 网页工具「导出」后弹窗直接预览两页墨水屏画面(400×300),每页可下载 PNG 或一键复制 - 修 3 个 bug:排期防抖定时器二次生成冲掉结果、指定菜与库存撞同一食材、同一天多条指定互相覆盖 - 菜库调整:新增生煎三文鱼 / 白灼三文鱼,移除南瓜浓汤 **v1.0.0** 首个发布版:菜单页 + 采购页推送、当天高亮、断线重连、跨天自动重渲染 ## 环境要求 | 项目 | 要求 | | --- | --- | | 设备 | ZECTRIX NOTE4 黑白墨水屏(400×300),**不适用 NOTE4C** | | 固件 | 官方本地推送 SDK 0.2.0 配套版本;**3.7.2 实测可用**,本程序不刷机、不升级固件 | | 网络 | 电脑与 NOTE4 处于同一局域网;设备「设置 → 网络同步 → 待机保持 Wi-Fi」需开启 | | 构建 | Rust stable(Windows 用 MSVC 工具链)、CMake、Python 3 + Pillow | ## 快速开始 把下面整段丢给 Codex / Claude Code / WorkBuddy 之类的 AI Agent,它能自己跑完: > 帮我安装 NOTE4 本地推送应用「家宴看板」。先 `git clone https://github.com/itopinion/zectrix-local-push-sdk.git`, > 把 SDK 和本应用目录放在同一个父目录下(本应用以 `../zectrix-local-push-sdk` 路径依赖它)。 > 然后在本应用目录执行 `cargo build --release`(Windows 若 CMake 报策略错误,先设 > `CMAKE_POLICY_VERSION_MINIMUM=3.5`),再用 `python render_cards.py` 生成两页图, > 最后 `cargo run --release -- <我的设备IP> pages gray16` 推送并保持运行。不要升级设备固件。 手动执行等价于: ```sh git clone https://github.com/itopinion/zectrix-local-push-sdk.git # 与本目录同级 cd note4-menu-board pip install pillow cargo build --release # Windows: set CMAKE_POLICY_VERSION_MINIMUM=3.5 python render_cards.py # 读 menu.json → pages/01_menu.png、02_shopping.png cargo run --release -- 192.168.1.100 pages gray16 ``` 不记得设备 IP 时可用 `cargo run --release -- discover`(mDNS 自动发现)。 启动后设备上:**上/下键翻页**,**确认键刷新当前页**,上下键长按退出应用回到系统界面。 ## 每周更新菜单 1. 拿到学校本周「一餐两点」菜单,写进 `school.txt`(顿号/逗号/换行分隔都行) 2. 把冰箱里剩下的食材写进 `stock.txt`(如 `鳝鱼丝、半只鸡、娃娃菜`) 3. 生成并渲染: ```sh python weekly_gen.py # 生成 menu.json python render_cards.py # 渲染两页 PNG ``` 4. 在设备上按**确认键**刷新,上下键翻到另一页也刷一下,完成——不用重启程序。 想固定某天吃某道菜: ```sh python weekly_gen.py --pin 周一=鳝鱼丝炒香干 --pin 周四=香煎鲳鱼 ``` 不想开命令行,也可以用配套的《每周菜单轮换工具.html》(浏览器打开即可): 填库存、上传学校菜单截图 → 识别 → 生成 → 「导出 menu.json」覆盖到本目录 → `python render_cards.py`。 ## 目录结构 ``` note4-menu-board/ ├── src/main.rs # 推送主程序:连接/翻页/刷新/断线重连/跨天重渲染 ├── Cargo.toml # 依赖 ../zectrix-local-push-sdk(0.2.0) ├── weekly_gen.py # 排菜:学校去重 + 库存优先 + 周四高蛋白 ├── render_cards.py # 渲染 400×300 两页 PNG(跨平台中文字体查找) ├── menu.json # 本周菜单数据(生成产物,也是渲染输入) ├── school.txt # 学校本周菜单(输入示例) ├── stock.txt # 家庭现有食材(输入示例) ├── pages/ # 01_menu.png / 02_shopping.png(程序读取这里) └── docs/ # 演示图 ``` ## 排菜规则 - **学校去重**按主料关键词:学校吃鸡,家里不排鸡;学校吃鱼,家里不排鱼 - **库存优先**:已买食材优先安排,即使与学校同类也照排(买了猪肚和半只鸡,猪肚鸡照上) - 一样库存只被一道菜消费(鸡蛋等常备食材不限);同一周不重复买两份鳝鱼丝这类水产/肉禽 - 游泳课日自动排一道高蛋白主菜,默认周四;`--swim 周三` 可把高蛋白日跟着改(课程调期) - 指定某天吃某道菜:`--pin 周四=香煎鲳鱼`(同一天可写多条,撞食材的菜自动让位);网页工具里直接输入「游泳课改到周三」「周四=白灼三文鱼」,点导出按钮还能生成 400×300 的墨水屏画面预览(下载/复制) - `--seed` 可换一版结果 ## 设计说明 - 每次显示都从磁盘重新读取 PNG,图片更新即刷即用,程序可长期驻留 - 当天高亮按系统日期计算,跨天自动重渲染推送 - 遵循官方运行约定:单设备单连接、正常退出调用 `close()`、不把传输完成当显示完成、 `ResultUnknown` 不自动重发 - 400×300 按墨水屏特性排版:大字号、高对比;菜名超宽自动缩小字号不贴边 ## 常见问题 - **连接报 Busy / 超时**:设备同一时间只接受一个程序。之前强杀过进程的话,租约要等约 1 分钟, 稍等重试即可;或先正常退出旧程序。 - **设备休眠后断连**:开启「待机保持 Wi-Fi」,并注意电量(低电会休眠断连)。 - **渲染报找不到中文字体**:安装 Noto Sans CJK / 微软雅黑,或用环境变量 `MENU_FONT` / `MENU_FONT_BOLD` 指定字体文件。 - **Windows 构建失败**:设置 `CMAKE_POLICY_VERSION_MINIMUM=3.5`;确认用的是 MSVC 工具链 (`rustup default stable-msvc`)。 ## License MIT。本地推送 SDK 部分遵循其原始许可证。