# @textjs/app 中文文档

规范地址：https://npmcn.com/package/%40textjs/app/

版本：1\.1\.0
npm 元数据更新时间：2026-11-02T16:07:49.752Z
中文译文更新时间：2026-11-02T16:12:53.543Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40textjs/app
原文对照：https://npmcn.com/package/%40textjs/app/?lang=original
项目主页：https://textjs.org/
源码仓库：https://github.com/anomalyco/textjs

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

- 包体积（解压后）：1.9 MB，336 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：7 个
- peer 依赖：react ^19\.0\.0，react-dom ^19\.0\.0
- 首次发布：2026-11-01T21:55:10.802Z
- 最新版本发布：2026-11-02T16:07:49.569Z
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

React 19的应用路由器框架，用于在浏览器控制台中渲染的应用。

## 安装

```sh
npm install @textjs/app
```

也可以使用：`pnpm add @textjs/app`、`yarn add @textjs/app`、`bun add @textjs/app`

## README

# ▼ @ textjs/app

**Web控制台框架。** 构建在DevTools控制台中呈现的React 19 App路由器应用。Turbolog将每个更改的帧作为一个 `console.log` 呼叫。

```bash
bunx create-text-app my-app
cd my-app && bun install && bun dev
```

| 命令 | 描述 |
| --- | --- |
| `text dev` | 使用React快速刷新和控制台内Redbox的Vite开发服务器 |
| `text build` | 优化控制台生产构建+路由摘要 |
| `text start` | 为生产构建提供服务（静态文件+路由处理程序） |
| `text run` | 在终端中渲染应用程序路由器应用程序 (Bun) |
| `text proxy` | 桥接textjs.org/opencode到您本地的OpenCode服务器；一样 `bunx @textjs/opencode@latest proxy` |
| `text mcp` | 通过MCP (stdio) 将应用程序无头服务于编码代理 |

## 入口点

-   `@textjs/app`: 完整的 `@textjs/react` 组件套件plus `defineConfig`， `Metadata`， `ViewportConfig`， `useAppTheme`
-   `@textjs/app/navigation`： `useRouter`， `usePathname`， `useParams`， `useSearchParams`， `notFound`， `redirect`
-   `@textjs/app/link`： `<Link href>` (focusable; `Enter` 导航，可选 `shortcut`）
-   `@textjs/app/server`： `NextRequest` 和 `NextResponse` 用于 `middleware.ts`
-   `@textjs/app/cache`： `unstable_cache`， `cache`， `revalidateTag`， `revalidatePath`
-   `@textjs/app/testing`： `render`， `renderToString` 和 `cleanup` 用于屏幕外测试
-   `@textjs/app/terminal`： `renderToTerminal`
-   `@textjs/app/router`： `<AppRouter>`， `matchAppRoutes`， `createBrowserHistory`， `createMemoryHistory`
-   `@textjs/app/devtools`： `<TextDevOverlay>` （`F2` / `` Ctrl+` `` )， `<RedboxOverlay>`， `connectViteHmr`
-   `@textjs/app/vite`： `textjsVitePlugin()` 对于自定义Vite设置
-   `@textjs/app/mcp`： `createTextMcpServer()` 和 `HeadlessSession` 从编码代理驱动应用程序

## `app/` 约定

`layout.tsx`， `page.tsx`， `loading.tsx` (悬念)， `error.tsx` 误差边界 `reset`)， `not-found.tsx`， `[param]`， `[...slug]`， `[[...slug]]`， `(group)` 和 `api/**/route.ts` 处理程序导出 `GET`， `POST`， `PUT`， `PATCH`， `DELETE`， `OPTIONS`.

## 常见问题

### @textjs/app 是什么？

React 19的应用路由器框架，用于在浏览器控制台中渲染的应用。

### 如何安装 @textjs/app？

在项目目录运行 npm install @textjs/app，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19\.0\.0）、react-dom（^19\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 text，可以用 npx text 直接运行。

### @textjs/app 支持 TypeScript 吗？

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

### @textjs/app 支持 ESM 还是 CommonJS？

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

### @textjs/app 可以商用吗？

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

### @textjs/app 还在维护吗？

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