# 支持的文件格式

文件页点文件的 **⋮ → 预览**，下面这些格式都能直接看。

**认不出的文件也有兜底**：十六进制转储（前 4 KB，等宽、可横向滚动）。

> ⚠ 这份清单与代码是**同一份数据**（`PreviewFormatCatalog`），自测逐条断言
> 「这个扩展名走的确实是这一种预览」—— 所以文档不会写着写着就与实现分家。

## 文本

| 类别 | 扩展名 | 预览成什么样 |
|---|---|---|
| 纯文本 / 源码 | `.txt` `.log` `.rst` `.adoc` `.asciidoc` `.tex` `.latex` `.http` `.rest` `.rep` `.lst` | 等宽 + 行号 |
| Markdown | `.md` `.markdown` | 按 Markdown 渲染 |
| 网页 | `.html` `.htm` `.xhtml` | 按网页渲染（WebView；CSS / 脚本 / 同目录资源由浏览器加载） |
| JSON | `.json` | 结构化，可折叠 |
| XML | `.xml` | 节点树，可折叠 |
| CSV | `.csv` | 表格 |
| 表格数据 | `.tsv` `.jsonl` `.ndjson` `.rep` | 表格（`.rep` 是 PADS 的孔径报告） |
| SQL | `.sql` | 按 SQL 上色 |
| 配置文件 | `.yaml` `.yml` `.toml` `.ini` `.conf` `.cfg` `.properties` `.env` `.gradle` `.cmake` `.editorconfig` `.gitignore` `.gitattributes` `.dockerignore` `.npmrc` `.prettierrc` `.eslintrc` `.htaccess` | 键值上色 |
| Diff | `.diff` `.patch` | 增删着色 |
| draw.io | `.drawio` | 按原图坐标画成 SVG |
| Mermaid | `.mmd` `.mermaid` | 流程图出图（分层布局）· 其它图种给节点/连线表 |
| Jupyter Notebook | `.ipynb` | 每个 cell 一节 |
| Protocol Buffers | `.proto` | 消息 / 枚举 / 服务表 |
| GraphQL | `.graphql` `.gql` | 类型 / 字段表 |

## 文档

| 类别 | 扩展名 | 预览成什么样 |
|---|---|---|
| Office | `.docx` `.doc` `.xlsx` `.xls` `.pptx` `.ppt` | 抽出正文 + 表格（docx/xlsx 转 Markdown 表格；**不保字体/颜色/精确版面**） |
| RTF | `.rtf` | 抽正文（控制字不外露；不还原排版） |
| OpenDocument | `.odt` `.ods` `.odp` `.odg` | 抽出正文 |
| PDF | `.pdf` | 页面里有图先出图（扫描件），否则抽出文本按页翻 |
| OFD | `.ofd` | 版式方块图（文字块/图片块）+ 按页抽正文 |
| XPS | `.xps` `.oxps` | 固定版式文档：按页抽正文（**不还原字体/版面**，与 OFD 同一定位） |
| EPUB | `.epub` | 按章节 |
| 日历 / 联系人 | `.ics` `.ifb` `.vcf` `.vcard` | 属性块 → 表格 |
| 字幕 | `.srt` `.vtt` `.ass` `.ssa` | 时间轴 + 文本 |
| 属性列表 | `.plist` | XML 与 bplist 两种编码 |

## 图形

| 类别 | 扩展名 | 预览成什么样 |
|---|---|---|
| 图片 | `.svg` `.png` `.jpg` `.jpeg` `.gif` `.webp` `.bmp` `.tga` `.ico` `.cur` `.pnm` `.ppm` `.pgm` `.pbm` `.pam` | 看 + 缩放 + 旋转 |
| 3D 模型 | `.obj` `.glb` `.gltf` `.stl` `.ply` `.3mf` | 软件光栅出图，可旋转缩放 |
| PCB 板图 | `.gbr` `.ger` `.pho` `.gtl` `.gbl` `.gto` `.gbo` `.gts` `.gbs` `.gko` `.drl` `.nc` | Gerber / Excellon 都画板子 |
| KiCad | `.kicad_pcb` | 走线 / 过孔 / 焊盘 |
| GDSII | `.gds` `.gds2` | 芯片 / 光罩版图：顶层 cell 的多边形画俯视图 + cell / 图层清单（引用与阵列只计数不展开） |
| DXF | `.dxf` | 2D CAD 线图 |
| G-code | `.gcode` `.gco` `.ngc` `.tap` `.cnc` | 俯视刀路 |
| PSD | `.psd` `.psb` | 合成图（含索引色 / Lab；解不出时退回图层清单） |
| 字体 | `.ttf` `.otf` `.ttc` `.woff` `.woff2` | 信息表 + 样字 |

## 建筑 / 工程

| 类别 | 扩展名 | 预览成什么样 |
|---|---|---|
| gbXML | `.gbxml` | 楼栋 / 房间 / 围护面结构树 + 面积摘要（**不解几何**） |

## 电路

| 类别 | 扩展名 | 预览成什么样 |
|---|---|---|
| SPICE | `.cir` `.sp` `.spice` | 连接图（圆点=网络、连线=器件，力导向布局）+ 元件清单 |

## 媒体

| 类别 | 扩展名 | 预览成什么样 |
|---|---|---|
| 音频 | `.mp3` `.wav` `.ogg` `.oga` `.m4a` `.aac` `.flac` `.opus` | 播放 / 暂停 / 音量 / 进度 |
| 视频 | `.mp4` `.m4v` `.webm` `.mov` `.mkv` | 官方播放器控件 |
| MIDI | `.mid` `.midi` | 钢琴卷帘 |

