菜单
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.
用 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.
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.
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.
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-yatgstorage |
| description | 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. |
Import path: github.com/YaCodeDev/GoYaCodeDevUtils/yatgstorage.
Redis-backed persistence for gotd/td's updates.Manager state (pts/qts/seq/date via RedisJSON) plus
channel/user access-hash bookkeeping, and a separate GORM/AES-encrypted session-storage layer for the
client's auth key.
Store interface — Ping, GetState/SetState/SetPts/SetQts/SetDate/SetSeq/SetDateSeq, SetChannelPts/GetChannelPts/ForEachChannels, SetChannelAccessHash/GetChannelAccessHash, AccessHashSaveHandler, SetUserAccessHash/GetUserAccessHash, TelegramStorageCompatible() updates.StateStorage, TelegramAccessHasherCompatible() updates.ChannelAccessHasher.Storage struct + NewStorage(cache yacache.Cache[*redis.Client], log yalogger.Logger) *Storage.HandlerFunc func(ctx, tg.UpdatesClass) error — adapts a plain func to telegram.UpdateHandler.SessionStore interface — LoadSession, StoreSession, TelegramSessionStorageCompatible().SessionStorage struct + NewSessionStorage(entityID, secret) *SessionStorage (in-memory repo) / NewSessionStorageWithCustomRepo(entityID, secret, repo EntitySessionStorageRepo) *SessionStorage.EntitySessionStorageRepo interface — UpdateAuthKey, FetchAuthKey.GormRepo + NewGormSessionStorage(poolDB *gorm.DB) (*GormRepo, yaerrors.Error) (auto-migrates the YaTgClientSession table); MemoryRepo + NewMemorySessionStorage(entityID) *MemoryRepo.AES struct + NewAES(key string) AES — Encrypt/Decrypt (AES-256-CTR); DeriveAESKey(data string) []byte (SHA-256).YaTgClientSession GORM model; const BasePathRedisJSON = "$", FieldEncryptedAuthKey, LoggerEntityID, etc.Storage requires a Redis build with the RedisJSON module (via cache.Raw() exposing a *redis.Client with JSONGet/JSONSet/JSONMSet).writeStateWithRecovery auto-repairs missing/wrong-type RedisJSON roots (lazily creates {} at "$") and retries once on recoverable errors (e.g. "no such key", "wrongtype").DeriveAESKey), giving AES-256. Depends on yacache, yaerrors, yalogger, yathreadsafeset; used by yatgbot and yatgclient (NewUpdateManagerWithYaStorage).StoreModule provides Store (needs yacache.Cache[*redis.Client] + yalogger.Logger); SessionRepoModule provides EntitySessionStorageRepo from a *gorm.DB (fx.go).