打开即适配阅读宽度
PDF 和 Word 会按当前视口计算默认缩放，PDF 支持页侧边栏和目录树侧边栏切换，Word / PDF 打印使用专属完整页适配器，其他格式按能力动态显隐打印按钮。
149个扩展名映射
20条预览链路
4条 npm 包线
Iframe支持多系统复用
Product Experience
产品化的文件预览，而不是格式清单
文档解析、阅读布局、示例验收和分发交付被放在同一条链路里维护。接入前可以先看真实 Demo， 接入后也能通过 npm、私有化静态站或 iframe 继续迭代。
重型能力按需进入
OFD、Typst、压缩包、邮件、OLB/DRA、CAD、3D 模型、绘图、EPUB、UMD、PDF、Office、Markdown、音频和代码高亮都拆成异步块，命中格式时再加载。
示例覆盖完整验收路径
示例文件按文档、表格、图纸、电子书、压缩包、邮件、EDA、代码、媒体等类型分组，方便快速定位和回归。
独立比对不污染主入口
/compare.html 提供左右并排预览、示例选择、URL、本地上传、交换和同步滚动，适合合同、报告、PPT 和导出物的视觉核对。
Why It Works
为业务系统准备的工程取舍
它不是一个只展示单一 PDF 的小组件，而是一套面向附件中心、OA、知识库和工单系统的前端预览方案。
少一条服务端链路
大多数格式直接在浏览器完成解析，不需要把附件交给后端转 PDF，也减少临时文件和队列任务。
格式覆盖贴近业务
除了 Office、PDF 和图片，也补齐 OFD、Typst、压缩包、邮件、OLB/DRA、CAD、3D 模型、Excalidraw、draw.io、EPUB、UMD、Markdown、代码、日志、配置文件、音频和 MP4；PPTX 对组合图形、主题背景和 EMF 图片做了专门增强。
阅读质感有兜底
Word 保留白色纸张和灰色页面底，PDF 具备缩放、页码、页面/目录导航和宽度自适应，PPTX 会尽量保留模板背景、组合元素和矢量插图。
接入边界清晰
Vue3、Vue2.7、React、纯 JS 和 iframe 都有明确示例，URL、File、Blob 转 File 等输入路径也已写明。
成品可直接下载
公开仓库提供混淆压缩库产物、Demo 静态站点、文档静态站点、样例文件和 tarball。
版本交付可追踪
README、文档站、Demo、npm 包和公开成品仓库同步维护，便于验收和分发。
Choose Your Path
按你的接入场景开始
先选路线，再进入对应文档。每条路线都给出最短示例和真实项目里的注意事项。
Vue 3 项目安装 @flyfish-group/file-viewer3@1.0.22，使用 createApp(App).use(FileViewer)，样式会随安装器自动带入。Vue2.7 项目安装 @flyfish-group/file-viewer@1.0.22，使用 Vue.use(FileViewer)，安装器会自动带上样式。React 项目安装 @flyfish-group/file-viewer-react@1.0.22，通过 iframe 加载私有化 viewer。纯 JS 页面安装 @flyfish-group/file-viewer-web@1.0.22，用 helper 创建和同步 iframe。多系统复用独立部署预览器，通过 URL 或 postMessage 推送二进制文件。成品与二开下载公开产物，或前往官方渠道开通源码和商业二开。
Official Resources
进入文档导览官网用于验证，组件用于私有化接入
官方文档是 doc.flyfish.dev， 在线预览是 viewer.flyfish.dev， 公开成品仓库是 github.com/flyfish-dev/file-viewer， Gitee 镜像是 gitee.com/flyfish-dev/file-viewer。 React 和纯 JS 组件默认加载你私有部署的 /file-viewer/index.html，不会把官网 Demo 地址作为内置依赖。