# @g9tm/lynxcontrols-lynxtron 中文文档

规范地址：https://npmcn.com/package/%40g9tm/lynxcontrols-lynxtron/

版本：1\.7\.3
npm 元数据更新时间：2026-11-15T21:58:55.881Z
中文译文更新时间：2026-11-15T23:19:06.990Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40g9tm/lynxcontrols-lynxtron
原文对照：https://npmcn.com/package/%40g9tm/lynxcontrols-lynxtron/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：186 kB，46 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-10-06T18:29:09.943Z
- 最新版本发布：2026-11-15T21:58:55.696Z
- 近 30 天下载量：2016（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

Lynxtron的桌面平台层:在上下文Bridge预装后由工人行走的 SQLite 驱动程序及主机服务.

## 安装

```sh
npm install @g9tm/lynxcontrols-lynxtron
```

也可以使用：`pnpm add @g9tm/lynxcontrols-lynxtron`、`yarn add @g9tm/lynxcontrols-lynxtron`、`bun add @g9tm/lynxcontrols-lynxtron`

## README

# @g9tm/lynxcontrols-lynxtron (英语)

用于 Lynxtron 0.0.28 (Windows, macOS; Linux 无头)的桌面平台层(Plan/ specs/06 §3, §7):

-   **`@g9tm/lynxcontrols-lynxtron/preload`** (单位:千美元)`dist/preload.cjs`: 设定为 `lynxPreference.preload` 您的电话 `LynxWindow`。 曝光情况 `g9sqlite` 财务报告和审定财务报表 `g9host` 到 Lynx 背景线程通过 `contextBridge.exposeInLynxBTS`。 。 。 .
-   **`@g9tm/lynxcontrols-lynxtron`** (Lynx侧): `createLynxtronSqliteDriver()` 联合国 `G9SqliteDriver`和 `createLynxtronHostServices()` (单位:千美元)`{ host, preferences }` 页:1 `G9Provider services`) (中文(简体) ).
-   **`@g9tm/lynxcontrols-lynxtron/node`**:用于自定义预装和测试的节点侧(引擎,工人主机,偏好文件).

```ts
// main process (see apps/desktop-host/main.mjs)
process.env.G9_USER_DATA ??= app.getPath('userData');
new LynxWindow({ lynxPreference: { preload: require.resolve('@g9tm/lynxcontrols-lynxtron/preload') } });

// Lynx code
import { createLynxtronHostServices, createLynxtronSqliteDriver } from '@g9tm/lynxcontrols-lynxtron';
const { host, preferences } = createLynxtronHostServices();
const db = createG9Sqlite({ driver: createLynxtronSqliteDriver(), … });
```

## SQL 点

-   一个 `worker_threads` 每个开放数据库的工人拥有a `node:sqlite` `DatabaseSync` (节点22.18嵌入 Lynxtron),一个已准备好的报表缓存和会话的交易. A 类 `run` 批次为 **一个** 桥号呼叫.
-   值:安全整数为数字,较大为 `{ int64 }` 标记, BLOBs 为 `ArrayBuffer` (在Lynx上规范化) 边,无论哪个域或键入的阵列,桥交接),文本被NUL拒绝(Contract D24).
-   错误交叉为数据( E)`{ ok: false, error }` 信封吗 `code`, (中文(简体) ), `sqliteCode`, (中文(简体) ), `sql` 财务报告和审定财务报表 `completedStatements` 在桥上幸存下来 `G9SqliteError`编号.
-   死亡的工人在等待处理的请求中失败 `interrupted`,或 `outcome-unknown` 当ComMIT在飞行中; 然后会话会死(重新打开) 。 工人只有在其数据库关闭(idle)时才终止工作,从不作中期陈述.
-   取消: Lynx 一侧的会话队列请求; 其信号在转向未到达前中止的批次 那个工人 正在运行的语句不可中断( E)`capabilities().interrupt === false`) (中文(简体) ).

## 东道方服务

首选项 `<userData>/<namespace>.prefs.json` (名称空间) `g9`),从解剖角度写出(temp文件,然后重命名): a kill 中写离开上一个文件;一个腐败的文件读取为空并被下个写入所取代. `exit` 关闭应用程序( 桌面没有“ 移动到背景 ” ); `hideKeyboard` 没有安全区域设置.

## 测试

`npm test` 驾驶员合同通过工人协议执行 **真正的工人线程**崩溃 恢复、队列取消、偏好原子性和切入点. `apps/desktop-host` 执行合同 通过 **真正的林克星桥** 无头 (`node test/run-headless.mjs`; 27/27 on Linux 在"云"中.

## 常见问题

### @g9tm/lynxcontrols-lynxtron 是什么？

Lynxtron的桌面平台层:在上下文Bridge预装后由工人行走的 SQLite 驱动程序及主机服务\.

### 如何安装 @g9tm/lynxcontrols-lynxtron？

在项目目录运行 npm install @g9tm/lynxcontrols-lynxtron，或使用 pnpm add / yarn add / bun add。

### @g9tm/lynxcontrols-lynxtron 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @g9tm/lynxcontrols-lynxtron 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @g9tm/lynxcontrols-lynxtron 可以商用吗？

@g9tm/lynxcontrols-lynxtron 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @g9tm/lynxcontrols-lynxtron 的下载量有多少？

根据 npm 官方下载统计，@g9tm/lynxcontrols-lynxtron 在 2026/10/16 – 2026/11/14 这 30 天内被下载 2,016 次，日均约 67 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @g9tm/lynxcontrols-lynxtron 还在维护吗？

最新版本 1\.7\.3 发布于 2026/11/16（今天）；至今共发布 15 个版本，其中过去 12 个月发布了 15 个；首次发布于 2026/10/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

