IOS-INFO-009：阅读位置采集适配器 #117

New Issue

wangdl · 2026-06-10T21:28:11+08:00

wangdl commented

2026-06-10 21:28:11 +08:00

目标

实现不同预览模式下的阅读位置采集适配器，将 PDF / Markdown / Text / Image 等阅读位置统一为 ReadingPositionDTO。

适配对象

PDF page position
Markdown block / scroll position
Text scroll position
Image view position
QuickLook fallback position

输出字段

progress
pageIndex
pageCount
blockId
chapterId
scrollRatio
anchorText
raw

规则

progress clamp 到 0~1。
没有精确位置时至少提供 progress。
PDF 优先 pageIndex/pageCount。
Markdown 优先 blockId/scrollRatio。
Image 可使用 progress=1 或 raw。
position_changed 不应高频刷爆事件，需要 throttle。

验收标准

可从 PDF 阅读页生成 position。
可从 Markdown 阅读页生成 position。
可从普通文本阅读页生成 position。
position 字段 camelCase。
progress 合法。
支持 throttle。
有适配器测试。

## 目标实现不同预览模式下的阅读位置采集适配器，将 PDF / Markdown / Text / Image 等阅读位置统一为 ReadingPositionDTO。 ## 适配对象 - PDF page position - Markdown block / scroll position - Text scroll position - Image view position - QuickLook fallback position ## 输出字段 - progress - pageIndex - pageCount - blockId - chapterId - scrollRatio - anchorText - raw ## 规则 1. progress clamp 到 0~1。 2. 没有精确位置时至少提供 progress。 3. PDF 优先 pageIndex/pageCount。 4. Markdown 优先 blockId/scrollRatio。 5. Image 可使用 progress=1 或 raw。 6. position_changed 不应高频刷爆事件，需要 throttle。 ## 验收标准 1. 可从 PDF 阅读页生成 position。 2. 可从 Markdown 阅读页生成 position。 3. 可从普通文本阅读页生成 position。 4. position 字段 camelCase。 5. progress 合法。 6. 支持 throttle。 7. 有适配器测试。

wangdl added this to the M-IOS-INFO：学习信息采集、上传、继续学习与基础分析闭环 milestone 2026-06-10 21:28:11 +08:00

wangdl added the

labels 2026-06-10 21:28:11 +08:00

Sign in to join this conversation.