Fable 将 reMarkable 平板变成哈利·波特的里德尔日记：开源魔法让手写笔记可交互

通过开源工具 Fable，将 reMarkable 平板改造成类似哈利·波特中汤姆·里德尔日记的交互式手写设备，实现实时响应、动画绘制与数据持久化。

背景：从魔法到代码的灵感

在《哈利·波特》系列中，汤姆·里德尔的日记是一本“活”的魔法书——当你用羽毛笔在上面写字时，墨水会消失，然后日记本会通过浮现的文字与你对话。这个创意激发了开发者 Maxime Rivest 创建了 Fable 项目，其核心目标是将 reMarkable 平板（一款专注于手写笔记的电子墨水设备）变成一个可编程的交互式画布。

reMarkable 平板本身是一台基于 Linux 的电子纸设备，支持手写笔输入，但默认系统只提供基础的笔记和阅读功能。Fable 通过直接与 reMarkable 的底层输入系统交互，捕获笔迹数据，并利用 WebSocket 实时传输到自定义渲染引擎，从而实现“写下去就有反馈”的魔法效果。

技术架构：Fable 如何工作

Fable 的架构分为三层：

1. 输入捕获层：在 reMarkable 上运行一个守护进程（daemon），通过监听 /dev/input/event* 设备文件获取笔的原始触摸事件。reMarkable 的笔使用 Wacom 电磁感应技术，每毫秒发送 X/Y 坐标、压力值（0-4095）、倾斜角（包括 azimuth 和 altitude）以及笔是否接触屏幕的状态。Fable 将这些事件打包成 JSON 格式，通过 WebSocket 发送到服务端。

2. 实时通信层：使用 WebSocket 协议实现低延迟双向通信。reMarkable 作为客户端连接到一个运行在本地网络或云端的 Node.js 服务器。服务器接收笔迹数据后，立即将其转发给前端渲染模块。延迟通常控制在 10-20ms 以内，足以模拟“即时响应”的魔法感。

3. 渲染与交互层：前端使用 HTML5 Canvas 或 WebGL 进行渲染。关键特性包括：

   • 笔迹动画：不是简单显示线段，而是根据笔的移动速度、压力动态生成“墨水消失”或“文字浮现”的动画效果。例如，当用户写完一个字符后，该字符会像被吸收一样逐渐淡化，然后从另一个位置重新绘制出来。
   • 智能识别：集成了手写识别库（如 MyScript 或 TensorFlow Lite 模型），将手写内容转化为字符串。识别结果可以作为触发后续行为的“咒语”——比如写下“lumos”会点亮屏幕，写下“obliviate”会清除笔迹。
   • 状态持久化：所有笔迹和对话记录存储在 SQLite 数据库中。每次打开日记时，系统会从数据库加载上一次的“对话历史”，并逐页渲染。

实现细节：从 raw 事件到魔法效果

1. 笔迹捕获与坐标转换

reMarkable 的屏幕分辨率为 1872×1404（在 10.3 英寸屏幕上为 226 DPI），但触摸控制器返回的坐标范围是 0-4095（12 位 ADC）。Fable 使用以下公式进行归一化：

python
x_normalized = x_raw * 1872 / 4096
y_normalized = y_raw * 1404 / 4096

同时，压力值（0-4095）被映射到 0-1 的浮点数，用于控制笔画的透明度或宽度。

2. 魔法动画引擎

Fable 的动画引擎基于 requestAnimationFrame 循环，每帧处理三个队列：

• 写入队列：存储最近 50ms 内捕获的笔迹点，用于实时渲染“墨水”效果。
• 消失队列：存储已经写入超过 500ms 的笔画，逐帧降低其透明度（alpha 值从 1 降到 0，历时 1 秒）。
• 浮现队列：存储“回复文字”的动画帧。例如，当系统检测到用户写完了“Hello”，它会生成一个包含“Hello, young wizard”的文本块，然后每个字符以随机延迟（0-200ms）从底部弹出并稳定在指定位置。

