安裝
npx ai-elements@latest適合誰
這份指南面向要在 shadcn/ui 之上更快搭建 AI 原生應用介面的前端開發者。官方把 AI Elements 寫成建立在 shadcn/ui 上的元件庫。
動手前必須同時滿足：Node.js 18 or later；已有安裝了 AI SDK 的 Next.js 專案；專案裡已經初始化 shadcn/ui（頁面寫出 npx shadcn@latest init）。還要求 Tailwind CSS 已設定，並且 AI Elements 只支援 CSS Variables mode。缺一項都不要跑安裝。
這是元件安裝，不是某個 Agent 市場外掛。不要把 npx ai-elements@latest 推廣成未出現的 IDE 外掛。
3 分鐘完成第一次嘗試
只採用頁面給出的推薦安裝命令：
npx ai-elements@latest
前置條件：目前目錄就是那個已初始化 shadcn/ui、且裝有 AI SDK 的 Next.js 專案；Node.js 為 18+；Tailwind 處於 CSS Variables 模式。安裝位置是你已設定的 components 目錄，以及專案依賴。
副作用確認點：頁面寫明安裝全部元件時會：若尚未設定則 Set up shadcn/ui；把所有 AI Elements 元件裝進已設定的 components 目錄；並把必要依賴加入專案。這會改檔案和 package 依賴。若目錄不對，或你只想先核對前提，先停下來。確認後再執行。
成功訊號：命令正常結束，components 目錄出現新元件、依賴已寫入。第一次只做檢查：打開其中一個新裝入的元件檔案，確認它落在你設定的目錄中。不要馬上把它接到未出現在摘錄裡的聊天頁面或正式路由。若精靈還要繼續改更多檔案，先停在確認點。
使用案例
案例一：在滿足前提的專案裡執行官方安裝。確認 Node.js 18+、Next.js + AI SDK、npx shadcn@latest init 已完成、Tailwind 為 CSS Variables mode 後，執行 npx ai-elements@latest。證據涵蓋的是這條推薦命令和前提列表。完成標準止於安裝成功、元件進入已設定目錄。不要補寫未出現的單個元件名或 registry URL。
案例二：先看清「安裝全部元件」會做什麼，再決定是否繼續。摘錄寫明它會在需要時設定 shadcn/ui、把全部 AI Elements 裝進 components 目錄，並新增必要依賴。第一次若你尚未準備好接收這些寫入，就不要執行命令，只核對這三項副作用是否可接受。可觀察的成功訊號是：你能對照專案現況，確認 shadcn 已初始化、目標 components 目錄存在。不要把「安裝全部」理解成可以跳過 Tailwind CSS Variables 限制。
使用邊界
主安裝路徑只有 npx ai-elements@latest。npx shadcn@latest init 是前提，不是第二套主安裝器。必須 Node.js 18+、Next.js + AI SDK、已初始化的 shadcn/ui，且 Tailwind 僅支援 CSS Variables mode。安裝會改元件目錄和依賴。解除安裝與單個元件選型未寫明，不能當成安全結論。