addon-previewer

OrcaS 文档预览插件 ^via

—— 基于h5，纯离线本地版，效果和兼容性更好，可自行适配存储 ——

类型	进度	展示方案	兼容转换方案	支持格式	注意事项
pdf	✅	vue-pdf-embed	-	pdf	支持有密码文件
文字	✅	docxjs	x2t转换成docx	docx、doc、wps等	* 字体问题；有密码文档问题
表格	✅	luckyexcel	x2t转换成xlsx	xlsx、xls、csv、et等	* 字体问题；有密码文档问题
演示	✅	同pdf	x2t转换成pdf	pptx、ppt、dps等	* 字体问题；有密码文档问题
iWork	✅	h5原生	iwork2html转换成html	pages、numbers、key等	* 临时方案
文本	✅	同docx	x2t转换成docx	txt、json/toml/yml/config/xml等	enca/file检测编码防止中文乱码
代码		prism	-	cpp、c、h、java、py、go、php、js、html、css等	enca/file检测编码防止中文乱码
设计	✅	同图片	cad2x转换成png	dwg、dwt、dxf等	* 字体问题；代码页问题
图片	✅	el-image	vips压缩webp/(jpg+png)	png、jpg、gif、bmp、ico、icns、eps、psd等	gif需要处理多帧；vips支持SIMD/OpenMP加速；支持智能裁剪
视频	✅	vue-plyr	ffmpeg转码+支持随机读(Range:bytes)	mp4、wmv、mkv、avi、mov、webm、flv、mpeg、mpg、3gp、asf、rm、rmv、rmvb、m4v、swf等	fps和码率；支持GPU加速（OpenCL/Vulkan等）；可以用方言，比如Rockchip、Mali GPU
音频	✅	vue-plyr	ffmpeg转码	mp3、aac、wav、flac、ogg、m4a、aiff、wma、ape等	码率
存档	✅	复用webapp	archiver像FS一样遍历	rar、zip、7z、dmg、iso等	中文乱码；有密码的文档

缩略图（文件图标）

类型	进度	转换方案	支持格式	注意事项
文档	✅	x2t转换成png	Office文档： docx、doc、wps、xlsx、xls、csv、et、pptx、ppt、dps等；文本： txt、json/toml/yml/config/xml等；PDF	* 字体问题；有密码文档问题
iWork	✅	zip获取preview.jpg	pages、numbers、key等
设计	✅	cad2x转换成png	dwg、dwt、dxf等	* 字体问题；代码页问题
图片	✅	vips转换png	png、jpg、gif、bmp、ico、icns、eps、psd等	gif需要处理多帧；vips支持SIMD/OpenMP加速；支持智能裁剪
视频	✅	ffmpeg获取封面	mp4、wmv、mkv、avi、mov、webm、flv、mpeg、mpg、3gp、asf、rm、rmv、rmvb、m4v、swf等	fps和码率；可以尝试h.265；支持GPU加速（OpenCL/Vulkan）
其他	✅	fico转换png	图标（ ico、 icns）、 Windows可执行文件（exe、dll）、资源文件（mui、mun）、 Linux可执行文件（*.desktop【*.AppImage、*.run】）、📱 手机应用安装包（ apk包、 ipa包）、 文件夹图标（autorun.inf、desktop.ini）、 MacOSX程序（*.app）	目录图标特殊处理

关于x2t

部署方法：

• 把back/x2t下的common和对应平台（linux_arm64/linux_x64）目录下的文件都拷贝到/opt/x2t下
• 执行sh allfontsgen.sh安装字体文件、生成字体列表

方案优势：

• 更好的性能

  • 纯C++开发，无依赖
  • 原生支持同时并发转换多个文件
  • 秒级启动，不需要常驻

• 更小的体积

  • x2t完整功能支持仅90MB：可执行文件32.9MB + 配置文件57.1MB
    • 对比LibreOffice（6.4.7.2）需要401MB：jvm运行环境179MB + 包222MB（无字体）
  • 字体文件166MB左右：常见字体82.8MB（见core-fonts） + 下载82.9MB（见allfontsgen.sh）
    移除了非中文字体，可按需补回

    类别	名称	大小	说明
    韩文	nanum	34.3MB	韩国的Naver公司开发
    藏文	TibetanMachineUni	4.3MB	用于显示藏文的Unicode字体
    高棉文	khmeros	520KB	支持柬埔寨语言的文字显示
    缅甸文	padauk	1.76MB	支持缅甸语言的文字显示
    孟加拉文	beng-extra	678KB	支持孟加拉语的文字显示
    阿拉伯文	kacst	1.06MB	KACST（沙特阿拉伯国王阿卜杜拉兹国王科学技术城）开发，旨在支持阿拉伯语的文字显示
    拉丁、希腊文等	asana	760KB	由 SIL International（国际文字系统学会）开发，支持拉丁字母、希腊字母和西里尔字母等
    埃塞俄比亚文	abyssinica	596KB	支持埃塞俄比亚文字（比如阿姆哈拉语和提格雷语等）的显示
    日文	takao-gothic	6MB	支持日文文字显示，包括Takao明朝（Takao Mincho）和Takao高桥（Takao Gothic）
    	takao-pgothic	6MB	支持日文文字显示，无衬线字体，包括Takao P明朝（Takao P Mincho）和Takao Pゴシック（Takao P Gothic）
    	mona	2.8MB	支持日文文字显示
    印度文	samyak	324KB	支持印度语言（包括印地语、马拉地语等）的文字显示
    	lohit	1.3MB	支持印度语言（印地语、孟加拉语、古吉拉特语、卡纳达语等）的文字显示
    	gujr-extra	394KB	支持古吉拉特语言（Gujarati）（印度的一种官方语言，主要在古吉拉特邦使用）的文字显示
    	telu-extra	430KB	支持泰卢固语（Telugu）（印度的一种官方语言，主要在特伦甘纳邦和安得拉邦使用）的文字显示
    总计		61.22MB

