HOP架构全解：Tauri 2、Rust与TypeScript如何协作构建跨平台HWP编辑器

【免费下载链接】hop项目地址https://gitcode.com/gh_mirrors/hop22/hop点击查看免费下载HOP是一个开源的跨平台 HWP/HWPX 文档编辑器它的架构核心是Tauri 2 Rust TypeScript的三层协作Rust 负责桌面原生能力文件、窗口、PDF 导出TypeScript 负责编辑器界面与交互而文档解析引擎则由只读上游依赖rhwp提供。本文将带你快速看懂 HOP 的完整架构设计。️ 先看全貌三层架构一览HOP 的仓库结构本身就是架构的直观体现层级目录技术栈职责桌面外壳apps/desktop/Tauri 2 Rust窗口、菜单、文件关联、保存/打印/PDF 导出编辑器前端apps/studio-host/TypeScript Vite工具栏、命令系统、渲染会话、桌面事件路由文档引擎third_party/rhwp/Rust WASM只读HWP 解析、渲染、PDF 协议一句话概括分工TypeScript UI 调用清晰的 Bridge APIRust 拥有原生文件系统、文档会话、保存/导出/打印和操作系统集成行为——这是 HOP 在 AGENTS.md 中明确写下的架构原则。 Tauri 2 层Rust 打造的桌面外壳HOP 的桌面端基于 Tauri 2 构建入口在 lib.rs。它在启动时装配了一系列 Tauri 插件日志、对话框、文件系统、Store、Updater、窗口状态、单实例并通过invoke_handler向前端暴露了一组类型安全的 Rust 命令例如prepare_document_open/commit_staged_hwp_save文档打开与两阶段原子保存export_pdf/print_webviewPDF 导出与原生打印create_editor_window/destroy_current_window多窗口管理list_recent_documents/record_recent_document最近文档这套设计还处理了不少细节单实例运行时把命令行传入的.hwp/.hwpx路径路由到对应窗口见 pending_open.rs、拖拽打开文件、macOS 的RunEvent::Opened事件以及 macOS 专属的Quick Look 预览扩展apps/desktop/quicklook/让 Finder 中按空格键就能预览 HWP 文档。应用元数据、文件关联和更新器配置集中在 tauri.conf.json其中声明了.hwp/.hwpx的文件关联fileAssociations以及面向三个平台的打包目标。️ TypeScript 层studio-host 编辑器前端编辑器界面位于 apps/studio-host/基于 Vite Vitest 开发。它并非从零实现而是在上游rhwp-studio之上做了一层覆盖层overlayBridge 工厂bridge-factory.ts 检测是否运行在 Tauri 环境是则创建TauriBridgetauri-bridge.ts否则回退到纯 WASM 的WasmBridge。TauriBridge封装了打开/保存/导出/打印/更新等全部桌面能力是前端与 Rust 之间的唯一类型化边界。命令运行时command-runtime.ts 以类型化贡献的方式组装文件、编辑、格式、表格等命令组HOP 的桌面命令如 file.ts、edit.ts替换或包裹对应上游命令组。渲染会话renderer-session.ts 固定使用 Canvas2D 后端把产品策略收敛在工厂里一次性决定。Shadowing 机制Vite 的 alias 解析vite.config.ts让 HOP 只需用同路径文件遮蔽上游实现无需复制整棵源码树。 Rust 适配层与只读上游边界rhwp文档引擎以 git submodule 形式放在 third_party/rhwp/HOP 产品代码严禁直接修改它。Rust 侧通过 rhwp-adapter 这个薄适配层访问上游 crate——upstream 包/模块位置变动时只留一个修复点。例如 pdf_export.rs 的导出流程就是逐页渲染 SVG → 经过 adapter 的searchable_pdf_from_svg_pages()交给 rhwp 原生 PDF 协议保留文本可搜索→ 原子写入磁盘。上下游的关系由两个配置文件精确锚定config/rhwp-upstream.json上游版本的单一事实来源当前为 v0.8.7含精确 commit、Rust 工具链与 wasm-pack 版本config/rhwp-studio-overrides.json所有 shadow alias 的清单每条 override 标注策略——extension包裹上游实现、fork有意保留的分叉、contributionHOP 独有功能——并记录存在理由配合 SHA-256 基线防止上游更新时悄然漂移更新上游只需一条命令pnpm upstream:update -- vX.Y.Z pnpm upstream:verify详细流程见 docs/architecture/UPSTREAM.md 与 docs/operations/RHWP_UPDATE.md。 一次打开文档的完整数据流把三层串起来用户双击一个.hwp文件后发生的事是RustTauri 外壳单实例插件接收文件路径入队到pending_open_paths向前端发送hop-open-paths事件TypeScriptstudio-hostTauriBridge.openDocumentByPath()调用 Rust 命令prepare_document_open拿到docId、页数、revision 等会话信息Rust文档会话文档字节交给 rhwp 引擎解析后续每次编辑经mutate_document命令走类型化指令TypeScript渲染CanvasView渲染页面命令系统驱动工具栏状态更新保存时则是两阶段提交prepare_staged_hwp_save→ 外部修改检测 →commit_staged_hwp_save配合原子写入保证文件安全。✅ 架构如何被验证每个边界都有对应的测试防线pnpm run test:studioTypeScript / Vitest、pnpm run test:desktopRust / cargo test clippy、pnpm run test:upstream上游基线与边界测试。完整命令列表见 docs/DEVELOPMENT.md。 总结HOP 的架构精髓在于边界清晰、适配层薄Tauri 2提供轻量跨平台外壳Rust 独占文件系统与 OS 集成TypeScript专注编辑器体验通过类型化 Bridge 与桌面能力对话rhwp作为只读上游引擎用配置基线 适配层隔离变更成本这种上游引擎 薄产品层的组合让 HOP 既能持续享受上游引擎的改进又能自由演进自己的桌面产品特性——这正是它在 macOS、Windows、Linux 三端保持行为一致的关键。赞分享【免费下载链接】hop项目地址https://gitcode.com/gh_mirrors/hop22/hop点击查看免费下载相关推荐开源HWP编辑器HOP工程实践1-Pager问题陈述法如何让跨平台重构风险可控开源HWP编辑器HOP工程实践1 Pager问题陈述法如何让跨平台重构风险可控 HOPOpen HWP是一款开源的跨平台 HWP/HWPX 文档编辑器支Tabularis架构深度解析React 19前端与Rust Tauri v2后端如何构建跨平台SQL工作台Tabularis架构深度解析React 19前端与Rust Tauri v2后端如何构建跨平台SQL工作台 Tabularis 是一款开源桌面 SQL 工作大麦双端自动抢票指南网页 Selenium 手机 Appium开票前 30 分钟备好大麦双端自动抢票指南网页 Selenium 手机 Appium开票前 30 分钟备好 ticket purchase 是大麦自动抢票工具网页端用 SeGUI 自动化RPA创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考