# Public Sample Sources

本目录中的 PDF、DOCX、PPTX、CAD、OpenDocument、3D 模型、绘图、音视频、EPUB 和 MSG 示例文件使用项目方提供的真实资料、可追溯的公开样本或项目内最小夹具；RTF、FODS、地理数据、MIDI、SQLite、WASM、UMD、EML、MBOX、XMind、Mermaid、PlantUML、PSD、Git patch、Git bundle、OLB、DRA、GDS、OAS/OASIS 和压缩包示例文件由项目内生成，用于固定回归对应结构。后续替换这些文件时，请优先选择许可清楚、可直接访问 raw 文件的公开仓库、国际组织公开文档或项目方明确授权的资料，并同步更新本文件与 `README.md`。

| Local file | Source | License | Purpose |
| --- | --- | --- | --- |
| `drawing.dxf` | `https://github.com/mozman/ezdxf/blob/master/examples_dxf/wipeout_door.dxf` | MIT | Real DXF CAD drawing for pan, zoom and layer smoke tests |
| `word.docx` | `https://www.basel.int/Portals/4/download.aspx?d=UNEP-CHW.15-6-Add.5-Rev.1.Chinese.docx` | Public Basel Convention document, source attribution required | Rich Chinese DOCX preview with headings, long-form text, tables, drawings, responsive white paper and print/export smoke tests |
| `en/calibre-demo.docx` | `https://calibre-ebook.com/downloads/demos/demo.docx` | calibre public demo document by Kovid Goyal / calibre project | Rich English DOCX preview with typography, headings, lists, tables and conversion-oriented Word features |
| `template.dot` | Copied from project `test.doc` fixture and saved with the Word 97-2003 template extension | Apache-2.0 | DOT extension routing smoke test for legacy Word template preview |
| `ppt.pptx` | `https://github.com/hcp4715/R4Psy/blob/main/slides/chapter_1.pptx` | CC-BY-4.0 | Rich Chinese presentation smoke test for slide layout, images, theme styling and media-heavy PPTX rendering |
| `en/sample-presentation.pptx` | `https://raw.githubusercontent.com/scanny/python-pptx/master/tests/test_files/test_slides.pptx` | MIT | English PPTX smoke test from python-pptx fixtures for OOXML presentation routing and slide rendering |
| `en/financial-sample.xlsx` | `https://learn.microsoft.com/en-us/power-bi/create-reports/sample-financial-download` direct download `https://go.microsoft.com/fwlink/?LinkID=521962` | Microsoft public sample workbook | English XLSX workbook with multiple business fields for spreadsheet tabs, styles, column sizing and print smoke tests |
| `pdf.pdf` | Project-owner provided `PDF沉浸式翻译技术说明.pdf` | Demo distribution authorized by project owner | 13-page PDF toolbar, scale, page/tree sidebar, print, export and dark-shell isolation smoke tests |
| `en/prince-sample.pdf` | `https://www.princexml.com/samples/magic6/magic.pdf` | Prince / YesLogic public sample PDF | English PDF sample covering CSS print features, tables, columns, bookmarks, math and multi-page layout |
| `en/markdown.md` / `en/notes.markdown` / `en/text.txt` / `en/app.log` / `en/table.csv` / `en/data.json` / `en/data.jsonc` / `en/data.json5` / `en/code.ts` / `en/code.js` | Project-authored English fixtures based on common integration, support, config and log scenarios | Apache-2.0 | Lightweight English demo set for Markdown, text, log, CSV, JSON/JSONC/JSON5 and source-code preview without adding heavy network assets |
| `en/map.geojson` | Project-authored GeoJSON fixture inspired by common OpenLayers / GeoJSON demo structures | Apache-2.0 | English geospatial route and point sample for offline GeoJSON rendering, search and zoom smoke tests |
| `en/model.gltf` | Project-authored embedded glTF 2.0 triangle fixture after reviewing Khronos glTF sample conventions | Apache-2.0 | Lightweight English 3D sample with embedded buffer so the demo stays fully offline and needs no sidecar asset |
| `sample.dwg` | `https://download.autodesk.com/us/samplefiles/acad/blocks_and_tables_-_imperial.dwg` | Autodesk public AutoCAD sample file | Official Autodesk DWG sample for Worker + LibreDWG WASM geometry, blocks and table smoke tests |
| `samples/apache/blocks_and_tables.dwf` | `https://issues.apache.org/jira/browse/TIKA-1823` attachment `blocks_and_tables.dwf` | Apache Software Foundation Jira attachment | Native DWF 6 container smoke test for blocks, tables, W2D graphics and MIME/header handling |
| `samples/autodesk/house.dwfx` | `https://github.com/Developer-Autodesk/viewer-javascript-tutorial/blob/master/Sample%20files/House.dwfx` | MIT | Official Autodesk Viewer tutorial DWFx sample for native DWFx/XPS rendering, multi-page structure and CAD viewport smoke tests |
| `samples/autodesk/robot-arm.dwfx` | `https://github.com/Developer-Autodesk/viewer-javascript-tutorial/blob/master/Sample%20files/RobotArm1.dwfx` | MIT | Official Autodesk Viewer tutorial DWFx sample for W2D/W3D native rendering and assembly drawing smoke tests |
| `model.gltf` / `model.obj` / `model.stl` / `model.ply` / `model.step` | Project-generated minimal fixtures | Apache-2.0 | Three.js model rendering and engineering-format fallback smoke tests |
| `mindmap.xmind` | Project-generated with `@ljheee/xmind-parser` | Apache-2.0 | XMind 2020+ package fixture for sheet tabs, tree layout, labels, notes, links, search, zoom, print and HTML export smoke tests |
| `architecture.mermaid` | Project-authored Mermaid fixture | Apache-2.0 | Mermaid architecture and flowchart route for official renderer, theme and Panzoom smoke tests |
| `sequence.plantuml` | Project-authored PlantUML fixture | Apache-2.0 | PlantUML sequence route for encoder, configurable SVG endpoint, theme shell and Panzoom smoke tests |
| `flow.excalidraw` | `https://github.com/neo4j-labs/agent-memory/blob/main/docs/assets/images/diagrams/excalidraw/poleo-model.excalidraw` | Apache-2.0 | Real Excalidraw scene for official restore/export smoke tests |
| `process.drawio` | `https://github.com/jgraph/drawio-diagrams/blob/dev/blog/data-flow.drawio` | Apache-2.0 | Official draw.io sample for diagrams.net viewer smoke tests |
| `book.umd` | 项目内生成的最小 UMD 文本电子书 fixture | Apache-2.0 | UMD ebook metadata, table-of-contents and zlib text smoke tests |
| `document.odt` | `https://wiki.documentfoundation.org/File:Book-template-0-2.odt` | CC-BY-SA-3.0 / LGPL-3.0+ / MPL-1.1 | Real The Document Foundation ODT template for OpenDocument text route smoke tests |
| `excel.ods` | `https://wiki.documentfoundation.org/File:Fixture_Copa_del_Mundo_2014.ods` | CC-BY-SA-3.0 | Real The Document Foundation ODS spreadsheet for OpenDocument sheet tabs, data and style smoke tests |
| `slides.odp` | `https://wiki.documentfoundation.org/File:QA_Impress_Example_01_ODP_File.odp` | CC-BY-SA-3.0 via The Document Foundation Wiki default contribution license | Real The Document Foundation ODP presentation for OpenDocument slide outline smoke tests |
| `excel.fods` | Project-authored Flat ODS XML fixture | Apache-2.0 | Standards-conforming Flat OpenDocument spreadsheet route smoke test |
| `sample.rtf` | Project-generated compatible document fixture | Apache-2.0 | RTF route smoke test |
| `map.geojson` / `route.kml` / `track.gpx` | Project-generated lightweight geospatial fixtures | Apache-2.0 | GeoJSON, KML and GPX normalization plus offline SVG map smoke tests |
| `report.typ` | Project-generated Typst multi-page fixture | Apache-2.0 | Direct Typst browser WASM rendering and smoke tests |
| `archive.zip` / `archive.tar.gz` | Project-packaged PDF, public DOCX, Markdown, TypeScript and JSON sample set | See bundled file sources | Archive directory, lazy extraction, cache and nested preview smoke tests |
| `en/archive.zip` / `en/archive.tar.gz` | Project-packaged English DOCX, PDF, PPTX, XLSX, Markdown, text, log, CSV, JSON, TypeScript, JavaScript, GeoJSON and glTF sample set | See bundled file sources | English archive directory, lazy extraction, cache and nested preview smoke tests |
| `sample.eml` | Project-generated MIME email fixture | Apache-2.0 | EML headers, text/html body, attachment download and attachment preview smoke tests |
| `sample.msg` | `https://github.com/HiraokaHyperTools/msgreader/blob/master/test/A%20memo.msg` | MIT | Outlook MSG parsing smoke test through @kenjiuno/msgreader |
| `sample.mbox` | Project-generated MBOX email archive fixture | Apache-2.0 | MBOX message detection and first-message preview smoke tests |
| `sample.olb` / `sample.dra` / `layout.gds` / `layout.oas` / `layout.oasis` | Project-generated EDA / layout fixtures | Apache-2.0 | OLB/DRA structure tree plus GDSII/OASIS readable-string, layer, cell, entity and diagnostic smoke tests |
| `design.psd` | Project-generated layered PSD fixture using `ag-psd` | Apache-2.0 | PSD layer list, visibility toggles, canvas redraw and zoom smoke tests |
| `change.patch` | Project-authored git patch fixture | Apache-2.0 | Side-by-side diff view, file list, syntax color and zoom smoke tests |
| `repository.bundle` | Project-generated git bundle fixture from a tiny local repository | Apache-2.0 | Git bundle refs, commit history, tree and readable blob preview smoke tests |
| `data.jsonc` / `data.json5` / `notebook.ipynb` / `config.toml` / `service.proto` / `infrastructure.hcl` / `formula.tex` / `graph.gv` / `request.http` / `component.react` / `code.rb` / `code.swift` / `Main.kt` | Project-authored source/config fixtures | Apache-2.0 | Expanded highlight.js language mapping smoke tests |
| `melody.mid` / `sample.sqlite` / `module.wasm` / `icon.ico` | Project-generated or favicon-derived fixtures | Apache-2.0 | MIDI, SQLite, WASM and ICO smoke tests |
| `audio.mp3` | `https://interactive-examples.mdn.mozilla.net/media/cc0-audio/t-rex-roar.mp3` | CC0 | Small MP3 sample for native audio playback smoke tests |
| `audio.ogg` | `https://commons.wikimedia.org/wiki/File:Example.ogg` | CC BY-SA 3.0 | OGG Vorbis sample for native audio playback smoke tests |
| `book.epub` | `https://www.gutenberg.org/ebooks/928.epub3.images` | Public domain in the USA | EPUB sample for epubjs table-of-contents and paginated reading smoke tests |

