DOC-003 定义支持格式分级 #3

New Issue

wangdl · 2026-05-30T19:48:59+08:00

wangdl commented

2026-05-30 19:48:59 +08:00

定义文件格式支持等级，形成 docs/supported-formats.md。

支持等级：NativeReader、PlatformPreview、ExternalOpen、Unsupported

格式策略：
Markdown: NativeReader
TXT: NativeReader
PDF: PlatformPreview 优先，Rust 只定义位置模型
图片: NativeReader/原生图片预览
Word/DOCX: PlatformPreview/ExternalOpen
Excel/XLSX: PlatformPreview/ExternalOpen
PPT/PPTX: ExternalOpen
EPUB: 后置

非目标：PDF 不要求 Rust 渲染，Word/Excel/PPT 不进入 Rust 内置解析，图片不做 OCR

定义文件格式支持等级，形成 docs/supported-formats.md。支持等级：NativeReader、PlatformPreview、ExternalOpen、Unsupported 格式策略： Markdown: NativeReader TXT: NativeReader PDF: PlatformPreview 优先，Rust 只定义位置模型图片: NativeReader/原生图片预览 Word/DOCX: PlatformPreview/ExternalOpen Excel/XLSX: PlatformPreview/ExternalOpen PPT/PPTX: ExternalOpen EPUB: 后置非目标：PDF 不要求 Rust 渲染，Word/Excel/PPT 不进入 Rust 内置解析，图片不做 OCR

wangdl added this to the M0：项目初始化与技术边界冻结 milestone 2026-05-30 19:48:59 +08:00

wangdl added the

priority:p0

type:design

area:architecture

labels 2026-05-30 19:48:59 +08:00

wangdl commented

2026-05-30 20:18:12 +08:00

完成项

✅ docs/supported-formats.md 已编写并推送

格式支持等级

等级	含义
NativeReader	知习内置阅读能力
PlatformPreview	平台系统预览（iOS QuickLook）
ExternalOpen	交给外部 App 打开
Unsupported	暂不支持

格式矩阵确认

格式	等级	备注
Markdown	NativeReader	Rust 解析为 DocumentBlock
TXT	NativeReader	Rust 读取
PDF	PlatformPreview	Rust 只定义位置模型，不渲染
图片	NativeReader	Rust 读 metadata，App 渲染
Word	PlatformPreview	QuickLook 兜底
Excel	PlatformPreview	QuickLook 兜底
PPT	ExternalOpen	外部 App 打开
EPUB	后置	P1 再做

明确不做

PDF 不要求 Rust 渲染（第一版）
Word/Excel/PPT 不进入 Rust 内置解析
图片不做 OCR
不做 DRM、Kindle 格式

识别策略

magic bytes → 2. MIME → 3. 扩展名
使用 infer + mime_guess crate

## 完成项 ✅ docs/supported-formats.md 已编写并推送 ## 格式支持等级 | 等级 | 含义 | |------|------| | NativeReader | 知习内置阅读能力 | | PlatformPreview | 平台系统预览（iOS QuickLook） | | ExternalOpen | 交给外部 App 打开 | | Unsupported | 暂不支持 | ## 格式矩阵确认 | 格式 | 等级 | 备注 | |------|------|------| | Markdown | NativeReader | Rust 解析为 DocumentBlock | | TXT | NativeReader | Rust 读取 | | PDF | PlatformPreview | Rust 只定义位置模型，不渲染 | | 图片 | NativeReader | Rust 读 metadata，App 渲染 | | Word | PlatformPreview | QuickLook 兜底 | | Excel | PlatformPreview | QuickLook 兜底 | | PPT | ExternalOpen | 外部 App 打开 | | EPUB | 后置 | P1 再做 | ## 明确不做 - PDF 不要求 Rust 渲染（第一版） - Word/Excel/PPT 不进入 Rust 内置解析 - 图片不做 OCR - 不做 DRM、Kindle 格式 ## 识别策略 1. magic bytes → 2. MIME → 3. 扩展名使用 infer + mime_guess crate

wangdl closed this issue

2026-05-30 20:31:14 +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#3