Convert to it Electron桌面版架构解析跨平台文件转换器设计【免费下载链接】convertTruly universal online file converter项目地址: https://gitcode.com/GitHub_Trending/convert7/convertConvert to itConvert to it Electron 桌面版是一款号称真正通用的跨平台文件转换器它不只支持图片转图片、视频转视频甚至能把 AVI 视频转成 PDF。整个转换过程在本地完成文件无需上传服务器兼顾了隐私与安全。它的核心是一套格式处理器 图搜索路由的架构而 Electron 桌面版则让这套纯浏览器技术可以离线跑在 Windows、macOS 和 Linux 上。一、项目全景一个转换器由哪些部分组成项目采用Bun Vite TypeScript技术栈代码结构清晰各模块分工明确模块职责src/main.ts前端 UI 编排文件选择、格式列表构建、发起转换src/handlers/各类格式的转换处理器FFmpeg、ImageMagick、pandoc 等src/TraversionGraph.ts转换路径搜索引擎带代价权重的图遍历src/FormatHandler.ts定义统一的格式处理器接口与文件格式模型src/electron.cjsElectron 桌面版主进程入口vite.config.js构建配置负责把 WASM 等资产拷到/convert/wasm/二、核心设计处理器 路径搜索2.1 统一的 FormatHandler 接口所有转换工具都被规范化成标准接口——即所谓的处理器Handler。每个处理器只需声明三件事支持哪些格式输入/输出、MIME 类型、扩展名、是否无损如何初始化init()加载 WASM 等依赖如何执行转换doConvert()接收输入文件字节返回输出文件格式定义通过 FormatDefinition 类描述并提供链式构建器builder来声明from/to/lossless属性。这种抽象让 src/handlers/ 目录下的几十个处理器FFmpeg.ts、ImageMagick.ts、pandoc.ts 等对外呈现完全一致的行为。2.2 TraversionGraph像导航一样找转换路线最有意思的设计在 src/TraversionGraph.ts。由于很多格式无法一步转换比如 DOCX → 图片项目把所有格式和处理器建成一张有向带权图用类 A* 算法自动寻找转换路线DOCX →(pandoc)→ HTML →(pandoc)→ PNG边的代价由多组权重叠加而成见 TraversionGraph.ts 第23-29行DEPTH_COST 1每多一步转换代价增加优先选择更短的路径LOSSY_COST_MULTIPLIER 1.4有损转换更贵算法倾向无损路径类别切换成本例如 图→视频 代价 0.2近似无损图→音频 代价 1.4极有损甚至对特定组合如 FFmpeg 做图转音频直接标 100相当于断路HANDLER/FORMAT_PRIORITY同代价时优先更专业的处理器与格式转换失败时该路段会被记录为死路dead endmain.ts 的 attemptConvertPath 会跳过已知死路并尝试下一条候选路径——这就是为什么用户点击转换后界面上会出现Finding conversion route...的提示。2.3 格式列表缓存加速启动所有处理器的格式元数据在首次运行时汇总为一份缓存cache.json由 buildCache.js 离线预生成。桌面构建流程 package.json 中的desktop:build脚本会依次执行 TypeScript 编译、带IS_DESKTOPtrue标记的 Vite 构建、缓存生成让应用启动时直接读取 main.ts 中的缓存加载逻辑跳过漫长的格式探测。三、Electron 桌面版的关键实现3.1 为什么要自定义app://协议electron.cjs 是整个桌面版的精髓全文仅 120 余行。它注册了一个特权自定义协议app把app://-/index.html这样的请求映射到本地dist/目录的真实文件app://-/index.html → 项目/dist/index.html直接加载本地文件file://会导致 CORS 和 Web Worker 行为异常而自定义协议让应用表现得像一个正常的 HTTPS 站点。协议处理中还有两个精妙细节路径逃逸防护electron.cjs 第72-76行校验解析后的路径必须位于dist/内防止../越权读取系统文件。注入 COOP/COEP 响应头electron.cjs 第82-85行headers.set(Cross-Origin-Opener-Policy, same-origin); headers.set(Cross-Origin-Embedder-Policy, credentialless);这两行让浏览器启用SharedArrayBuffer——项目依赖大量WebAssemblyFFmpeg、ImageMagick、pandoc、7z 等编译为 WASM 在浏览器里运行多线程 WASM 正是需要这个能力。3.2 安全配置窗口创建时开启了现代 Electron 的标准安全组合electron.cjs 第20-30行contextIsolation: true上下文隔离、nodeIntegration: false渲染进程禁用 Node、webSecurity: true。同时通过setWindowOpenHandler和will-navigate监听器拦截所有外部链接一律交给系统默认浏览器打开electron.cjs 第34-40行保证应用内部永不跳出到网络页面。3.3 跨平台打包一条命令三端出包跨平台能力由 package.json 中的 electron-builder 配置实现平台命令产物格式Windowsbun run desktop:dist:winNSIS 安装包.exemacOSbun run desktop:dist:macDMG 镜像Linuxbun run desktop:dist:linuxAppImage三端产物统一输出到release/目录可执行文件名固定为ConvertToItappId 为com.p2r3.convert。由于所有转换逻辑都是 Web/WASM 技术桌面版与 Web 版共用同一套前端代码Electron 层只负责安全地加载本地资源这一件事维护成本极低。四、架构总结与启发Convert to it 的 Electron 桌面版给浏览器应用桌面化提供了很好的参考范本薄主进程electron.cjs 只做协议映射与安全拦截复杂业务全部留在渲染进程架构边界清晰。协议层解决 WASM 约束用自定义协议注入 COOP/COEP 头是无头化、多线程化 WASM 的关键一步。图搜索替代穷举TraversionGraph.ts 用代价函数把该走哪条转换链变成可计算问题并支持失败路段的运行时学习。Web 与桌面同源IS_DESKTOPtrue环境变量切换构建模式一套代码两种形态发布时再叠加 electron-builder 的三端目标配置。如果你想给它添加新的格式支持只需在 src/handlers/ 下实现一个符合 FormatHandler 接口的处理器类并注册路径搜索引擎会自动把它纳入转换图——这正是这套架构可扩展性的体现。 【免费下载链接】convertTruly universal online file converter项目地址: https://gitcode.com/GitHub_Trending/convert7/convert创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