3. 对话逻辑：状态机设计

Fable 内置了一个简单的有限状态机（FSM）来模拟“日记本有自我意识”的体验：

• IDLE：等待用户输入。屏幕显示“以空白页”或“上次对话的最后一行”。
• WRITING：用户正在书写。系统实时捕获笔迹，但不做任何交互。
• PROCESSING：用户停止书写超过 1 秒。系统触发 OCR 识别，将手写内容转为文本，然后根据预设规则生成回复（支持自定义 JSON 规则文件，如“如果内容包含‘你好’，则回复‘欢迎回来’”。）
• ANIMATING：系统正在播放“墨水消失”和“文字浮现”动画。期间禁用笔输入，防止冲突。
• DISPLAYING：动画完成，显示完整对话。用户可继续书写。

4. 硬件适配与性能优化

reMarkable 使用 1.2GHz ARM Cortex-A9 处理器和 512MB RAM，性能有限。Fable 做了以下优化：

• 事件批处理：不将每个触摸事件单独发送，而是累积 5ms 内的所有事件打包发送，减少 WebSocket 帧数。
• Canvas 分层：使用两个叠加的 Canvas——底层用于显示永久笔迹（仅当确认“保存”后才渲染），上层用于显示动画和临时笔迹。这样在动画过程中无需重绘整个页面。
• 降采样：对于快速移动的笔画（如草书），每 2 个点只取 1 个，减少渲染计算量，同时保留视觉连贯性。

安装与配置

Fable 的安装需要 reMarkable 开启 SSH 访问（通过 reMarkable 设置中的“开发者模式”）。基本步骤：

1. 在 reMarkable 上安装 Node.js（使用 entware 包管理器）。
2. 克隆 Fable 仓库，运行 npm install。
3. 在 reMarkable 上启动守护进程：node server.js。
4. 在电脑浏览器上打开 http://remarkable-ip:3000，即可看到实时笔迹。

用户可以通过修改 config.json 自定义魔法效果：

• "ink_color": "#1a1a2e"：墨水颜色
• "fade_duration_ms": 800：墨水消失的持续时间
• "response_delay_ms": 1500：系统回复前的延迟（模拟“思考”时间）
• "ocr_enabled": true：是否启用手写识别
• "auto_save": true：是否在每次对话后自动保存到 SQLite

扩展与创意应用

Fable 不仅是一个哈利·波特粉丝项目，它展示了电子墨水设备作为“魔法界面”的潜力：

• 互动故事书：通过手写触发不同的剧情分支。例如，写下“去森林”会显示森林地图，写下“回村子”则显示村庄场景。
• 加密日记：结合 AES 加密，只有在写下正确的“咒语”时才会解密内容。
• 多用户协作：多个 reMarkable 设备连接到同一服务器，实现“远程笔迹同步”——你和朋友可以在各自的日记本上看到对方的书写过程。
• 实时翻译：当识别到用户用一种语言书写时，自动用另一种语言回复。

局限与未来改进

当前 Fable 的局限性包括：

• 手写识别精度有限，尤其是连笔字和中文（MyScript 对中文支持较好，但需要额外付费的 API key）。
• 动画效果依赖浏览器渲染，如果使用 reMarkable 本身的电子墨水屏幕进行显示（而非外接电脑浏览器），刷新率只有 15Hz，无法实现流畅动画。目前项目默认是在电脑浏览器上观看魔法效果，而 reMarkable 本身只作为输入设备。
• 对话逻辑基于简单规则，缺乏真正的自然语言处理。未来可以集成 GPT 等大语言模型，让日记本真正“像人一样对话”。

总结

Fable 项目巧妙地将硬件黑客技巧、实时通信和创意编程结合在一起，把一个普通的电子纸平板变成了充满魔幻色彩的交互工具。它不仅是技术演示，更是对“数字与魔法融合”这一概念的实践——当我们在电子墨水上写字时，每一笔都可以是代码，每一次停顿都可能是对话的开始。

原文链接：https://github.com/MaximeRivest/Riddle