安装

使用nb-cli [推荐]

nb plugin install nonebot-plugin-tg-stickers-downloads

使用pip

pip install nonebot-plugin-tg-stickers-downloads

使用

命令用法：

/tgsd https://t.me/addstickers/<StickerPackName>

示例：

/tgsd https://t.me/addstickers/TgStickerPackDemo

外部依赖安装（macOS / Linux）

说明：

• .webm -> .gif 需要 ffmpeg（可选 gifsicle 优化体积）
• .webp -> .png 默认使用 Pillow；配置 tgsd_imagemagick_path 时优先使用 ImageMagick

macOS（Homebrew）：

brew install ffmpeg gifsicle imagemagick

Linux（Debian/Ubuntu）：

sudo apt update
sudo apt install -y ffmpeg gifsicle imagemagick

Linux（Fedora）：

sudo dnf install -y ffmpeg gifsicle ImageMagick

如果你的可执行文件不在系统 PATH 中，请在配置里显式填写：

• tgsd_ffmpeg_path
• tgsd_gifsicle_path
• tgsd_imagemagick_path

外部依赖安装 （Windows）

点击展开

我不知道

配置项

配置方式：直接在 NoneBot 全局配置文件中添加以下配置项即可

tgsd_bot_token [必填]

• 类型：str
• 默认值：None
• 说明：用于获取贴纸包信息与文件下载地址的 Telegram Bot Token

tgsd_proxy [选填]

• 类型：str
• 默认值：None
• 说明: 配置用于访问 Telegram Bot Api 的代理 例如 tgsd_proxy="http://127.0.0.1:6152"

tgsd_ffmpeg_path [选填]

• 类型：str
• 默认值：None
• 说明：ffmpeg 可执行文件的绝对路径. 用于 .webm -> .gif 转换; 不填写时将自动从系统 PATH 中查找 ffmpeg

tgsd_gifsicle_path [选填]

• 类型：str
• 默认值：None
• 说明：gifsicle 可执行文件的绝对路径. 用于对生成的 GIF 进行进一步压缩优化; 不填写时将自动从系统 PATH 中查找, 找不到则跳过优化

tgsd_imagemagick_path [选填]

• 类型：str
• 默认值：None
• 说明：ImageMagick 可执行文件路径（magick 或 convert）仅在配置该项时优先使用 ImageMagick 进行 .webp -> .png 转换; 未配置时默认使用 Pillow

tgsd_cache_expire_seconds [选填]

• 类型：int
• 默认值：86400（24 小时）
• 说明：贴纸包缓存过期时间（秒）过期后缓存将在定时清理时被删除

tgsd_download_concurrency [选填]

• 类型：int
• 默认值：5
• 说明：同时下载贴纸的最大并发数

tgsd_convert_concurrency [选填]

• 类型：int
• 默认值：2
• 说明：同时进行格式转换的最大并发数

tgsd_skip_conversion [选填]

• 类型：bool
• 默认值：False
• 说明：设为 True 时跳过所有格式转换, 仅保留原始文件（.webp、.webm、.tgs）

tgsd_subprocess_timeout [选填]

• 类型：int
• 默认值：120
• 说明：外部转换工具（ffmpeg、gifsicle、ImageMagick）的子进程超时时间（秒）超时后进程将被终止