From 18b50a29b4c4079192d4384a413fd263346d87ae Mon Sep 17 00:00:00 2001 From: krau Date: Mon, 19 Jan 2026 13:55:46 +0000 Subject: [PATCH] deploy: 33a886fac9ff1d63ee44bb246eaad8bb3441035f --- deployment/configuration/index.html | 20 ++++++---- en/deployment/configuration/index.html | 14 +++++-- en/index.html | 11 ++++-- en/sitemap.xml | 2 +- en/usage/index.html | 53 +++++++++++++++++++++++--- index.html | 11 ++++-- sitemap.xml | 2 +- usage/index.html | 53 +++++++++++++++++++++++--- zh/sitemap.xml | 2 +- 9 files changed, 136 insertions(+), 32 deletions(-) diff --git a/deployment/configuration/index.html b/deployment/configuration/index.html index f42918d..f6da81e 100644 --- a/deployment/configuration/index.html +++ b/deployment/configuration/index.html @@ -96,16 +96,16 @@ url = "socks5://127.0.0.1:7890" enable = false session = "data/usersession.db" - 存储端列表 + Aria2 配置 # -存储端列表用于定义 Bot 支持的存储位置, 每个存储端需要指定名称、类型和相关配置, 使用双中括号语法 [[storages]] 定义.'>配置说明 | Save Any Bot +[telegram] token = "1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZ" [[users]] # telegram user id id = 777000 blacklist = true [[storages]] name = "本机存储" type = "local" enable = true base_path = "./downloads" 详细配置 # 全局配置 # stream: 是否启用 Stream 模式, 默认为 false. 启用后 Bot 将直接将文件流式传输到存储端(若存储端支持), 不需要下载到本地 Stream 模式对于磁盘空间有限的部署环境十分有用, 但也有一些弊端: 无法使用多线程从 Telegram 下载文件, 速度较慢. 网络不稳定时, 任务失败率高. 无法在中间层对文件进行处理, 例如自动文件类型识别. 并非支持所有存储端, 不支持的存储端可能会降级为普通模式或无法上传. workers: 同时处理任务数量, 默认为 3 threads: 下载文件时使用的线程数, 默认为 4. 仅在未启用 Stream 模式时生效. retry: 任务失败时的重试次数, 默认为 3. proxy: 全局代理配置, 配置后程序内一切网络连接将会尝试使用该代理, 可选. stream = false workers = 3 threads = 4 retry = 3 proxy = "socks5://127.0.0.1:7890" Telegram 配置 # token: 你的 Telegram Bot Token, 可以通过 BotFather 创建 Bot 并获取 Token. app_id, app_hash: Telegram API ID & Hash, 在 Telegram API 创建应用获取, 若不提供则使用默认值. flood_retry: Flood 控制重试次数, 默认为 5. rpc_retry: RPC 请求重试次数, 默认为 5. proxy: 代理配置, 可选. enable: 是否启用代理. url: 代理地址 userbot: userbot 配置, 可选. enable: 启用 userbot 集成, 需要登录用户账号, 此时请务必使用自己的 api id & hash. session: userbot 会话文件路径, 默认为 data/usersession.db. 启用 userbot 集成后, bot 可以下载私密频道和群组的文件, 但具有无法避免的账号被封禁的风险. 开启 userbot 集成后第一次启动 bot 时需要通过终端交互输入手机号, 2FA 和验证码. 如果你使用 docker 部署, 请使用 -it 参数为容器提供交互式环境, 然后执行登录操作. [telegram] token = "1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZ" app_id = 1025907 app_hash = "452b0359b988148995f22ff0f4229750" flood_retry = 5 rpc_retry = 5 [telegram.proxy] enable = false url = "socks5://127.0.0.1:7890" [telegram.userbot] enable = false session = "data/usersession.db" Aria2 配置 # Aria2 是一个强大的下载管理器，支持 HTTP/HTTPS、FTP、BitTorrent 等多种协议。启用后，Bot 可以使用 /aria2dl 命令通过 Aria2 下载文件。'>配置说明 | Save Any Bot

配置说明

配置说明

配置说明 #

