Install
npm i chatلمن يناسب
استخدم Chat SDK عندما تريد نفس منطق TypeScript لتشغيل روبوتات دردشة على Slack و Microsoft Teams و Google Chat و Discord و Telegram و GitHub و Linear و WhatsApp ومنصات مشابهة. يؤكّد كتابة منطق الروبوت مرة ونشره في كل مكان، لا كتابة إطار غير مسمّى لكل منصة.
الفرضية الأنسب: أن تنوي تثبيت الحزمة الأساسية في مشروع 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";
إشارة النجاح: يمكن استيراد الحزمة الأساسية. تحتاج الـ adapters إلى تثبيت إضافي حسب المنصة؛ يقول المقتطف 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 لن يستبدل مجلدًا قائمًا.
حالات الاستخدام
الحالة الأولى: ربط Slack بمشروع TypeScript قائم. أولاً 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؛ قدرة المنصة تأتي من الـ adapters. مثال الاستيراد يعطي فقط Slack adapter وحالة Redis. تظهر السقالة وتثبيت agent skill كمداخل أخرى جنبًا إلى جنب؛ لا تخلطها مع تثبيت الحزمة الأساسية كخطوة يجب تشغيلها معًا.
لا تفترض أن لكل منصة في القائمة اسم حزمة adapter مكتوب أصلًا. لا تعطي المادة قائمة عملاء ولا كيفية الوصول إلى Teams أو WhatsApp دون adapter مثبت. ما يتجاوز أوامر التثبيت والاستيراد والسقالة المكتوبة هنا خارج تغطية هذا الدليل.