DOC-FULL-032 P1 | 文档：Supported Formats 【status:partial】 #81

New Issue

wangdl · 2026-06-07T11:33:20+08:00

wangdl commented

2026-06-07 11:33:20 +08:00

每种格式的 MaterialType/PreviewMode/DocumentInfo 能力/Search 能力/Position 能力/Anchor 能力/限制

M-DOC-FULL 里程碑 issue。详见设计文档。

## 每种格式的 MaterialType/PreviewMode/DocumentInfo 能力/Search 能力/Position 能力/Anchor 能力/限制 M-DOC-FULL 里程碑 issue。详见设计文档。

wangdl added this to the M-DOC-FULL：Document Runtime 完整阅读内核与学习事件协议 milestone 2026-06-07 11:33:20 +08:00

wangdl changed title from ~~DOC-FULL-032 P1 | 文档：Supported Formats~~ to DOC-FULL-032 P1 | 文档：Supported Formats 【status:partial】

2026-06-07 19:15:08 +08:00

wangdl commented

2026-06-07 19:15:08 +08:00

审查结论：document runtime 当前有文件类型识别/MaterialType/PreviewMode/DocumentInfo(基本)/Markdown解析/Text解析/ImageMeta/Search(V1 Markdown+Text)/NoteAnchor(V1)/ReadingEvent(V1)/ReadingPosition(V1)/EventBuffer(V1基础)/iOS构建/UniFFI绑定/docs。但 V2 核心模型(ReadingSession/EventV2/ActiveTimeTracker)不存在，EventBuffer 缺 ack/failed，Position 缺 camelCase+clamp，PDF/EPUB/Office 为 stub，测试覆盖不足 V2。

本 Issue: docs/supported-formats.md 存在。需更新为完整能力矩阵。

状态: status:partial
工作类型: work:docs

## 审查结论：document runtime 当前有文件类型识别/MaterialType/PreviewMode/DocumentInfo(基本)/Markdown解析/Text解析/ImageMeta/Search(V1 Markdown+Text)/NoteAnchor(V1)/ReadingEvent(V1)/ReadingPosition(V1)/EventBuffer(V1基础)/iOS构建/UniFFI绑定/docs。但 V2 核心模型(ReadingSession/EventV2/ActiveTimeTracker)不存在，EventBuffer 缺 ack/failed，Position 缺 camelCase+clamp，PDF/EPUB/Office 为 stub，测试覆盖不足 V2。 **本 Issue**: docs/supported-formats.md 存在。需更新为完整能力矩阵。 **状态**: status:partial **工作类型**: work:docs

wangdl commented

2026-06-07 22:01:12 +08:00

完成报告

更新内容

docs/supported-formats.md 新增：

第二版（已支持）：EPUB 元数据/章节列表 + PDF 元数据/页数检测 + Office 预览策略
EPUB 能力矩阵（元数据/章节/NCX/NAV 状态）
PDF 能力矩阵（元数据/页数/文本/搜索状态）
Office 能力矩阵（Word/Excel/PPT 策略+搜索）
第三版（计划）：PDF 增强（pdfium）+ EPUB3 NAV

当前覆盖

格式	MaterialType	PreviewMode	搜索	Position	Anchor
Markdown	Markdown	NativeReader	✅ search_blocks	✅ Markdown	✅ MarkdownBlock
Text	Text	NativeReader	✅ search_text	✅ Text	✅ TextLine
PDF	Pdf	PlatformPreview	✅ search_pdf_text	✅ Pdf	✅ PdfPage
Image	Image	NativeReader	❌	✅ Image	✅ Image
EPUB	Epub	NativeReader	✅ search_epub	✅ Epub	✅ EpubChapter
Word	Word	PlatformPreview	❌	❌	✅ Material
Excel	Excel	PlatformPreview	❌	❌	✅ Material
PPT	PowerPoint	ExternalOpen	❌	❌	✅ Material

## 完成报告 ### 更新内容 `docs/supported-formats.md` 新增： - 第二版（已支持）：EPUB 元数据/章节列表 + PDF 元数据/页数检测 + Office 预览策略 - EPUB 能力矩阵（元数据/章节/NCX/NAV 状态） - PDF 能力矩阵（元数据/页数/文本/搜索状态） - Office 能力矩阵（Word/Excel/PPT 策略+搜索） - 第三版（计划）：PDF 增强（pdfium）+ EPUB3 NAV ### 当前覆盖 | 格式 | MaterialType | PreviewMode | 搜索 | Position | Anchor | |------|-------------|-------------|------|----------|--------| | Markdown | Markdown | NativeReader | ✅ search_blocks | ✅ Markdown | ✅ MarkdownBlock | | Text | Text | NativeReader | ✅ search_text | ✅ Text | ✅ TextLine | | PDF | Pdf | PlatformPreview | ✅ search_pdf_text | ✅ Pdf | ✅ PdfPage | | Image | Image | NativeReader | ❌ | ✅ Image | ✅ Image | | EPUB | Epub | NativeReader | ✅ search_epub | ✅ Epub | ✅ EpubChapter | | Word | Word | PlatformPreview | ❌ | ❌ | ✅ Material | | Excel | Excel | PlatformPreview | ❌ | ❌ | ✅ Material | | PPT | PowerPoint | ExternalOpen | ❌ | ❌ | ✅ Material |

wangdl closed this issue

2026-06-07 22:01:56 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/zhixi-document-runtime#81