# @ai-matrx/terminal 中文文档

规范地址：https://npmcn.com/package/%40ai-matrx/terminal/

版本：0\.1\.29
npm 元数据更新时间：2026-10-28T12:24:03.690Z
中文译文更新时间：2026-11-05T20:08:41.203Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40ai-matrx/terminal
原文对照：https://npmcn.com/package/%40ai-matrx/terminal/?lang=original
项目主页：https://github.com/AI-Matrix-Engine/aidream/tree/main/apps/shared/terminal#readme
源码仓库：https://github.com/AI-Matrix-Engine/aidream

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

- 包体积（解压后）：360 kB，20 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：4 个
- peer 依赖：react \>=18\.0\.0，react-dom \>=18\.0\.0
- 首次发布：2026-10-02T13:52:52.028Z
- 最新版本发布：2026-10-28T12:24:03.482Z
- 近 30 天下载量：31578（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 30 个）

## 中文简介

AI Matrx终端:xterm 6带相合(到其盒子或屏幕上键盘上方的可视取景口),一个遵循应用的主题,一个无交通控件任意PTY驱动器,电话级触控(momentum卷轴,长压字选择,副本),一个Termius-

## 安装

```sh
npm install @ai-matrx/terminal
```

也可以使用：`pnpm add @ai-matrx/terminal`、`yarn add @ai-matrx/terminal`、`bun add @ai-matrx/terminal`

## README

# `@ai-matrx/terminal`

AI Matrx终端:xterm 6 配有所有主机否则会重建,电话优先.

```bash
pnpm add @ai-matrx/terminal
```

| 条目 | 这是什么 |
| --- | --- |
| `@ai-matrx/terminal` | 无框架核心:从属密钥及其字节, Ctrl/Alt Latch, 触摸手势识别器, 选择和可视- port 数学, 主题, 以及 `createLineEditor`。 。 。 . |
| `@ai-matrx/terminal/react` | `<Terminal>` 财务报告和审定财务报表 `<AccessoryBar>`。 。 。 . |
| `@ai-matrx/terminal/styles.css` | 结构CSS(由 `<Terminal>` 页:1. |
| `@ai-matrx/terminal/tokens.css` | 默认 `--mxt-*` 颜色,对于没有自己主题的主机. |

## 一个PTY

```tsx
import { Terminal } from "@ai-matrx/terminal/react";

<Terminal
  fit="viewport" // phones: grow to the bottom of the visual viewport, above the keyboard
  onReady={(term) => pty.onOutput((bytes) => term.write(bytes))} // write() resolves after parse
  onData={(keys) => pty.write(keys)} // already modified by the bar's Ctrl / Alt
  onResize={({ cols, rows }) => pty.resize(cols, rows)}
/>;
```

## 每个呼叫一个命令( 无 PTY)

```ts
import { createLineEditor } from "@ai-matrx/terminal";

const editor = createLineEditor({
  write: (d) => term.xterm.write(d),
  prompt: () => "$ ",
  history: () => commands,
  onSubmit: async (line) => {
    term.write(await run(line));
    editor.done(); // prompt again, then any typeahead or pasted lines
  },
});
// <Terminal onData={(d) => editor.input(d)} … />
```

在粗糙的指针上,终端打开其电话层:按键键,拖取滚动 音效、按下并按住以选择一个单词(drag to extend, Copy),以及44px键盘栏 (Esc Tab Ctrl Alt,箭头, `| / ~ -`, Home End PgUp PgDn, Paste, 隐藏键盘). Ctrl:自带=为 下个键,双塔普=锁定.

颜色: 映射 `--mxt-*` 主题的指号,或导入 `tokens.css`。 。 。 .

MIT AI 矩阵引擎

## 常见问题

### @ai-matrx/terminal 是什么？

AI Matrx终端:xterm 6带相合\(到其盒子或屏幕上键盘上方的可视取景口\),一个遵循应用的主题,一个无交通控件任意PTY驱动器,电话级触控\(momentum卷轴,长压字选择,副本\),一个Termius-

### 如何安装 @ai-matrx/terminal？

在项目目录运行 npm install @ai-matrx/terminal，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=18\.0\.0）、react-dom（\>=18\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @ai-matrx/terminal 支持 TypeScript 吗？

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

### @ai-matrx/terminal 支持 ESM 还是 CommonJS？

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

### @ai-matrx/terminal 需要什么版本的 Node\.js？

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

### @ai-matrx/terminal 可以商用吗？

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

### @ai-matrx/terminal 的下载量有多少？

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

### @ai-matrx/terminal 还在维护吗？

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