运行时说明:

- `sample.dwg` 来自 Autodesk 官方 AutoCAD sample files 的 `blocks_and_tables_-_imperial.dwg`；运行时通过 `@flyfish-dev/cad-viewer` 按需加载 DWG Worker 和 LibreDWG WASM，验证浏览器本地 DWG 几何、块和表格预览链路。
- `samples/apache/blocks_and_tables.dwf` 来自 Apache Tika `TIKA-1823` 的公开 Jira 附件，保留 `(DWF V06.00)PK` 文件头，用于验证原生 DWF 6 ZIP 容器、块、表格、W2D 图形和 MIME/header 识别。
- `samples/autodesk/house.dwfx` 来自 Autodesk 官方 Viewer 教程仓库，用于验证 DWFx / XPS native renderer、图形、多页结构和视图适配；该文件约 17MB，但只在用户选择样例时按需加载。
- `samples/autodesk/robot-arm.dwfx` 同样来自 Autodesk 官方 Viewer 教程仓库，用于验证 W2D/W3D native renderer 和复杂装配图形。
- `word.docx` 来自 Basel Convention 公开中文正式文档，覆盖标题层级、长正文、表格、图示、白色纸张和完整打印回归；该样本保留真实文档复杂度，但避免默认 Demo 首屏触发超大 DOCX 保护。
- `en/calibre-demo.docx` 来自 calibre 官方 DOCX demo，用于英文浏览器默认 Demo，覆盖英文排版、标题、列表、表格和富文本结构。
- `template.dot` 复用 `test.doc` 的二进制内容，仅用于验证 Word 97-2003 模板扩展名能正确进入老 Word 渲染链路。
- `ppt.pptx` 来自 `hcp4715/R4Psy` 的 CC-BY-4.0 中文课程课件，覆盖多页幻灯片、图片资源、主题样式、组合元素和富文本排版。
- `en/sample-presentation.pptx` 来自 `python-pptx` MIT 测试夹具，用于英文 PPTX 路由、OOXML 包结构和幻灯片基础渲染回归。
- `en/financial-sample.xlsx` 来自 Microsoft Power BI Financial Sample Workbook，用于英文 Excel 多业务字段、sheet 标签、列宽和打印回归。
- `pdf.pdf` 是项目方提供的 13 页真实技术说明 PDF，覆盖缩放、页侧边栏、树形导航、打印、导出和暗色外壳隔离回归。
- `en/prince-sample.pdf` 来自 Prince 官方 Sample Documents，用于英文 PDF 默认样例，覆盖打印 CSS、分栏、目录、表格和多页布局。
- `en/markdown.md`、`en/notes.markdown`、`en/text.txt`、`en/app.log`、`en/table.csv`、`en/data.json`、`en/data.jsonc`、`en/data.json5`、`en/code.ts` 和 `en/code.js` 是项目内英文轻量夹具，用于保证英文 demo 在文本、代码、配置、日志和数据类格式下不只换标签，也能打开英文内容。
- `en/map.geojson` 是项目内英文 GeoJSON 夹具，覆盖点、线路和属性表；`en/model.gltf` 是嵌入 buffer 的 glTF 2.0 夹具，避免英文 3D demo 依赖额外 `.bin` sidecar 或公网资源。
- `model.gltf`、`model.obj`、`model.stl`、`model.ply` 和 `model.step` 是最小 3D fixture，用于验证 Three.js 预览和工程格式转换提示。
- `mindmap.xmind` 由项目内使用 `@ljheee/xmind-parser` 生成，覆盖 XMind 2020+ 多 sheet、节点、标签、备注、链接、标记、目录、缩放、搜索、打印和 HTML 导出链路。
- `architecture.mermaid` 和 `sequence.plantuml` 是项目内绘制的最小但完整的架构图/时序图样例，用于验证 Mermaid 官方 renderer、PlantUML SVG 服务、主题容器、拖拽平移和统一缩放。
- `design.psd` 由项目内使用 `ag-psd` 生成，覆盖多图层、图层显隐、重绘、透明背景和缩放链路。
- `change.patch` 用于验证 `diff2html` 左右比对视图；`repository.bundle` 用于验证浏览器端 Git bundle header、refs、commit/tree/blob 解析和 delta pack 边界提示。
- `flow.excalidraw` 先经过 `@excalidraw/excalidraw` 的官方 `restore`，再用 `exportToSvg` 输出只读预览，以兼容公开样例中常见的精简字段。
- `process.drawio` 由 diagrams.net 官方 `GraphViewer` 解析，组件不自行实现 draw.io 方言解析。
- `audio.mp3` 与 `audio.ogg` 只用于验证浏览器原生音频播放能力；不同浏览器对编码的支持存在差异。
- `melody.mid` 是最小 MIDI fixture，用于验证 `@tonejs/midi` 只在 MIDI 命中时按需加载并展示轨道、时长和音符摘要。
- `book.epub` 来自 Project Gutenberg，运行时由 `epubjs` 解析 EPUB 包、目录和章节资源。
- `book.umd` 由项目内生成，覆盖 UMD 文件头、元数据、章节偏移、章节标题和 zlib 压缩正文段。
- `report.typ` 由项目内编写，覆盖 Typst 标题、表格、公式、代码块、多页输出、页面尺寸和打印/HTML 导出，线上 Demo 会直接读取源文件并通过浏览器端 WASM 编译预览。
- `archive.zip` 与 `archive.tar.gz` 由本目录中的 PDF、DOCX、Markdown、TypeScript 和 JSON 示例打包，用于验证 `libarchive.js` Worker、按需解压、IndexedDB 缓存和内部文件继续预览；其中 DOCX 同步使用当前公开中文 Word 样例。
- `en/archive.zip` 与 `en/archive.tar.gz` 由英文 DOCX、PDF、PPTX、XLSX、Markdown、文本、日志、CSV、JSON、TypeScript、JavaScript、GeoJSON 和 glTF 示例打包，用于英文环境下验证压缩包目录、按需解压、缓存和内部文件继续预览。
- `sample.eml` 是标准 MIME fixture，用于验证 EML 头信息、HTML/文本正文和附件链路。
- `sample.msg` 来自 `HiraokaHyperTools/msgreader` 测试样例，用于验证 Outlook MSG 解析。
- `sample.mbox` 是项目内生成的邮件归档 fixture，用于验证 MBOX 归档识别和首封邮件预览。
- `sample.olb` 与 `sample.dra` 是项目内生成的 CFB 夹具，用于验证 OLB / DRA 结构树、对象候选、属性和可读字符串索引；`layout.gds`、`layout.oas` 和 `layout.oasis` 用于验证 GDSII / OASIS 版图结构退化预览、实体候选和诊断信息。
- `document.odt`、`excel.ods` 和 `slides.odp` 均来自 The Document Foundation Wiki 的真实公开 OpenDocument 文件，用于验证 ODT 正文、ODS 工作表和 ODP 幻灯片包结构读取；`excel.fods` 是标准 Flat ODS XML 夹具，用于验证平面 OpenDocument 表格入口。
- `sample.rtf` 是项目内生成的兼容文档 fixture，用于验证 RTFJS 读取。
- `map.geojson`、`route.kml` 和 `track.gpx` 是项目内生成的轻量地理数据 fixture，用于验证 GeoJSON/KML/GPX 标准化和离线 SVG 地图预览。
- `sample.sqlite`、`module.wasm` 和 `icon.ico` 用于验证结构化数据、WASM 模块摘要和 ICO 图标预览；`data.jsonc` 等工程文本 fixture 用于验证新增 highlight.js 扩展名映射。