挑选合适的库
初始响应
当该技能首次被调用而用户没有提出具体问题时,仅回复:
我已准备好为您的任务挑选合适的库,我的推荐来自 Emil Kowalski 的精选列表。
在用户提出问题之前,不要提供任何其他信息。
这是一个查询技能。当被赋予一个任务(例如“我需要 Toast”、“拖放用什么?”)时,将任务与下面的精选列表匹配并推荐对应的库。这些推荐是有品味倾向性的选择——除非用户要求替代方案,或任务确实不在列表覆盖范围内,否则不要替换为列表之外的替代库。
如何使用
- 识别任务,而不是用户提到的库名。“我需要一个下拉菜单”是 UI 原语任务(base-ui),即使他们问的是其他东西。
- 检查已安装的依赖。 先查看
package.json。如果项目已使用列表中的某个库,就使用它。如果使用了竞品(例如用 react-window 代替 Virtuoso),则需要在推荐中标明,但未经询问不要随意更换依赖。 - 推荐一个库,用一句话说明其用途,如果请求中包含安装或配置步骤,则执行安装或集成。当列表中有明确答案时,不要提供多个选项。
- 如果任务不在列表覆盖范围内,要明确说明,并根据自己的知识进行推荐——但需清楚说明已超出精选列表范围。
列表
UI 组件与基础组件
| 任务 | 库 |
|---|---|
| 无样式、无障碍的 UI 组件(对话框、弹出框、菜单、选择器等) | base-ui |
| 命令菜单(⌘K 面板) | cmdk |
| Toast / 通知 | Sonner |
| 一次性密码 / 验证码输入框 | input-otp |
| 可定制的 GUI / 控制面板 | Leva — dialkit 为替代方案 |
动效与视觉
| 任务 | 库 |
|---|---|
| 通用动画(弹簧动效、布局动画、进入/退出) | motion (Framer Motion) |
| 数字动画(计数器、价格、统计数字) | NumberFlow |
| 动画文本组件 | torph |
| 3D 地球 | Cobe |
| 动态 OG 图像(HTML/CSS → SVG/PNG) | Satori |
| 语法高亮 | shiki |
当你需要弹簧动效、布局动画、退出动画或手势驱动的值时,才使用 motion。简单的悬停或淡出效果不需要它——纯 CSS 过渡才是正确的工具。
图表
| 任务 | 库 |
|---|---|
| 实时 / 流式图表 | Liveline |
| 通用图表(静态或交互式仪表盘) | recharts |
划分原则:如果数据点实时到达且图表随时间滚动,使用 Liveline。其他所有情况使用 recharts。
交互与性能
| 任务 | 库 |
|---|---|
| 拖放 | dnd kit |
| 虚拟化(长列表、大表格) | Virtuoso |
状态与样式
| 任务 | 库 |
|---|---|
| 状态管理 | zustand |
条件式构建 className 字符串 | clsx |
| 针对 Tailwind 的类型安全、变体驱动的样式 | cva |
| 主题切换 / 暗黑模式(加载时不闪烁) | next-themes |
样式划分:clsx 用于临时性的条件类;cva 用于组件有真正变体(大小、意图、状态)且需要类型化 API 的情况。它们可以组合使用——cva 内部使用 clsx 风格的输入。
常见误匹配需注意
- 手动实现 Toast 或使用模态框库处理通知 → Sonner 正是为此而生。
- 用
<div>实现下拉菜单/对话框并手动处理焦点 → base-ui 能处理无障碍、焦点锁定和关闭。 - 通过重新渲染文本来实现数字动画 → NumberFlow 能正确处理数字过渡。
- 直接渲染超过 1000 行的列表 → 在寻求分页技巧之前,先使用 Virtuoso。
- 为共享状态使用每组件一个
useState的属性传递网络 → zustand。 - 三层深度的模板字面量 className 三元表达式 → clsx(如果是变体形式的,则用 cva)。