Merge pull request #31 from Starry-OvO/develop

Update 0.4.1

aiotieba_reviewer/__version__.py

@@ -1 +1 @@
-__version__ = "0.4.0"
+__version__ = "0.4.1"

aiotieba_reviewer/reviewer/posts/producer.py

@@ -24,11 +24,12 @@ async def __default_producer(thread: Thread) -> List[Post]:
         need_rn = last_floor - len(last_posts)
         if need_rn > 0:
             post_set = set(last_posts.objs)
-            if need_rn <= 30:
+            rn_clamp = 30
+            if need_rn <= rn_clamp:
                 first_posts = await client.get_posts(thread.tid, rn=need_rn, with_comments=True, comment_rn=10)
                 post_set.update(first_posts.objs)
             else:
-                first_posts = await client.get_posts(thread.tid, rn=need_rn, with_comments=True, comment_rn=10)
+                first_posts = await client.get_posts(thread.tid, rn=rn_clamp, with_comments=True, comment_rn=10)
                 post_set.update(first_posts.objs)
                 hot_posts = await client.get_posts(thread.tid, sort=PostSortType.HOT, with_comments=True, comment_rn=10)
                 post_set.update(hot_posts.objs)

docs/tutorial/cmd_handler_dev.md

@@ -2,20 +2,46 @@
 
 ## 配置文件
 
+在当前工作目录下新建配置文件`account.toml`，并参考下列案例填写你自己的配置
+
+```toml
+[my_account_0]
+BDUSS = "账号0的BDUSS"
+
+[my_account_1]
+BDUSS = "账号1的BDUSS"
+
+[my_account_2]
+BDUSS = "账号2的BDUSS"
+```
+
+在当前工作目录下新建配置文件`database.toml`，并参考下列案例填写你自己的配置
+
+```toml
+host = "127.0.0.1"
+port = 3306
+user = ""                                 # 填用户名
+password = ""                             # 填密码
+db = "aiotieba"                           # 使用的数据库名，不填则默认为aiotieba
+unix_socket = "/var/lib/mysql/mysql.sock" # 用于优化linux系统的本机连接速度，看不懂就不用填
+pool_recycle = 3600                       # 填连接超时的秒数，需要与服务端保持一致，不填则默认为28800秒
+ssl_cafile = "/path/to/your/cacert.file"  # 用于加密连接的CA证书的路径
+```
+
 在当前工作目录下新建配置文件`cmd_handler.toml`，并参考下列案例填写你自己的配置
 
 ```toml
-listener = "listener"  # 在这里填用于监听at信息的账号的BDUSS_key
+listener = "my_account_1"  # 在这里填用于监听at信息的账号的BDUSS_key
 
 [[Forum]]
 fname = "lol半价"  # 在这里填贴吧名
-admin = "default"  # 在这里填用于在该吧行使吧务权限的账号的BDUSS_key
-speaker = "default"  # 在这里填用于在该吧发送回复的账号的BDUSS_key
+admin = "my_account_0"  # 在这里填用于在该吧行使吧务权限的账号的BDUSS_key
+speaker = "my_account_2"  # 在这里填用于在该吧发送回复的账号的BDUSS_key
 
 [[Forum]]
 fname = "抗压背锅"  # 在这里填另一个贴吧名
-admin = "default"  # 在这里填用于在该吧行使吧务权限的账号的BDUSS_key
-speaker = "default"  # 在这里填用于在该吧发送回复的账号的BDUSS_key
+admin = "my_account_1"  # 在这里填用于在该吧行使吧务权限的账号的BDUSS_key
+speaker = "my_account_1"  # 在这里填用于在该吧发送回复的账号的BDUSS_key
 ```
 
 ## 运行脚本

docs/tutorial/cmd_handler_user.md

@@ -24,7 +24,7 @@
 
 再输入
 
