terminaltui — TypeScript 开发工具

terminaltui 是一个用于构建交互式终端应用的 TypeScript 框架，其设计理念可概括为“终端的 Next.js”。开发者通过编写 `pages/` 目录下的 TypeScript 文件来定义页面，框架自动处理路由、导航、布局与渲染，最终应用可通过 `npx` 命令分发，或通过 SSH 托管供用户连接使用，无需浏览器或 Electron。

框架内置 42 个组件（如卡片、表格、时间线、表单等）、12 列响应式网格系统、空间导航（方向键移动焦点）、12 种主题、ASCII 艺术引擎，以及图像和视频渲染能力。图像在 Kitty 与 Ghostty 终端中通过图形协议显示为真实像素，在其他终端（如 Apple Terminal、tmux、SSH）则回退为彩色单元格，且两种路径保持相同的行数，避免页面重排。视频支持预打包的 `.tvf` 帧格式，播放时无需运行时解码器，GIF 则通过纯 TypeScript 解码。此外，框架支持文件式 API 路由（如 `api/stats.ts` 映射为 `GET /api/stats`）、响应式状态管理（`createState`、`dynamic` 等），以及基于行差异的渲染优化，仅在内容变化时重绘。

适用项目包括需要快速构建终端仪表盘、菜单、作品集或演示工具的场景，尤其适合希望以 `npx` 或 SSH 方式分发的应用。使用门槛主要在于 Node.js >= 18 且包为 ESM-only，需使用 `import` 加载。SSH 托管功能依赖可选依赖 `ssh2`，需自行安装。当前版本为 2.1，引入了图像与视频管线，但组件状态键控方式有所变更，若依赖旧版标签共享行为需注意迁移。建议上线前通过 `terminaltui validate` 检查项目，并确认目标终端对图像协议的支持情况。