KindleBoard

把旧 Kindle Paperwhite 1 改造成家庭公告板，并以同一套内容模型探索电子菜谱。

当前进度

• PW1 从 5.6.1.1 降级至 5.3.3 并越狱
• 升回官方 5.6.1.1，并安装越狱 Hotfix
• 安装 MRPI、DevCerts、KUAL 2.7.37
• 安装 Python 3.9 与 linkss 0.25.N
• 在真机显示自定义 758x1024 屏保
• 生成一屏显示七天的每周菜单
• 部署局域网发布服务到 miniPC
• 通过 KUAL 手动拉取，并验证无更新时不重复下载
• 使用 FBInk 全屏显示，不保留 Kindle 顶部状态栏
• 通过 PW1 的 mxc_rtc 深度休眠、唤醒并重新联网同步
• 提供 KUAL 手动启动的每日公告板模式和 USB 停止标记
• 提供局域网每周菜单编辑、预览与安全发布页面
• 完成每日模式的长期续航观察
• 决定外网发布及手机入口
• 电子菜谱原型

近期最小闭环

结构化公告 -> renderer -> 758x1024 PNG + state.json
                              |
                              v
                     HTTP 静态文件目录
                              |
                              v
        Kindle 每日唤醒，主动检查版本并下载新图
                              |
                              v
         FBInk 全屏显示 -> mxc_rtc 深度休眠

发布服务运行在局域网 miniPC。具体地址和 SSH 账户保存在不提交的 config.local.json；KindleBoard 不开放公网，外网访问与认证留到后续单独设计。

目录

• docs/：设备状态、架构和决策记录
• renderer/：图片渲染器
• kindle/：Kindle 端扩展与同步脚本
• content/：结构化公告内容
• web/：局域网发布服务与响应式菜单编辑页面
• assets/reference/：已人工验证的参考图片
• output/：本地生成图片，Git 忽略

本地运行

要求 Node.js 20+ 和 Python 3。首次运行：

npm install
npm run check
npm run serve

服务默认监听 8787 端口，并在启动时列出本机与局域网地址。Kindle 扩展的安装和配置见 docs/setup.md。

从 /templates 选择主菜＋副菜、主菜菜单或家庭公告板。编辑模板从空白开始，生成预览不会发布；确认后才备份并更新内容。/published 可只读查看当前发布图片，不代表 Kindle 已同步。服务只应通过局域网防火墙开放，不提供公网访问。

miniPC 的 SSH 快捷入口：

npm run ssh