为什么值得关注

它将越狱Kindle的电子墨水屏与现代云后端及Telegram聊天输入相结合，支持离线缓存、实时SSE更新以及带AI回退的灵活消息解析，是一种独特的低功耗交互式规划方案。

适合谁使用

越狱Kindle的极客用户
对电子墨水仪表盘感兴趣的开发者
自托管个人规划后端的爱好者
希望通过Telegram管理任务并拥有实体显示的用户

典型使用场景

在电子墨水屏上查看每日规划概览
通过Telegram添加购物清单或任务
将Apple Health数据同步到仪表盘
离线可用的低功耗仪表盘场景

项目优势

原生C++渲染器，快速刷新电子墨水屏
支持离线缓存和网络故障时的优雅降级
灵活的消息解析，含AI（OpenAI）和确定性回退
实时SSE事件驱动更新，实现变更检测

使用前须知

需要越狱Kindle并安装KUAL
依赖第三方后端服务InsForge
无触摸框架，需手动坐标点击处理
仅支持iOS健康同步，无Android版本

README 快速开始

Kindle Planner Dashboard

Monochrome, Kindle-friendly planner dashboard with Telegram bot updates.

Requirements

A jailbroken Kindle with KUAL installed for the native dashboard.
Node.js 20+ and npm for scripts, checks, and backend bootstrapping.
An InsForge account for the database, edge functions, and secrets.
A Telegram bot token from BotFather for chat-based planner updates.
Optional: an OpenAI API key for natural-language message parsing. Without it, the webhook uses the built-in command parser.
Optional: Zig or a Kindle-compatible ARM cross compiler to rebuild the KUAL package.
Optional: Xcode and a real iPhone for the Health Sync companion app.

Setup Instructions

This repo can be published as a bring-your-own-backend kit. Each owner runs their own InsForge project, Telegram bot, and KUAL package config instead of connecting to this checkout's production backend.

Start with docs/INSTALL_FOR_USERS.md.

If you are using a coding assistant for setup, use docs/SETUP_WITH_ASSISTANT.md.

Project Structure

functions/: InsForge edge functions for dashboard JSON, live events, item toggles, Telegram parsing/actions, version checks, and Health Sync uploads.
migrations/: Postgres schema and optional sample-data migrations used by the bring-your-own-backend setup.
kindle/native/: Native C++ e-ink dashboard renderer, local render check, and KUAL package build targets.
kindle/kual/kindle-dashboard/: KUAL extension files, shell launchers, placeholder assets, and config.sh.example.
kindle/launch-dashboard.sh: Kindle-side launcher used by installed shortcuts and native install helpers.
ios/HealthSyncCompanion/: Optional iOS app that reads Apple Health daily aggregates and posts them to the health-sync function.
scripts/: Setup and maintenance helpers for InsForge bootstrapping, Telegram webhook configuration, Kindle native install, and Kindle proof checks.
docs/: Human and coding-assistant setup guides.

Technical Breakdown

The Stack

Renderer: Native C++ app

Backend: InsForge

Inputs: Telegram bot + iOS HealthKit

Code entry points:

Native app: kindle/native/src/kindle_dashboard.cpp
Backend functions: functions/
Health companion: [`ios/

kdashboard