@alemonjs/twitch

Twitch 平台适配器。运行环境 Node.js 22.22+。

接入

使用用户 OAuth Token；频道配置使用 login，标准发送 ChannelId 使用 broadcaster 数字 ID。管理动作需 moderator 权限和对应 scopes。

twitch:
  client_id: replace-with-client-id
  access_token: replace-with-user-access-token
  user_id: '123456'
  username: botname
  channels: [channel_login]
  scopes: [chat:read, chat:edit, user:write:chat]
  # whispers: true # scopes 还需加入 user:read:whispers 和 user:manage:whispers

import { start } from 'alemonjs';
import platform from '@alemonjs/twitch';
start({ platform: [platform] });

已实现范围

直播聊天消息、消息删除。

聊天文本、回复、删除、封禁/解禁、chatters 查询。发送检查 isSent，拦截消息返回失败。支持 whisper 发送；whispers: true 开启 EventSub 私信接收，需 user:read:whispers / user:manage:whispers 权限。订阅/直播事件通过原生 api/EventSub；StaticAuthProvider 不自动刷新令牌。

connection.status 返回当前状态和标准动作的 capabilities。未注册动作明确失败，不会静默超时。查询结果保留原始 value 并按可用字段映射 UserId / ChannelId / GuildId；分页字段接受框架 Limit / Cursor / Before / After。

逐项 API 入口、框架动作和未映射范围见 API.md。

原生 API

适配器客户端通过框架 useClient 的 client.api 通道调用公开方法，支持点分路径，保留方法的 this。原生 API 的参数遵循平台 SDK/文档，响应不等于业务投递回执。

使用的开源 SDK：@twurple/chat；依赖通过 npm 引用，没有复制 SDK 源码。完整平台接口可以从 SDK 导出直接使用；适配器未将全部 SDK API 逐个映射成统一动作。

平台业务限制、原生 SDK 与统一动作之间的差异见上面的边界说明。复杂卡片、媒体参数和权限管理请使用原生 API，不会编造平台不存在的能力。

验证

仓库命令 yarn test:social 使用注入的 SDK 和本地 HTTP 回调测试，无真实账号凭据。构建、接口签名核对和离线通过不代表真实登录、消息投递、权限审核及线上风控已经通过。

来源

• SDK / 平台文档