待办同步Microsoft To Do 双向同步
Microsoft To Do 双向同步到设备待办；该项目不生成独立墨卡图片。
自定义墨卡 · NOTE4 · 黑白
NBA 赛程赛况看板
用一张固定版面查看比分、下一场对阵、近期赛果与一条中文 NBA 热点。
它能做什么
用一张固定版面查看比分、下一场对阵、近期赛果与一条中文 NBA 热点。
按 LIVE / NEXT / FINAL / REST 切换内容
ESPN 赛事主源与中文热点
离线样例、缓存回退与定时推送
安装与使用
让 AI 帮你装好
填入 Key，把任务交给本地 AI。安装、预览和设备查找由 AI 完成。
1
连接 NOTE，交给 AI
只需 API Key，MAC 可以让 AI 自动找
AI 用 Key 列出设备，你只需确认要用哪台。
打开云平台获取 Key ↗
现在怎么获取？
云平台扫码登录 → 小程序“我的”中扫一扫登录平台 → 网页“开放 API” → 创建 API Key。
计划中的更短入口：小程序菜单“获取 API”。该入口目前还未上线。
指定设备和墨卡位置（可选）
不知道就留空，AI 通过官方设备列表取得，不用到设备菜单里翻找。
这是图片槽位 1–5。首次推送前，AI 会确认目标设备和位置，避免覆盖已有内容。
Key 只用于保存在本机的连接文件，不会进入复制给 AI 的任务。
此标签页已记住连接文件信息
Key 在你保存的本机文件中，页面只记住文件名和设备选择。换插件可以复用。
电脑、设备和项目要求
本项目适用于 NOTE4 · 黑白。
- 原厂固件 NOTE4 · 电脑 / VPS 上的 Python 3 · Pillow / CairoSVG · 自己的 API Key
看看交给 AI 的内容
任务包含项目资料、标准 API 文档、连接文件名与设备选择。API Key 只在本机文件中，不会被复制到任务里。
2
装好以后，看这一眼
NOTE 屏幕出现赛事看板；再次运行可以更新赛程或比分。
AI 先生成预览，再与你确认目标设备和首次更新。完成后汇报安装位置、验证结果和以后怎么启动；有问题时在同一个对话继续处理。
熟悉安装？查看手动步骤与源码
原厂固件 NOTE4 · 电脑 / VPS 上的 Python 3 · Pillow / CairoSVG · 自己的 API Key
准备电脑或 VPS
NBA 程序在电脑或 VPS 运行，不需要给 NOTE4 刷机。机器需能访问赛事和新闻数据源、极趣云。
安装与初始化
按下方 README 的 VPS 安装命令准备依赖，交互式输入自己的 API Key、设备标识与页面号。默认页面为 3，配置保存在用户目录。
分层检查画面
先生成离线样例，再联网获取数据但不上传。确认日期、比赛状态与中文热点后再执行云端推送。上游数据源暂时不可用时可能使用缓存。
按自己的需求定时
当前 README 的最短建议周期为 10 分钟，并提供随赛事状态降低频率的脚本。设备实际更新还受轮询影响，不等同于逐秒直播。
1. 在电脑 / VPS 安装依赖
mkdir -p ~/services
cd ~/services
git clone https://github.com/happynailinzz/zectrix-nba-board.git
cd ~/services/zectrix-nba-board
python3 -m venv .venv
.venv/bin/python -m pip install --upgrade pip
.venv/bin/python -m pip install -r requirements.txt2. 交互式配置自己的设备
.venv/bin/python scripts/init.py3. 离线样例（不联网、不上传）
.venv/bin/python scripts/nba_board.py --offline-sample --output /tmp/nba-sample.png4. 实时预览（联网、不上传）
ZECTRIX_NO_PUSH=1 .venv/bin/python scripts/nba_board.py --output /tmp/nba-live-check.png5. 确认后推送到自己的设备
.venv/bin/python scripts/nba_board.py公开 README 已核对 · 本机部署与实屏推送待验证。生成任务不会自动发送，也不会执行安装。
常见问题
NBA 数据源还要申请 API Key 吗？
当前默认赛事与新闻使用公开数据源，无需另外的赛事 API Key；向自己的 NOTE4 推送仍需要 ZECTRIX API Key。
它会不停轮播多个页面吗？
项目保持一张固定版面，在同步时按比赛状态更换主卡内容。
为什么赛事更新慢或使用旧结果？
数据源、网络、调度周期和设备轮询都会影响更新。项目在源不可用时使用最近成功缓存，需检查更新时间。
