# mantou-ui 中文文档

规范地址：https://npmcn.com/package/mantou-ui/

版本：0\.1\.3
npm 元数据更新时间：2026-11-04T02:32:24.320Z
中文译文更新时间：2026-11-04T03:10:04.224Z
软件包许可：MIT OR Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/mantou-ui
原文对照：https://npmcn.com/package/mantou-ui/?lang=original
项目主页：https://mantou.dunkbing.dev/
源码仓库：https://github.com/dunkbing/mantou

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

- 包体积（解压后）：2.1 MB，50 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：4 个
- 首次发布：2026-11-03T16:03:29.318Z
- 最新版本发布：2026-11-04T02:32:23.992Z
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

Mantou：为Bun + TypeScript设计的原生GUI框架

## 安装

```sh
npm install mantou-ui
```

也可以使用：`pnpm add mantou-ui`、`yarn add mantou-ui`、`bun add mantou-ui`

## README

# 做馒头

基于TypeScript的本地桌面应用。你的应用运行在一个Bun Worker中；一个Rust核心加载了 `bun:ffi` 拥有窗口并使用wgpu在GPU上绘制UI。没有webview。

> **早期的发展。** 线程模型适用于Linux、macOS和Windows。实体风格的JSX， flexbox布局，文本，文本输入，滚动，圆角和边框，剪切，按，键和车轮工作。

```tsx
import { Text, View, createSignal, run } from "mantou-ui";

function App() {
  const [on, setOn] = createSignal(false);
  return (
    <View style={{ width: 120, height: 48, borderRadius: 8, justifyContent: "center", backgroundColor: on() ? "#16a34a" : "#4b5563" }} onPress={() => setOn(!on())}>
      <Text style={{ color: "#ffffff", fontWeight: 600, textAlign: "center" }}>{on() ? "On" : "Off"}</Text>
    </View>
  );
}

run(() => <App />);
```

## 试一试

需要 [包子](https://bun.sh/) 1.4.4和 [生锈](https://rustup.rs/)。

```bash
bun install
```

```bash
bun run build:core
```

```bash
bun run counter
```

对于更大的应用程序， [馒头的邮件](https://github.com/dunkbing/mantou-mail) 是一个以包形式构建在Mantou上的三窗格邮件客户端。

## 在应用程序中使用它

```bash
bun add mantou-ui
```

```bash
bunx mantou run src/main.tsx
```

原生内核是为Linux （x64、arm64）、macOS （arm64、x64）和Windows （x64）预先构建的。在其他地方，或使用GitHub的mantouu -ui (`bun add github:dunkbing/mantou`)，用它建一次 `bunx mantou build-core` (需要生锈)。

集 `"jsx": "preserve"` 和 `"jsxImportSource": "mantou-ui"` 在 `tsconfig.json`、预加载 `mantou-ui/preload` 为 `bun test` （`bunfig.toml`）. 发现了一个bug或者需要一个特性？ [打开一个问题](https://github.com/dunkbing/mantou/issues/new/choose)。

## 文档

给出了设计、方案和测试结果 [`website/`](https://npmcn.com/package/mantou-ui/website/) （Astro + Starlight, on Bun）：

```bash
bun run docs
```

以个人身份还是代理人的身份执行代码？开始 [AGENTS.md](https://npmcn.com/package/mantou-ui/AGENTS.md)。

## 常见问题

### mantou-ui 是什么？

Mantou：为Bun \+ TypeScript设计的原生GUI框架

### 如何安装 mantou-ui？

在项目目录运行 npm install mantou-ui，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mantou，可以用 npx mantou 直接运行。

### mantou-ui 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/mantou-ui 是否存在。

### mantou-ui 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### mantou-ui 可以商用吗？

mantou-ui 使用 MIT OR Apache-2\.0 许可。可在 MIT、Apache-2\.0 中任选其一遵守。选择 MIT 时，宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### mantou-ui 还在维护吗？

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