设备固件 · NOTE4 · 黑白
Zectrix-claw
面向小学生的 NOTE4 家庭学习伴侣，文档中也称 PocketClaw。将专用固件、Python 本地服务、家长网页与微信小程序结合，提供作业清单、课表、听写、古诗、口算、英语和习惯打卡；AI 与语音服务需按需配置。
它能做什么
面向小学生的 NOTE4 家庭学习伴侣，文档中也称 PocketClaw。将专用固件、Python 本地服务、家长网页与微信小程序结合，提供作业清单、课表、听写、古诗、口算、英语和习惯打卡；AI 与语音服务需按需配置。
今日作业、周课表与习惯打卡，家长网页录入并推送内容
听写、古诗背诵、口算、英语阅读与单词练习
三键操作，配合可配置的语音交互与 AI 学伴
番茄钟、亲子留言与屏保；可自行导入微信小程序源码
安装与使用
让 AI 帮你装好
连接设备，把检测结果和这份固件资料一起交给 AI。
1
确认设备，接上 USB
USB 芯片信息不能区分黑白屏与四色屏，请先确认型号。
接上 USB，检测设备
先识别芯片和容量，让 AI 少问几个问题。
检测可能让设备重启进入下载模式，不会刷写。屏幕型号仍需你确认。
尚未检测。也可以先复制任务，让 AI 协助连接。
2
把安装任务交给 AI
电脑上的 Codex 可以在本机安装依赖和运行程序。
AI 会接着做这些事
核对兼容性 → 准备固件和完整备份 → 协助本机安装 → 检查首次运行
复制后，在电脑上的 Codex 新建对话并粘贴。
看看交给 AI 的内容
只包含项目资料与本次选择的设备信息。网络地址、账号和密钥在安装时由你本地配置。
3
装好以后，看这一眼
设备能展示Zectrix-claw的预期画面，重复更新仍然正常。
让 AI 汇报安装位置、验证结果和以后怎么启动；有问题时在同一个对话继续处理。
熟悉安装？查看手动步骤与源码
NOTE4 黑白屏 · ESP-IDF 5.4+ · Python 3.10–3.12 常驻服务 · 同一局域网 · 可选 AI／识图／语音接口
先启动本地服务
在 Windows、macOS 或 Linux 上准备 Python 3.10–3.12。在 server 目录建立独立虚拟环境并安装 requirements.txt，首次从 .env.example 创建配置，保留原有 .env 和 data。运行 python serve.py，先访问 http://127.0.0.1:8000/pocketclaw/parent 检查家长页面。
备份并构建 NOTE4 固件
先保存自己设备的完整 Flash 备份并核对恢复方式。当前组件清单要求 ESP-IDF >=5.4.0，优先于 README 的 5.3 标注；在 zectrix 工程中选择 ESP32-S3，按作者文档编译并使用自己的串口烧录。尚未发现正式 Releases 安装包；该固件替换设备原系统，不适用于 NOTE4C。
连接设备与家长端
将设备服务地址设为自己的 ws://主机IP:8000/pocketclaw，核对网络、作业清单、按键和音频。家长网页可在同一局域网访问；小程序需自行用微信开发者工具导入并配置 AppID 与服务地址，不是已发布的小程序。默认家庭局域网模式不应直接暴露公网；跨网络使用需配置认证或家庭隔离及 HTTPS/WSS。
源码与界面预览已核对 · 固件实机待验证。生成任务不会自动发送，也不会执行安装。
常见问题
全部功能都能离线使用吗？
不能。基础功能依赖持续运行的本地服务，离线规则库能力有限。在线 AI 对话、拍照识别与语音需要分别配置服务与 API 权限；启用在线模型时，对话、所选照片及填写的孩子资料可能发送至配置的服务。
Windows 可以完成全部部署吗？
服务端文档支持 Windows Python 3.10–3.12，使用 requirements.txt，不直接使用含平台限定依赖的锁文件。USB 凭据工具和部分测试依赖 POSIX 串口或 pty，作者注明需 macOS/Linux 或 WSL，未完成原生 Windows 真机验证。
页面图片和验证代表什么？
配图来自作者的 400×300 作业清单预览，不是本站实机照片。本站运行服务端测试：218 项通过、1 项课程表显示断言失败（测试预期两门课同一行，当前为分行显示）。固件编译、USB 烧录、设备音频和微信小程序真机体验尚未独立验证。
你可能还喜欢
浏览更多固件 →
