工具开发 · WEB COMPONENT
Uni-Viewer
面向企业后台、内网和私有化系统的纯前端文件预览组件。私有文件留在浏览器内，无需服务端转码，即可预览 Office、PDF/OFD、CAD、压缩包、邮件、图片、音视频和代码。
核心能力
一个组件起步，统一文件源、生命周期、搜索、缩放、打印、导出和下载契约。
部署不出网
浏览器内解析和渲染，支持离线网络、Docker、私有 CDN 和完整资源自托管，私有文件不离开内网。
全格式覆盖
Office（DOCX / XLSX / PPTX / 二进制 PPT）、PDF / OFD、CAD（DWG / DXF）、STEP 三维、Typst、XMind、压缩包、邮件、绘图、音视频、代码。
专业格式扩展
Adobe 设计文件、DICOM、数字签名容器、ELF / PE / Mach-O 二进制检查器按需启用，只读分析不执行文件。
框架全覆盖
Vanilla JS / Web Component 优先，同时提供 Vue 2.6 / 2.7 / 3、React 16.8 - 19、Svelte、jQuery 原生组件。
按需加载
PDF、Office、CAD、Typst、压缩包、图纸、PSD、Mermaid 等重型能力只在命中格式时加载 Worker / WASM / 字体资产。
操作完整
搜索、高亮、缩放、打印、导出 HTML、下载、水印、主题、生命周期钩子和按钮前置校验都走统一 API。
有界多页 TIFF
CCITT Group 4 TIFF 在独立懒加载边界逐页解码，支持整组缩放、旋转、适宽、页码状态与大图查看。
工程化接入
CLI 一键生成示例：npm create uni-viewer@latest；Vite 插件自动发布同版本资源。
开源许可
源码基于 Apache-2.0 许可，npm 生态持续维护，历史包同步更新。
界面实录
同一套 API，覆盖办公文档、工程图纸与移动端。
技术栈
TypeScript · Web Components · Vite 5 - 8 适配 · Web Worker · WASM · 私有 CDN / Docker 部署
快速接入
新项目可用 CLI 生成示例，已有项目按提示添加组件和资产配置。
① 生成 / 添加
npm create uni-viewer@latest my-viewer
或在已有项目中：npx uni-viewer-cli@latest add .
② 选择组合
CLI 默认 Standard 组合，--profile full 选择 Full 兼容包并添加 DICOM、数字签名能力。
③ 自托管资产
Vite 使用 @uni-viewer/vite-plugin；其它构建工具运行 Full 包自带 CLI 复制同版本资源。