Chat SDK Chat实例创建指南配置适配器、状态与多平台注册实战【免费下载链接】chatUniversal chat layer for building bots and agents.项目地址: https://gitcode.com/gh_mirrors/chat67/chatChat SDK是一个通用的聊天层框架Universal chat layer让你只需编写一次 Bot 逻辑就能同时运行在 Slack、Microsoft Teams、Discord、Telegram、Google Chat 等十几个平台上。本文带你完整走一遍Chat 实例创建的全过程如何配置平台适配器、选择持久化状态适配器以及如何一次性注册多平台让你快速拥有一个可上线的跨平台聊天机器人。Chat 实例是什么为什么它是 Bot 的核心入口Chat类是整个机器人的总调度台。它负责三件事协调适配器把来自不同平台的 Webhook 请求统一解析成标准化消息。路由事件把 提及、消息、表情反应、按钮点击等事件分发给你注册的处理器。管理线程状态维护订阅关系与分布式锁保证并发安全。理解这三点你就掌握了创建 Chat 实例的全部心法。核心实现在 chat.ts配置项类型定义见 types.ts 中的ChatConfig。快速上手3 步创建第一个 Chat 实例先安装核心包和所需的平台、状态适配器npm i chat npm install chat-adapter/slack chat-adapter/state-redis接着创建实例并注册一个 提及处理器import { Chat } from chat; import { createSlackAdapter } from chat-adapter/slack; import { createRedisState } from chat-adapter/state-redis; const bot new Chat({ userName: mybot, adapters: { slack: createSlackAdapter() }, state: createRedisState(), }); bot.onNewMention(async (thread) { await thread.subscribe(); await thread.post(Hello! Im listening to this thread.); }); 就这么简单。三个必填项——userName、adapters、state——齐了一个可运行的 Chat 实例就诞生了。适配器工厂会自动从环境变量如SLACK_BOT_TOKEN、REDIS_URL读取凭证无需手动传入。配置适配器连接一个或多个聊天平台每个平台适配器都实现了统一的Adapter接口负责 Webhook 签名校验、平台专属载荷解析以及把 Markdown/卡片转换为平台原生格式。完整原理见 platform-adapters.mdx。多平台注册一次配置处处运行想让同一个 Bot 同时服务 Slack、Teams 和 Discord只需在adapters里注册多个适配器即可。因为 SDK 会把各平台的消息、线程、反应归一化成同一种格式你的事件处理器对每个已注册平台都同样生效const bot new Chat({ userName: mybot, adapters: { slack: createSlackAdapter(), teams: createTeamsAdapter(), discord: createDiscordAdapter(), }, state: createRedisState(), });当平台能力存在差异例如速率限制或某功能不支持时SDK 会抛出类型化错误方便你针对性处理。官方、厂商官方与社区适配器的完整清单可在文档的 Adapters 页查阅。配置状态适配器让 Bot 状态持久化每个Chat实例都必须配备一个状态适配器它是机器人的记忆中枢负责三类数据职责说明线程订阅持久化thread.subscribe()重启后仍能正确路由消息分布式锁防止同一线程被两个处理器同时处理即使跑在多个无服务器实例上缓存与存储提供带 TTL 的键值存储支撑消息去重、线程状态与内部缓存生产环境推荐Redis或PostgreSQLchat-adapter/state-redis、chat-adapter/state-pg本地开发或测试可用内存适配器chat-adapter/state-memory。各选项的权衡详见 state-adapters.mdx。小贴士concurrency配置项决定锁被占用时的策略默认drop丢弃新消息并抛出LockError。你也可以改成queue、debounce、burst或concurrent灵活应对消息洪峰。完整配置项速查表创建 Chat 实例时ChatConfig支持的常用选项如下前 3 项为必填选项类型默认值说明userNamestring必填所有适配器的默认 Bot 用户名adaptersRecordstring, Adapter必填适配器名称 → 实例的映射表stateStateAdapter必填订阅与锁定的状态适配器loggerLogger \| LogLevelinfo日志实例或级别debug/info/warn/error/silentconcurrency策略字符串 /ConcurrencyConfigdrop同一线程消息重叠时的处理策略dedupeTtlMsnumber600000消息去重 TTL毫秒默认 10 分钟lockScopethread \| channel \| function适配器默认锁粒度按线程或按频道streamingUpdateIntervalMsnumber500流式postedit更新间隔historyHistoryConfig—用户、线程、频道历史设置Webhook 路由把平台请求接进 Chat 实例注册适配器后每个适配器都会获得一个名为bot.webhooks.name的类型化处理器。把它接到你的 HTTP 框架路由即可// app/api/webhooks/slack/route.ts import { after } from next/server; import { bot } from /lib/bot; export async function POST(request: Request): PromiseResponse { return bot.webhooks.slack(request, { waitUntil: (task) after(() task), }); }waitUntil能让事件处理器在 Webhook 响应后继续运行避免无服务器平台过早中断任务。生命周期管理与单例模式初始化Chat 实例在首个 Webhook 到达时惰性初始化也可手动await bot.initialize()。优雅关闭服务器销毁时调用await bot.shutdown()。单例模式当需要跨文件访问同一实例时注册单例// lib/bot.ts const bot new Chat({ /* ...配置 */ }).registerSingleton(); export default bot; // 其他文件 import { Chat } from chat; const bot Chat.getSingleton();总结把 Chat 实例配置到位的关键点三个必填项不能少userName、adapters、state。多平台 多注册在adapters映射表里加一个平台处理器即自动跨平台生效。状态适配器选对后端生产用 Redis/PostgreSQL开发用内存确保订阅与锁不丢失。别忘了 Webhook 路由用bot.webhooks.name把每个平台接进 HTTP 路由。按需微调concurrency、lockScope、history让并发与历史表现更贴合业务。按这套流程走下来你就拥有了一个可上线的跨平台聊天机器人。更多进阶用法事件处理、消息投递、AI 流式可在 docs 目录 中继续探索。【免费下载链接】chatUniversal chat layer for building bots and agents.项目地址: https://gitcode.com/gh_mirrors/chat67/chat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考