菜单
Use when deciding which @yaebal/* package solves a problem in a yaebal bot — storage, keyboards, dialogs, rate limits, media, formatting, deployment, testing.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | yaebal-pick-plugin |
| description | Use when deciding which @yaebal/* package solves a problem in a yaebal bot — storage, keyboards, dialogs, rate limits, media, formatting, deployment, testing. |
reach for a first-party package before writing infrastructure by hand. installable plugins are
wired with bot.install(plugin()) — never bot.use(plugin()). some packages are libraries
(builders, functions) rather than plugins; those are noted below.
@yaebal/session — typed ctx.session, loaded before handlers and saved after (dirty-checked).
bot.install(session({ initial: () => ({ count: 0 }) })).@yaebal/sklad — the StorageAdapter contract + adapters (memory, redis, sqlite, cloudflare
kv, json file). not a plugin: pass an adapter to session/scenes/i18n/media-cache/ai.@yaebal/keyboard — InlineKeyboard / Keyboard builders. library, no install.@yaebal/callback-data — typed, compact callback_data schemas; routes via
bot.callbackQuery(namespace, handler). library, no install.@yaebal/pagination — paginated lists with ◀/▶ navigation that edit in place.
const list = pagination({...}); bot.install(list.plugin()).@yaebal/scenes — declarative step-by-step wizards, durable snapshots. bot.install(scenes({...})).@yaebal/conversation — linear await cv.waitFor(...) async flows. bot.install(conversation({...})).@yaebal/prompt — one-off question → handle the next message. bot.install(prompt()).@yaebal/commands — one registry for handlers + the / command menu, with sync() to push
the menu. const cmd = commands().add(...); bot.install(cmd.plugin()).@yaebal/router — file-based routing: load routes/commands/*.ts etc. via loadRoutes(bot, dir).@yaebal/throttle — outbound: queues your api calls under telegram's flood limits.
bot.install(throttle({ globalPerSec: 30 })).@yaebal/ratelimiter — inbound: drops update floods from spammy users.
bot.install(ratelimiter({ limit: 5, windowMs: 1000 })).@yaebal/again — autoRetry() re-runs failed api calls (429 retry_after, network errors).@yaebal/fmt — html / md tagged templates → entities, auto-escaped interpolation, no
parse_mode. library, no install.@yaebal/rich — telegram's block-tree rich messages (headings, tables, collages) via
sendRichMessage. library, no install.@yaebal/split — send >4096-char text as multiple messages: bot.install(splitter()) adds
ctx.sendLong / ctx.replyLong.@yaebal/files — bot.install(files()) adds ctx.files.info/url/download.@yaebal/file-id — parse/inspect file_id strings. library, no install.@yaebal/media-group — collect album parts into one handler call: bot.install(mediaGroup(handler)).@yaebal/media-cache — upload once, reuse file_id:
const cache = mediaCache(); bot.install(cache.plugin()).@yaebal/i18n — typed translations, ctx.t(...), plurals, locale persistence.
bot.install(i18n({ defaultLocale: "en", locales: { en, ru } })).@yaebal/payments — invoice builder + onPreCheckout/onSuccessfulPayment hooks (telegram
stars and providers). bot.install(payments({...})).@yaebal/broadcast — mass delivery with progress, retries and pause/resume:
await broadcast(bot.api, chatIds, text, options).@yaebal/ai — llm replies streamed into the chat: bot.install(ai({ model })) adds ctx.ai
(see the yaebal-ai-features skill).@yaebal/runner — concurrent long polling, ordered per chat: const handle = run(bot, {...}).@yaebal/web — webhooks on any runtime: webhook(bot), serve(bot), framework adapters,
sequentialize() / dedupe() hardening.@yaebal/test — createTestEnv + user/chat actors; no real HTTP ever. dev dependency.Use when building multi-step dialogs in a yaebal bot — choosing between scenes, conversation, and prompt, and wiring their persistence.
Use when writing or modifying a Telegram bot built on the yaebal framework — bot setup, handlers, filter queries, commands, and context typing.
Use when adding LLM features to a yaebal bot with @yaebal/ai — ctx.ai streaming replies, model adapters, conversation memory, and rate limits.
Use when writing a custom yaebal plugin — the Plugin<In, Out> contract, derive vs decorate, and typed plugin dependencies.
Use when a yaebal bot fails to compile, start, or respond — install-order type errors, ESM specifier errors, Telegram 400/409/429 responses.
Use when running a yaebal bot in production — long polling with @yaebal/runner vs webhooks with @yaebal/web, graceful shutdown, and error handling.