# @androidtui/core 中文文档

规范地址：https://npmcn.com/package/%40androidtui/core/

版本：0\.8\.0
npm 元数据更新时间：2026-10-30T13:51:34.274Z
中文译文更新时间：2026-11-06T20:45:10.844Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40androidtui/core
原文对照：https://npmcn.com/package/%40androidtui/core/?lang=original
项目主页：https://github.com/bd-loser/opentui#readme
源码仓库：https://github.com/bd-loser/opentui

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

- 包体积（解压后）：18.1 MB，202 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=26\.4\.0
- 运行依赖：4 个
- peer 依赖：web-tree-sitter 0\.25\.10
- 首次发布：2026-08-09T04:46:37.942Z
- 最新版本发布：2026-10-30T13:51:34.099Z
- 近 30 天下载量：2372（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：29（近 12 个月 29 个）

## 中文简介

本地 Android 和 Termux 终端用户界面的 OpenTUI 核心

## 安装

```sh
npm install @androidtui/core
```

也可以使用：`pnpm add @androidtui/core`、`yarn add @androidtui/core`、`bun add @androidtui/core`

## README

[![OpenTUI logo](https://opentui.com/opentui-logo-auto.svg)](https://opentui.com/)

[![npm version](https://img.shields.io/npm/v/@opentui/core?style=flat-square)](https://www.npmjs.com/package/@opentui/core) [![Core build status](https://img.shields.io/github/actions/workflow/status/anomalyco/opentui/build-core.yml?style=flat-square&branch=main)](https://github.com/anomalyco/opentui/actions/workflows/build-core.yml)

OpenTUI是一个用于构建终端用户界面的库.

-   以兹克所出.
-   您直接或通过 React and Solid 写入 TypeScript .
-   你用活字箱安排盒子和文字.
-   您添加带有键盘和鼠标控件的选定、输入和滚动框.
-   可以播放声音,显示图像,并渲染出3D图形.

OpenCode在为上百万用户生产时使用OpenTUI.

[网站](https://opentui.com/) | [文档](https://opentui.com/docs) | [软件包](https://opentui.com/packages)

## OpenTUI 核心软件

`@opentui/core` 提供渲染器和 TypeScript API。 你直接使用必需的可变和事件。 这个 TypeScript包通过一个内部的外用函数接口(FFI)边界来称呼本土Zig.

```typescript
import { TextRenderable, createCliRenderer } from "@opentui/core"

const renderer = await createCliRenderer({ exitOnCtrlC: true })

renderer.root.add(new TextRenderable(renderer, { content: "Hello, OpenTUI!" }))
```

`exitOnCtrlC: true` 电话 `renderer.destroy()` 当用户按 Ctrl+C 键时。 创建渲染器的代码必须 调用 `renderer.destroy()` 在其他关闭路径.

安装软件包 :

```bash
bun add @opentui/core
```

然后,你的第一个应用程序与 [快速启动](https://opentui.com/docs/getting-started/quickstart)。 。 。 .

## 运行时间和平台支持

`@opentui/core` 在Bun 1.3.14或以后运行,或在Node.js 26.4.0或以后运行,使用ECMAScript模块(ESM)和 `--experimental-ffi`。 。 。 .

在本地Windows arm64上使用Bun 1.4.0或后期.

本地的 ABI 和生成的平台软件包, 例如 `@opentui/core-linux-x64`,是内部分布 表面,而不是应用程序 API.

## AI 代理技能

安装 OpenTUI 文档作为您的 AI 编码助理的技能 [`npx skills`](https://skills.sh/)数字 :

```bash
npx skills add https://opentui.com --skill opentui
```

添加 `-g` 在全球安装该技能。 技能与最新发布的相匹配 `npx skills update` 移动到每个 新发行。 从 `https://opentui.com/docs/next` 以便跟随主分支. 安装在 `npx skills add anomalyco/opentui` 遵循主分支;运行上面的命令将其切换为放行.

## 许可证

OpenTUI 根据 [MIT 许可证](https://github.com/anomalyco/opentui/blob/main/LICENSE)。 。 。 .

## 常见问题

### @androidtui/core 是什么？

本地 Android 和 Termux 终端用户界面的 OpenTUI 核心

### 如何安装 @androidtui/core？

在项目目录运行 npm install @androidtui/core，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：web-tree-sitter（0\.25\.10）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @androidtui/core 支持 TypeScript 吗？

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

### @androidtui/core 支持 ESM 还是 CommonJS？

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

### @androidtui/core 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=26\.4\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @androidtui/core 可以商用吗？

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

### @androidtui/core 的下载量有多少？

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

### @androidtui/core 还在维护吗？

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