EinkWordsGPT 与 7.3 英寸电子纸：一次归档项目核验

历史版本 EinkWordsGPT 在七色电子纸上显示的单词卡

2026 年 9 月归档说明： 这个原型使用的是已经停产的 Waveshare 7.3 英寸 F 屏。如果要换成现售 E 屏重新制作，请从对应驱动开始，先验证显示，再迁移单词卡代码。

最初的想法很简单：让 Raspberry Pi 准备一张词汇卡，渲染单词、音标、彩色音节和日语释义，再把结果留在反射式屏幕上。电子纸无须持续刷新也能保留最后一幅图像，因此很适合“随时可见、却不强迫你注意”的信息。

现在更值得保留的，不是“买下这些零件，运行这个脚本”，而是如何分清归档材料已经证明了什么，以及新装置仍须验证什么。

Table of Contents

状态概览

问题	归档能够说明什么
是否演示过七色单词卡？	是。保留的照片和渲染代码支持这一历史结果。
代码针对哪一块屏幕？	已停产的 Waveshare 7.3inch e-Paper HAT (F)，使用 `epd7in3f` Python 驱动。
项目是否写明 Raspberry Pi 5？	是，但归档没有保留系统镜像、HAT 版本、驱动提交、接线记录或全新安装证明。
现售 7.3inch e-Paper HAT (E) 是否可以直接替换？	尚未证明。Waveshare 为它提供不同的 `epd7in3e` 示例，因此必须单独迁移测试。
Local Knowledge Terminal 现在能驱动电子纸吗？	不能。浏览器输出可用；在选定面板和色彩配置前，电子纸适配器会明确报告不可用。

归档代码实际做了什么

主程序导入 waveshare_epd.epd7in3f，打开本地 SQLite 单词数据库，并从本地环境创建 OpenAI 客户端。它用 Pillow 生成 RGB 图像，为音标和拼写片段分配颜色，绘制带读音提示的日语释义，将图像缩放到面板尺寸，再把缓冲区发送到屏幕。

连续循环会选择一个单词，等待 300 秒后再更新。程序只在退出时清屏并让面板休眠。这能说明程序原本打算怎样工作，却不能证明它已经是无人值守服务，也不能证明它能从断电中恢复或适合长期运行。

语言模型生成的词汇字段同样需要人工复核。音标分段、音节边界、日语选词和读音，即使在卡片看起来很漂亮时也可能出错。

重新制作前还要核对什么

工作照片很有用，但无法恢复复现硬件项目所需的全部细节。这份归档没有记录：

HAT 或驱动板上印刷的具体版本；
使用的是 HAT 排针还是连接线；
Raspberry Pi OS、内核、Python 环境或驱动提交；
准确的电压与供电方式；
依赖锁定文件或全新安装流程；
中断、网络故障、API 故障或 BUSY 引脚卡住后的行为；
适合长期运行的刷新与休眠方式。

归档副本还提到 requirements.txt、LICENSE 和随项目附带的 Waveshare 库，但这些文件并不存在于该副本中。因此应把它视为设计证据和原型源码，而不是一条命令即可安装的产品。

准确硬件与现售产品边界

代码与复制的厂商示例都指向 7.3inch e-Paper (F) 驱动。Waveshare 把 F 屏记录为 800×480、七色、SPI 接口的电子纸。其手册给出的典型全刷时间约为 35 秒，并规定了较窄的工作温度范围；实际表现仍取决于具体板卡与环境。

Waveshare 现已把 F 产品标为停产，并推荐 7.3inch e-Paper (E) 作为替代方案。“替代”不等于“直接兼容”。现行 E 手册使用 epd7in3e，归档程序却使用 epd7in3f。不能假定旧的图像编码、颜色常量、初始化顺序、HAT 版本或时序可以原样复用。

先迁移、后购买的清单

购买或连接替代面板前：

记录准确的产品名、SKU、HAT 印刷版本，以及它究竟是 HAT 还是裸屏。
阅读该准确版本的手册；核对电压、SPI 引脚、GPIO 映射、温度范围与供电要求。
从匹配的现行厂商驱动和静态图片示例开始，而不是从归档的 epd7in3f 应用开始。
先测试一张厂商图片，再测试一张本地生成的 800×480 图片，之后才加入网络或模型调用。
验证面板的颜色转换，不要直接复用归档中非正式的 RGB 调色板。
为 BUSY 引脚、API 故障和刷新中断增加超时与安全恢复路径。
每次更新之间，按厂商建议让面板进入休眠或断电状态。
重新演练全新安装，并记录系统、软件包版本、驱动提交、接线、供电和输出照片。

只有完成这些步骤后，才应该把词汇流程迁移到替代驱动。

与 Local Knowledge Terminal 的关系

较新的 Local Knowledge Terminal（LKT）继承了这个想法中更有价值的部分：多语言术语、词义、词源、词根、词缀、历史词形与来源链。

目前可用的输出是浏览器界面。电子纸仍是独立适配器，需要在准确的面板和色彩配置上另行测试。

如果你已经有一套权利清晰的术语表、词典或阅读资料，想测试它能否在自己的机器上变成带来源的本地卡片，可以先看这份 LKT 适配报告样例。

参考资料与来源说明

本文 2025 年版本原本是一篇宽泛的“偷懒的艺术”项目概览。2026 年 9 月修订版把范围收窄到照片中的电子纸原型，依据保留代码和厂商文档核对说法，并明确写出停产硬件边界。原始导出仍保存在博客仓库中。