> For AI agents: the complete documentation index is available at /next/zh/llms.txt, the full documentation bundle is available at /next/zh/llms-full.txt.

# 什么是 Lynxtron？

Lynxtron 是一个使用 [Lynx](https://lynxjs.org/) 和 Node.js 构建桌面应用的框架。如果你了解 [Electron](https://www.electronjs.org/)，可以将 Lynxtron 理解为**把 Chromium 渲染层替换为 Lynx 的 Electron**。

- **主进程**侧本质上就是 [Electron](https://www.electronjs.org/docs/latest/tutorial/process-model#the-main-process)。Node.js 控制应用生命周期、窗口、菜单、托盘、对话框等系统级 API。
- **UI** 侧是 [Lynx](https://lynxjs.org/zh/guide/start/quick-start.html) 运行时。可以使用 ReactLynx、VueLynx 等 Lynx 运行时 DSL 编写界面，最终使用 [`<view>`](/next/zh/api/elements/built-in/view.md)、[`<text>`](/next/zh/api/elements/built-in/text.md)、[`<image>`](/next/zh/api/elements/built-in/image.md) 等原生元素进行渲染，而非 HTML。

:::tip 已经熟悉 Electron 和 Lynx？
那你已经掌握了 Lynxtron 的大部分知识。本页只介绍**新的部分**：那些只因 Electron + Lynx 组合才存在的概念。
:::

## 来自 Electron 的部分

主进程运行在 Node.js 上；Lynxtron 提供一组 Electron 风格的窗口、应用生命周期、菜单、托盘等桌面端 API。如果你用过 Electron，以下常用概念基本相同：

| Electron                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Lynxtron                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 区别                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`BrowserWindow`](https://www.electronjs.org/zh/docs/latest/api/browser-window)                                                                                                                                                                                                                                                                                                                                                                                                         | [`LynxWindow`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Class.LynxWindow.md)                                                                                                                                                                                                                                                                                                                                                                                                                                              | 加载 Lynx bundle 而非 HTML；窗口构造与定制选项如 [`width`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Interface.LynxWindowConstructorOptions.md#width)、[`height`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Interface.LynxWindowConstructorOptions.md#height)、[`frame`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Interface.LynxWindowConstructorOptions.md#frame)、[`transparent`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Interface.LynxWindowConstructorOptions.md#transparent)、[`titleBarStyle`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Interface.LynxWindowConstructorOptions.md#titlebarstyle)、[`vibrancy`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Interface.LynxWindowConstructorOptions.md#vibrancy) 用法一致 |
| [`app`](https://www.electronjs.org/zh/docs/latest/api/app) / [`Menu`](https://www.electronjs.org/zh/docs/latest/api/menu) / [`Tray`](https://www.electronjs.org/zh/docs/latest/api/tray) / [`Notification`](https://www.electronjs.org/zh/docs/latest/api/notification) / [`dialog`](https://www.electronjs.org/zh/docs/latest/api/dialog) / [`shell`](https://www.electronjs.org/zh/docs/latest/api/shell) / [`screen`](https://www.electronjs.org/zh/docs/latest/api/screen) 等桌面端 API | [`app`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Variable.app.md) / [`Menu`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Class.Menu.md) / [`Tray`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Class.Tray.md) / [`Notification`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Class.Notification.md) / [`dialog`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Variable.dialog.md) / [`shell`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Variable.shell.md) / [`screen`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Variable.screen.md) 等桌面端 API | 基本沿用 Electron API                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| [`contextBridge`](https://www.electronjs.org/zh/docs/latest/api/context-bridge)                                                                                                                                                                                                                                                                                                                                                                                                         | [`contextBridge`](/next/zh/lynxtron/api/@lynx-js/lynxtron/context-bridge/Interface.ContextBridge.md)                                                                                                                                                                                                                                                                                                                                                                                                                     | [`exposeInLynxBTS()`](/next/zh/lynxtron/api/@lynx-js/lynxtron/context-bridge/Interface.ContextBridge.md#exposeinlynxbts) 用于替代 Electron [`exposeInMainWorld()`](https://www.electronjs.org/zh/docs/latest/api/context-bridge)，并在其基础上增加了从 Node.js 向 Lynx 暴露可调用 JS 对象的能力，暴露对象可以包含函数、闭包和返回 Promise 的异步 API                                                                                                                                                                                                                                                                                                                                                                                       |
| [`@electron/rebuild`](https://www.electronjs.org/zh/docs/latest/tutorial/using-native-node-modules)                                                                                                                                                                                                                                                                                                                                                                                     | [`@lynx-js/lynxtron-rebuild`](/next/zh/lynxtron/api/@lynx-js/lynxtron-rebuild/index.md)                                                                                                                                                                                                                                                                                                                                                                                                                                  | 不同的运行时 ABI                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| [`electron-builder`](https://www.electron.build/)                                                                                                                                                                                                                                                                                                                                                                                                                                       | [`@lynx-js/lynxtron-builder`](/next/zh/lynxtron/api/@lynx-js/lynxtron-builder/index.md)                                                                                                                                                                                                                                                                                                                                                                                                                                  | 基于 electron-builder 的 Lynxtron 打包入口；复用 `electron-builder.yml`，将 Electron runtime 替换为对应版本的 Lynxtron runtime，并支持 macOS universal 构建                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

## 来自 Lynx 的部分

UI 层就是标准的 Lynx。你可以使用 Lynx 支持的运行时 DSL（如 ReactLynx、VueLynx）编写界面：

| Lynx 概念                                                                                                                                                                                                                   | 在 Lynxtron 中的使用                                                                                                                                            | 了解更多                                                                                                         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| [元素](https://lynxjs.org/zh/guide/ui/elements-components.html)（[`<view>`](/next/zh/api/elements/built-in/view.md)、[`<text>`](/next/zh/api/elements/built-in/text.md)、[`<image>`](/next/zh/api/elements/built-in/image.md)） | 窗口内容使用 Lynx 元素，而非 HTML                                                                                                                                     | [Lynx 元素](https://lynxjs.org/zh/guide/ui/elements-components.html)                                           |
| [样式](https://lynxjs.org/zh/guide/ui/styling.html)（CSS 子集 + `-x-` 扩展）                                                                                                                                                      | 标准 Lynx 样式                                                                                                                                                 | [Lynx 样式](https://lynxjs.org/zh/guide/ui/styling.html)                                                       |
| ReactLynx / VueLynx 等运行时 DSL                                                                                                                                                                                              | 使用 Lynx 支持的 DSL 编写 UI                                                                                                                                      | [ReactLynx](https://lynxjs.org/zh/react/introduction.html) / [VueLynx](https://vue.lynxjs.org/)              |
| [`NativeModules`](https://lynxjs.org/zh/guide/use-native-modules)                                                                                                                                                         | Lynx 原生模块入口；在 Lynxtron 中包含 `NativeModules.bridge` / [`NativeModules.nodejs`](/next/zh/lynxtron/api/@lynx-js/lynxtron/lynx/Interface.LynxtronNodejs.md) 等通道 | [Lynx NativeModules](https://lynxjs.org/zh/guide/use-native-modules)                                         |
| [`GlobalEventEmitter`](/next/zh/guide/interaction/event-handling/event-propagation.md#globaleventemitter)                                                                                                                 | 接收主进程推送的事件                                                                                                                                                 | [Lynx GlobalEventEmitter](/next/zh/guide/interaction/event-handling/event-propagation.md#globaleventemitter) |

## 架构：单进程，双线程隔离

与 Electron 的多进程模型（主进程 + 渲染进程）不同，Lynxtron 运行在**单个进程**中，通过**主线程 + Lynx 后台线程**形成和 Electron 双进程模型对偶的双线程隔离；其中 Lynx 后台线程可以被多个窗口共享，也可以为窗口使用独立后台线程。

![Lynxtron 单进程双线程架构](https://lf-lynx.tiktok-cdns.com/obj/lynx-artifacts-oss-sg/lynx-website/assets/lynxtron/lynxtron-architecture.png)
| Lynxtron 线程   | 线程关系      | Electron 对偶                       | 主要职责                                                                                                   |
| ------------- | --------- | --------------------------------- | ------------------------------------------------------------------------------------------------------ |
| **主线程**       | 每个应用一个    | Electron 主进程 + Chromium 渲染侧的主线程职责 | Node.js 主进程 API、窗口管理、原生能力、Lynx [MTS](/next/zh/react/main-thread-script.md)、输入、布局、渲染                    |
| **Lynx 后台线程** | 可共享或按窗口独立 | Electron Renderer 中的页面业务 JS       | 直接运行在 Node.js 上，承载各窗口隔离的 BTS Context，执行 Lynx UI 业务逻辑；BTS Context 不是 Node.js 全局环境，可通过桥接访问白名单 Node.js 能力 |

Lynxtron 在单进程内，把主控能力和 Lynx 主线程能力放在主线程，把 Lynx UI 业务逻辑放在 Lynx 后台线程。Lynx 后台线程直接运行在 Node.js 上，但每个窗口的 BTS Context 是隔离 context，不是 Node.js 全局环境，不能直接使用 Node.js 接口。多个窗口可以共享同一个后台线程，也可以为窗口分配独立后台线程；无论哪种方式，各窗口的 BTS Context 仍然相互隔离；BTS 只能通过 `NativeModules.bridge` 或 [preload scripts](/next/zh/lynxtron/learn/Communication-Between-Node-And-Lynx.md#使用-preload-scripts) 暴露的白名单能力访问 Node.js。

## Lynxtron 中的关键差异

以下机制用于连接 Electron-like 主进程模型和 Lynx UI 运行时，是 Lynxtron 相比 Electron 或纯 Lynx 需要额外理解的部分：

### 使用 Lynx 元素构建桌面 UI

Lynxtron 为 Lynx 的 UI 系统增加了桌面特有的能力：

- **[`LynxWindow`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Class.LynxWindow.md) 替代 Electron [`BrowserWindow`](https://www.electronjs.org/zh/docs/latest/api/browser-window)**：窗口加载 Lynx bundle，并使用 Lynx 元素渲染 UI，而非加载 HTML 页面
- **[`-x-app-region: drag`](/next/zh/lynxtron/learn/Custom-Window-Styles.md#定义-ui-拖拽区域)**：让 Lynx 元素成为窗口拖拽区域（类似 Electron 的 [`-webkit-app-region: drag`](https://www.electronjs.org/zh/docs/latest/tutorial/custom-window-interactions)）
- **[`<title-bar-view>`](/next/zh/api/elements/built-in/title-bar-view.md)**：用于自定义标题栏的内置 Lynx 元素

→ [了解更多：构建自定义窗口](/next/zh/lynxtron/learn/Custom-Window-Styles.md)

### 线程间通信

Lynxtron 有三种线程间通信模式，对应 [Electron 的 IPC](https://www.electronjs.org/zh/docs/latest/tutorial/ipc)：

| 方向                     | Lynxtron                                                                                                                            | Electron 对应                                                                                                                                                         |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Node.js → Lynx**     | [`LynxWindow.sendGlobalEvent()`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Class.LynxWindow.md#sendglobalevent)                       | [`webContents.send()`](https://www.electronjs.org/zh/docs/latest/api/web-contents)                                                                                  |
| **Lynx → Node.js**（双向） | `NativeModules.bridge.call` → [`-lynx-invoke`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Class.LynxWindow.md#event--lynx-invoke) 事件   | [`ipcRenderer.invoke()`](https://www.electronjs.org/zh/docs/latest/api/ipc-renderer) + [`ipcMain.handle()`](https://www.electronjs.org/zh/docs/latest/api/ipc-main) |
| **Lynx → Node.js**（单向） | `NativeModules.bridge.send` → [`-lynx-message`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Class.LynxWindow.md#event--lynx-message) 事件 | [`ipcRenderer.send()`](https://www.electronjs.org/zh/docs/latest/api/ipc-renderer) + [`ipcMain.on()`](https://www.electronjs.org/zh/docs/latest/api/ipc-main)       |

→ [了解更多：Node 与 Lynx 之间的通信](/next/zh/lynxtron/learn/Communication-Between-Node-And-Lynx.md)

### 通过 [Preload Scripts](/next/zh/lynxtron/learn/Communication-Between-Node-And-Lynx.md#使用-preload-scripts) 集成 Node.js

[Preload scripts](/next/zh/lynxtron/learn/Communication-Between-Node-And-Lynx.md#使用-preload-scripts) 可以理解为 [Electron preload scripts](https://www.electronjs.org/zh/docs/latest/tutorial/tutorial-preload) / contextBridge 模式面向 Lynx BTS 的能力桥接层：preload scripts 在具备 Node.js 能力的隔离 context 中执行，再把明确允许的方法或对象暴露给 Lynx UI。

与 Electron 不同，Lynxtron 的 preload scripts 和 BTS 位于同一进程内的隔离 JS context 中。[`contextBridge.exposeInLynxBTS()`](/next/zh/lynxtron/api/@lynx-js/lynxtron/context-bridge/Interface.ContextBridge.md#exposeinlynxbts) 暴露的不是单纯的可序列化消息 payload，而是可供 BTS 直接调用的 JS 对象；这些对象可以包含函数、闭包，也可以返回 Promise。

核心流程是：

1. 在 [`LynxWindow`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Class.LynxWindow.md) 上配置 [`lynxPreference.preload`](/next/zh/lynxtron/api/@lynx-js/lynxtron/Interface.LynxPreference.md#preload) 指定 preload script 文件。
2. preload script 直接使用 Node.js API，并通过 [`contextBridge.exposeInLynxBTS()`](/next/zh/lynxtron/api/@lynx-js/lynxtron/context-bridge/Interface.ContextBridge.md#exposeinlynxbts) 暴露白名单能力。
3. Lynx BTS 通过 [`NativeModules.nodejs.exposed`](/next/zh/lynxtron/api/@lynx-js/lynxtron/lynx/Interface.LynxtronNodejs.md#exposed) 调用暴露出来的对象。

BTS 所在的 Lynx 后台线程直接运行在 Node.js 上，但 BTS 仍然处于隔离 context，不是 Node.js 全局环境，不能直接访问 Node.js 接口；所有 Node.js 能力都需要经过 preload scripts 显式暴露。

→ [了解更多：Lynxtron 中 Node.js 与 Lynx 的通信](/next/zh/lynxtron/learn/Communication-Between-Node-And-Lynx.md)

## 下一步

- 准备动手写代码：[快速上手](/next/zh/lynxtron/introduction.md)
- 边做边学：[教程：打造你的浏览器](/next/zh/lynxtron/learn/introduction_to_browser.md)
- API 参考：[@lynx-js/lynxtron API](/next/zh/lynxtron/api/@lynx-js/lynxtron/index.md)
