用途:把文档转换为快速串行视觉呈现(RSVP)令牌流,按目标 WPM 给出每个单词的 ORP 索引与显示延迟,供阅读界面逐词闪现使用。适用触发场景包括用户要求“speed read/RSVP 某文件”“以 N WPM 阅读”、上传文档要求快速阅读、要求生成令牌流或提到 Spritz、ORP 对齐。
主要能力:解析 .txt、.md、.pdf、.docx;按 Spritz ORP 公式计算识别点;按 WPM 校准延迟;可选在句末插入额外延迟。输出令牌示例:{"w": "Hello", "orp": 1, "delay_ms": 200, "is_sentence_end": false, "is_para_end": false}。
使用方式:依赖仅需 Python 3.8+ 标准库,requirements 锁文件目前为空。安装:pip-compile ./requirements.in 与 pip install -r ./requirements.txt。执行分两步:python ./scripts/parse_document.py --input <file_path> --output /tmp/rsvp_words.json;然后 python ./scripts/orp_engine.py --input /tmp/rsvp_words.json --wpm <wpm> --output <output_path>。执行前需收集文件路径与 WPM(默认 300,范围 100–1000),可选输出 JSON 路径(默认 ./rsvp_output.json)、句末暂停(默认 false)、ORP 对齐(默认 true)。完成后报告总词数、预计阅读时长、输出路径及前 5 个令牌预览。超过 50000 词会先显示确认门。
限制:扫描版或图片多的 PDF 词提取可能退化,建议用 .txt 或 .md;WPM 高于 800 可能降低理解,仅警告不阻止;超过 50000 词需确认;ORP 公式针对英语优化,其他语言 ORP 位置可能欠佳。