• 更好的兼容性

  • 从OnlyOffice最新版本v8.0.0.99修改

  • 举例： 用MacOSX的keynote创建的pptx，OnlyOffice转换没问题，并且展示准确

    • 对比Microsoft Office/WPS打开失败、LibreOffice/OpenOffice转换pdf格式丢失（老版本也打开失败）

  • 插件移除了不常用的djvu、epub、fb2格式

    展开查看支持矩阵

    • 官方文档

    文字文档	输出格式
    	bmp	docm	docx	docxf	dotm	dotx	gif	html	jpg	odt	ott	pdf	pdfa	png	rtf	txt
    doc	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    docm	🆗	=	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    docx	🆗	🆗	=	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    docxf	🆗	🆗	🆗	=	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    dot	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    dotm	🆗	🆗	🆗	🆗	=	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    dotx	🆗	🆗	🆗	🆗	🆗	=	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    fodt	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    htm	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    html	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    mht	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    mhtml	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    odt	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=	🆗	🆗	🆗	🆗	🆗	🆗
    ott	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=	🆗	🆗	🆗	🆗	🆗
    oxps	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    pdf	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=	🆗	🆗	🆗	🆗
    rtf	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=	🆗
    stw	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    sxw	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    txt	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=
    wps	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    wpt	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    xml	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    xps	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    表格文档	输出格式
    	bmp	csv	gif	jpg	ods	ots	pdf	pdfa	png	xlsm	xlsx	xltm	xltx
    csv	🆗	=	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    et	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    ett	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    fods	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    ods	🆗	🆗	🆗	🆗	=	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    ots	🆗	🆗	🆗	🆗	🆗	=	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    sxc	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    xls	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    xlsb	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    xlsm	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=	🆗	🆗	🆗
    xlsx	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=	🆗	🆗
    xlt	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    xltm	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=	🆗
    xltx	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=
    xml	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    演示文档	输出格式
    	bmp	gif	jpg	odp	otp	pdf	pdfa	png	potm	potx	ppsm	ppsx	pptm	pptx
    dps	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    dpt	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    fodp	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    odp	🆗	🆗	🆗	=	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    otp	🆗	🆗	🆗	🆗	=	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    pot	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    potm	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=	🆗	🆗	🆗	🆗	🆗
    potx	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=	🆗	🆗	🆗	🆗
    pps	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    ppsm	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=	🆗	🆗	🆗
    ppsx	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=	🆗	🆗
    ppt	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗
    pptm	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=	🆗
    pptx	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	=
    sxi	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗	🆗

关于cad2x

部署方法：

• 把back/cad2x下的common和对应平台（linux_arm64/linux_x64）目录下的cad2x文件都拷贝到/opt/cad2x下

方案优势：

• 更小的体积

  • 去除了GUI部分（界面渲染和跨平台）
  • 裁剪了大量无用依赖库和代码
  • 最终二进制文件仅2.9MB

• 更好的兼容性

  • 从LibreCAD最新代码（commit-id：0601535）裁剪
  • 修复编码错误导致乱码问题
  • 支持自动识别横向纵向
  • 支持复用系统和x2t的ttf字体

关于ffmpeg

部署方法：

• 普遍安装方式

  • 使用包安装器或者源码编译安装ffmpeg，在/opt/ffmpeg下创建/usr/bin/ffmpeg的软链接

• Rockchip加速版

  • 把back/ffmpeg下的对应平台（rockchip）目录下的文件都拷贝到/opt/ffmpeg下
  • 配置类似ORCAS_FFMPEG_HWACCEL="-hwaccel rkmpp -hwaccel_output_format drm_prime -afbc rga"环境变量支持硬件加速

注意事项：

• 如果转换插件在docker镜像中部署，需要配置ORCAS_DOCKER_EXEC="docker exec -i <container_id>"环境变量，其中container_id为容器的id值
• 打包后的文件和webapp的放置到一起： ln -s $(addon-previewer)/front/dist $(webapp)/dist/prvw