docs(zh): update watch feat

client/bot/handlers/register.go

@@ -81,7 +81,7 @@ func listenMediaMessageEvent(ch chan userclient.MediaMessageEvent) {
 				filterType := filter[0]
 				filterData := filter[1]
 				switch filterType {
-				case "msgre":
+				case "msgre": // [TODO] enums for filter types
 					if ok, err := regexp.MatchString(filterData, msgText); err != nil {
 						continue
 					} else if !ok {

client/bot/handlers/utils/msgelem/watch.go

@@ -2,18 +2,18 @@ package msgelem
 
 const (
 	WatchHelpText = `
-	使用 /watch 命令监听一个聊天的消息, 并自动保存到默认存储中, 遵从存储规则.
+使用 /watch 命令监听一个聊天的消息, 并自动保存到默认存储中, 遵从存储规则.
 
-	命令语法:
+命令语法:
-	/watch <chat_id> [filter]
+/watch <chat_id> [filter]
 
-	参数:
+参数:
-	- <chat_id>: 聊天的 ID 或用户名
+- <chat_id>: 聊天的 ID 或用户名
-	- [filter]: 可选, 格式为 过滤器类型:表达式 , 所有支持类型的过滤器请查看文档
+- [filter]: 可选, 格式为 过滤器类型:表达式 , 所有支持类型的过滤器请查看文档
 
-	命令示例:
+命令示例:
-	/watch 2229835658 msgre:.*plana.*
+/watch 2229835658 msgre:.*plana.*
 
-	这将监听 ID 为 2229835658 的聊天, 并转存所有包含 "plana" 的媒体消息
+这将监听 ID 为 2229835658 的聊天, 并转存所有包含 "plana" 的媒体消息
 	`
 )

docs/content/zh/deployment/configuration/_index.md

@@ -61,8 +61,6 @@ Stream 模式对于磁盘空间有限的部署环境十分有用, 但也有一
 {{< hint warning >}}
 启用 userbot 集成后, bot 可以下载私密频道和群组的文件, 但具有无法避免的账号被封禁的风险.
 <br />
-并且, 由于上游依赖问题, 该功能不稳定, 会出现获取文件失败的情况.
-<br />
 开启 userbot 集成后第一次启动 bot 时需要通过终端交互输入手机号, 2FA 和验证码, 如果你使用 docker 部署, 请进入容器内执行相关操作.
 {{< /hint >}}
 

docs/content/zh/usage/_index.md

@@ -50,7 +50,7 @@ Bot 接受两种消息: 文件和链接.
 
 此外, 规则中的存储名若使用 "CHOSEN" , 则表示存储到点击按钮选择的存储端的路径下
 
-规则介绍:
+规则类型:
 
 ### FILENAME-REGEX
 
@@ -78,4 +78,37 @@ FILENAME-REGEX (?i)\.(mp4|mkv|ts|avi|flv)$ MyAlist /视频
 IS-ALBUM true MyWebdav NEW-FOR-ALBUM
 ```
 
-这将会把以 media group 形式发送的消息保存到名为 MyWebdav 的存储下, 并为每个相册新建一个文件夹(由第一个文件生成)来存储它们.
+这将会把以 media group 形式发送的消息保存到名为 MyWebdav 的存储下, 并为每个相册新建一个文件夹(由第一个文件生成)来存储它们.
+
+
+## 监听聊天
+
+{{< hint warning >}}
+该功能需开启 UserBot 集成.
+{{< /hint >}}
+
+监听指定聊天的消息, 并自动保存到默认存储中, 遵从存储规则, 并且可以设置过滤器来只保存匹配的消息.
+
+监听聊天:
+
+```
+/watch <chat_id/username> [filter] 
+```
+
+取消监听:
+
+```
+/unwatch <chat_id/username>
+```
+
+过滤器类型:
+
+### msgre
+
+正则匹配消息文本, 例如:
+
+```
+/watch 12345678 msgre:.*hello.*
+```
+
+这将会监听 ID 为 12345678 的聊天, 并且只保存消息文本中包含 "hello" 的消息.