-**指令类型**: [`drop`](#drop--drop3--drop1-删封)<br>
+**指令类型**: [`drop`](#drop-删封)<br>
 **参数1**: `test1234` (可选的封禁理由)
 
 并发布回复
@@ -55,7 +55,7 @@
 先`@v_guard`并确保@变蓝<br>
 再输入
 
-**指令类型**: [`block`](#block--block3--block1-封禁)<br>
+**指令类型**: [`block`](#block-封禁)<br>
 **参数1**: `刚刚复制的那坨东西` (用户id: 包含[tieba_uid](https://aiotieba.cc/tutorial/start#tieba_uid)的字符串)
 
 点击回复
@@ -76,7 +76,7 @@
 先`@v_guard`并确保@变蓝<br>
 再输入
 
-**指令类型**: [`drop3`](#drop--drop3--drop1-删封)
+**指令类型**: [`drop3`](#drop-删封)
 
 点击回复
 
@@ -124,7 +124,7 @@
 @v_guard <指令类型> [参数1] [参数2] ...
 ```
 
-例如在封禁指令[`block`](#block--block3--block1-封禁)
+例如在封禁指令[`block`](#block-封禁)
 
 ```text
 @v_guard block 李彦宏 封禁测试
@@ -267,22 +267,22 @@
 
 ---
 
-### block & block3 & block1 封禁
+### block 封禁
 
 ```text
 @v_guard block [id] [reason]
-@v_guard block3 [id] [reason]
-@v_guard block1 [id] [reason]
+@v_guard blockx [id] [reason]
 ```
 
 ***功能***
 
 block: *封禁*`id`对应的用户10天<br>
-block3: *封禁*`id`对应的用户3天<br>
-block1: *封禁*`id`对应的用户1天
+blockx: *封禁*`id`对应的用户x天，x是1~90的任意整数
 
 ***参数说明***
 
+`x`: 若吧务账号无svip则仅可封禁1/3/10天，分别对应`block1` `block3` `block/block10`。若因无svip导致封禁失败则会再次尝试封禁10天
+
 `reason`: 可选参数，封禁理由
 
 `id`: [`用户名`](https://aiotieba.cc/tutorial/start#user_name)或[`portrait`](https://aiotieba.cc/tutorial/start#portrait)或包含[`tieba_uid`](https://aiotieba.cc/tutorial/start#tieba_uid)的字符串或包含[`user_id`](https://aiotieba.cc/tutorial/start#user_id)的字符串，它们都可以用来唯一地确定一个贴吧用户
@@ -348,12 +348,11 @@ block1: *封禁*`id`对应的用户1天
 
 ---
 
-### drop & drop3 & drop1 删封
+### drop 删封
 
 ```text
 @v_guard drop [reason]
-@v_guard drop3 [reason]
-@v_guard drop1 [reason]
+@v_guard dropx [reason]
 ```
 
 ***功能***
@@ -362,12 +361,13 @@ block1: *封禁*`id`对应的用户1天
 如果这条指令是一条`楼中楼`，那么指令所在回复会被*删除*，并且层主会被*封禁*<br>
 如果这条指令是一条`转发了另一主题帖的主题帖`，那么被转发的主题帖会被*删除*，并且该主题帖的楼主会被*封禁*<br>
 drop: 对应10天封禁<br>
-drop3: 对应3天封禁<br>
-drop1: 对应1天封禁<br>
+dropx: 对应x天封禁<br>
 在使用该指令时请**特别注意指令的发送位置**，以免产生意料之外的效果
 
 ***参数说明***
 
+`x`: 若吧务账号无svip则仅可封禁1/3/10天，分别对应`drop1` `drop3` `drop/drop10`。若因无svip导致封禁失败则会再次尝试封禁10天
+
 `reason`: 可选参数，封禁理由
 
 ***能使用该指令的最低权限级别***
@@ -376,7 +376,7 @@ drop1: 对应1天封禁<br>
 
 ***开发者说***
 
-[`block`](#block--block3--block1-封禁)和[`delete`](#delete-删帖)的组合，用于提升删封操作效率
+[`block`](#block-封禁)和[`delete`](#delete-删帖)的组合，用于提升删封操作效率
 
 ---
 
@@ -627,9 +627,9 @@ drop1: 对应1天封禁<br>
 
 ***功能***
 
-如果这条指令是一条`回复`，那么指令所在主题帖会被*删除*，楼主的权限级别会被设为`-5`并*封禁*10天<br>
-如果这条指令是一条`楼中楼`，那么指令所在回复会被*删除*，层主的权限级别会被设为`-5`并*封禁*10天<br>
-如果这条指令是一条`转发了另一主题帖的主题帖`，那么被转发的主题帖会被*删除*，该主题帖的楼主的权限级别会被设为`-5`并*封禁*10天<br>
+如果这条指令是一条`回复`，那么指令所在主题帖会被*删除*，楼主的权限级别会被设为`-5`并*封禁*90天<br>
+如果这条指令是一条`楼中楼`，那么指令所在回复会被*删除*，层主的权限级别会被设为`-5`并*封禁*90天<br>
+如果这条指令是一条`转发了另一主题帖的主题帖`，那么被转发的主题帖会被*删除*，该主题帖的楼主的权限级别会被设为`-5`并*封禁*90天<br>
 在使用该指令时请**特别注意指令的发送位置**，以免产生意料之外的效果<br>
 修改权限时，操作者的权限级别必须大于被操作者的权限级别。若操作者权限不足则修改权限的请求被拒绝而其余请求正常执行
 
@@ -643,7 +643,7 @@ drop1: 对应1天封禁<br>
 
 ***开发者说***
 
-指令[`block`](#block--block3--block1-封禁) [`delete`](#delete-删帖) [`black`](#black-黑名单)的组合，用于提升删封循操作效率
+指令[`block`](#block-封禁) [`delete`](#delete-删帖) [`black`](#black-黑名单)的组合，用于提升删封循操作效率
 
 ---
 

docs/tutorial/reviewer.md

@@ -33,7 +33,7 @@
 ## 使用方法
 
 1. 首先，你需要一个`MySQL`数据库，用来缓存通过检测的内容id以及记录用户权限级别（黑、白名单）
-1. 参考[**该教程**](config.md)，填写`Database`字段，以便aiotieba使用你的`MySQL`数据库。aiotieba将会在你第一次调用特定方法时自动创建数据库表，因此你无须手动建表
+1. 参考[**该教程**](cmd_handler_dev.md)，填写`database.toml`字段，以便aiotieba-reviewer使用你的`MySQL`数据库。在你第一次调用特定方法时会自动创建数据库表，因此你无须手动建表
 1. 自定义审查行为：请参照我给出的例子自己编程修改[reviewer_example.py](https://github.com/Starry-OvO/aiotieba-reviewer/blob/develop/examples/reviewer_example.py)
 1. 运行`your_reviewer.py`