Skip to content

Platform Adapters

Adapters connect IM / chat platforms to the Zhin.js core. Each @zhin.js/adapter-* package has its own documentation page, kept in sync with the in-package README.md (pnpm sync:adapter-docs).

For framework-level concepts (multi-platform concurrency, message flow, endpoint lifecycle), see Core Concepts and Endpoint Lifecycle.

Tier SSOT: scripts/adapter-meta.mjs (same source as docs/snippets/platform-tiers.md).

Tiers

TierMeaning
StableConsistent with pnpm check:stable and minimal-bot
Platform StableMainstream IM; must satisfy ADR 0015 D3 and enter the check:stable Platform batch (currently none)
AdvancedCommonly used by the test-bot maintainer kitchen sink (not a user template); has integration tests but not in the Stable smoke
ExperimentalUsability varies greatly by deployment; requires self-verification; does not mean untested, just no full CI / real-device guarantee

Stable

AdapterPackageEndpoint Management CapabilitiesDocs
Sandbox@zhin.js/adapter-sandboxSandbox

Platform Stable

(Currently none)

Advanced

AdapterPackageEndpoint Management CapabilitiesDocs
DingTalk@zhin.js/adapter-dingtalkDingTalk
Lark@zhin.js/adapter-larkLark
WeChat Official Account@zhin.js/adapter-wechat-mpWeChat Official Account
Discord@zhin.js/adapter-discordDiscord
ICQQ (QQ)@zhin.js/adapter-icqqlistFriends, listGroups, listChannels, listGroupMembers, approveRequest, rejectRequest, kickGroupMember, muteGroupMember, setGroupAdmin, deleteFriendICQQ (QQ)
KOOK@zhin.js/adapter-kookKOOK
OneBot v11@zhin.js/adapter-onebot11OneBot v11
QQ Official@zhin.js/adapter-qqlistChannelsQQ Official
Slack@zhin.js/adapter-slackSlack
Telegram@zhin.js/adapter-telegramTelegram

Experimental

AdapterPackageEndpoint Management CapabilitiesDocs
WeCom@zhin.js/adapter-wecomWeCom
WeChat iLink@zhin.js/adapter-weixin-ilinkWeChat iLink
Email@zhin.js/adapter-emailEmail
GitHub@zhin.js/adapter-githubGitHub
LINE@zhin.js/adapter-lineLINE
Milky@zhin.js/adapter-milkyMilky
NapCat@zhin.js/adapter-napcatNapCat
OneBot v12@zhin.js/adapter-onebot12OneBot v12
Satori@zhin.js/adapter-satoriSatori

Maintenance Notes

  • Single source of truth (tiers): scripts/adapter-meta.mjs
  • Single source of truth (content): plugins/adapters/<name>/README.md
  • Sync command: Run pnpm sync:adapter-docs from the repository root
  • CI checks: pnpm check:adapter-docs, pnpm check:platform-tiers-ssot

Source index: plugins/adapters/README.md