poxiaoxi博客为了查看一份DOCX、工程图纸或邮件附件，将文件上传到在线转换网站并不总是合适。合同、报表、内部图纸和客户资料可能包含敏感内容，断网电脑或企业内网也无法依赖云端预览服务。
FileDesk Offline提供了一种相对直接的处理方式：把文件预览引擎及其依赖资源完整保存在本地，通过浏览器解析和展示文件，不要求用户把文件发送到第三方转换平台。
FileDesk的实际定位
offline-filedesk仓库中的产品名称为FileDesk Offline。它不是从零开发的文件解析器，而是File Viewer项目的第三方离线发行版。
项目明确说明，文件预览引擎、格式渲染能力、主要依赖和Web Demo基础页面来自上游flyfish-dev/file-viewer。FileDesk在此基础上完成了离线资源打包、界面调整、隐私提示、加载状态、最近打开记录、本地启动服务和跨平台脚本等工作。
当前仓库使用的上游版本为2.2.3。它与File Viewer原作者不存在隶属、授权代理或官方背书关系，因此更准确的理解是：FileDesk是一套方便普通用户直接运行的离线封装，而不是另一个独立文件预览引擎。
离线版如何运行
复杂文件的浏览器预览不只依赖一个HTML页面，还需要JavaScript、Worker、WASM、字体和不同格式对应的渲染资源。FileDesk已经把运行所需资源放入项目目录，因此不需要执行npm install，也不依赖公共CDN。
使用时必须复制整个offline-filedesk文件夹，不能只保留index.html。否则PDF、Office、CAD或三维文件需要的资源路径可能缺失。
Windows电脑安装Python 3后，可以双击：
启动-FileDesk.bat
macOS安装Python 3后，可以运行：
启动-FileDesk.command
Linux用户在项目目录执行：
python3 server.py
本地服务器默认从8765端口开始寻找可用端口，并且只监听127.0.0.1。启动完成后会自动打开浏览器，关闭命令窗口或停止Python进程即可结束服务。
使用本地服务器而不是直接双击index.html，主要是为了正确加载Worker、WASM及浏览器安全策略所需的静态资源。
支持哪些文件类型
FileDesk继承了File Viewer 2.2.3的格式预览能力，覆盖范围不只限于常见办公文档。
办公文档：DOC、DOCX、XLS、XLSX、PPT、PPTX、RTF及OpenDocument格式。
电子文档：PDF、OFD、EPUB、Markdown及Typst等。
工程文件：DWG、DXF、DWF、DWFX及部分STEP、IFC和三维模型。
压缩文件：ZIP、RAR、7Z、TAR、ISO及其他相关格式。
邮件文件：EML、MSG和MBOX等。
图表设计：Draw.io、Excalidraw、Mermaid、PlantUML、XMind和PSD等。
开发数据：源代码、diff、patch、SQLite、Parquet及部分结构化数据。
媒体文件：常见图片、音频和视频。
格式出现在支持列表中，不代表任何文件都能获得与原软件完全相同的显示效果。复杂排版、嵌入字体、宏、特殊插件、供应商私有扩展和损坏文件，都可能影响预览结果。
本地与链接两种模式
FileDesk工作台提供“本地”和“链接”两种文件来源。
本地模式允许用户选择或拖入电脑中的文件。文件主要由浏览器在本机解析和渲染，项目不包含账号、遥测或云端转换服务，也不会主动把本地文件上传到第三方平台。
链接模式用于打开远程文件地址。此时浏览器必须向目标网址发送请求，因此仍然会产生网络访问。远程服务器是否记录IP、请求头和访问日志，取决于对应网站的规则。
处理合同、财务报表、设计图纸或其他敏感内容时，更适合使用本地模式，并在必要时断开网络。仅仅打开FileDesk页面，并不能让远程URL变成本地文件。
预览工作台提供什么
FileDesk对上游Web Demo进行了工作台化调整。用户可以从示例文件开始测试，也可以选择自己的文件，并在界面中查看最近打开记录。
预览区域的工具栏提供缩放、搜索、水印、下载、打印和HTML等操作入口。不同文件格式使用的渲染链路不同，能够执行的具体操作及输出效果也可能存在差异。
页面还设置了中英文界面切换和“接入代码”入口。需要将预览能力集成到OA、知识库、附件中心或其他Web系统时，可以进一步查看上游File Viewer提供的Web Component、React、Vue、Svelte和jQuery组件。
FileDesk本身更偏向开箱即用的本地工作台。需要深度定制权限、工具栏、文件源和业务流程时，直接使用上游组件开发通常更合适。
联网轻量版有何区别
仓库还提供FileDesk-联网轻量版.html。它适合电脑能够联网，但不方便安装Python的情况，下载单个HTML文件后即可双击运行。
这个版本会从公共unpkg CDN加载上游@file-viewer/web-full 2.2.3资源，因此并不属于真正的离线版。网络中断、CDN无法访问或相关资源发生变化时，文件预览可能无法正常工作。
两种版本的选择比较明确：
需要断网、内网或U盘便携运行，应复制完整离线项目。
电脑可以联网，只想临时查看文件，可以使用联网轻量版。
敏感资料强调运行环境可控时，应优先使用完整离线版。
精彩评论