SaveAnyBot 的配置文件使用 toml 格式, 你可以在 TOML 官方网站 上了解更多关于 toml 的语法.

SaveAnyBot 需要读取工作目录下的 config.toml 文件作为配置文件, 若缺少该文件则会创建默认文件, 并尝试从环境变量中加载配置.

以下是一个最简的配置文件示例:

[telegram]
 token = "1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZ"
 
@@ -139,6 +139,12 @@ SaveAnyBot 需要读取工作目录下的 config.toml 文件作为配置文件,
 [telegram.userbot]
 enable = false
 session = "data/usersession.db"
+

Aria2 配置 +#

Aria2 是一个强大的下载管理器，支持 HTTP/HTTPS、FTP、BitTorrent 等多种协议。启用后，Bot 可以使用 /aria2dl 命令通过 Aria2 下载文件。

  • enable: 是否启用 Aria2 支持，默认为 false
  • url: Aria2 RPC 地址，通常为 http://localhost:6800/jsonrpc
  • secret: Aria2 RPC 密钥，如果你在 Aria2 中配置了 rpc-secret，需要在此填写
  • remove_after_transfer: 转存完成后是否删除 Aria2 下载的本地文件，默认为 true
Aria2 需要单独安装和运行。你可以参考 [Aria2 官方文档](https://aria2.github.io/) 了解如何安装和配置 Aria2。
[aria2]
+enable = true
+url = "http://localhost:6800/jsonrpc"
+secret = "your-rpc-secret"
+remove_after_transfer = true

存储端列表 #

存储端列表用于定义 Bot 支持的存储位置, 每个存储端需要指定名称、类型和相关配置, 使用双中括号语法 [[storages]] 定义.

每一个存储端至少需要以下字段:

  • name: 存储端名称, 用于在 Bot 中识别, 需要唯一
  • enable: 是否启用该存储端, 默认为 true
  • type: 存储端类型, 目前支持以下类型:
    • local: 本地磁盘
    • alist: Alist
    • webdav: WebDAV
    • s3: aws S3 及其他兼容 S3 的服务
    • telegram: 上传到 Telegram

示例, 这是一个包含本地存储和 webdav 存储的配置:

[[storages]]
 name = "本地存储"
@@ -185,6 +191,6 @@ SaveAnyBot 需要读取工作目录下的 config.toml 文件作为配置文件,
 # 临时下载文件夹配置
 [temp]
 base_path = "./cache"
-
\ No newline at end of file +
\ No newline at end of file diff --git a/en/deployment/configuration/index.html b/en/deployment/configuration/index.html index 6e314d4..4a5f79d 100644 --- a/en/deployment/configuration/index.html +++ b/en/deployment/configuration/index.html @@ -9,7 +9,7 @@ SaveAnyBot needs to read a config.toml file in the working directory as its conf Here is an example of a minimal configuration file:">Configuration Guide | Save Any Bot

Configuration Guide

Configuration Guide

Configuration Guide #

SaveAnyBot uses the toml format for its configuration files. You can learn more about toml syntax on the TOML official website.

SaveAnyBot needs to read a config.toml file in the working directory as its configuration file. If this file is missing, a default file will be created, and the bot will attempt to load configuration from environment variables.

Here is an example of a minimal configuration file:

[telegram]
 token = "1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZ"
 
@@ -44,6 +44,12 @@ English
  • 简体中文[telegram.userbot]
 enable = false
 session = "data/usersession.db"
+

Aria2 Configuration +#

Aria2 is a powerful download manager that supports HTTP/HTTPS, FTP, BitTorrent, and other protocols. When enabled, the bot can use the /aria2dl command to download files via Aria2.

  • enable: Whether to enable Aria2 support, default is false
  • url: Aria2 RPC address, typically http://localhost:6800/jsonrpc
  • secret: Aria2 RPC secret, if you configured rpc-secret in Aria2, you need to fill it in here
  • remove_after_transfer: Whether to remove local files downloaded by Aria2 after transfer, default is true
Aria2 needs to be installed and running separately. You can refer to the [Aria2 official documentation](https://aria2.github.io/) to learn how to install and configure Aria2.
[aria2]
+enable = true
+url = "http://localhost:6800/jsonrpc"
+secret = "your-rpc-secret"
+remove_after_transfer = true

Storage Endpoints List #

The storage endpoints list is used to define the storage locations supported by the Bot. Each storage endpoint needs to specify a name, type, and related configuration, using the double bracket syntax [[storages]].

Each storage endpoint requires at least the following fields:

  • name: Storage endpoint name, used for identification in the Bot, must be unique.
  • enable: Whether to enable this storage endpoint, default is true.
  • type: Storage endpoint type, currently supports the following types:
    • local: Local disk
    • alist: Alist
    • webdav: WebDAV
    • s3: aws S3 and other S3 compatible services
    • telegram: Upload to Telegram

Example, this is a configuration that includes local storage and webdav storage:

[[storages]]
 name = "Local Storage"
@@ -90,6 +96,6 @@ English
  • 简体中文# Temporary download folder configuration
 [temp]
 base_path = "./cache"
-
\ No newline at end of file +
\ No newline at end of file diff --git a/en/index.html b/en/index.html index 822a1be..9074c97 100644 --- a/en/index.html +++ b/en/index.html @@ -19,6 +19,9 @@ Streaming Multi-user Automatic organization based on storage rules Watch specific chats and automatically save messages, with filters +Transfer files between different storage backends +Integrate with yt-dlp to download and save media from 1000+ websites +Aria2 integration to download files from URLs/magnets and save to storages Write JS parser plugins to save files from almost any website Supports multiple storage backends: @@ -35,7 +38,7 @@ Telegram (re-upload to specified chat) # ">Introduction | Save Any Bot +🎯 Features # Supports documents/videos/images/stickers… and even Telegraph Breaks restrictions on saving files Batch download Streaming Multi-user Automatic organization based on storage rules Watch specific chats and automatically save messages, with filters Transfer files between different storage backends Integrate with yt-dlp to download and save media from 1000+ websites Aria2 integration to download files from URLs/magnets and save to storages Write JS parser plugins to save files from almost any website Supports multiple storage backends: Alist S3 WebDAV Local disk Telegram (re-upload to specified chat) Contributors #">Introduction | Save Any Bot

Introduction

Save Any Bot @@ -43,7 +46,7 @@ English

  • Save Any Bot is a tool that allows you to save files from Telegram to various storage backends.

    🎯 Features -#

    • Supports documents/videos/images/stickers… and even Telegraph
    • Breaks restrictions on saving files
    • Batch download
    • Streaming
    • Multi-user
    • Automatic organization based on storage rules
    • Watch specific chats and automatically save messages, with filters
    • Write JS parser plugins to save files from almost any website
    • Supports multiple storage backends:
      • Alist
      • S3
      • WebDAV
      • Local disk
      • Telegram (re-upload to specified chat)

    Contributors -#

    Contributors

+#
  • Supports documents/videos/images/stickers… and even Telegraph
  • Breaks restrictions on saving files
  • Batch download
  • Streaming
  • Multi-user
  • Automatic organization based on storage rules
  • Watch specific chats and automatically save messages, with filters
  • Transfer files between different storage backends
  • Integrate with yt-dlp to download and save media from 1000+ websites
  • Aria2 integration to download files from URLs/magnets and save to storages
  • Write JS parser plugins to save files from almost any website
  • Supports multiple storage backends:
    • Alist
    • S3
    • WebDAV
    • Local disk
    • Telegram (re-upload to specified chat)

Contributors +#

Contributors

\ No newline at end of file diff --git a/en/sitemap.xml b/en/sitemap.xml index 55a5efb..30706f5 100644 --- a/en/sitemap.xml +++ b/en/sitemap.xml @@ -1 +1 @@ -https://sabot.unv.app/en/deployment/2025-06-16T16:30:45+08:00https://sabot.unv.app/en/usage/2025-12-19T21:03:58+08:00https://sabot.unv.app/en/help/2025-06-16T16:30:45+08:00https://sabot.unv.app/en/contribute/2025-12-19T21:03:58+08:00https://sabot.unv.app/en/categories/https://sabot.unv.app/en/deployment/configuration/2026-01-06T09:35:21+08:00https://sabot.unv.app/en/deployment/installation/2026-01-05T11:56:19+08:00https://sabot.unv.app/en/2025-12-19T21:03:58+08:00https://sabot.unv.app/en/deployment/configuration/storages/2025-12-19T21:03:58+08:00https://sabot.unv.app/en/tags/ \ No newline at end of file +https://sabot.unv.app/en/deployment/2025-06-16T16:30:45+08:00https://sabot.unv.app/en/usage/2026-01-19T21:55:26+08:00https://sabot.unv.app/en/help/2025-06-16T16:30:45+08:00https://sabot.unv.app/en/contribute/2025-12-19T21:03:58+08:00https://sabot.unv.app/en/categories/https://sabot.unv.app/en/deployment/configuration/2026-01-19T21:55:26+08:00https://sabot.unv.app/en/deployment/installation/2026-01-05T11:56:19+08:00https://sabot.unv.app/en/2026-01-19T21:55:26+08:00https://sabot.unv.app/en/deployment/configuration/storages/2025-12-19T21:03:58+08:00https://sabot.unv.app/en/tags/ \ No newline at end of file diff --git a/en/usage/index.html b/en/usage/index.html index f62c8d6..23f2b53 100644 --- a/en/usage/index.html +++ b/en/usage/index.html @@ -22,7 +22,7 @@ File Transfer # To use the bot’s Telegram file saving feature, you need to sen File or media messages, such as images, videos, documents, etc. Telegram message links, for example: https://t.me/acherkrau/1097. Even if the channel prohibits forwarding and saving, the bot can still download its files. Telegra.ph article links. The bot will download all images in the article. Silent Mode (silent) # Use the /silent command to toggle silent mode.">Usage | Save Any Bot

Usage

Usage

Usage #

This page introduces some of Save Any Bot’s features and basic usage. If you can’t find what you need here, please also see the Configuration Guide or ask in GitHub Discussions.

File Transfer #

To use the bot’s Telegram file saving feature, you need to send or forward the following types of messages to the bot:

  1. File or media messages, such as images, videos, documents, etc.
  2. Telegram message links, for example: https://t.me/acherkrau/1097. Even if the channel prohibits forwarding and saving, the bot can still download its files.
  3. Telegra.ph article links. The bot will download all images in the article.

Silent Mode (silent) #

Use the /silent command to toggle silent mode.

By default, silent mode is off, and the bot will ask you for the save location of each file.

When silent mode is enabled, the bot will save files directly to the default location without confirmation.

Before enabling silent mode, you need to set the default save location using the /storage command.

Storage Rules @@ -37,7 +37,50 @@ English<

Stop watching:

/unwatch <chat_id/username>

Filter types:

msgre #

Regex-match the message text. For example:

/watch 12345678 msgre:.*hello.*
-

This will watch the chat with ID 12345678, and only save messages whose text contains hello.

Save Files Outside Telegram -#

Besides files on Telegram, the bot can also save files from other websites via JavaScript plugins or built-in parsers.

See the Contributing Parsers document for details.

Just send links that match the requirements of a parser to the bot. Currently built-in parsers include:

  • Twitter
  • Kemono
\ No newline at end of file +

This will watch the chat with ID 12345678, and only save messages whose text contains hello.

Use the /dl command to directly download one or more HTTP/HTTPS files to storage.

/dl <url1> [url2] [url3] ...
+

Examples:

/dl https://example.com/file.zip
+/dl https://example.com/file1.zip https://example.com/file2.zip
+

The bot will validate the link format and then ask you to select the target storage location.

Aria2 Download +#

This feature requires enabling Aria2 in the configuration file and configuring the RPC connection.

Use the /aria2dl command to download files via the Aria2 download manager, supporting HTTP/HTTPS, FTP, BitTorrent, and other protocols.

/aria2dl <uri1> [uri2] [uri3] ...
+

Examples:

# Download HTTP link
+/aria2dl https://example.com/file.zip
+
+# Download magnet link
+/aria2dl magnet:?xt=urn:btih:...
+
+# Download torrent file (need to upload .torrent file first)
+/aria2dl https://example.com/file.torrent
+

Configure Aria2:

Add to config.toml:

[aria2]
+enable = true
+url = "http://localhost:6800/jsonrpc"
+secret = "your-rpc-secret"  # If rpc-secret is configured
+remove_after_transfer = true  # Remove local files after transfer
+

yt-dlp Video Download +#

This feature requires the yt-dlp command-line tool installed on your system.

Use the /ytdlp command to download videos and audio from supported video websites, including YouTube, Bilibili, Twitter, and 1000+ other sites.

/ytdlp <url1> [url2] [flags...]
+

Examples:

# Basic download
+/ytdlp https://www.youtube.com/watch?v=dQw4w9WgXcQ
+
+# Download multiple videos
+/ytdlp https://www.youtube.com/watch?v=video1 https://www.youtube.com/watch?v=video2
+
+# Use custom parameters
+/ytdlp https://www.youtube.com/watch?v=dQw4w9WgXcQ -f best
+/ytdlp https://www.youtube.com/watch?v=dQw4w9WgXcQ --extract-audio --audio-format mp3
+

Common parameters:

For more parameters, see yt-dlp documentation.

Storage Transfer +#

Use the /transfer command to transfer files directly between different storages without going through Telegram.

/transfer <source_storage>:/<source_path> [filter]
+

Parameters:

Examples:

# Transfer entire directory
+/transfer local1:/downloads
+
+# Transfer files from specified path
+/transfer alist1:/media/photos
+
+# Transfer only mp4 files
+/transfer webdav1:/videos ".*\.mp4$"
+
+# Transfer image files
+/transfer local1:/pictures "(?i)\.(jpg|png|gif)$"
+

The bot will:

  1. List all files in the source path
  2. Apply the filter (if provided)
  3. Display file count and total size
  4. Ask you to select the target storage
  5. Ask you to select the target directory (if configured for that storage)
  6. Start the transfer task

Notes:

Save Files Outside Telegram +#

Besides files on Telegram, the bot can also save files from other websites via JavaScript plugins or built-in parsers.

See the Contributing Parsers document for details.

Just send links that match the requirements of a parser to the bot. Currently built-in parsers include:

\ No newline at end of file diff --git a/index.html b/index.html index b6952bd..ae88403 100644 --- a/index.html +++ b/index.html @@ -19,6 +19,9 @@ 多用户使用 基于存储规则的自动整理 监听并自动转存指定聊天的消息, 支持过滤 +在不同存储端之间转存文件 +集成 yt-dlp, 从所支持的网站下载并转存媒体文件 +集成 Aria2, 支持直链/磁力下载和转存 使用 js 编写解析器插件以转存任意网站的文件 存储端支持: @@ -35,7 +38,7 @@ Telegram (重传回指定聊天) # ">介绍 | Save Any Bot +🎯 特性 # 支持文档/视频/图片/贴纸…甚至还有 Telegraph 破解禁止保存的文件 批量下载 流式传输 多用户使用 基于存储规则的自动整理 监听并自动转存指定聊天的消息, 支持过滤 在不同存储端之间转存文件 集成 yt-dlp, 从所支持的网站下载并转存媒体文件 集成 Aria2, 支持直链/磁力下载和转存 使用 js 编写解析器插件以转存任意网站的文件 存储端支持: Alist S3 WebDAV 本地磁盘 Telegram (重传回指定聊天) 贡献者 #">介绍 | Save Any Bot

介绍

Save Any Bot @@ -43,7 +46,7 @@ Telegram (重传回指定聊天)

把 Telegram 上的文件转存到多种存储端.

🎯 特性 -#

  • 支持文档/视频/图片/贴纸…甚至还有 Telegraph
  • 破解禁止保存的文件
  • 批量下载
  • 流式传输
  • 多用户使用
  • 基于存储规则的自动整理
  • 监听并自动转存指定聊天的消息, 支持过滤
  • 使用 js 编写解析器插件以转存任意网站的文件
  • 存储端支持:
    • Alist
    • S3
    • WebDAV
    • 本地磁盘
    • Telegram (重传回指定聊天)

贡献者 -#

Contributors

+#
  • 支持文档/视频/图片/贴纸…甚至还有 Telegraph
  • 破解禁止保存的文件
  • 批量下载
  • 流式传输
  • 多用户使用
  • 基于存储规则的自动整理
  • 监听并自动转存指定聊天的消息, 支持过滤
  • 在不同存储端之间转存文件
  • 集成 yt-dlp, 从所支持的网站下载并转存媒体文件
  • 集成 Aria2, 支持直链/磁力下载和转存
  • 使用 js 编写解析器插件以转存任意网站的文件
  • 存储端支持:
    • Alist
    • S3
    • WebDAV
    • 本地磁盘
    • Telegram (重传回指定聊天)

贡献者 +#

Contributors

\ No newline at end of file diff --git a/sitemap.xml b/sitemap.xml index 2d010ae..e6d3ece 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -1 +1 @@ -https://sabot.unv.app/zh/sitemap.xml2026-01-06T09:35:21+08:00https://sabot.unv.app/en/sitemap.xml2026-01-06T09:35:21+08:00 \ No newline at end of file +https://sabot.unv.app/zh/sitemap.xml2026-01-19T21:55:26+08:00https://sabot.unv.app/en/sitemap.xml2026-01-19T21:55:26+08:00 \ No newline at end of file diff --git a/usage/index.html b/usage/index.html index 25c211a..f097578 100644 --- a/usage/index.html +++ b/usage/index.html @@ -45,7 +45,7 @@ IS-ALBUM FILENAME-REGEX MESSAGE-REGEX IS-ALBUM 添加规则的基本语法:">使用帮助 | Save Any Bot

使用帮助

使用帮助

使用帮助 #

这里介绍 Save Any Bot 的一些功能和使用方法, 如果你没有在这里找到你需要的内容, 另请参阅 配置说明 或前往 Github Discussions 提问.

转存文件 #

要使用 Bot 的转存 Telegram 文件功能, 需要向 Bot 发送或转发以下类型的消息.

  1. 文件或媒体消息, 如图片, 视频, 文档等
  2. Telegram 消息链接, 例如: https://t.me/acherkrau/1097. 即使频道禁止了转发和保存, Bot 依然可以下载其文件.
  3. Telegra.ph 的文章链接, Bot 将下载其中的所有图片

静默模式 (silent) #

使用 /silent 命令可以开关静默模式.

默认情况下不开启静默模式, Bot 会询问你每个文件的保存位置.

开启静默模式后, Bot 会直接保存文件到默认位置, 无需确认.

在开启静默模式之前, 需要使用 /storage 命令设置默认保存位置.

存储规则 @@ -60,7 +60,50 @@ FILENAME-REGEX MESSAGE-REGEX IS-ALBUM 添加规则的基本语法:">

取消监听:

/unwatch <chat_id/username>

过滤器类型:

msgre #

正则匹配消息文本, 例如:

/watch 12345678 msgre:.*hello.*
-

这将会监听 ID 为 12345678 的聊天, 并且只保存消息文本中包含 “hello” 的消息.

转存 Telegram 之外的文件 -#

除了 Telegram 上的文件, Bot 还可通过 JavaScript 插件或内置解析器来支持转存其他网站的文件.

查看贡献解析器文档了解详情

只需向 Bot 发送符合解析器要求的链接即可使用, 当前内置的解析器:

  • Twitter
  • Kemono
\ No newline at end of file +

这将会监听 ID 为 12345678 的聊天, 并且只保存消息文本中包含 “hello” 的消息.

直接下载链接 +#

使用 /dl 命令可以直接下载一个或多个 HTTP/HTTPS 链接的文件到存储中.

/dl <url1> [url2] [url3] ...
+

示例:

/dl https://example.com/file.zip
+/dl https://example.com/file1.zip https://example.com/file2.zip
+

Bot 会验证链接格式, 然后让你选择目标存储位置.

Aria2 下载 +#

该功能需要在配置文件中启用 Aria2 并配置 RPC 连接.

使用 /aria2dl 命令可以通过 Aria2 下载管理器下载文件, 支持 HTTP/HTTPS、FTP、BitTorrent 等多种协议.

/aria2dl <uri1> [uri2] [uri3] ...
+

示例:

# 下载 HTTP 链接
+/aria2dl https://example.com/file.zip
+
+# 下载磁力链接
+/aria2dl magnet:?xt=urn:btih:...
+
+# 下载种子文件 (需要先上传 .torrent 文件)
+/aria2dl https://example.com/file.torrent
+

配置 Aria2:

在 config.toml 中添加:

[aria2]
+enable = true
+url = "http://localhost:6800/jsonrpc"
+secret = "your-rpc-secret"  # 如果配置了 rpc-secret
+remove_after_transfer = true  # 转存完成后删除本地文件
+

yt-dlp 视频下载 +#

该功能需要在系统中安装 yt-dlp 命令行工具.

使用 /ytdlp 命令可以下载支持的视频网站的视频和音频, 支持 YouTube、Bilibili、Twitter 等 1000+ 个网站.

/ytdlp <url1> [url2] [flags...]
+

示例:

# 基本下载
+/ytdlp https://www.youtube.com/watch?v=dQw4w9WgXcQ
+
+# 下载多个视频
+/ytdlp https://www.youtube.com/watch?v=video1 https://www.youtube.com/watch?v=video2
+
+# 使用自定义参数
+/ytdlp https://www.youtube.com/watch?v=dQw4w9WgXcQ -f best
+/ytdlp https://www.youtube.com/watch?v=dQw4w9WgXcQ --extract-audio --audio-format mp3
+

常用参数:

更多参数请参考 yt-dlp 文档.

存储间传输 +#

使用 /transfer 命令可以在不同存储之间直接传输文件, 无需经过 Telegram.

/transfer <source_storage>:/<source_path> [filter]
+

参数说明:

示例:

# 传输整个目录
+/transfer local1:/downloads
+
+# 传输指定路径的文件
+/transfer alist1:/media/photos
+
+# 只传输 mp4 文件
+/transfer webdav1:/videos ".*\.mp4$"
+
+# 传输图片文件
+/transfer local1:/pictures "(?i)\.(jpg|png|gif)$"
+

Bot 会:

  1. 列出源路径下的所有文件
  2. 应用过滤器 (如果提供)
  3. 显示文件数量和总大小
  4. 让你选择目标存储
  5. 让你选择目标目录 (如果该存储配置了目录)
  6. 开始传输任务

注意:

转存 Telegram 之外的文件 +#

除了 Telegram 上的文件, Bot 还可通过 JavaScript 插件或内置解析器来支持转存其他网站的文件.

查看贡献解析器文档了解详情

只需向 Bot 发送符合解析器要求的链接即可使用, 当前内置的解析器:

\ No newline at end of file diff --git a/zh/sitemap.xml b/zh/sitemap.xml index d9333cf..e0d24c7 100644 --- a/zh/sitemap.xml +++ b/zh/sitemap.xml @@ -1 +1 @@ -https://sabot.unv.app/deployment/2025-06-16T15:58:03+08:00https://sabot.unv.app/usage/2025-08-23T20:42:51+08:00https://sabot.unv.app/help/2025-06-16T15:58:03+08:00https://sabot.unv.app/contribute/2025-12-19T11:45:52+08:00https://sabot.unv.app/categories/https://sabot.unv.app/tags/https://sabot.unv.app/deployment/installation/2025-12-18T18:43:57+08:00https://sabot.unv.app/deployment/configuration/storages/2025-12-19T10:44:38+08:00https://sabot.unv.app/2025-12-04T22:59:23+08:00https://sabot.unv.app/deployment/configuration/2026-01-06T09:35:21+08:00 \ No newline at end of file +https://sabot.unv.app/deployment/2025-06-16T15:58:03+08:00https://sabot.unv.app/usage/2026-01-19T21:55:26+08:00https://sabot.unv.app/help/2025-06-16T15:58:03+08:00https://sabot.unv.app/contribute/2025-12-19T11:45:52+08:00https://sabot.unv.app/categories/https://sabot.unv.app/tags/https://sabot.unv.app/deployment/installation/2025-12-18T18:43:57+08:00https://sabot.unv.app/deployment/configuration/storages/2025-12-19T10:44:38+08:00https://sabot.unv.app/2026-01-19T21:55:26+08:00https://sabot.unv.app/deployment/configuration/2026-01-19T21:55:26+08:00 \ No newline at end of file