安裝
npm i chat適合誰
當你要用同一套 TypeScript 邏輯,在 Slack、Microsoft Teams、Google Chat、Discord、Telegram、GitHub、Linear、WhatsApp 等平台做聊天機器人時,使用 Chat SDK。它強調寫一次機器人邏輯、部署到各處,而不是為每個平台各寫一套未點名的框架。
更合適的前提是:你準備在 Node / TypeScript 專案裡裝核心套件,並再裝對應平台的 adapter。資料沒有把這些平台寫成互斥名單,後面還有 and more。官方說明頁是
https://github.com/vercel/chat
3 分鐘完成第一次嘗試
建議的第一條路徑是核心套件安裝,不要同時開三條安裝程式:
npm i chat
前置:本機已有 npm。這條命令會改 package.json 和 node_modules,先確認目前目錄就是你的機器人專案。裝完後做唯讀核對:在腳本裡寫出資料中的匯入,先不要連真實工作區、也不要對外發訊息。
import { Chat } from "chat";
import { createSlackAdapter } from "@chat-adapter/slack";
import { createRedisState } from "@chat-adapter/state-redis";
成功訊號:核心套件能匯入。adapter 需要再按平台安裝,摘錄寫明 Install one or more adapters for your platforms;摘要點名例如 @chat-adapter/slack。若匯入 adapter 失敗,先停在缺失依賴,不要編造其他套件名。
同一頁還出現 npx skills add vercel/chat 以及 npx create-chat-sdk@latest my-bot。第一次不要並行跑腳手架;那會產生專案檔案,必須先確認目錄名 my-bot 不會覆蓋現有資料夾。
使用案例
案例一:在已有 TypeScript 專案裡接入 Slack。先 npm i chat,再安裝 Slack adapter,然後用 Chat、createSlackAdapter、createRedisState 組裝實例。摘要還提到處理 onNewMention 與 onSubscribedMessage,但摘錄沒有寫出這兩個回呼的完整函式體,因此本案例完成標準是匯入與組裝成功,而不是已經在 Slack 裡回覆了一則訊息。連 Redis 或註冊 webhook 前,先確認連線目標和路由不會寫到錯誤環境。
案例二:用官方腳手架新建一個 bot 目錄。命令是 npx create-chat-sdk@latest my-bot。摘要說它會產生 Chat 設定、webhook 路由和 .env.example。這是寫盤操作:先確認 my-bot 目錄不存在或可以覆蓋,再執行。完成標準是目錄被建立,並且你能看到產生物。不要向 .env.example 填入任何金鑰佔位符之外的偽造金鑰,也不要在未改設定時啟動對外服務。資料沒有寫出環境變數名,因此不要編造。
使用界線
核心安裝是 npm i chat,平台能力靠 adapter。匯入示例只給出 Slack adapter 與 Redis state。腳手架和 agent skill 安裝是並列出現的其他入口,不要把它們和核心套件安裝混成必須同時執行的一步。
不要假設列表裡的每個平台都有已寫出的 adapter 套件名。資料沒有給出用戶端名單,也沒有寫如何在未安裝 adapter 時直接打到 Teams 或 WhatsApp。超出這些已寫明的安裝、匯入和腳手架命令,這份說明涵蓋不到。