菜单
High-level Telegram bot framework on top of gotd/td - router/dispatcher with filters and middleware, FSM-aware routing, per-user localization, sequential-update scheduling, and a message-send queue. Use as the starting point for any Telegram bot.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Index of every GoYaCodeDevUtils utility package (config, errors, logging, caching, rate limiting, backoff, hashing, gzip, RSA, feature flags, FSM, thread-safe collections, locales, Telegram bot stack) with a pointer to each package's own skill. Use before hand-rolling infrastructure code GoYaCodeDevUtils may already provide.
Thin wrapper around gotd/td's telegram.Client adding background-connect-with-retry, bot-token authorization, updates.Manager wiring, and SOCKS5/MTProto proxy helpers. Use for direct low-level Telegram client control instead of raw gotd/td.
Redis-backed persistence for gotd/td's updates.Manager state (pts/qts/seq/date via RedisJSON) plus channel/user access-hash bookkeeping, and a GORM/AES-encrypted session-storage layer. Use for any yatgclient/yatgbot state or session persistence.
Generic pluggable key-value cache abstraction with interchangeable in-memory and Redis backends, hash-oriented API. Use for any caching/session-store need instead of hand-rolling a map or a bare redis.Client call.
Loads JSON locale files into a nested key-tree with lookup, {placeholder} formatting, JSON serving, language-tag normalization, and Go-struct codegen. Use for any i18n/localization instead of hand-rolled JSON locale loading.
Bidirectional converter between a custom Markdown-like syntax and Telegram (gotd) rich-text MessageEntityClass formatting, with correct UTF-16LE offsets. Use as the ParseMode for any yatgbot/gotd-based bot.
| name | goyacodedevutils-yatgbot |
| description | High-level Telegram bot framework on top of gotd/td - router/dispatcher with filters and middleware, FSM-aware routing, per-user localization, sequential-update scheduling, and a message-send queue. Use as the starting point for any Telegram bot. |
Import path: github.com/YaCodeDev/GoYaCodeDevUtils/yatgbot.
High-level Telegram bot framework on top of gotd/td — router/dispatcher with filters and middleware,
FSM-aware routing, per-user localization, sequential-update scheduling, and a message-send queue. Wires
together yatgclient, yatgstorage, yafsm, yalocales, and yacache.
Options struct — all InitYaTgBot inputs: AppID/AppHash/BotToken/PoolDB/Cache/MainRouter/ParseMode/Log/Sync/Features/EmbeddedLocales/MessageQueueRatePerSecond/ForgetUpdatesOnStart.InitYaTgBot(ctx, *Options) (Dispatcher, yaerrors.Error) — one-call bootstrap: parses the bot token, sets up FSM storage, localizer, GORM+Redis session/state storage, the gotd client, connects, authorizes, and starts updates.Manager.Dispatcher struct — { FSMStore, Log, BotUser, MessageDispatcher, Localizer, Client, UpdatesErrors <-chan yatgclient.EntityError, MainRouter, Features } + Bind(tgDispatcher, sync bool).RouterGroup struct + NewRouterGroup(); router.OnMessage/OnCallback/OnEditMessage/OnDeleteMessage/OnNewChannelMessage/OnEditChannelMessage/OnDeleteChannelMessages/OnMessageReactions/OnChannelParticipant/OnPrecheckoutQuery/OnInlineQuery(handler, filters...); RouterGroup.IncludeRouter(subs...), AddMiddleware(mw...).Filter type + StateIs/TextEq/TextRegex/CallbackEq/CallbackPrefix/MessageServiceFilter/MessageServiceActionFilter[T]/OneOfFilter/AllOfFilter.HandlerData struct — per-handler deps: Entities, Client, Update, UserID, Peer, StateStorage, Log, Dispatcher, Localizer, JobResults.FeatureFlags (uint8) + const FeatureSequentialUpdates.ExtractMessageFromUpdate/ExtractMessageServiceFromUpdate(upd) (*tg.Message/*tg.MessageService, bool).FeatureSequentialUpdates ensures async updates sharing a user/chat key are processed in arrival order via an internal scheduler; Options.Sync = true forces fully synchronous (blocking) dispatch instead.ErrRouteMismatch to fall through (used internally by wrapHandler's type assertion).yacache (FSM + state storage), yafsm (per-user state), yalocales (per-user language via user.LangCode), yalogger, yatgclient (connection/auth), yatgmessageencoding (ParseMode), yatgstorage (session + updates.Manager state). Has an internal messagequeue subpackage not covered by its own skill.Module (fx.go) provides *Dispatcher, deferring InitYaTgBot to an fx.Lifecycle OnStart hook (needs a live context); OnStop tears the connection down.