Prompt Area icon

Prompt Area

Prompt Area 是一款适用于 AI 界面的 React 聊天与提示词输入组件,支持 @提及、/命令、标签、Markdown 和文件附件,可通过 npm 或 shadcn registry 安装。

Prompt Area

Prompt Area 是什么

Prompt Area 是为 AI 界面打造的 React 聊天与提示词输入组件。它将结构化文本输入、行内 Markdown 和附件处理整合在一个 contentEditable 组件中,让团队可以用一个专用输入替代一组分散的库。

该网站将其描述为面向提示词编写器的零额外依赖方案,而不是通用文档编辑器。它同时通过 npm 和 shadcn registry 分发,文档强调 shadcn 路径会将源码复制到项目中,而 npm 路径则安装带有自包含样式表的版本化包。

核心能力

基于触发器的 chips

支持结构化提示词输入,包含 @提及、/命令、#标签和自定义回调,因此输入的标记会变成 chips,而不是普通文本。

行内 Markdown 与富粘贴

处理粗体、斜体、列表、自动链接 URL、富粘贴,以及实时 Markdown 渲染,适用于聊天式编写。

撤销与重做

包含完整的撤销栈,支持 Ctrl+Z 和 Ctrl+Shift+Z,以便一致地回退更改。

附件处理

内置支持文件和图片附件,并提供缩略图、加载状态和移除控件。

配套组件

提供 Action Bar、Status Bar、Compact Prompt Area 和 Chat Prompt Layout 等配套 UI 组件,帮助构建完整的聊天界面。

无障碍与主题感知

提供键盘导航、ARIA 标签、屏幕阅读器提示和焦点管理,并通过 CSS 变量支持浅色和深色主题。

团队使用 Prompt Area 的常见方式

  • AI 应用消息编写器

    为 AI 产品添加聊天编写器,让用户在一个输入框中同时使用提及、命令、标签、Markdown 格式和文件附件。

  • 提示词输入升级

    在 React 应用中用结构化提示词输入替换普通 textarea,同时让实现保持专注于单一输入组件。

  • 可组合的聊天界面

    借助 action bar、status bar、紧凑输入或完整聊天布局等附加组件,构建更丰富的聊天 UI。

  • 基于 shadcn 的集成

    当项目已经使用 shadcn/ui,并希望将源码复制到代码库中以便自定义时,使用 shadcn registry 路径。

  • 基于 npm 的集成

    当你希望获得版本化依赖和可直接导入的样式表,而无需 Tailwind 配置时,选择 npm 包路径。

Pros and Cons

Pros

  • 将 @提及、/命令、标签、Markdown 和附件整合到一个输入框中,而不是依赖多个独立库。
  • 提供两种安装路径,包括带自包含样式表的 npm 包和 shadcn registry 选项。
  • 导出状态 hooks、trigger 预设、segment 辅助函数和类型,便于将输入集成到 React 应用中。
  • 包含有助于组装完整聊天编写器或布局的配套组件。
  • 将无障碍和主题支持作为内置关注点。

Cons

  • 该产品有意专注于提示词和聊天输入,因此网站建议对块、表格、列或协作等文档式需求使用其他编辑器。
  • shadcn registry 路径有设置前提:它要求你的 React 项目已经配置好 Tailwind CSS 和 shadcn/ui。

FAQ

Prompt Area 最适合用于什么场景?

Prompt Area 适用于需要聊天或提示词编写器的 React 项目,支持结构化输入,包括 @提及、/命令、标签、Markdown 和附件。文档将其定位为在目标是提示词输入而非富文本编辑时,对完整文档编辑器的专注替代方案。

如何安装它?

文档展示了两种安装方式:使用包管理器安装 npm 包,或通过 shadcn registry 添加该组件。shadcn 路径要求项目已配置 React、Tailwind CSS 和 shadcn/ui。

这个包包含哪些内容?

该包导出 PromptArea 组件以及 usePromptAreaState hook、trigger 预设、segment 辅助函数和类型。文档还提到 Action Bar、Status Bar、Compact Prompt Area 和 Chat Prompt Layout 等配套组件。

它需要额外依赖吗?

Prompt Area 被描述为零运行时依赖,clsx 和 tailwind-merge 列为 peer dependencies。源码还说明,自包含样式表意味着 npm 包路线不需要 Tailwind 配置。

什么时候我应该选择其他方案?

对比页面说明 Prompt Area 并非用于完整文档编辑。如果你需要块、表格、列或实时协作,网站推荐使用 Tiptap、Lexical 或 Plate.js 等框架。

Quick Facts

类别
AI 聊天 / 开发者工具
框架
React
分发方式
npm 包和 shadcn registry
主要用途
提示词与聊天编写器
源码域名
prompt-area.com
许可证
MIT License(网站页脚)