docs: Enhance documentation with new features, guidelines, and configuration details

docs/content/en/usage/_index.md

@@ -5,16 +5,17 @@ weight: 10
 
 # 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](../deployment/configuration) or ask in GitHub [Discussions](https://github.com/krau/SaveAny-Bot/discussions).
+
 ## File Transfer
 
-The bot accepts two types of messages: files and links.
+To use the bot's Telegram file saving feature, you need to send or forward the following types of messages to the bot:
 
-Supported links:
+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.
 
-1. 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.**
-2. Telegra.ph article links, the bot will download all images within.
-
-## Silent Mode
+## Silent Mode (silent)
 
 Use the `/silent` command to toggle silent mode.
 
@@ -27,7 +28,7 @@ Before enabling silent mode, you need to set the default save location using the
 
 ## Storage Rules
 
-Allows you to set some redirection rules for the bot when uploading files to storage, for automatic organization of saved files.
+Storage rules allow you to define redirection rules when the bot uploads files to storage, so that saved files are automatically organized.
 
 See: <a href="https://github.com/krau/SaveAny-Bot/issues/28" target="_blank">#28</a>
 
@@ -35,20 +36,21 @@ Currently supported rule types:
 
 1. FILENAME-REGEX
 2. MESSAGE-REGEX
+3. IS-ALBUM
 
 Basic syntax for adding rules:
 
-"Rule Type Rule Content Storage Name Path"
+"RuleType RuleContent StorageName Path"
 
-Pay attention to the use of spaces; the bot can only parse correctly formatted syntax. Below is an example of a valid rule command:
+Pay attention to spaces; the bot can only parse correctly formatted syntax. Below is an example of a valid rule command:
 
 ```
 /rule add FILENAME-REGEX (?i)\.(mp4|mkv|ts|avi|flv)$ MyAlist /videos
 ```
 
-Additionally, if "CHOSEN" is used as the storage name in the rule, it means the file will be stored in the path of the storage selected via button click.
+In addition, if `CHOSEN` is used as the storage name in the rule, it means files will be stored under the path of the storage you selected by clicking the inline button.
 
-Rule descriptions:
+Rule types:
 
 ### FILENAME-REGEX
 
@@ -58,8 +60,65 @@ Matches based on filename regex. The rule content must be a valid regular expres
 FILENAME-REGEX (?i)\.(mp4|mkv|ts|avi|flv)$ MyAlist /videos
 ```
 
-This means files with extensions mp4, mkv, ts, avi, flv will be saved to the /videos directory in the storage named MyAlist (also affected by the `base_path` in the configuration file).
+This means files with extensions mp4, mkv, ts, avi, flv will be saved to the `/videos` directory in the storage named `MyAlist` (also affected by the `base_path` in the configuration file).
 
 ### MESSAGE-REGEX
 
-Similar to the above, but matches based on the text content of the message itself.
+Similar to the above, but matches based on the text content of the message itself.
+
+### IS-ALBUM
+
+Matches album messages (media groups). Rule content can only be `true` or `false`.
+
+If the path in the rule uses `NEW-FOR-ALBUM`, the bot will create a new folder for each media group and store all files of that group there. See: https://github.com/krau/SaveAny-Bot/issues/87
+
+For example:
+
+```
+IS-ALBUM true MyWebdav NEW-FOR-ALBUM
+```
+
+This will save media-group messages to the storage named `MyWebdav`, creating a new folder (generated from the first file) for each album.
+
+## Watch Chats
+
+{{< hint warning >}}
+This feature requires enabling UserBot integration.
+{{< /hint >}}
+
+You can watch messages in a specific chat and automatically save them to the default storage, following storage rules. You can also add filters so that only matching messages are saved.
+
+Watch a chat:
+
+```
+/watch <chat_id/username> [filter]
+```
+
+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](../contribute) document for details.
+
+Just send links that match the requirements of a parser to the bot. Currently built-in parsers include:
+
+- Twitter
+- Kemono