## 数据与容器

| 类别 | 扩展名 | 预览成什么样 |
|---|---|---|
| 压缩包 | `.zip` `.tar` `.tgz` `.iso` | 条目清单（**点条目直接预览**）· `.iso` 读卷标与目录记录，Joliet / Rock Ridge 名优先 |
| SQLite | `.db` `.sqlite` `.sqlite3` | 表结构 + 前几行 |
| HTTP 归档 | `.har` | 请求清单 |
| 种子 | `.torrent` | 文件清单 |
| 可执行 / 目标文件 | `.elf` `.so` `.o` `.a` `.dylib` `.exe` `.dll` `.dex` `.wasm` | 头字段 + 节表 |
| 地图 / 轨迹 | `.kml` `.kmz` `.geojson` `.gpx` | 画成矢量图 |
| MBTiles | `.mbtiles` | 离线地图：取放得下的最高缩放级拼成一张图（矢量瓦片画覆盖图） |
| Shapefile | `.shp` | GIS 矢量图（线 / 面，同名 `.dbf` 的属性行数写进状态栏） |
| NumPy | `.npy` `.npz` | 二维数组画灰度图（按值域拉伸）；一维只给统计表 |
| Scratch | `.sb3` `.sb2` | 第一张造型出图 + 角色 / 积木数 / 声音 / 变量（不运行积木） |
| PDB | `.pdb` `.ent` | Cα 主链 + 球棍分子图（PCA 取景）· 原子/残基/链/配体计数 |
| 序列文件 | `.fasta` `.fa` `.fna` `.faa` `.fastq` `.fq` | 条数 / 总碱基 / 长度分布 / GC / 字母表 |
| QIF | `.qif` | 记账：笔数 / 收支合计 / 日期范围 + 最近几笔 |
| OFX | `.ofx` `.qfx` | 银行对账单（1.x SGML 与 2.x XML 都认） |
| EDI | `.edi` `.x12` `.edifact` | X12 / EDIFACT：段数 + 事务集类型 |
| IGES | `.igs` `.iges` | 俯视轮廓：直线 / 圆弧 / 折线 / B 样条 / 点（另附实体类型统计） |
| IFC | `.ifc` `.ifczip` | 建筑模型：**线框俯视图**（`IFCPOLYLOOP` / `IFCPOLYLINE` / `IFCTRIANGULATEDFACESET` 的边，XY 投影） |
| STEP | `.stp` `.step` | CAD 交换：**线框俯视图**（`EDGE_CURVE` 两端连线，XY 投影） |
| EML | `.eml` `.mbox` | 邮件：主题 / 收发 / 正文 / 附件清单（不执行 HTML） |
| PCAP | `.pcap` `.pcapng` `.cap` | 抓包：包数 / 时间范围 / 协议分布（不做 TCP 重组） |
| 证书 | `.pem` `.crt` `.cer` `.der` `.p12` `.pfx` `.p7b` | 主题 / 颁发者 / 有效期 / SAN / 指纹（不验签不验链） |
| GML | `.gml` | GIS 地图：点/线/面（按文件坐标）· 无几何时退回要素树 |
| GeoPackage | `.gpkg` | OGC 地理数据库：几何列画地图 + 表结构 |
| dBASE | `.dbf` | 字段定义 + 前 10 行（只读） |
| Radiance HDR | `.hdr` | HDRI 素材：解码后出图（已做色调映射） |
| FITS | `.fits` `.fit` `.fts` | 天文影像：出灰度图 + 头摘要 |
| MATLAB MAT | `.mat` | 变量清单（名字/类型/尺寸）+ 二维数值矩阵画灰度热图（v7.3 是 HDF5，只提示） |
| NIfTI | `.nii` `.nii.gz` | 轴位 / 冠状 / 矢状三个切面各取中间一层，横排拼成一张灰度图 |
| DICOM | `.dcm` | 医学影像：未压缩灰度/彩色（RGB、YBR）、**RLE 无损**与 JPEG baseline 出图；多帧只画首帧；JPEG 2000 / JPEG-LS 只给标签摘要 |
| HDF5 | `.h5` `.hdf5` `.he5` `.nc4` | 组 / 数据集层级 + 属性；最大的二维数值数据集画成灰度热图（**MAT v7.3 与 NetCDF-4 也走这里**） |
| NetCDF | `.cdf` | 二维数值变量画灰度图 + 维度/变量清单（`.nc` 归 PCB 钻孔） |
| LAS | `.las` `.laz` | 点云俯视图（`.laz` 压缩版**读不了**） |
| 大纲 / 思维导图 | `.opml` `.mm` | 可折叠树 |

## 兜底

| 类别 | 扩展名 | 预览成什么样 |
|---|---|---|
| 其它任何文件 | 不含上面任何扩展名也行 | 十六进制转储：前 4 KB，等宽、可横向滚动 |

## 几点说明

- **预览是只读的**：它不改文件；要改就点文件名进编辑器。
- **文本类不做语法校验**：没有 YAML/TOML 解析器，半吊子校验把合法文件判错比不校验更坏。
  只有**结构性**错误（非对象行、坏 JSON、无制表符）才会报错点名。
- **解析失败不会闪退**：任何格式解析不出来就退回十六进制，并说明原因。
- **大文件有上限**：十六进制只读前 4 KB；文本超过 8 MB 会提示无法预览；
  超过 6 万字符的文本改用等宽显示（不做富文本，避免卡顿）。
- **压缩包里也能预览**：`zip` 清单里能预览的条目可以直接点开（会解到缓存目录）。
