# File Viewer Documentation

> Browser-native, offline-first file preview for 266 registered extensions across 45 preview pipelines: 224 stable and 42 experimental.

Use the canonical HTML pages for navigation and citations. For retrieval, prefer the per-page raw Markdown links below instead of loading the complete corpus at once.

# File Viewer

- Documentation
  - [Docs Home](/guide): File Viewer by Flyfish is an offline-first frontend file preview system for web applications.

  - **Start here**
  - [Overview](/guide/overview): File Viewer by Flyfish is a modular, offline-first file preview ecosystem for product teams that need reliable attachment preview inside real web applications.
  - [Demo Guide](/guide/demo): Test File Viewer against real PDF, Office, CAD, archive, mobile, comparison, toolbar, and offline-asset behavior in the official demo.
  - [Quickstart](/guide/quickstart): If your first goal is to see the viewer running, this page starts with the shortest runnable path.
  - [File Viewer CLI](/guide/cli): Scaffold new File Viewer apps, detect and integrate existing projects, select exact renderers or presets, preserve copy-assets compatibility, and prepare private or offline packages.

  - **Integration**
  - [Ecosystem Packages](/guide/ecosystem): New integrations should prefer the standard @file-viewer/ packages. Historical @flyfish-group/ names remain available for existing users.
  - [Modular And On-demand Renderers](/guide/on-demand-renderers): The 2.1.0 architecture lets teams choose minimal renderer imports, product-shaped presets, or the complete official demo capability set.
  - [Modular Profiles and Full Compatibility](/guide/v3-modular-profiles): Choose standard, preset, custom, or Full installation boundaries, preserve every existing Full package contract, and keep specialist capabilities explicitly opt-in.
  - [Vanilla JS / Script Tag](/guide/quickstart-web): Use @file-viewer/web when you want a framework-free viewer with the same renderer capability as Vue, React, Svelte, and jQuery packages.
  - [Vue 3 Integration](/guide/quickstart-vue3): @file-viewer/vue3 provides a Vue-native component and plugin while keeping renderer engines lazy and framework-neutral underneath.
  - [Vue 2 Integration](/guide/quickstart-vue2): Vue 2 projects can use native component packages without switching to an iframe-only integration.
  - [React Integration](/guide/quickstart-react): @file-viewer/react exposes a React component and handle APIs while sharing the same core options and renderer packages as other ecosystems.
  - [Svelte Integration](/guide/quickstart-svelte): The Svelte package provides both a native component and an action. Use the component for declarative pages and the action for existing DOM containers.
  - [React Legacy](/guide/ecosystem#react-legacy)
  - [jQuery](/guide/ecosystem#jquery)
  - [Core API](/guide/ecosystem#core-api)
  - [PPT / PPTX Engines](/guide/ecosystem#ppt-and-pptx-engines)
  - [Component Options](/guide/usage): Vanilla JS, Vue, React, Svelte, jQuery, and custom core integrations share the same viewer options, renderer assembly model, lifecycle hooks, operation guards, and controller semantics.
  - [Style Isolation And Customization](/guide/style-isolation): File Viewer uses Shadow DOM by default in every standard component to isolate the viewer shell and rendered content.

  - **Capability**
  - [Supported Formats](/guide/formats): The canonical catalog registers 266 file extensions across 45 preview pipelines: 224 stable and 42 experimental.
  - [Format Fidelity](/guide/format-fidelity): File Viewer by Flyfish documents what is fully rendered, what is structurally inspected, and which formats need specialist engines for perfect fidelity.
  - [Comparison](/guide/compare): File Viewer is a pure frontend file preview component for internal tools, intranet systems, and private deployments.
  - [FAQ](/guide/faq): Troubleshoot File Viewer packages, runtime assets, Worker and WASM paths, supported formats, licensing, mobile layout, and deployment behavior.

  - **Development and release**
  - [Development](/guide/development): Maintainer-only commands: this page contains complete-workspace release or verification examples that are not part of the public checkout.
  - [Docker](/guide/docker): The published image is the supported Docker path for public consumers. It serves a prebuilt File Viewer site and does not require a conversion backend.
  - [Distribution](/guide/distribution): File Viewer is distributed through npm, GitHub Releases, Docker and the hosted demo/documentation sites.

- **More**
- [Changelog](/changelog): The notable user-facing changes shipped from the current File Viewer mainline. GitHub Releases remains the source for downloadable artifacts and immutable release notes.
- [Support File Viewer](/donate): File Viewer remains Apache-2.0 open source. Sponsorship helps fund compatibility work, documentation, examples, offline assets, and long-term maintenance.

# File Viewer

- 文档指南
  - [文档导览](/zh/guide): File Viewer by Flyfish 官方文档同时承担组件主页、接入手册和开源分发说明。 文档围绕真实交付路径组织: 先确认支持格式和 Demo 表现，再选择 Vanilla JS / Pure Web、Vue3、Vue2.7、Vue2.6、React、React Legacy、jQuery 或 Svelte 原生接入，最后了解安装、私有化部署和开源分发。

  - **开始阅读**
  - [概述](/zh/guide/overview): File Viewer by Flyfish 可以为业务系统快速补齐文件在线预览能力。它不同于依赖后端转码的方案，核心解析和渲染都在浏览器端完成，不会额外占用服务器执行 Office 转 PDF、临时文件清理或异步转换任务。
  - [Demo 说明](/zh/guide/demo): 一个好用的 Demo，不只是“给别人看看”，也是团队内部确认能力边界、联调文件样本和复现问题的最快入口。 当前能力矩阵包含 266 个已注册扩展名（224 个稳定、42 个实验）和 45 条预览链路；Demo 为每条链路提供可重复验证的代表样例，实验样例不会冒充稳定支持证据。
  - [快速开始](/zh/guide/quickstart): 如果你现在最想做的是“尽快看到效果”，这一页会先给最短可运行路径。 先选生态组件，再按业务文件类型选择 preset 或 renderer；跑通后再进入按需装配、离线资源和工具栏定制。
  - [File Viewer CLI](/zh/guide/cli): 使用 File Viewer CLI 创建新项目、检测并接入已有项目、精确选择 renderer 或 preset、兼容 copy-assets，并为私有源或离线环境准备安装包。

  - **集成方式**
  - [生态组件总览](/zh/guide/ecosystem): File Viewer by Flyfish 的 2.x 架构把底层预览能力、重型渲染引擎和各框架组件拆清楚了。 新项目优先选择 @file-viewer/ 标准包名；历史 @flyfish-group/ 包名仍同步维护，用于平滑升级旧项目。 生态目标是让每个技术栈都有原生接入体验，同时通过 preset 或 renderer 明确控制格式能力和安装边界。
  - [按需渲染架构](/zh/guide/on-demand-renderers): 文件预览器的格式越来越多，不能让每个项目在安装阶段都承担全部 Office、CAD、Typst、3D、压缩包、邮件和工程格式依赖。 2.x 的目标是把 core 收敛为轻量、框架无关、纯 TypeScript 的预览底座，把重渲染链路拆成可组合、可自动装配、可独立发布的 renderer package。
  - [模块化 Profile 与 Full 兼容边界](/zh/guide/v3-modular-profiles): 选择 standard、preset、自定义或 Full 安装边界，完整保留既有 Full 包契约，并让 DICOM、数字签名等专业能力保持显式按需安装。
  - [纯 JS 集成](/zh/guide/quickstart-web): 纯 JS 包现在提供原生 <flyfish-file-viewer> 组件和 mountViewer(container, options) 两种标准入口。 推荐优先使用 Custom Element；需要完全命令式控制时再使用 controller 挂载。
  - [Vue3 集成](/zh/guide/quickstart-vue3): 如果你的业务工程本身就是 Vue 3，这条路线几乎是最顺手的。 安装组件、注册一次，然后把文件 URL 或二进制交给它，剩下的渲染工作交给预览器处理。
  - [Vue2 集成](/zh/guide/quickstart-vue2): Vue2 已拆成 @file-viewer/vue2.7 和 @file-viewer/vue2.6 两条标准包线。 它们面向仍在 Vue2 的业务系统，格式能力、示例文件和 options / 事件语义与 Vue3 包保持一致。
  - [React 集成](/zh/guide/quickstart-react): React 包提供原生组件体验。组件内部通过共享 core 能力直接挂载完整预览器， props、事件、ref、调试链路都留在 React 项目内。
  - [Svelte 集成](/zh/guide/quickstart-svelte): Svelte 包提供原生组件和 action 两种入口。组件适合页面声明式使用，action 适合已有 DOM 容器或轻量工具页。
  - [React Legacy 集成](/zh/guide/ecosystem#react-legacy)
  - [jQuery 集成](/zh/guide/ecosystem#jquery)
  - [Core 自定义接入](/zh/guide/ecosystem#core-自定义接入)
  - [PPT / PPTX 引擎接入](/zh/guide/ecosystem#ppt-与-pptx-引擎接入)
  - [组件用法](/zh/guide/usage): file-viewer 的 API 非常克制，目前真正需要记住的是两条输入路径： url 和 file ，以及一个可选的 options 。 但要把它接进真实业务里，光知道“有这两个参数”还不够，你还得知道渲染器是怎么识别文件类型的、什么时候该传 URL、什么时候应该先把结果包装成带扩展名的 File 。
  - [样式隔离与主题定制](/zh/guide/style-isolation): File Viewer 的所有标准组件默认使用 Shadow DOM 隔离组件壳和预览内容。 业务侧通过 CSS Custom Properties 和 Shadow Parts 定制外观，不再依赖内部 class 或全局覆盖。

  - **能力与边界**
  - [支持格式](/zh/guide/formats): 唯一格式目录当前注册 266 个扩展名 ，覆盖 45 条预览链路 ：其中 224 个稳定 、 42 个实验 。 这一页不是“计划支持什么”，而是以当前代码里已经注册好的渲染器为准，告诉你项目现在到底能处理哪些格式、分别走哪条渲染链路，以及在真实业务里应该怎么选。
  - [格式完整度与渲染路线](/zh/guide/format-fidelity): File Viewer by Flyfish 的目标不是“识别一个扩展名就算支持”，而是尽量让文件在浏览器里形成可理解、可操作、可交付的预览体验。 本页基于当前实现和公开生态调研，说明新增复杂格式的真实完整度、WASM / 手写解析可行性，以及后续需要独立维护的 renderer 方向。 依赖拆包和按需安装路线见 按需渲染架构计划 。
  - [方案对比](/zh/guide/compare): File Viewer 的定位是企业后台、内网和私有化场景里的纯前端文件预览组件。它适合“业务附件快速查看、初筛、检索、打印、导出和自托管交付”，但不替代专业编辑器，也不承诺把所有复杂文件做到像原生软件一样高还原。
  - [常见问题](/zh/guide/faq): 快速排查 File Viewer 组件选型、Full 包资源、Worker/WASM 路径、格式支持、移动端布局、授权与部署问题。

  - **开发与发布**
  - [参与开发](/zh/guide/development): Maintainer-only commands: this page contains complete-workspace release or verification examples that are not part of the public checkout.
  - [Docker 部署](/zh/guide/docker): 公开用户推荐直接运行已发布镜像。镜像提供预构建的 File Viewer 静态站点，不需要文档转换后端。
  - [分发方式](/zh/guide/distribution): File Viewer 通过 npm、GitHub Releases、Docker 以及在线 demo/文档站分发。

- **更多信息**
- [更新日志](/zh/changelog): 查看 File Viewer 主线版本的功能更新、安全修复、性能优化、验证证据与各发行渠道同步记录。
- [赞助 File Viewer](/zh/donate): File Viewer 会持续保持 Apache-2.0 开源。赞助主要用于真实文件兼容、文档与示例、离线资产以及项目的长期维护。

## Raw Markdown directory

- [English · File Viewer Documentation](https://doc.file-viewer.app/llms.mdx/content.md): Build browser-native file preview with clear package choices, 266 registered extensions across 45 preview pipelines, and fully self-hosted runtime assets.
- [English · Changelog](https://doc.file-viewer.app/llms.mdx/changelog/content.md): The notable user-facing changes shipped from the current File Viewer mainline. GitHub Releases remains the source for downloadable artifacts and immutable release notes.
- [English · Support File Viewer](https://doc.file-viewer.app/llms.mdx/donate/content.md): File Viewer remains Apache-2.0 open source. Sponsorship helps fund compatibility work, documentation, examples, offline assets, and long-term maintenance.
- [English · Docs Home](https://doc.file-viewer.app/llms.mdx/guide/content.md): File Viewer by Flyfish is an offline-first frontend file preview system for web applications.
- [English · File Viewer CLI](https://doc.file-viewer.app/llms.mdx/guide/cli/content.md): Scaffold new File Viewer apps, detect and integrate existing projects, select exact renderers or presets, preserve copy-assets compatibility, and prepare private or offline packages.
- [English · Comparison](https://doc.file-viewer.app/llms.mdx/guide/compare/content.md): File Viewer is a pure frontend file preview component for internal tools, intranet systems, and private deployments.
- [English · Demo Guide](https://doc.file-viewer.app/llms.mdx/guide/demo/content.md): Test File Viewer against real PDF, Office, CAD, archive, mobile, comparison, toolbar, and offline-asset behavior in the official demo.
- [English · Development](https://doc.file-viewer.app/llms.mdx/guide/development/content.md): Maintainer-only commands: this page contains complete-workspace release or verification examples that are not part of the public checkout.
- [English · Distribution](https://doc.file-viewer.app/llms.mdx/guide/distribution/content.md): File Viewer is distributed through npm, GitHub Releases, Docker and the hosted demo/documentation sites.
- [English · Docker](https://doc.file-viewer.app/llms.mdx/guide/docker/content.md): The published image is the supported Docker path for public consumers. It serves a prebuilt File Viewer site and does not require a conversion backend.
- [English · Ecosystem Packages](https://doc.file-viewer.app/llms.mdx/guide/ecosystem/content.md): New integrations should prefer the standard @file-viewer/ packages. Historical @flyfish-group/ names remain available for existing users.
- [English · FAQ](https://doc.file-viewer.app/llms.mdx/guide/faq/content.md): Troubleshoot File Viewer packages, runtime assets, Worker and WASM paths, supported formats, licensing, mobile layout, and deployment behavior.
- [English · Format Fidelity](https://doc.file-viewer.app/llms.mdx/guide/format-fidelity/content.md): File Viewer by Flyfish documents what is fully rendered, what is structurally inspected, and which formats need specialist engines for perfect fidelity.
- [English · Supported Formats](https://doc.file-viewer.app/llms.mdx/guide/formats/content.md): The canonical catalog registers 266 file extensions across 45 preview pipelines: 224 stable and 42 experimental.
- [English · Modular And On-demand Renderers](https://doc.file-viewer.app/llms.mdx/guide/on-demand-renderers/content.md): The 2.1.0 architecture lets teams choose minimal renderer imports, product-shaped presets, or the complete official demo capability set.
- [English · Overview](https://doc.file-viewer.app/llms.mdx/guide/overview/content.md): File Viewer by Flyfish is a modular, offline-first file preview ecosystem for product teams that need reliable attachment preview inside real web applications.
- [English · Quickstart](https://doc.file-viewer.app/llms.mdx/guide/quickstart/content.md): If your first goal is to see the viewer running, this page starts with the shortest runnable path.
- [English · React Integration](https://doc.file-viewer.app/llms.mdx/guide/quickstart-react/content.md): @file-viewer/react exposes a React component and handle APIs while sharing the same core options and renderer packages as other ecosystems.
- [English · Svelte Integration](https://doc.file-viewer.app/llms.mdx/guide/quickstart-svelte/content.md): The Svelte package provides both a native component and an action. Use the component for declarative pages and the action for existing DOM containers.
- [English · Vue 2 Integration](https://doc.file-viewer.app/llms.mdx/guide/quickstart-vue2/content.md): Vue 2 projects can use native component packages without switching to an iframe-only integration.
- [English · Vue 3 Integration](https://doc.file-viewer.app/llms.mdx/guide/quickstart-vue3/content.md): @file-viewer/vue3 provides a Vue-native component and plugin while keeping renderer engines lazy and framework-neutral underneath.
- [English · Vanilla JS / Script Tag](https://doc.file-viewer.app/llms.mdx/guide/quickstart-web/content.md): Use @file-viewer/web when you want a framework-free viewer with the same renderer capability as Vue, React, Svelte, and jQuery packages.
- [English · Style Isolation And Customization](https://doc.file-viewer.app/llms.mdx/guide/style-isolation/content.md): File Viewer uses Shadow DOM by default in every standard component to isolate the viewer shell and rendered content.
- [English · Component Options](https://doc.file-viewer.app/llms.mdx/guide/usage/content.md): Vanilla JS, Vue, React, Svelte, jQuery, and custom core integrations share the same viewer options, renderer assembly model, lifecycle hooks, operation guards, and controller semantics.
- [English · Modular Profiles and Full Compatibility](https://doc.file-viewer.app/llms.mdx/guide/v3-modular-profiles/content.md): Choose standard, preset, custom, or Full installation boundaries, preserve every existing Full package contract, and keep specialist capabilities explicitly opt-in.
- [中文 · File Viewer 文档](https://doc.file-viewer.app/llms.mdx/zh/content.md): 用清晰的组件包选择、266 个已注册扩展名、45 条预览链路与完全自托管的运行时资源，构建浏览器原生文件预览。
- [中文 · 更新日志](https://doc.file-viewer.app/llms.mdx/zh/changelog/content.md): 查看 File Viewer 主线版本的功能更新、安全修复、性能优化、验证证据与各发行渠道同步记录。
- [中文 · 赞助 File Viewer](https://doc.file-viewer.app/llms.mdx/zh/donate/content.md): File Viewer 会持续保持 Apache-2.0 开源。赞助主要用于真实文件兼容、文档与示例、离线资产以及项目的长期维护。
- [中文 · 文档导览](https://doc.file-viewer.app/llms.mdx/zh/guide/content.md): File Viewer by Flyfish 官方文档同时承担组件主页、接入手册和开源分发说明。 文档围绕真实交付路径组织: 先确认支持格式和 Demo 表现，再选择 Vanilla JS / Pure Web、Vue3、Vue2.7、Vue2.6、React、React Legacy、jQuery 或 Svelte 原生接入，最后了解安装、私有化部署和开源分发。
- [中文 · File Viewer CLI](https://doc.file-viewer.app/llms.mdx/zh/guide/cli/content.md): 使用 File Viewer CLI 创建新项目、检测并接入已有项目、精确选择 renderer 或 preset、兼容 copy-assets，并为私有源或离线环境准备安装包。
- [中文 · 方案对比](https://doc.file-viewer.app/llms.mdx/zh/guide/compare/content.md): File Viewer 的定位是企业后台、内网和私有化场景里的纯前端文件预览组件。它适合“业务附件快速查看、初筛、检索、打印、导出和自托管交付”，但不替代专业编辑器，也不承诺把所有复杂文件做到像原生软件一样高还原。
- [中文 · Demo 说明](https://doc.file-viewer.app/llms.mdx/zh/guide/demo/content.md): 一个好用的 Demo，不只是“给别人看看”，也是团队内部确认能力边界、联调文件样本和复现问题的最快入口。 当前能力矩阵包含 266 个已注册扩展名（224 个稳定、42 个实验）和 45 条预览链路；Demo 为每条链路提供可重复验证的代表样例，实验样例不会冒充稳定支持证据。
- [中文 · 参与开发](https://doc.file-viewer.app/llms.mdx/zh/guide/development/content.md): Maintainer-only commands: this page contains complete-workspace release or verification examples that are not part of the public checkout.
- [中文 · 分发方式](https://doc.file-viewer.app/llms.mdx/zh/guide/distribution/content.md): File Viewer 通过 npm、GitHub Releases、Docker 以及在线 demo/文档站分发。
- [中文 · Docker 部署](https://doc.file-viewer.app/llms.mdx/zh/guide/docker/content.md): 公开用户推荐直接运行已发布镜像。镜像提供预构建的 File Viewer 静态站点，不需要文档转换后端。
- [中文 · 生态组件总览](https://doc.file-viewer.app/llms.mdx/zh/guide/ecosystem/content.md): File Viewer by Flyfish 的 2.x 架构把底层预览能力、重型渲染引擎和各框架组件拆清楚了。 新项目优先选择 @file-viewer/ 标准包名；历史 @flyfish-group/ 包名仍同步维护，用于平滑升级旧项目。 生态目标是让每个技术栈都有原生接入体验，同时通过 preset 或 renderer 明确控制格式能力和安装边界。
- [中文 · 常见问题](https://doc.file-viewer.app/llms.mdx/zh/guide/faq/content.md): 快速排查 File Viewer 组件选型、Full 包资源、Worker/WASM 路径、格式支持、移动端布局、授权与部署问题。
- [中文 · 格式完整度与渲染路线](https://doc.file-viewer.app/llms.mdx/zh/guide/format-fidelity/content.md): File Viewer by Flyfish 的目标不是“识别一个扩展名就算支持”，而是尽量让文件在浏览器里形成可理解、可操作、可交付的预览体验。 本页基于当前实现和公开生态调研，说明新增复杂格式的真实完整度、WASM / 手写解析可行性，以及后续需要独立维护的 renderer 方向。 依赖拆包和按需安装路线见 按需渲染架构计划 。
- [中文 · 支持格式](https://doc.file-viewer.app/llms.mdx/zh/guide/formats/content.md): 唯一格式目录当前注册 266 个扩展名 ，覆盖 45 条预览链路 ：其中 224 个稳定 、 42 个实验 。 这一页不是“计划支持什么”，而是以当前代码里已经注册好的渲染器为准，告诉你项目现在到底能处理哪些格式、分别走哪条渲染链路，以及在真实业务里应该怎么选。
- [中文 · 按需渲染架构](https://doc.file-viewer.app/llms.mdx/zh/guide/on-demand-renderers/content.md): 文件预览器的格式越来越多，不能让每个项目在安装阶段都承担全部 Office、CAD、Typst、3D、压缩包、邮件和工程格式依赖。 2.x 的目标是把 core 收敛为轻量、框架无关、纯 TypeScript 的预览底座，把重渲染链路拆成可组合、可自动装配、可独立发布的 renderer package。
- [中文 · 概述](https://doc.file-viewer.app/llms.mdx/zh/guide/overview/content.md): File Viewer by Flyfish 可以为业务系统快速补齐文件在线预览能力。它不同于依赖后端转码的方案，核心解析和渲染都在浏览器端完成，不会额外占用服务器执行 Office 转 PDF、临时文件清理或异步转换任务。
- [中文 · 快速开始](https://doc.file-viewer.app/llms.mdx/zh/guide/quickstart/content.md): 如果你现在最想做的是“尽快看到效果”，这一页会先给最短可运行路径。 先选生态组件，再按业务文件类型选择 preset 或 renderer；跑通后再进入按需装配、离线资源和工具栏定制。
- [中文 · React 集成](https://doc.file-viewer.app/llms.mdx/zh/guide/quickstart-react/content.md): React 包提供原生组件体验。组件内部通过共享 core 能力直接挂载完整预览器， props、事件、ref、调试链路都留在 React 项目内。
- [中文 · Svelte 集成](https://doc.file-viewer.app/llms.mdx/zh/guide/quickstart-svelte/content.md): Svelte 包提供原生组件和 action 两种入口。组件适合页面声明式使用，action 适合已有 DOM 容器或轻量工具页。
- [中文 · Vue2 集成](https://doc.file-viewer.app/llms.mdx/zh/guide/quickstart-vue2/content.md): Vue2 已拆成 @file-viewer/vue2.7 和 @file-viewer/vue2.6 两条标准包线。 它们面向仍在 Vue2 的业务系统，格式能力、示例文件和 options / 事件语义与 Vue3 包保持一致。
- [中文 · Vue3 集成](https://doc.file-viewer.app/llms.mdx/zh/guide/quickstart-vue3/content.md): 如果你的业务工程本身就是 Vue 3，这条路线几乎是最顺手的。 安装组件、注册一次，然后把文件 URL 或二进制交给它，剩下的渲染工作交给预览器处理。
- [中文 · 纯 JS 集成](https://doc.file-viewer.app/llms.mdx/zh/guide/quickstart-web/content.md): 纯 JS 包现在提供原生 <flyfish-file-viewer> 组件和 mountViewer(container, options) 两种标准入口。 推荐优先使用 Custom Element；需要完全命令式控制时再使用 controller 挂载。
- [中文 · 样式隔离与主题定制](https://doc.file-viewer.app/llms.mdx/zh/guide/style-isolation/content.md): File Viewer 的所有标准组件默认使用 Shadow DOM 隔离组件壳和预览内容。 业务侧通过 CSS Custom Properties 和 Shadow Parts 定制外观，不再依赖内部 class 或全局覆盖。
- [中文 · 组件用法](https://doc.file-viewer.app/llms.mdx/zh/guide/usage/content.md): file-viewer 的 API 非常克制，目前真正需要记住的是两条输入路径： url 和 file ，以及一个可选的 options 。 但要把它接进真实业务里，光知道“有这两个参数”还不够，你还得知道渲染器是怎么识别文件类型的、什么时候该传 URL、什么时候应该先把结果包装成带扩展名的 File 。
- [中文 · 模块化 Profile 与 Full 兼容边界](https://doc.file-viewer.app/llms.mdx/zh/guide/v3-modular-profiles/content.md): 选择 standard、preset、自定义或 Full 安装边界，完整保留既有 Full 包契约，并让 DICOM、数字签名等专业能力保持显式按需安装。