文档指南
分发方式
File Viewer 通过 npm、GitHub Releases、Docker 以及在线 demo/文档站分发。
File Viewer 通过 npm、GitHub Releases、Docker 以及在线 demo/文档站分发。
| 需求 | 推荐渠道 |
|---|---|
| 应用集成 | npm 上的 @file-viewer/* 包 |
| 框架完整集成 | 对应的 @file-viewer/*-full 包 + /file-viewer/ 运行时资产 |
| 静态/iframe/离线归档 | GitHub Releases |
| 可直接运行的容器 | Docker Hub 的 flyfishdev/file-viewer |
| 源码开发 | 当前 GitHub 总仓 |
大体积发行归档和 npm tarball 不进入 Git 历史。公开仓 artifacts/ 只保留 manifest、status、matrix 和 schema JSON；发行记录通过下载链接指向 GitHub Release 资产。
*-full 已内置 preset-all，无需重复安装 preset。Vite 使用 fileViewerRenderers({ copyAssets:true })，把同版本 Worker、WASM、字体和 vendor 资源发布到部署基址下的 file-viewer/；其它构建工具运行 full 包自带的 npx --no-install file-viewer-copy-assets ./public/file-viewer。直接使用 CDN web-full，或完整部署它的整个 dist/ 目录时，无需复制。
公开源码构建
pnpm install --frozen-lockfile
pnpm build
pnpm docs:build维护者边界
版本管理、npm 发布、官方 Docker 发布、Cloudflare 部署、仓库同步和发行签名属于完整私有工作区的维护者操作。公开边界不复制这些内部脚本，从而保证公开文档中的命令真实可执行。