[Change] 将RankingMode和RankingContentType从PixivURL分离, 并增加Parser, 顺便整理单行过长的代码;

[Add] RankingMode, RankingModeParser 从PixivURL分离并增加对应Parser;
[Add] RankingContentType, RankingContentTypeParser 从PixivURL分离并增加对应Parser;
[Delete] PixivURL 分离RankingMode和RankingContentType两个枚举类;
[Add] BotEventHandler 注册两个新的Parser;
[Change] BotCommandProcess 适配更改, 调整`ranking`命令的"type"和"mode"参数数据类型;
[Change] DateParser, PagesQualityParser 调整包路径;
[Change] BotAdminCommandProcess, CacheStoreCentral, Main, PixivDownload, PixivDownloadTest, RandomRankingArtworksSender, RankingUpdateTimer 适配更改;

README.md

@@ -1,20 +1,19 @@
 # ContentGrabbingJi - 色图姬 #
-一个以高性能、高效率为目标，多平台/框架支持、持续维护的Pixiv聊天机器人  
-
+一个以高性能、高效率为目标，多平台/框架支持、持续维护的 Pixiv 聊天机器人；  
 色图姬存在的目的最初是作为**爬虫 + 机器人**的形式开发，在开发过程中逐渐以多聊天平台，高效率为目标进行。
 
 ## 安装 ##
-### 通过Jar文件部署 ###
-1. 从项目的[版本页面](https://github.com/LamGC/ContentGrabbingJi/releases)下载最新版色图姬主程序jar文件
-2. 准备一个目录, 用于存放运行数据(这里以`./runData`为例子).
-3. 将通过PixivLoginProxyServer获得的Pixiv登录会话文件放置在目录中(`./runData/cookies.store`).
-4. 使用命令`java -jar <CGJ.jar> buildPassword -password "QQ机器人账号的密码"`构造一个登录用的密码.
-5. 在数据目录创建一个配置文件`bot.properties`, 并添加如下内容:
+### 通过 Jar 文件部署 ###
+1. 从项目的[版本页面](https://github.com/LamGC/ContentGrabbingJi/releases)下载最新版色图姬主程序 jar 文件。
+2. 准备一个目录，用于存放运行数据（这里以 `./runData` 为例子）。
+3. 将通过 PixivLoginProxyServer 获得的 Pixiv 登录会话文件放置在目录中（`./runData/cookies.store`）。
+4. 使用命令 `java -jar <CGJ.jar> buildPassword -password "QQ机器人账号的密码"` 构造一个登录用的密码。
+5. 在数据目录创建一个配置文件 `bot.properties`，并添加如下内容：
     ```properties
     bot.qq=<机器人QQ账号>
     bot.password=<通过buildPassword获得的密码>
     ```
-6. 在数据目录创建新文件夹`setting`, 并创建一个全局配置文件`global.properties`, 然后设置如下内容:
+6. 在数据目录创建新文件夹 `setting`，并创建一个全局配置文件 `global.properties`，然后设置如下内容：
     ```properties
     # 该配置为全局配置文件, 当群组没有特定配置时, 将使用全局配置.
     # 管理员QQ (必填)
@@ -30,12 +29,14 @@
     # 搜索结果长度. 该选项请适当调整, 设置过长可能导致超出聊天平台的最长消息长度, 导致发送失败!
     search.itemCountLimit=8
     ```
-7. 配置完成后, 准备一台Redis服务端, 用于缓存数据.
-8. Redis服务器准备好后, 使用命令启动色图姬：`java -jar <CGJ.jar> botMode -botDataDir <数据目录> -redisAddress <Redis服务器地址> [-proxy 代理服务器地址]`
+    （管理员 QQ 的作用/用法将在下面详细说明。）
+7. 配置完成后，准备一台 Redis 服务端，用于缓存数据。
+8. Redis 服务器准备好后，使用命令启动色图姬：  
+    `java -jar <CGJ.jar> botMode -botDataDir <数据目录> -redisAddress <Redis服务器地址> [-proxy 代理服务器地址]`
 9. 完成！好好享受！
 
-### 通过Docker部署 ###
-使用Docker将可以更好的管理色图姬所使用的资源，和管理色图姬的运行。
+### 通过 Docker 部署 ###
+使用 Docker 将可以更好的管理色图姬所使用的资源，和管理色图姬的运行。
 (正在完善中...)
 
 ## 使用 ##
@@ -51,7 +52,7 @@
 如果色图姬无法识别你的命令，那么它会发送一次帮助信息给你。
 
 ### 管理员用户 ###
-你应该注意到了，在部署过程中，你需要设置一个管理员QQ的配置，色图姬支持通过命令来管理色图姬的运行。  
+你应该注意到了，在部署过程中，你需要设置一个管理员 QQ 的配置，色图姬支持通过命令来管理色图姬的运行。  
 目前支持的管理员命令：
 ```bash
 # 清除缓存(慎用)
@@ -106,13 +107,13 @@
 ```
 
 ## 贡献 ##
-向色图姬贡献不一定需要编程知识，向色图姬项目提出意见，反馈问题同样会为色图姬项目提供很大的帮助！  
-如果你在使用色图姬的过程中，遇到了Bug，可以通过色图姬项目的**Issues**使用[Bug反馈模板](https://github.com/LamGC/ContentGrabbingJi/issues/new?assignees=&labels=bug&template=Bug_Report.md&title=)向色图姬提供Bug信息。  
-如果是为色图姬提供一些新功能想法，或者对色图姬有什么意见，则可以直接通过Issues发起讨论。
+**向色图姬贡献不一定需要编程知识，向色图姬项目提出意见，反馈问题同样会为色图姬项目提供很大的帮助！**  
+如果你在使用色图姬的过程中，遇到了 Bug，可以通过色图姬项目的 **Issues** 使用[ Bug 反馈模板](https://github.com/LamGC/ContentGrabbingJi/issues/new?assignees=&labels=bug&template=Bug_Report.md&title=)向色图姬提供 Bug 信息。  
+如果是为色图姬提供一些新功能想法，或者对色图姬有什么意见，则可以使用[功能/意见提议模板](https://github.com/LamGC/ContentGrabbingJi/issues/new?assignees=&labels=function%2C+question&template=Feature_Report.md&title=)反馈你的想法！
 
-如果你会Java开发，又想为色图姬提供一些新功能，可以通过Fork仓库的方法，实现后发起PR，合并到色图姬项目中！  
+如果你会 Java 开发，又想为色图姬提供一些新功能，可以通过 Fork 仓库的方法，实现后发起 PR，合并到色图姬项目中！  
 向色图姬贡献代码，需要遵循一些贡献事项，如果你的代码不符合这些事项，PR有可能会被关闭！  
-> 注意：色图姬的初衷并没有任何恶意的意图，如果尝试向色图姬提供恶意功能或代码，PR将会被拒绝、关闭。
+> 注意：色图姬的初衷并没有任何恶意的意图，如果尝试向色图姬提供恶意功能或代码，PR 将会被拒绝、关闭。
 
 ## LICENSE ##
 本项目基于 `GNU Affero General Public License 3.0` 开源许可协议开源，  

documents/interfaces/Pixiv排行榜接口.md

@@ -41,16 +41,15 @@ GET https://www.pixiv.net/ranking.php
    :-:    |:-:| :-:  | :-:  | :-:
 daily     |`√`|`√`|`√`|`√`
 weekly    |`√`|`√`|`√`|`√`
-monthly   |`√`|`√`|×|`√`
-rookie    |`√`|`√`|×|`√`
-original  |`√`|×|×|×
-male      |`√`|×|×|×
-female    |`√`|×|×|×
+monthly   |`√`|`√`| × |`√`
+rookie    |`√`|`√`| × |`√`
+original  |`√`| × | × | ×
+male      |`√`| × | × | ×
+female    |`√`| × | × | ×
 daily_r18 |`√`|`√`|`√`|`√`
 weekly_r18|`√`|`√`|`√`|`√`
-male_r18  |`√`|×|×|×
-female_r18|`√`|×|×|×
-
+male_r18  |`√`| × | × | ×
+female_r18|`√`| × | × | ×
 
 ### 返回数据 ###
 #### 数据示例 ####

documents/interfaces/Pixiv搜索接口.md

@@ -16,14 +16,17 @@ GET https://www.pixiv.net/ajax/search/{Type}/{Content}?{Param...}
 ### 参数 ###
 #### Url参数 ####
 - `Type`: 内容类型
-    - illustrations(插画)
-    - top(推荐)
-    - manga(漫画)
-    - novels(小说)
+    - `artworks` - 所有类型
+    - `top` - 推荐
+    - `illustrations` - 插画
+    - `manga` - 漫画
+    - `novels` - 小说
+    - `tags` - 查询标签信息
 - `Content`: 搜索内容
 
 #### GET参数 ####
 ##### 必填 #####
+> 注意：除 `tags` 类型外，其他内容类型都需要以下参数。
 - `word`: 与搜索内容一致 (经测试似乎可以省略)
 - `s_mode`: 匹配模式
     - `s_tag`: 标签，部分一致
@@ -82,7 +85,8 @@ GET https://www.pixiv.net/ajax/search/{Type}/{Content}?{Param...}
                         "風景",
                         "空",
                         "草",
-                        "雲"],
+                        "雲"
+                    ],
                     "userId":"31507675",
                     "userName":"昏omeme",
                     "width":1600,
@@ -155,7 +159,8 @@ GET https://www.pixiv.net/ajax/search/{Type}/{Content}?{Param...}
                         "女の子",
                         "カラス",
                         "风景",
-                        "線路"],
+                        "線路"
+                    ],
                     "userId":"1069005",
                     "userName":"へちま",
                     "width":2000,
@@ -310,24 +315,10 @@ GET https://www.pixiv.net/ajax/search/{Type}/{Content}?{Param...}
     }
 }
 ```
+> 注意：根据 Url 参数中 `Type` 的不同，返回数据的属性也会出现差异，  
+  详见字段说明下的【请求 Url 中的 Type 与返回数据中属性的关系】表格
+
 #### 字段说明 ####
-- `novel`: (`Object`) 小说搜索结果
-    - `data`: (`Object`) 搜索结果(仅当前页数)
-        - (待补充)
-    - `total`: (`number`) 搜索结果总量
-- `popular`: (`Object`) 受欢迎的搜索结果
-- `relatedTags`: (`string[]`) 与搜索结果相关的标签
-- `tagTranslation`: (`Object`) 相关标签的翻译信息
-    - `{Attr: 标签名}`: 标签名为属性名
-        - `语言名(例如 中文是 zh)`: (`string`) 标签翻译名
-- `zoneConfig`: (`Object`) 猜测是广告相关信息?
-- `extraData`: (`Object`) 扩展信息
-    - `meta`: (`Object`) 网页元数据
-        - `title`: (`string`) 网页标题
-        - `description`: 搜索结果说明内容
-        - `descriptionHeader`: (`string`) 说明内容的Html代码
-        - `alternateLanguages`: (`Object`) 不明链接?
-            - `{语言名}`: 对应语言的链接
 - `illustManga`: (`Object`) 漫画和插画的搜索结果
     - `total`: (`number`) 搜索结果总量
     - `data`: (`Object[]`) 搜索结果(仅当前页数)
@@ -362,4 +353,45 @@ GET https://www.pixiv.net/ajax/search/{Type}/{Content}?{Param...}
         - `createDate`: (`string`) 作品创建时间(或者是完成时间?)
         - `updateDate`: (`string`) 作品上传时间
         - `profileImageUrl`: (`string`) 作者用户头像图片链接
-        
+    - `bookmarkRanges`: (`Object[]`) 收藏数范围(推测是用于按收藏数搜索而使用)
+        - `min`: (`number`) 最小收藏数, 值为 `null` 则无限制
+        - `max`: (`number`) 最大收藏数, 值为 `null` 则无限制
+- `illust`: (`Object`) 插画作品搜索结果
+    - **与`illustManga`结构相同**
+- `manga`: (`Object`) 漫画作品搜索结果
+    - **与`illustManga`结构相同**
+- `novel`: (`Object`) 小说搜索结果
+    - **与`illustManga`结构相同**
+- `popular`: (`Object`) 受欢迎的搜索结果
+    - `recent`: (`Object[]`) 近期推荐
+        - **与`illustManga.data.{element}`结构相同**
+    - `permanent`: (`Object[]`) 旧作品推荐
+        - **与`illustManga.data.{element}`结构相同**
+- `relatedTags`: (`string[]`) 与搜索结果相关的原始标签名
+- `tagTranslation`: (`Object`) 相关标签的翻译信息
+    - `{Attr: 标签名}`: 标签名为属性名, 对应 `relatedTags` 中的原始标签名
+        - `语言名(例如 中文是 zh)`: (`string`) 标签翻译名
+- `zoneConfig`: (`Object`) 猜测是广告相关信息?
+- `extraData`: (`Object`) 扩展信息
+    - `meta`: (`Object`) 网页元数据
+        - `title`: (`string`) 网页标题
+        - `description`: 搜索结果说明内容
+        - `descriptionHeader`: (`string`) 说明内容的Html代码
+        - `alternateLanguages`: (`Object`) 不明链接?
+            - `{语言名}`: 对应语言的链接
+
+##### 请求 Url 中的 Type 与返回数据中属性的关系 #####
+> 表中数据可能有错误，如发现问题，可在发起 Issue 并附上不在该表中情况（例如）的请求信息和返回数据，经确认后将会更新文档。  
+
+类型|illustManga|illust|manga|novel
+:--|:-:|:-:|:-:|:-:
+`artworks`     |√|×|×|×
+`top`          |√|×|×|?
+`illustrations`|×|√|×|×
+`manga`        |×|×|√|×
+`novels`       |×|×|×|√
+
+符号解释:  
+- `√`: 该属性一定存在
+- `?`: 该属性可能存在
+- `×`: 该属性不存在

src/main/java/net/lamgc/cgj/Main.java

@@ -10,9 +10,7 @@ import net.lamgc.cgj.bot.boot.BotGlobal;
 import net.lamgc.cgj.bot.framework.cli.ConsoleMain;
 import net.lamgc.cgj.bot.framework.coolq.SpringCQApplication;
 import net.lamgc.cgj.bot.framework.mirai.MiraiMain;
-import net.lamgc.cgj.pixiv.PixivDownload;
-import net.lamgc.cgj.pixiv.PixivSearchLinkBuilder;
-import net.lamgc.cgj.pixiv.PixivURL;
+import net.lamgc.cgj.pixiv.*;
 import net.lamgc.utils.base.runner.Argument;
 import net.lamgc.utils.base.runner.ArgumentsRunner;
 import net.lamgc.utils.base.runner.Command;
@@ -182,18 +180,18 @@ public class Main {
         date = format.format(queryDate);
 
         log.info("查询时间: {}", date);
-        PixivURL.RankingMode rankingMode = PixivURL.RankingMode.MODE_DAILY;
-        PixivURL.RankingContentType contentType = null;
+        RankingMode rankingMode = RankingMode.MODE_DAILY;
+        RankingContentType contentType = null;
         if(mode != null) {
             try {
-                rankingMode = PixivURL.RankingMode.valueOf(mode);
+                rankingMode = RankingMode.valueOf(mode);
             } catch (IllegalArgumentException e) {
                 log.warn("不支持的RankingMode: {}", mode);
             }
         }
         if(content != null) {
             try {
-                contentType = PixivURL.RankingContentType.valueOf(content);
+                contentType = RankingContentType.valueOf(content);
             } catch (IllegalArgumentException e) {
                 log.warn("不支持的RankingContentType: {}", content);
             }
@@ -215,7 +213,8 @@ public class Main {
 
         log.info("正在调用方法...");
         try {
-            pixivDownload.getRankingAsInputStream(contentType, rankingMode, queryDate, range, PixivDownload.PageQuality.ORIGINAL, (rank, link, rankInfo, inputStream) -> {
+            pixivDownload.getRankingAsInputStream(contentType, rankingMode, queryDate, range,
+                    PixivDownload.PageQuality.ORIGINAL, (rank, link, rankInfo, inputStream) -> {
                 try {
                     ZipEntry entry = new ZipEntry("Rank" + rank + "-" + link.substring(link.lastIndexOf("/") + 1));
                     entry.setComment(rankInfo.toString());
@@ -301,35 +300,39 @@ public class Main {
 
         JsonObject resultBody = jsonObject.getAsJsonObject("body");
 
-        for(PixivSearchLinkBuilder.SearchArea searchArea : PixivSearchLinkBuilder.SearchArea.values()) {
-            if(!resultBody.has(searchArea.jsonKey) || resultBody.getAsJsonObject(searchArea.jsonKey).getAsJsonArray("data").size() == 0) {
-                //log.info("返回数据不包含 {}", searchArea.jsonKey);
-                continue;
-            }
-            JsonArray illustsArray = resultBody
-                    .getAsJsonObject(searchArea.jsonKey).getAsJsonArray("data");
-            log.info("已找到与 {} 相关插图信息({})：", content, searchArea.name().toLowerCase());
-            int count = 1;
-            for (JsonElement jsonElement : illustsArray) {
-                JsonObject illustObj = jsonElement.getAsJsonObject();
-                if(!illustObj.has("illustId")) {
+        for(PixivSearchAttribute attribute : PixivSearchAttribute.values()) {
+            for(String attrName : attribute.attributeNames) {
+                if(!resultBody.has(attrName) ||
+                        resultBody.getAsJsonObject(attrName).getAsJsonArray("data").size() == 0) {
+                    //log.info("返回数据不包含 {}", attrName);
                     continue;
                 }
-                int illustId = illustObj.get("illustId").getAsInt();
-                StringBuilder builder = new StringBuilder("[");
-                illustObj.get("tags").getAsJsonArray().forEach(el -> builder.append(el.getAsString()).append(", "));
-                builder.replace(builder.length() - 2, builder.length(), "]");
-                log.info("{} ({} / {})\n\t作品id: {}, \n\t作者名(作者id): {} ({}), \n\t作品标题: {}, \n\t作品Tags: {}, \n\t作品链接: {}",
-                        searchArea.name(),
-                        count++,
-                        illustsArray.size(),
-                        illustId,
-                        illustObj.get("userName").getAsString(),
-                        illustObj.get("userId").getAsInt(),
-                        illustObj.get("illustTitle").getAsString(),
-                        builder,
-                        PixivURL.getPixivRefererLink(illustId)
-                );
+                JsonArray illustsArray = resultBody
+                        .getAsJsonObject(attrName).getAsJsonArray("data");
+                log.info("已找到与 {} 相关插图信息({})：", content, attribute.name().toLowerCase());
+                int count = 1;
+                for (JsonElement jsonElement : illustsArray) {
+                    JsonObject illustObj = jsonElement.getAsJsonObject();
+                    if(!illustObj.has("illustId")) {
+                        continue;
+                    }
+                    int illustId = illustObj.get("illustId").getAsInt();
+                    StringBuilder builder = new StringBuilder("[");
+                    illustObj.get("tags").getAsJsonArray().forEach(el -> builder.append(el.getAsString()).append(", "));
+                    builder.replace(builder.length() - 2, builder.length(), "]");
+                    log.info("{} ({} / {})\n\t作品id: {}, \n\t作者名(作者id): {} ({}), " +
+                                    "\n\t作品标题: {}, \n\t作品Tags: {}, \n\t作品链接: {}",
+                            attribute.name(),
+                            count++,
+                            illustsArray.size(),
+                            illustId,
+                            illustObj.get("userName").getAsString(),
+                            illustObj.get("userId").getAsInt(),
+                            illustObj.get("illustTitle").getAsString(),
+                            builder,
+                            PixivURL.getPixivRefererLink(illustId)
+                    );
+                }
             }
         }
     }

src/main/java/net/lamgc/cgj/bot/BotAdminCommandProcess.java

@@ -9,7 +9,8 @@ import net.lamgc.cgj.bot.boot.BotGlobal;
 import net.lamgc.cgj.bot.message.MessageSenderBuilder;
 import net.lamgc.cgj.bot.message.MessageSource;
 import net.lamgc.cgj.pixiv.PixivDownload;
-import net.lamgc.cgj.pixiv.PixivURL;
+import net.lamgc.cgj.pixiv.RankingContentType;
+import net.lamgc.cgj.pixiv.RankingMode;
 import net.lamgc.utils.base.runner.Argument;
 import net.lamgc.utils.base.runner.Command;
 import org.slf4j.Logger;
@@ -118,16 +119,16 @@ public class BotAdminCommandProcess {
             return "排行榜范围选取错误！";
         }
 
-        PixivURL.RankingContentType type;
-        PixivURL.RankingMode mode;
+        RankingContentType type;
+        RankingMode mode;
         try {
-            type = PixivURL.RankingContentType.valueOf("TYPE_" + rankingContentType.toUpperCase());
+            type = RankingContentType.valueOf("TYPE_" + rankingContentType.toUpperCase());
         } catch(IllegalArgumentException e) {
             return "无效的排行榜类型参数！";
         }
 
         try {
-            mode = PixivURL.RankingMode.valueOf("MODE_" + rankingMode.toUpperCase());
+            mode = RankingMode.valueOf("MODE_" + rankingMode.toUpperCase());
         } catch(IllegalArgumentException e) {
             return "无效的排行榜模式参数！";
         }
@@ -225,10 +226,13 @@ public class BotAdminCommandProcess {
         } catch(NoSuchElementException ignored) {
         }
 
-        int rankingStart = setting.has(RANKING_SETTING_RANKING_START) ? setting.get(RANKING_SETTING_RANKING_START).getAsInt() : 1;
-        int rankingEnd = setting.has(RANKING_SETTING_RANKING_END) ? setting.get(RANKING_SETTING_RANKING_END).getAsInt() : 150;
-        PixivURL.RankingMode rankingMode = PixivURL.RankingMode.MODE_DAILY;
-        PixivURL.RankingContentType rankingContentType = PixivURL.RankingContentType.TYPE_ILLUST;
+        int rankingStart = setting.has(RANKING_SETTING_RANKING_START) ?
+                setting.get(RANKING_SETTING_RANKING_START).getAsInt() : 1;
+        int rankingEnd = setting.has(RANKING_SETTING_RANKING_END) ?
+                setting.get(RANKING_SETTING_RANKING_END).getAsInt() : 150;
+
+        RankingMode rankingMode = RankingMode.MODE_DAILY;
+        RankingContentType rankingContentType = RankingContentType.TYPE_ILLUST;
         PixivDownload.PageQuality pageQuality = PixivDownload.PageQuality.REGULAR;
 
         if(rankingStart <= 0 || rankingStart > 500) {
@@ -246,7 +250,7 @@ public class BotAdminCommandProcess {
         if(setting.has(RANKING_SETTING_RANKING_MODE)) {
             String value = setting.get(RANKING_SETTING_RANKING_MODE).getAsString().trim().toUpperCase();
             try {
-                rankingMode = PixivURL.RankingMode.valueOf(value.startsWith("MODE_") ? value : "MODE_" + value);
+                rankingMode = RankingMode.valueOf(value.startsWith("MODE_") ? value : "MODE_" + value);
             } catch(IllegalArgumentException e) {
                 log.warn("群组ID [{}] - 无效的RankingMode设定值, 将重置为默认值: {}", id, value);
             }
@@ -254,7 +258,7 @@ public class BotAdminCommandProcess {
         if(setting.has(RANKING_SETTING_RANKING_CONTENT_TYPE)) {
             String value = setting.get(RANKING_SETTING_RANKING_CONTENT_TYPE).getAsString().trim().toUpperCase();
             try {
-                rankingContentType = PixivURL.RankingContentType.valueOf(value.startsWith("TYPE_") ? value : "TYPE_" + value);
+                rankingContentType = RankingContentType.valueOf(value.startsWith("TYPE_") ? value : "TYPE_" + value);
             } catch(IllegalArgumentException e) {
                 log.warn("群组ID [{}] - 无效的RankingContentType设定值: {}", id, value);
             }
@@ -293,7 +297,10 @@ public class BotAdminCommandProcess {
      * @throws NoSuchElementException 当这个群号没有定时器的时候抛出异常
      */
     @Command
-    public static String removePushGroup(@Argument(name = "$fromGroup") long fromGroup, @Argument(name = "group", force = false) long id) {
+    public static String removePushGroup(
+            @Argument(name = "$fromGroup") long fromGroup,
+            @Argument(name = "group", force = false) long id
+    ) {
         long group = id <= 0 ? fromGroup : id;
         RandomIntervalSendTimer.getTimerById(group).destroy();
         pushInfoMap.remove(group);
@@ -324,7 +331,8 @@ public class BotAdminCommandProcess {
             log.debug("{} - Report: {}", illustIdStr, report);
             String reason = report.get("reason").isJsonNull() ? "" : report.get("reason").getAsString();
             msgBuilder.append(count).append(". 作品Id: ").append(illustIdStr)
-                    .append("(").append(dateFormat.format(new Date(report.get("reportTime").getAsLong()))).append(")：\n")
+                    .append("(").append(
+                            dateFormat.format(new Date(report.get("reportTime").getAsLong()))).append(")：\n")
                     .append("报告者QQ：").append(report.get("fromQQ").getAsLong()).append("\n")
                     .append("报告所在群：").append(report.get("fromGroup").getAsLong()).append("\n")
                     .append("报告原因：\n").append(reason).append("\n");

src/main/java/net/lamgc/cgj/bot/BotCommandProcess.java

@@ -11,10 +11,9 @@ import net.lamgc.cgj.bot.cache.JsonRedisCacheStore;
 import net.lamgc.cgj.bot.event.BufferedMessageSender;
 import net.lamgc.cgj.bot.sort.PreLoadDataAttribute;
 import net.lamgc.cgj.bot.sort.PreLoadDataAttributeComparator;
-import net.lamgc.cgj.pixiv.PixivDownload;
+import net.lamgc.cgj.pixiv.*;
 import net.lamgc.cgj.pixiv.PixivDownload.PageQuality;
-import net.lamgc.cgj.pixiv.PixivSearchLinkBuilder;
-import net.lamgc.cgj.pixiv.PixivURL;
+import net.lamgc.cgj.util.PixivUtils;
 import net.lamgc.utils.base.runner.Argument;
 import net.lamgc.utils.base.runner.Command;
 import org.slf4j.Logger;
@@ -40,6 +39,8 @@ public class BotCommandProcess {
 
     private final static RankingUpdateTimer updateTimer = new RankingUpdateTimer();
 
+    private final static int SEARCH_PAGE_MAX_ITEM = 60;
+
     public static void initialize() {
         log.info("正在初始化...");
 
@@ -142,9 +143,14 @@ public class BotCommandProcess {
             @Argument(name = "$fromGroup") long fromGroup,
             @Argument(force = false, name = "date") Date queryTime,
             @Argument(force = false, name = "force") boolean force,
-            @Argument(force = false, name = "mode", defaultValue = "DAILY") String contentMode,
-            @Argument(force = false, name = "type", defaultValue = "ALL") String contentType
+            @Argument(force = false, name = "mode", defaultValue = "DAILY") RankingMode contentMode,
+            @Argument(force = false, name = "type", defaultValue = "ALL") RankingContentType contentType,
+            @Argument(force = false, name = "p", defaultValue = "1") int pageIndex
     ) throws InterruptedException {
+        if(pageIndex <= 0) {
+            return "色图姬找不到指定页数的排行榜!";
+        }
+
         Date queryDate = queryTime;
         if (queryDate == null) {
             queryDate = new Date();
@@ -164,33 +170,13 @@ public class BotCommandProcess {
             }
         }
 
-        PixivURL.RankingMode mode;
-        try {
-            String rankingModeValue = contentMode.toUpperCase();
-            mode = PixivURL.RankingMode.valueOf(rankingModeValue.startsWith("MODE_") ?
-                    rankingModeValue : "MODE_" + rankingModeValue);
-        } catch (IllegalArgumentException e) {
-            log.warn("无效的RankingMode值: {}", contentMode);
-            return "参数无效, 请查看帮助信息";
-        }
-
-        PixivURL.RankingContentType type;
-        try {
-            String contentTypeValue = contentType.toUpperCase();
-            type = PixivURL.RankingContentType.valueOf(
-                    contentTypeValue.startsWith("TYPE_") ? contentTypeValue : "TYPE_" + contentTypeValue);
-        } catch (IllegalArgumentException e) {
-            log.warn("无效的RankingContentType值: {}", contentType);
-            return "参数无效, 请查看帮助信息";
-        }
-
-        if(!type.isSupportedMode(mode)) {
+        if(!contentType.isSupportedMode(contentMode)) {
             log.warn("RankingContentType不支持指定的RankingMode.(ContentType: {}, RankingMode: {})",
-                    type.name(), mode.name());
+                    contentType.name(), contentMode.name());
             return "不支持的内容类型或模式!";
         }
 
-        StringBuilder resultBuilder = new StringBuilder(mode.name() + " - 以下是 ")
+        StringBuilder resultBuilder = new StringBuilder(contentMode.name() + " - 以下是 ")
                 .append(new SimpleDateFormat("yyyy-MM-dd").format(queryDate)).append(" 的Pixiv插画排名榜前十名：\n");
         try {
             int index = 0;
@@ -212,8 +198,10 @@ public class BotCommandProcess {
                 log.warn("配置项 {} 的参数值格式有误!", imageLimitPropertyKey);
             }
 
+            int startsIndex = itemLimit * pageIndex - (itemLimit - 1);
             List<JsonObject> rankingInfoList = CacheStoreCentral.getCentral()
-                    .getRankingInfoByCache(type, mode, queryDate, 1, Math.max(0, itemLimit), false);
+                    .getRankingInfoByCache(contentType, contentMode, queryDate,
+                            Math.max(1, startsIndex), Math.max(0, itemLimit), false);
             if(rankingInfoList.isEmpty()) {
                 return "无法查询排行榜，可能排行榜尚未更新。";
             }
@@ -232,7 +220,7 @@ public class BotCommandProcess {
                 if (index <= imageLimit) {
                     resultBuilder
                             .append(CacheStoreCentral.getCentral()
-                                    .getImageById(fromGroup, illustId, PixivDownload.PageQuality.REGULAR, 1))
+                                    .getImageById(fromGroup, illustId, PageQuality.REGULAR, 1))
                             .append("\n");
                 }
             }
@@ -262,20 +250,20 @@ public class BotCommandProcess {
             @Argument(name = "$fromGroup") long fromGroup,
             @Argument(force = false, name = "mode", defaultValue = "DAILY") String contentMode,
             @Argument(force = false, name = "type", defaultValue = "ILLUST") String contentType) {
-        PixivURL.RankingMode mode;
+        RankingMode mode;
         try {
             String rankingModeValue = contentMode.toUpperCase();
-            mode = PixivURL.RankingMode.valueOf(rankingModeValue.startsWith("MODE_") ?
+            mode = RankingMode.valueOf(rankingModeValue.startsWith("MODE_") ?
                     rankingModeValue : "MODE_" + rankingModeValue);
         } catch (IllegalArgumentException e) {
             log.warn("无效的RankingMode值: {}", contentMode);
             return "参数无效, 请查看帮助信息";
         }
 
-        PixivURL.RankingContentType type;
+        RankingContentType type;
         try {
             String contentTypeValue = contentType.toUpperCase();
-            type = PixivURL.RankingContentType.valueOf(
+            type = RankingContentType.valueOf(
                     contentTypeValue.startsWith("TYPE_") ? contentTypeValue : "TYPE_" + contentTypeValue);
         } catch (IllegalArgumentException e) {
             log.warn("无效的RankingContentType值: {}", contentType);
@@ -314,12 +302,9 @@ public class BotCommandProcess {
             @Argument(name = "option", force = false) String contentOption,
             @Argument(name = "p", force = false, defaultValue = "1") int pagesIndex
     ) throws IOException, InterruptedException {
+        PixivSearchLinkBuilder searchLinkBuilder = PixivUtils.buildSearchLinkBuilderFromString(content, type, area,
+                        includeKeywords, excludeKeywords, contentOption, pagesIndex);
         log.debug("正在执行搜索...");
-        JsonObject resultBody = CacheStoreCentral.getCentral()
-                .getSearchBody(content, type, area, includeKeywords, excludeKeywords, contentOption, pagesIndex);
-
-        StringBuilder result = new StringBuilder("内容 " + content + " 的搜索结果：\n");
-        log.debug("正在处理信息...");
         int limit = 8;
         try {
             limit = Integer.parseInt(SettingProperties.
@@ -327,95 +312,112 @@ public class BotCommandProcess {
         } catch (Exception e) {
             log.warn("参数转换异常!将使用默认值(" + limit + ")", e);
         }
+
         int totalCount = 0;
-        for (PixivSearchLinkBuilder.SearchArea searchArea : PixivSearchLinkBuilder.SearchArea.values()) {
-            if (!resultBody.has(searchArea.jsonKey) ||
-                    resultBody.getAsJsonObject(searchArea.jsonKey).getAsJsonArray("data").size() == 0) {
-                log.debug("返回数据不包含 {}", searchArea.jsonKey);
-                continue;
-            }
-            JsonArray illustsArray = resultBody
-                    .getAsJsonObject(searchArea.jsonKey).getAsJsonArray("data");
-            ArrayList<JsonElement> illustsList = new ArrayList<>();
-            illustsArray.forEach(illustsList::add);
-            illustsList.sort(new PreLoadDataAttributeComparator(PreLoadDataAttribute.BOOKMARK));
+        StringBuilder result = new StringBuilder("内容 " + content + " 的搜索结果：\n");
+        List<JsonObject> artworkList = getSearchResult(searchLinkBuilder, fromGroup, limit, pagesIndex);
+        artworkList.sort(new PreLoadDataAttributeComparator(PreLoadDataAttribute.LIKE));
+        int startIndex = limit * pagesIndex - limit + 1;
+        int pageStartIndex = startIndex % SEARCH_PAGE_MAX_ITEM;
+        for(int index = pageStartIndex; totalCount < limit && index < artworkList.size(); index++) {
+            int illustId = artworkList.get(index - 1).get("illustId").getAsInt();
+            // 预加载数据有更多信息可以提供
+            JsonObject artworkPreLoadData = CacheStoreCentral.getCentral()
+                    .getIllustPreLoadData(illustId, false);
 
-            log.debug("已找到与 {} 相关插图信息({})：", content, searchArea.name().toLowerCase());
-            int count = 1;
-            for (JsonElement jsonElement : illustsList) {
-                if (count > limit) {
-                    break;
-                }
-                JsonObject illustObj = jsonElement.getAsJsonObject();
-                if (!illustObj.has("illustId")) {
-                    continue;
-                }
-                int illustId = illustObj.get("illustId").getAsInt();
-                StringBuilder builder = new StringBuilder("[");
-                illustObj.get("tags").getAsJsonArray().forEach(el -> builder.append(el.getAsString()).append(", "));
-                builder.replace(builder.length() - 2, builder.length(), "]");
-                log.debug("{} ({} / {})\n\t作品id: {}, \n\t作者名(作者id): {} ({}), \n\t" +
-                                "作品标题: {}, \n\t作品Tags: {}, \n\t页数: {}页, \n\t作品链接: {}",
-                        searchArea.name(),
-                        count,
-                        illustsList.size(),
-                        illustId,
-                        illustObj.get("userName").getAsString(),
-                        illustObj.get("userId").getAsInt(),
-                        illustObj.get("illustTitle").getAsString(),
-                        builder,
-                        illustObj.get("pageCount").getAsInt(),
-                        PixivURL.getPixivRefererLink(illustId)
-                );
-
-                String imageMsg;
-                try {
-                    imageMsg = CacheStoreCentral.getCentral()
-                            .getImageById(fromGroup, illustId, PixivDownload.PageQuality.REGULAR, 1);
-                } catch (NoSuchElementException e) {
-                    if(e.getMessage().startsWith("No work found: ")) {
-                        log.warn("作品 {} 不存在, 跳过该作品...", illustId);
-                        continue;
-                    }
-                    throw e;
-                }
-                if (isNoSafe(illustId, SettingProperties.getProperties(fromGroup), false)) {
-                    log.warn("作品Id {} 为R-18作品, 跳过.", illustId);
-                    continue;
-                } else if(isReported(illustId)) {
-                    log.warn("作品Id {} 被报告, 正在等待审核, 跳过该作品.", illustId);
-                    continue;
-                }
-
-                JsonObject illustPreLoadData = CacheStoreCentral.getCentral()
-                        .getIllustPreLoadData(illustId, false);
-                result.append(searchArea.name()).append(" (").append(count).append(" / ")
-                        .append(limit).append(")\n\t作品id: ").append(illustId)
-                        .append(", \n\t作者名: ").append(illustObj.get("userName").getAsString())
-                        .append("\n\t作品标题: ").append(illustObj.get("illustTitle").getAsString())
-                        .append("\n\t作品页数: ").append(illustObj.get("pageCount").getAsInt()).append("页")
-                        .append("\n\t点赞数：")
-                        .append(illustPreLoadData.get(PreLoadDataAttribute.LIKE.attrName).getAsInt())
-                        .append("\n\t收藏数：")
-                        .append(illustPreLoadData.get(PreLoadDataAttribute.BOOKMARK.attrName).getAsInt())
-                        .append("\n\t围观数：")
-                        .append(illustPreLoadData.get(PreLoadDataAttribute.VIEW.attrName).getAsInt())
-                        .append("\n\t评论数：")
-                        .append(illustPreLoadData.get(PreLoadDataAttribute.COMMENT.attrName).getAsInt())
-                        .append("\n").append(imageMsg).append("\n");
-                count++;
-                totalCount++;
-            }
-            if (count > limit) {
-                break;
-            }
+            // 构造消息内容
+            result.append(startIndex++).append(". （").append(artworkPreLoadData.get("illustId").getAsInt()).append("） ")
+                    .append(artworkPreLoadData.get("illustTitle").getAsString());
+            result.append("\n\t").append("作者：").append(artworkPreLoadData.get("userName").getAsString());
+            result.append("\n\t").append("作品页数：").append(artworkPreLoadData.get("pageCount").getAsInt()).append(" 页");
+            result.append("\n\t").append("点赞数：")
+                    .append(artworkPreLoadData.get(PreLoadDataAttribute.LIKE.attrName).getAsInt()).append(" 页");
+            result.append("\n\t").append("收藏数：")
+                    .append(artworkPreLoadData.get(PreLoadDataAttribute.BOOKMARK.attrName).getAsInt()).append(" 页");
+            result.append("\n\t").append("围观数：")
+                    .append(artworkPreLoadData.get(PreLoadDataAttribute.VIEW.attrName).getAsInt()).append(" 页");
+            result.append("\n\t").append("评论数：")
+                    .append(artworkPreLoadData.get(PreLoadDataAttribute.COMMENT.attrName).getAsInt()).append(" 页");
+            result.append(CacheStoreCentral.getCentral()
+                    .getImageById(fromGroup, illustId, PageQuality.REGULAR, 1)).append("\n");
+            totalCount++;
         }
+
         return totalCount <= 0 ?
                 "搜索完成，未找到相关作品。" :
                 Strings.nullToEmpty(result.toString()) + "预览图片并非原图，使用“.cgj image -id 作品id”获取原图\n" +
                 "如有不当作品，可使用\".cgj report -id 作品id\"向色图姬反馈。";
     }
 
+    /**
+     * 获取 length 涉及的多个页的搜索结果.
+     * 例如:
+     *  pageMaxItem = 60;
+     *  length = 150;
+     *  page = 3;
+     * 那么:
+     *  endItemIndex = length * page = 450;
+     *  startItemIndex = endItemIndex - length + 1 = 301;
+     *  startPageIndex = ceil(startItemIndex / pageMaxItem) = 6;
+     *  pageRange = ceil((endItemIndex - length + 1) / pageMaxItem) = 3;
+     *  endPageIndex = startPageIndex - pageRange - 1 = 8;
+     * 该方法将会取搜索结果的 6 ~ 8 页结果并返回;
+     * @param searchLinkBuilder 已构造好除 Page 参数外其他参数的 {@link PixivSearchLinkBuilder}
+     * @param length 所需结果的范围
+     * @param page 所需结果的页数
+     * @return 返回包含范围的涉及页面所有搜索结果.
+     * @throws IOException 如获取发生异常则抛出.
+     */
+    private static List<JsonObject> getSearchResult(PixivSearchLinkBuilder searchLinkBuilder, long groupId, int length, int page) throws IOException {
+        List<JsonObject> artworkList = new ArrayList<>(length);
+
+        int endsItemIndex = length * page;
+        int startsItemIndex = endsItemIndex - length + 1;
+        int startPageIndex = (int) Math.ceil(startsItemIndex / (double) SEARCH_PAGE_MAX_ITEM);
+        int pageRange = (int) Math.ceil((endsItemIndex - startsItemIndex) / (double) SEARCH_PAGE_MAX_ITEM);
+        PixivSearchAttribute areaAttribute = PixivSearchAttribute.valueOf(searchLinkBuilder.getSearchArea().toString());
+        Properties properties = SettingProperties.getProperties(groupId);
+        int expectedQuantity = pageRange * SEARCH_PAGE_MAX_ITEM;
+        for(int pageIndex = startPageIndex;
+            pageIndex <= startPageIndex + pageRange - 1 || artworkList.size() < length || artworkList.size() < expectedQuantity;
+            pageIndex++) {
+            searchLinkBuilder.setPage(pageIndex);
+            JsonObject searchBody = CacheStoreCentral.getCentral().getSearchBody(searchLinkBuilder);
+            for(String areaAttributeName : areaAttribute.attributeNames) {
+                JsonObject areaResult = searchBody.getAsJsonObject(areaAttributeName);
+                if(areaResult == null || !areaResult.has("data")) {
+                    log.debug("作品类型属性 {} 无搜索结果, 跳过...", areaAttributeName);
+                    continue;
+                }
+
+                JsonArray areaArray = areaResult.getAsJsonArray("data");
+                for(JsonElement element : areaArray) {
+                    JsonObject artworkInfo = element.getAsJsonObject();
+                    if(!artworkInfo.has("illustId")) {
+                        log.warn("发现未含有illustId的JsonObject: '{}'", artworkInfo.toString());
+                        continue;
+                    }
+                    final int illustId = artworkInfo.get("illustId").getAsInt();
+                    if(isNoSafe(illustId, properties, false)) {
+                        log.warn("作品 {} 为R18作品, 跳过.", illustId);
+                        continue;
+                    } else if(isReported(illustId)) {
+                        log.warn("作品 {} 被报告, 跳过.", illustId);
+                        continue;
+                    }
+                    artworkList.add(artworkInfo);
+                }
+            }
+        }
+
+        // 去重
+        Set<JsonObject> hashSet = new HashSet<>(artworkList.size());
+        hashSet.addAll(artworkList);
+        artworkList.clear();
+        artworkList.addAll(hashSet);
+        return artworkList;
+    }
+
     /**
      * 获取作品页面的下载链接
      * @param illustId 作品Id

src/main/java/net/lamgc/cgj/bot/RandomRankingArtworksSender.java

@@ -4,7 +4,8 @@ import com.google.gson.JsonObject;
 import net.lamgc.cgj.bot.cache.CacheStoreCentral;
 import net.lamgc.cgj.bot.message.MessageSender;
 import net.lamgc.cgj.pixiv.PixivDownload;
-import net.lamgc.cgj.pixiv.PixivURL;
+import net.lamgc.cgj.pixiv.RankingContentType;
+import net.lamgc.cgj.pixiv.RankingMode;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -22,8 +23,8 @@ public class RandomRankingArtworksSender extends AutoSender {
     private final long groupId;
     private final int rankingStart;
     private final int rankingStop;
-    private final PixivURL.RankingMode mode;
-    private final PixivURL.RankingContentType contentType;
+    private final RankingMode mode;
+    private final RankingContentType contentType;
     private final PixivDownload.PageQuality quality;
 
     /**
@@ -40,8 +41,8 @@ public class RandomRankingArtworksSender extends AutoSender {
             MessageSender messageSender,
             int rankingStart,
             int rankingStop,
-            PixivURL.RankingMode mode,
-            PixivURL.RankingContentType contentType,
+            RankingMode mode,
+            RankingContentType contentType,
             PixivDownload.PageQuality quality) {
         this(messageSender, 0, rankingStart, rankingStop, mode, contentType, quality);
     }
@@ -62,8 +63,8 @@ public class RandomRankingArtworksSender extends AutoSender {
             long groupId,
             int rankingStart,
             int rankingStop,
-            PixivURL.RankingMode mode,
-            PixivURL.RankingContentType contentType,
+            RankingMode mode,
+            RankingContentType contentType,
             PixivDownload.PageQuality quality) {
         super(messageSender);
         this.groupId = groupId;
@@ -73,7 +74,8 @@ public class RandomRankingArtworksSender extends AutoSender {
         this.rankingStart = rankingStart > 0 ? rankingStart : 1;
         this.rankingStop = rankingStop > 0 ? rankingStop : 150;
         if(this.rankingStart > this.rankingStop) {
-            throw new IndexOutOfBoundsException("rankingStart=" + this.rankingStart + ", rankingStop=" + this.rankingStop);
+            throw new IndexOutOfBoundsException(
+                    "rankingStart=" + this.rankingStart + ", rankingStop=" + this.rankingStop);
         }
         this.quality = quality == null ? PixivDownload.PageQuality.REGULAR : quality;
     }

src/main/java/net/lamgc/cgj/bot/RankingUpdateTimer.java

@@ -2,7 +2,8 @@ package net.lamgc.cgj.bot;
 
 import net.lamgc.cgj.bot.event.BotEventHandler;
 import net.lamgc.cgj.bot.event.VirtualLoadMessageEvent;
-import net.lamgc.cgj.pixiv.PixivURL;
+import net.lamgc.cgj.pixiv.RankingContentType;
+import net.lamgc.cgj.pixiv.RankingMode;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -64,14 +65,15 @@ public class RankingUpdateTimer {
 
         String dateStr = new SimpleDateFormat("yyyy-MM-dd").format(calendar.getTime());
         log.info("正在获取 {} 期排行榜数据...", calendar.getTime());
-        for (PixivURL.RankingMode rankingMode : PixivURL.RankingMode.values()) {
-            for (PixivURL.RankingContentType contentType : PixivURL.RankingContentType.values()) {
+        for (RankingMode rankingMode : RankingMode.values()) {
+            for (RankingContentType contentType : RankingContentType.values()) {
                 if(!contentType.isSupportedMode(rankingMode)) {
                     log.debug("不支持的类型, 填空值跳过...(类型: {}.{})", rankingMode.name(), contentType.name());
                 }
                 log.info("当前排行榜类型: {}.{}, 正在更新...", rankingMode.name(), contentType.name());
                 BotEventHandler.executeMessageEvent(new VirtualLoadMessageEvent(0,0,
-                                ".cgj ranking -type=" + contentType.name() + " -mode=" + rankingMode.name() + " -force -date " + dateStr));
+                                ".cgj ranking -type=" + contentType.name() +
+                                        " -mode=" + rankingMode.name() + " -force -date " + dateStr));
                 log.info("排行榜 {}.{} 负载指令已投递.", rankingMode.name(), contentType.name());
             }
         }

src/main/java/net/lamgc/cgj/bot/cache/CacheStoreCentral.java

@@ -11,7 +11,8 @@ import net.lamgc.cgj.bot.boot.BotGlobal;
 import net.lamgc.cgj.exception.HttpRequestException;
 import net.lamgc.cgj.pixiv.PixivDownload;
 import net.lamgc.cgj.pixiv.PixivSearchLinkBuilder;
-import net.lamgc.cgj.pixiv.PixivURL;
+import net.lamgc.cgj.pixiv.RankingContentType;
+import net.lamgc.cgj.pixiv.RankingMode;
 import net.lamgc.cgj.util.Locker;
 import net.lamgc.cgj.util.LockerMap;
 import net.lamgc.cgj.util.URLs;
@@ -124,7 +125,8 @@ public final class CacheStoreCentral {
      * @param pageIndex 指定页面索引, 从1开始
      * @return 如果成功, 返回BotCode, 否则返回错误信息.
      */
-    public String getImageById(long fromGroup, int illustId, PixivDownload.PageQuality quality, int pageIndex) throws InterruptedException {
+    public String getImageById(long fromGroup, int illustId, PixivDownload.PageQuality quality, int pageIndex)
+            throws InterruptedException {
         log.debug("IllustId: {}, Quality: {}, PageIndex: {}", illustId, quality.name(), pageIndex);
         if(pageIndex <= 0) {
             log.warn("指定的页数不能小于或等于0: {}", pageIndex);
@@ -354,9 +356,9 @@ public final class CacheStoreCentral {
      * @return 成功返回有值List, 失败且无异常返回空
      * @throws IOException 获取异常时抛出
      */
-    public List<JsonObject> getRankingInfoByCache(PixivURL.RankingContentType contentType,
-                                                         PixivURL.RankingMode mode,
-                                                         Date queryDate, int start, int range, boolean flushCache)
+    public List<JsonObject> getRankingInfoByCache(RankingContentType contentType,
+                                                  RankingMode mode,
+                                                  Date queryDate, int start, int range, boolean flushCache)
             throws IOException {
         if(!contentType.isSupportedMode(mode)) {
             log.warn("试图获取不支持的排行榜类型已拒绝.(ContentType: {}, RankingMode: {})", contentType.name(), mode.name());
@@ -402,84 +404,29 @@ public final class CacheStoreCentral {
             result = rankingCache.getCache(requestSign, start - 1, range);
             log.trace("RequestSign [{}] 缓存命中.", requestSign);
         }
-        return PixivDownload.getRanking(result, start - 1, range);
+        return result;
     }
 
     /**
      * 获取搜索结果
-     * @param content 搜索内容
-     * @param type 类型
-     * @param area 范围
-     * @param includeKeywords 包含关键词
-     * @param excludeKeywords 排除关键词
-     * @param contentOption 内容类型
+     * @param searchBuilder 需要执行搜索的搜索链接构造器
      * @return 返回完整搜索结果
      * @throws IOException 当请求发生异常, 或接口返回异常信息时抛出.
      */
-    public JsonObject getSearchBody(
-            String content,
-            String type,
-            String area,
-            String includeKeywords,
-            String excludeKeywords,
-            String contentOption,
-            int pageIndex
-    ) throws IOException {
-        PixivSearchLinkBuilder searchBuilder = new PixivSearchLinkBuilder(Strings.isNullOrEmpty(content) ? "" : content);
-        if (type != null) {
-            try {
-                searchBuilder.setSearchType(PixivSearchLinkBuilder.SearchType.valueOf(type.toUpperCase()));
-            } catch (IllegalArgumentException e) {
-                log.warn("不支持的SearchType: {}", type);
-            }
-        }
-        if (area != null) {
-            try {
-                searchBuilder.setSearchArea(PixivSearchLinkBuilder.SearchArea.valueOf(area));
-            } catch (IllegalArgumentException e) {
-                log.warn("不支持的SearchArea: {}", area);
-            }
-        }
-        if (contentOption != null) {
-            try {
-                searchBuilder.setSearchContentOption(
-                        PixivSearchLinkBuilder.SearchContentOption.valueOf(contentOption.trim().toUpperCase()));
-            } catch (IllegalArgumentException e) {
-                log.warn("不支持的SearchContentOption: {}", contentOption);
-            }
-        }
-
-        if (!Strings.isNullOrEmpty(includeKeywords)) {
-            for (String keyword : includeKeywords.split(";")) {
-                searchBuilder.removeExcludeKeyword(keyword.trim());
-                searchBuilder.addIncludeKeyword(keyword.trim());
-                log.trace("已添加关键字: {}", keyword);
-            }
-        }
-        if (!Strings.isNullOrEmpty(excludeKeywords)) {
-            for (String keyword : excludeKeywords.split(";")) {
-                searchBuilder.removeIncludeKeyword(keyword.trim());
-                searchBuilder.addExcludeKeyword(keyword.trim());
-                log.trace("已添加排除关键字: {}", keyword);
-            }
-        }
-
-        if(pageIndex > 0) {
-            searchBuilder.setPage(pageIndex);
-        }
-
+    public JsonObject getSearchBody(PixivSearchLinkBuilder searchBuilder) throws IOException {
         log.debug("正在搜索作品, 条件: {}", searchBuilder.getSearchCondition());
-
-        Locker<String> locker
-                = buildSyncKey(searchBuilder.buildURL());
-        String requestUrl = locker.getKey();
+        String requestUrl = searchBuilder.buildURL();
+        String searchIdentify =
+                requestUrl.substring(requestUrl.lastIndexOf("/", requestUrl.lastIndexOf("/") - 1) + 1);
+        Locker<String> locker =
+                buildSyncKey(searchIdentify);
         log.debug("RequestUrl: {}", requestUrl);
         JsonObject resultBody = null;
-        if(!searchBodyCache.exists(requestUrl)) {
+        if(!searchBodyCache.exists(searchIdentify)) {
             try {
                 locker.lock();
                 synchronized (locker) {
-                    if (!searchBodyCache.exists(requestUrl)) {
+                    if (!searchBodyCache.exists(searchIdentify)) {
                         log.trace("searchBody缓存失效, 正在更新...");
                         JsonObject jsonObject;
                         HttpGet httpGetRequest = BotGlobal.getGlobal().getPixivDownload().
@@ -504,8 +451,8 @@ public final class CacheStoreCentral {
                         } catch (Exception e) {
                             log.warn("全局配置项 \"{}\" 值非法, 已使用默认值: {}", propValue, expire);
                         }
-                        resultBody = jsonObject.getAsJsonObject().getAsJsonObject("body");
-                        searchBodyCache.update(requestUrl, jsonObject, expire);
+                        resultBody = jsonObject;
+                        searchBodyCache.update(searchIdentify, jsonObject, expire);
                         log.trace("searchBody缓存已更新(有效时间: {})", expire);
                     } else {
                         log.trace("搜索缓存命中.");
@@ -519,9 +466,9 @@ public final class CacheStoreCentral {
         }
 
         if(Objects.isNull(resultBody)) {
-            resultBody = searchBodyCache.getCache(requestUrl).getAsJsonObject().getAsJsonObject("body");
+            resultBody = searchBodyCache.getCache(searchIdentify).getAsJsonObject();
         }
-        return resultBody;
+        return resultBody.getAsJsonObject("body");
     }
 
     protected ImageChecksum getImageChecksum(int illustId, int pageIndex) {

src/main/java/net/lamgc/cgj/bot/event/BotEventHandler.java

@@ -7,17 +7,18 @@ import net.lamgc.cgj.bot.BotAdminCommandProcess;
 import net.lamgc.cgj.bot.BotCommandProcess;
 import net.lamgc.cgj.bot.MessageEventExecutionDebugger;
 import net.lamgc.cgj.bot.SettingProperties;
-import net.lamgc.cgj.util.DateParser;
-import net.lamgc.cgj.util.PagesQualityParser;
+import net.lamgc.cgj.bot.util.parser.DateParser;
+import net.lamgc.cgj.bot.util.parser.PagesQualityParser;
+import net.lamgc.cgj.bot.util.parser.RankingContentTypeParser;
+import net.lamgc.cgj.bot.util.parser.RankingModeParser;
 import net.lamgc.cgj.util.TimeLimitThreadPoolExecutor;
 import net.lamgc.utils.base.runner.ArgumentsRunner;
 import net.lamgc.utils.base.runner.ArgumentsRunnerConfig;
 import net.lamgc.utils.base.runner.exception.DeveloperRunnerException;
 import net.lamgc.utils.base.runner.exception.NoSuchCommandException;
 import net.lamgc.utils.base.runner.exception.ParameterNoFoundException;
-import net.lamgc.utils.event.*;
 import net.lamgc.utils.event.EventObject;
-
+import net.lamgc.utils.event.*;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -70,7 +71,13 @@ public class BotEventHandler implements EventHandler {
         executor.setEventUncaughtExceptionHandler(new EventUncaughtExceptionHandler() {
             private final Logger log = LoggerFactory.getLogger(this.getClass());
             @Override
-            public void exceptionHandler(Thread executeThread, EventHandler handler, Method handlerMethod, EventObject event, Throwable cause) {
+            public void exceptionHandler(
+                    Thread executeThread,
+                    EventHandler handler,
+                    Method handlerMethod,
+                    EventObject event,
+                    Throwable cause
+            ) {
                 log.error("EventExecutor@{} 发生未捕获异常:\n\t" +
                                 "Thread:{}\n\tEventHandler: {}\n\tHandlerMethod: {}\n\tEventObject: {}\n" +
                         "------------------ Stack Trace ------------------\n{}",
@@ -103,8 +110,11 @@ public class BotEventHandler implements EventHandler {
         ArgumentsRunnerConfig runnerConfig = new ArgumentsRunnerConfig();
         runnerConfig.setUseDefaultValueInsteadOfException(true);
         runnerConfig.setCommandIgnoreCase(true);
+
         runnerConfig.addStringParameterParser(new DateParser(new SimpleDateFormat("yyyy-MM-dd")));
         runnerConfig.addStringParameterParser(new PagesQualityParser());
+        runnerConfig.addStringParameterParser(new RankingModeParser());
+        runnerConfig.addStringParameterParser(new RankingContentTypeParser());
 
         processRunner = new ArgumentsRunner(BotCommandProcess.class, runnerConfig);
         adminRunner = new ArgumentsRunner(BotAdminCommandProcess.class, runnerConfig);
@@ -137,7 +147,8 @@ public class BotEventHandler implements EventHandler {
         if(!event.getMessage().startsWith(ADMIN_COMMAND_PREFIX) &&
                 !Strings.isNullOrEmpty(debuggerName)) {
             try {
-                MessageEventExecutionDebugger debugger = MessageEventExecutionDebugger.valueOf(debuggerName.toUpperCase());
+                MessageEventExecutionDebugger debugger =
+                        MessageEventExecutionDebugger.valueOf(debuggerName.toUpperCase());
                 debugger.debugger.accept(executor, event, SettingProperties.getProperties(SettingProperties.GLOBAL),
                         MessageEventExecutionDebugger.getDebuggerLogger(debugger));
             } catch(IllegalArgumentException e) {
@@ -154,6 +165,9 @@ public class BotEventHandler implements EventHandler {
         }
     }
 
+    private final static Pattern MESSAGE_PATTERN =
+            Pattern.compile("/\\s*(\".+?\"|[^:\\s])+((\\s*:\\s*(\".+?\"|[^\\s])+)|)|(\".+?\"|[^\"\\s])+");
+
     /**
      * 以事件形式处理消息事件
      * @param event 消息事件对象
@@ -166,8 +180,7 @@ public class BotEventHandler implements EventHandler {
             return;
         }
 
-        Pattern pattern = Pattern.compile("/\\s*(\".+?\"|[^:\\s])+((\\s*:\\s*(\".+?\"|[^\\s])+)|)|(\".+?\"|[^\"\\s])+");
-        Matcher matcher = pattern.matcher(Strings.nullToEmpty(msg));
+        Matcher matcher = MESSAGE_PATTERN.matcher(Strings.nullToEmpty(msg));
         List<String> argsList = new ArrayList<>();
         while (matcher.find()) {
             String arg = matcher.group();
@@ -197,6 +210,7 @@ public class BotEventHandler implements EventHandler {
         args = Arrays.copyOf(args, args.length + 4);
         argsList.toArray(args);
 
+        String[] runnerArguments = args.length <= 1 ? new String[0] : Arrays.copyOfRange(args, 1, args.length);
         log.info("正在处理命令...");
         long time = System.currentTimeMillis();
         Object result;
@@ -206,10 +220,10 @@ public class BotEventHandler implements EventHandler {
                         .equals(SettingProperties.getProperty(0, "admin.adminId"))) {
                     result = "你没有执行该命令的权限！";
                 } else {
-                    result = adminRunner.run(args.length <= 1 ? new String[0] : Arrays.copyOfRange(args, 1, args.length));
+                    result = adminRunner.run(runnerArguments);
                 }
             } else {
-                result = processRunner.run(args.length <= 1 ? new String[0] : Arrays.copyOfRange(args, 1, args.length));
+                result = processRunner.run(runnerArguments);
             }
         } catch(NoSuchCommandException e) {
             result = "没有这个命令！请使用“.cgj”查看帮助说明！";
@@ -246,7 +260,8 @@ public class BotEventHandler implements EventHandler {
         long totalTime = System.currentTimeMillis() - time;
         log.info("命令反馈完成.(事件耗时: {}ms, P: {}%({}ms), R: {}%({}ms))", totalTime,
                 String.format("%.3f", ((double) processTime / (double)totalTime) * 100F), processTime,
-                String.format("%.3f", ((double) (totalTime - processTime) / (double)totalTime) * 100F), totalTime - processTime);
+                String.format("%.3f", ((double) (totalTime - processTime) / (double)totalTime) * 100F),
+                totalTime - processTime);
     }
 
     /**

src/main/java/net/lamgc/cgj/bot/framework/mirai/MiraiMain.java

@@ -92,11 +92,14 @@ public class MiraiMain implements Closeable {
     private void executeMessageEvent(MessageEvent message) {
         log.debug("Mirai Message: {}", message);
         if(message instanceof GroupMessageEvent) {
-            GroupMessageEvent GroupMessageEvent = (GroupMessageEvent) message;
-            Boolean muteState = muteManager.isMute(GroupMessageEvent.getGroup().getId(), true);
+            GroupMessageEvent groupMessageEvent = (GroupMessageEvent) message;
+            Boolean muteState = muteManager.isMute(groupMessageEvent.getGroup().getId(), true);
             if(muteState == null) {
-                muteManager.setMuteState(GroupMessageEvent.getGroup().getId(),
-                        ((GroupMessageEvent) message).getGroup().getBotMuteRemaining() != 0);
+                boolean mute = groupMessageEvent.getGroup().getBotMuteRemaining() != 0;
+                muteManager.setMuteState(groupMessageEvent.getGroup().getId(), mute);
+                if(mute) {
+                    return;
+                }
             } else if(muteState) {
                 return;
             }

src/main/java/net/lamgc/cgj/bot/util/parser/DateParser.java

@@ -1,4 +1,4 @@
-package net.lamgc.cgj.util;
+package net.lamgc.cgj.bot.util.parser;
 
 import net.lamgc.utils.base.runner.StringParameterParser;
 

src/main/java/net/lamgc/cgj/bot/util/parser/PagesQualityParser.java

@@ -1,4 +1,4 @@
-package net.lamgc.cgj.util;
+package net.lamgc.cgj.bot.util.parser;
 
 import net.lamgc.cgj.pixiv.PixivDownload;
 import net.lamgc.utils.base.runner.StringParameterParser;

src/main/java/net/lamgc/cgj/bot/util/parser/RankingContentTypeParser.java

@@ -0,0 +1,29 @@
+package net.lamgc.cgj.bot.util.parser;
+
+import net.lamgc.cgj.pixiv.RankingContentType;
+import net.lamgc.utils.base.runner.StringParameterParser;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+public class RankingContentTypeParser implements StringParameterParser<RankingContentType> {
+
+    private final static Logger log = LoggerFactory.getLogger(RankingContentTypeParser.class);
+
+    @Override
+    public RankingContentType parse(String strValue) {
+        try {
+            if(strValue.toUpperCase().startsWith("TYPE_")) {
+                return RankingContentType.valueOf(strValue.toUpperCase());
+            }
+            return RankingContentType.valueOf("TYPE_" + strValue.toUpperCase());
+        } catch(IllegalArgumentException e) {
+            log.warn("无效的RankingContentType值: {}", strValue);
+            throw e;
+        }
+    }
+
+    @Override
+    public RankingContentType defaultValue() {
+        return RankingContentType.TYPE_ALL;
+    }
+}

src/main/java/net/lamgc/cgj/bot/util/parser/RankingModeParser.java

@@ -0,0 +1,29 @@
+package net.lamgc.cgj.bot.util.parser;
+
+import net.lamgc.cgj.pixiv.RankingMode;
+import net.lamgc.utils.base.runner.StringParameterParser;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+public class RankingModeParser implements StringParameterParser<RankingMode> {
+
+    private final static Logger log = LoggerFactory.getLogger(RankingModeParser.class);
+
+    @Override
+    public RankingMode parse(String strValue) {
+        try {
+            if(strValue.toUpperCase().startsWith("MODE_")) {
+                return RankingMode.valueOf(strValue.toUpperCase());
+            }
+            return RankingMode.valueOf("MODE_" + strValue.toUpperCase());
+        } catch(IllegalArgumentException e) {
+            log.warn("无效的RankingMode值: {}", strValue);
+            throw e;
+        }
+    }
+
+    @Override
+    public RankingMode defaultValue() {
+        return RankingMode.MODE_DAILY;
+    }
+}

src/main/java/net/lamgc/cgj/pixiv/PixivDownload.java

@@ -4,7 +4,6 @@ import com.google.gson.Gson;
 import com.google.gson.JsonArray;
 import com.google.gson.JsonElement;
 import com.google.gson.JsonObject;
-import com.google.gson.reflect.TypeToken;
 import io.netty.handler.codec.http.HttpHeaderNames;
 import net.lamgc.cgj.exception.HttpRequestException;
 import org.apache.http.Header;
@@ -32,7 +31,6 @@ import java.util.*;
 import java.util.concurrent.atomic.AtomicInteger;
 import java.util.function.BiConsumer;
 
-@SuppressWarnings("ALL")
 public class PixivDownload {
 
     private final static Logger log = LoggerFactory.getLogger(PixivDownload.class);
@@ -58,10 +56,10 @@ public class PixivDownload {
         this.cookieStore = cookieStore;
         HttpClientBuilder builder = HttpClientBuilder.create();
         builder.setDefaultCookieStore(cookieStore);
-        // UA: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.122 Safari/537.36
         ArrayList<Header> defaultHeaders = new ArrayList<>(2);
         defaultHeaders.add(new BasicHeader("User-Agent",
-                "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.122 Safari/537.36"));
+                "Mozilla/5.0 (Windows NT 10.0; Win64; x64) " +
+                        "AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.122 Safari/537.36"));
         builder.setDefaultHeaders(defaultHeaders);
         builder.setProxy(proxy);
         httpClient = builder.build();
@@ -86,7 +84,8 @@ public class PixivDownload {
         Document document;
         ArrayList<String> linkList = new ArrayList<>();
         do {
-            request = new HttpGet(PixivURL.PIXIV_USER_COLLECTION_PAGE.replace("{pageIndex}", Integer.toString(++pageIndex)));
+            request = new HttpGet(PixivURL.PIXIV_USER_COLLECTION_PAGE
+                    .replace("{pageIndex}", Integer.toString(++pageIndex)));
             setCookieInRequest(request, cookieStore);
             log.debug("Request Link: " + request.getURI().toString());
             HttpResponse response = httpClient.execute(request);
@@ -101,10 +100,13 @@ public class PixivDownload {
 
             Gson gson = new Gson();
             for (String href : hrefList) {
-                HttpGet linkApiRequest = createHttpGetRequest(PixivURL.PIXIV_ILLUST_API_URL.replace("{illustId}", href.substring(href.lastIndexOf("/") + 1)));
+                HttpGet linkApiRequest = createHttpGetRequest(PixivURL.PIXIV_ILLUST_API_URL
+                        .replace("{illustId}", href.substring(href.lastIndexOf("/") + 1)));
                 log.debug(linkApiRequest.getURI().toString());
                 HttpResponse httpResponse = httpClient.execute(linkApiRequest);
-                JsonObject linkResult = gson.fromJson(EntityUtils.toString(httpResponse.getEntity()), JsonObject.class);
+                JsonObject linkResult =
+                        gson.fromJson(EntityUtils.toString(httpResponse.getEntity()), JsonObject.class);
+
                 if(linkResult.get("error").getAsBoolean()) {
                     log.error("接口返回错误信息: {}", linkResult.get("message").getAsString());
                     continue;
@@ -113,7 +115,10 @@ public class PixivDownload {
                 JsonArray linkArray = linkResult.get("body").getAsJsonArray();
                 for (int i = 0; i < linkArray.size(); i++) {
                     JsonObject linkObject = linkArray.get(i).getAsJsonObject().get("urls").getAsJsonObject();
-                    linkList.add(linkObject.get((quality == null ? PageQuality.ORIGINAL : quality).toString().toLowerCase()).getAsString());
+                    linkList.add(
+                            linkObject.get((quality == null ? PageQuality.ORIGINAL : quality).toString().toLowerCase())
+                            .getAsString()
+                    );
                 }
             }
         } while(!document.select(".pager-container>.next").isEmpty());
@@ -155,7 +160,8 @@ public class PixivDownload {
         Document document = Jsoup.parse(EntityUtils.toString(response.getEntity()));
 
         HttpClient imageClient = HttpClientBuilder.create().build();
-        Elements elements = document.select(".gtm-illust-recommend-zone>.image-item>.gtm-illust-recommend-thumbnail-link");
+        Elements elements = document
+                .select(".gtm-illust-recommend-zone>.image-item>.gtm-illust-recommend-thumbnail-link");
         for(int illustIndex = 0; illustIndex < elements.size(); illustIndex++){
             String href = elements.get(illustIndex).attr("href");
             int illustId = Integer.parseInt(href.substring(href.lastIndexOf("/") + 1));
@@ -197,8 +203,14 @@ public class PixivDownload {
      * @param fn 回调函数
      * @throws IOException 当请求发生异常时抛出
      */
-    public void getRankingAsInputStream(PixivURL.RankingContentType contentType, PixivURL.RankingMode mode,
-                                        Date time, int range, PageQuality quality, RankingDownloadFunction fn) throws IOException {
+    public void getRankingAsInputStream(
+            RankingContentType contentType,
+            RankingMode mode,
+            Date time,
+            int range,
+            PageQuality quality,
+            RankingDownloadFunction fn
+    ) throws IOException {
         getRankingAsInputStream(contentType, mode, time, 1, range, quality, fn);
     }
 
@@ -213,15 +225,23 @@ public class PixivDownload {
      * @param fn 回调函数
      * @throws IOException 当请求发生异常时抛出
      */
-    public void getRankingAsInputStream(PixivURL.RankingContentType contentType, PixivURL.RankingMode mode,
-                                        Date time, int rankStart, int range, PageQuality quality, RankingDownloadFunction fn) throws IOException {
+    public void getRankingAsInputStream(
+            RankingContentType contentType,
+            RankingMode mode,
+            Date time,
+            int rankStart,
+            int range,
+            PageQuality quality,
+            RankingDownloadFunction fn
+    ) throws IOException {
         getRanking(contentType, mode, time, rankStart, range).forEach(rankInfo -> {
             int rank = rankInfo.get("rank").getAsInt();
             int illustId = rankInfo.get("illust_id").getAsInt();
             int authorId = rankInfo.get("user_id").getAsInt();
             String authorName = rankInfo.get("user_name").getAsString();
             String title = rankInfo.get("title").getAsString();
-            log.trace("当前到第 {}/{} 名(总共 {} 名), IllustID: {}, Author: ({}) {}, Title: {}", rank, rankStart + range - 1, range, illustId, authorId, authorName, title);
+            log.trace("当前到第 {}/{} 名(总共 {} 名), IllustID: {}, Author: ({}) {}, Title: {}",
+                    rank, rankStart + range - 1, range, illustId, authorId, authorName, title);
             log.trace("正在获取PagesLink...");
             List<String> linkList;
             try {
@@ -238,7 +258,11 @@ public class PixivDownload {
             for (int pageIndex = 0; pageIndex < linkList.size(); pageIndex++) {
                 String downloadLink = linkList.get(pageIndex);
                 log.trace("当前Page: {}/{}", pageIndex + 1, linkList.size());
-                try(InputStream imageInputStream = new BufferedInputStream(getImageAsInputStream(HttpClientBuilder.create().build(), downloadLink), 256 * 1024)) {
+                try(InputStream imageInputStream =
+                            new BufferedInputStream(
+                                    getImageAsInputStream(HttpClientBuilder.create().build(), downloadLink),
+                                    256 * 1024)
+                ) {
                     fn.download(rank, downloadLink, rankInfo.deepCopy(), imageInputStream);
                 } catch(IOException e) {
                     log.error("下载插画时发生异常", e);
@@ -249,43 +273,6 @@ public class PixivDownload {
         });
     }
 
-    /**
-     * 从JsonArray获取数据
-     * @param rankingList JsonArray对象
-     * @param rankStart 开始索引, 从0开始
-     * @param range 范围
-     * @return 返回List对象
-     */
-    public static List<JsonObject> getRanking(List<JsonObject> rankingList, int rankStart, int range) {
-        log.debug("正在读取JsonArray...(rankStart: {}, range: {})", rankStart, range);
-        ArrayList<JsonObject> results = new ArrayList<>(rankingList.size());
-        for (int rankIndex = rankStart; rankIndex < rankStart + range; rankIndex++) {
-            JsonElement jsonElement = rankingList.get(rankIndex - rankStart);
-            JsonObject rankInfo = jsonElement.getAsJsonObject();
-            int rank = rankInfo.get("rank").getAsInt();
-            int illustId = rankInfo.get("illust_id").getAsInt();
-            int authorId = rankInfo.get("user_id").getAsInt();
-            String authorName = rankInfo.get("user_name").getAsString();
-            String title = rankInfo.get("title").getAsString();
-            log.trace("Array-当前到第 {}/{} 名(总共 {} 名), IllustID: {}, Author: ({}) {}, Title: {}", rank, rankStart + range, range, illustId, authorId, authorName, title);
-            results.add(rankInfo);
-        }
-        log.debug("JsonArray读取完成.");
-        return results;
-    }
-
-    /**
-     * 从JsonArray获取数据
-     * @param rankingArray JsonArray对象
-     * @param rankStart 开始索引, 从0开始
-     * @param range 范围
-     * @return 返回List对象
-     */
-    public static List<JsonObject> getRanking(JsonArray rankingArray, int rankStart, int range) {
-        List<JsonObject> list = new Gson().fromJson(rankingArray, new TypeToken<List<JsonObject>>(){}.getType());
-        return getRanking(list, rankStart, range);
-    }
-
     /**
      * 获取排行榜.
      * <p>注意: 如果范围实际上没超出, 但返回排行榜不足, 会导致与实际请求的数量不符, 需要检查</p>
@@ -295,22 +282,24 @@ public class PixivDownload {
      * @param rankStart 开始排名, 从1开始
      * @param range 取范围
      * @return 成功返回有值List, 失败且无异常返回空
-     * @throws IllegalArgumentException 当{@linkplain net.lamgc.cgj.pixiv.PixivURL.RankingContentType RankingContentType}
-     *                                  与{@linkplain net.lamgc.cgj.pixiv.PixivURL.RankingMode RankingMode}互不兼容时抛出
+     * @throws IllegalArgumentException 当{@linkplain net.lamgc.cgj.pixiv.RankingContentType RankingContentType}
+     *                                  与{@linkplain net.lamgc.cgj.pixiv.RankingMode RankingMode}互不兼容时抛出
      * @throws IndexOutOfBoundsException 当排行榜选取范围超出排行榜范围时抛出(排行榜范围为 1 ~ 500 名)
      * @throws IOException 当Http请求发生异常时抛出, 或Http请求响应码非200时抛出
      */
-    public List<JsonObject> getRanking(PixivURL.RankingContentType contentType, PixivURL.RankingMode mode,
+    public List<JsonObject> getRanking(RankingContentType contentType, RankingMode mode,
                                            Date time, int rankStart, int range) throws IOException {
         Objects.requireNonNull(time);
         if(!Objects.requireNonNull(contentType).isSupportedMode(Objects.requireNonNull(mode))) {
-            throw new IllegalArgumentException("ContentType不支持指定的RankingMode: ContentType: " + contentType.name() + ", Mode: " + mode.name());
+            throw new IllegalArgumentException("ContentType不支持指定的RankingMode: ContentType: "
+                    + contentType.name() + ", Mode: " + mode.name());
         } else if(rankStart <= 0) {
             throw new IndexOutOfBoundsException("rankStart cannot be less than or equal to zero: " + rankStart);
         } else if(range <= 0) {
             throw new IndexOutOfBoundsException("range cannot be less than or equal to zero:" + range);
         } else if(rankStart + range - 1 > 500) {
-            throw new IndexOutOfBoundsException("排名选取范围超出了排行榜范围: rankStart=" + rankStart + ", range=" + range + ", length:" + (rankStart + range - 1));
+            throw new IndexOutOfBoundsException("排名选取范围超出了排行榜范围: rankStart="
+                    + rankStart + ", range=" + range + ", length:" + (rankStart + range - 1));
         }
 
         int startPages = (int) Math.max(1, Math.floor(rankStart / 50F));
@@ -333,7 +322,8 @@ public class PixivDownload {
             JsonObject resultObject = gson.fromJson(responseBody, JsonObject.class);
             canNext = resultObject.get("next").getAsJsonPrimitive().isNumber();
             JsonArray resultArray = resultObject.getAsJsonArray("contents");
-            for (int resultIndex = startIndex; resultIndex < resultArray.size() && count < range; resultIndex++, count++) {
+            for (int resultIndex = startIndex;
+                 resultIndex < resultArray.size() && count < range; resultIndex++, count++) {
                 results.add(resultArray.get(resultIndex).getAsJsonObject());
             }
 
@@ -393,8 +383,14 @@ public class PixivDownload {
      * @return 返回该illust所有Page的下载链接
      * @throws IOException 当HttpClient在请求时发生异常, 或接口报错时抛出, 注意{@link IOException#getMessage()}
      */
-    public static List<String> getIllustAllPageDownload(HttpClient httpClient, CookieStore cookieStore, int illustId, PageQuality quality) throws IOException {
-        HttpGet linkApiRequest = new HttpGet(PixivURL.PIXIV_ILLUST_API_URL.replace("{illustId}", Integer.toString(illustId)));
+    public static List<String> getIllustAllPageDownload(
+            HttpClient httpClient,
+            CookieStore cookieStore,
+            int illustId,
+            PageQuality quality
+    ) throws IOException {
+        HttpGet linkApiRequest = new HttpGet(PixivURL.PIXIV_ILLUST_API_URL
+                .replace("{illustId}", Integer.toString(illustId)));
         setCookieInRequest(linkApiRequest, cookieStore);
         HttpResponse response = httpClient.execute(linkApiRequest);
         JsonObject resultObject = new Gson().fromJson(EntityUtils.toString(response.getEntity()), JsonObject.class);
@@ -421,6 +417,7 @@ public class PixivDownload {
     /**
      * 插图质量
      */
+    @SuppressWarnings("unused")
     public enum PageQuality{
         /**
          * 原图画质
@@ -450,7 +447,8 @@ public class PixivDownload {
     @Deprecated
     public Set<Map.Entry<String, InputStream>> getCollectionAsInputStream(PageQuality quality) throws IOException {
         HashSet<Map.Entry<String, InputStream>> illustInputStreamSet = new HashSet<>();
-        getCollectionAsInputStream(quality, (link, inputStream) -> illustInputStreamSet.add(new AbstractMap.SimpleEntry<>(link, inputStream)));
+        getCollectionAsInputStream(quality, (link, inputStream) ->
+                illustInputStreamSet.add(new AbstractMap.SimpleEntry<>(link, inputStream)));
         return illustInputStreamSet;
     }
 
@@ -531,7 +529,8 @@ public class PixivDownload {
 
     public static void setCookieInRequest(HttpRequest request, CookieStore cookieStore) {
         StringBuilder builder = new StringBuilder();
-        cookieStore.getCookies().forEach(cookie -> builder.append(cookie.getName()).append("=").append(cookie.getValue()).append("; "));
+        cookieStore.getCookies().forEach(cookie ->
+                builder.append(cookie.getName()).append("=").append(cookie.getValue()).append("; "));
         request.setHeader(HttpHeaderNames.COOKIE.toString(), builder.toString());
     }
 

src/main/java/net/lamgc/cgj/pixiv/PixivSearchAttribute.java

@@ -0,0 +1,22 @@
+package net.lamgc.cgj.pixiv;
+
+/**
+ * 搜索结果的属性枚举类.
+ * <p>按照请求的{@link PixivSearchLinkBuilder.SearchArea}获取所支持的属性数组</p>
+ */
+public enum PixivSearchAttribute {
+
+    ARTWORKS("illustManga"),
+    TOP("illustManga", "novel"),
+    ILLUSTRATIONS("illust"),
+    MANGA("manga"),
+    NOVELS("novel")
+    ;
+
+    public final String[] attributeNames;
+
+    PixivSearchAttribute(String... attributeNames) {
+        this.attributeNames = attributeNames;
+    }
+
+}

src/main/java/net/lamgc/cgj/pixiv/PixivSearchLinkBuilder.java

@@ -8,6 +8,7 @@ import java.text.SimpleDateFormat;
 import java.util.Date;
 import java.util.HashSet;
 import java.util.Objects;
+import java.util.Set;
 
 /**
  * Pixiv搜索URL构造器
@@ -15,7 +16,7 @@ import java.util.Objects;
  * @author LamGC
  * @see PixivURL#PIXIV_SEARCH_CONTENT_URL
  */
-@SuppressWarnings("unused")
+@SuppressWarnings({"unused", "UnusedReturnValue"})
 public class PixivSearchLinkBuilder {
 
     private final String content;
@@ -26,8 +27,8 @@ public class PixivSearchLinkBuilder {
     private SearchOrder searchOrder = SearchOrder.DATE_D;
     private SearchContentOption searchContentOption = SearchContentOption.ALL;
 
-    private final HashSet<String> includeKeywords = new HashSet<>(0);
-    private final HashSet<String> excludeKeywords = new HashSet<>(0);
+    private final Set<String> includeKeywords = new HashSet<>(0);
+    private final Set<String> excludeKeywords = new HashSet<>(0);
 
     private int page = 1;
 
@@ -161,11 +162,19 @@ public class PixivSearchLinkBuilder {
                 '}';
     }
 
+    public String getContent() {
+        return content;
+    }
+
     public PixivSearchLinkBuilder setSearchArea(SearchArea searchArea) {
         this.searchArea = Objects.requireNonNull(searchArea);
         return this;
     }
 
+    public SearchArea getSearchArea() {
+        return searchArea;
+    }
+
     /**
      * 获取搜索条件.
      * @return 搜索条件内容
@@ -199,32 +208,60 @@ public class PixivSearchLinkBuilder {
         return this;
     }
 
+    public SearchMode getSearchMode() {
+        return searchMode;
+    }
+
     public PixivSearchLinkBuilder setSearchType(SearchType searchType) {
         this.searchType = Objects.requireNonNull(searchType);
         return this;
     }
 
+    public SearchType getSearchType() {
+        return searchType;
+    }
+
     public PixivSearchLinkBuilder setSearchOrder(SearchOrder searchOrder) {
         this.searchOrder = Objects.requireNonNull(searchOrder);
         return this;
     }
 
+    public SearchOrder getSearchOrder() {
+        return searchOrder;
+    }
+
     public PixivSearchLinkBuilder setSearchContentOption(SearchContentOption searchContentOption) {
         this.searchContentOption = Objects.requireNonNull(searchContentOption);
         return this;
     }
 
+    public SearchContentOption getSearchContentOption() {
+        return searchContentOption;
+    }
+
     public PixivSearchLinkBuilder setRatioOption(RatioOption ratioOption) {
         this.ratioOption = Objects.requireNonNull(ratioOption);
         return this;
     }
 
+    public RatioOption getRatioOption() {
+        return ratioOption;
+    }
+
     public PixivSearchLinkBuilder setDateRange(Date startDate, Date endDate) {
         this.startDate = startDate;
         this.endDate = endDate;
         return this;
     }
 
+    public Date getStartDate() {
+        return startDate;
+    }
+
+    public Date getEndDate() {
+        return endDate;
+    }
+
     public PixivSearchLinkBuilder setMaxSize(int width, int height) {
         this.wgt = width;
         this.hgt = height;
@@ -245,6 +282,10 @@ public class PixivSearchLinkBuilder {
         return this;
     }
 
+    public int getPage() {
+        return page;
+    }
+
     public PixivSearchLinkBuilder addExcludeKeyword(String keyword) {
         excludeKeywords.add(keyword);
         return this;
@@ -265,6 +306,14 @@ public class PixivSearchLinkBuilder {
         return this;
     }
 
+    public Set<String> getIncludeKeywords() {
+        return new HashSet<>(includeKeywords);
+    }
+
+    public Set<String> getExcludeKeywords() {
+        return new HashSet<>(excludeKeywords);
+    }
+
     /**
      * 搜索区域
      */
@@ -296,13 +345,18 @@ public class PixivSearchLinkBuilder {
          */
         NOVELS("novel");
 
+        /**
+         * 可用的Json属性名
+         * @deprecated 该属性信息以移至 {@link PixivSearchAttribute}
+         * @see PixivSearchAttribute
+         */
+        @Deprecated
         public final String jsonKey;
 
         SearchArea(String jsonKey) {
             this.jsonKey = jsonKey;
         }
 
-
     }
 
     /**
@@ -401,5 +455,4 @@ public class PixivSearchLinkBuilder {
 
     }
 
-
 }

src/main/java/net/lamgc/cgj/pixiv/PixivURL.java

@@ -1,7 +1,6 @@
 package net.lamgc.cgj.pixiv;
 
 import java.text.SimpleDateFormat;
-import java.util.Arrays;
 import java.util.Calendar;
 import java.util.Date;
 import java.util.GregorianCalendar;
@@ -209,7 +208,13 @@ public final class PixivURL {
      * @param pageIndex 页数，一页50位，总共10页
      * @return 返回构建好的链接
      */
-    public static String getRankingLink(RankingContentType contentType, RankingMode mode, Date time, int pageIndex, boolean json){
+    public static String getRankingLink(
+            RankingContentType contentType,
+            RankingMode mode,
+            Date time,
+            int pageIndex,
+            boolean json
+    ){
         StringBuilder linkBuilder = new StringBuilder(PIXIV_RANKING_LINK);
         linkBuilder.append("mode=").append(mode == null ? RankingMode.MODE_DAILY.modeParam : mode.modeParam);
         if(contentType != null && !contentType.equals(RankingContentType.TYPE_ALL)){
@@ -235,63 +240,6 @@ public final class PixivURL {
         return linkBuilder.toString();
     }
 
-    /**
-     * 排名榜模式
-     */
-    public enum RankingMode{
-        /**
-         * 每天
-         */
-        MODE_DAILY("daily"),
-        /**
-         * 每周
-         */
-        MODE_WEEKLY("weekly"),
-        /**
-         * 每月
-         */
-        MODE_MONTHLY("monthly"),
-        /**
-         * 新人
-         */
-        MODE_ROOKIE("rookie"),
-        /**
-         * 原创
-         */
-        MODE_ORIGINAL("original"),
-        /**
-         * 受男性喜欢
-         */
-        MODE_MALE("male"),
-        /**
-         * 受女性喜欢
-         */
-        MODE_FEMALE("female"),
-
-        /**
-         * 每天 - R18
-         */
-        MODE_DAILY_R18("daily_r18"),
-        /**
-         * 每周 - R18
-         */
-        MODE_WEEKLY_R18("weekly_r18"),
-        /**
-         * 受男性喜欢 - R18
-         */
-        MODE_MALE_R18("male_r18"),
-        /**
-         * 受女性喜欢 - R18
-         */
-        MODE_FEMALE_R18("female_r18"),
-        ;
-        public String modeParam;
-
-        RankingMode(String modeParamName){
-            this.modeParam = modeParamName;
-        }
-    }
-
     /**
      * Pixiv搜索接口.<br/>
      * 要使用该链接请使用{@link PixivSearchLinkBuilder}构造链接.<br/>
@@ -300,72 +248,4 @@ public final class PixivURL {
      */
     final static String PIXIV_SEARCH_CONTENT_URL = "https://www.pixiv.net/ajax/search/{area}/{content}?word={content}";
 
-    /**
-     * 排名榜类型
-     */
-    public enum RankingContentType{
-        TYPE_ALL("", RankingMode.values()),
-        /**
-         * 插画
-         * 支持的时间类型: 每天, 每周, 每月, 新人
-         */
-        TYPE_ILLUST("illust",
-                new RankingMode[]{
-                        RankingMode.MODE_DAILY,
-                        RankingMode.MODE_MONTHLY,
-                        RankingMode.MODE_WEEKLY,
-                        RankingMode.MODE_ROOKIE,
-                        RankingMode.MODE_DAILY_R18,
-                        RankingMode.MODE_WEEKLY_R18,
-                }
-        ),
-        /**
-         * 动图
-         * 支持的时间类型:每天, 每周
-         */
-        TYPE_UGOIRA("ugoira",
-                new RankingMode[]{
-                        RankingMode.MODE_DAILY,
-                        RankingMode.MODE_WEEKLY,
-                        RankingMode.MODE_DAILY_R18,
-                        RankingMode.MODE_WEEKLY_R18
-                }
-        ),
-        /**
-         * 漫画
-         * 支持的时间类型: 每天, 每周, 每月, 新人
-         */
-        TYPE_MANGA("manga",
-                new RankingMode[]{
-                        RankingMode.MODE_DAILY,
-                        RankingMode.MODE_MONTHLY,
-                        RankingMode.MODE_WEEKLY,
-                        RankingMode.MODE_ROOKIE,
-                        RankingMode.MODE_DAILY_R18,
-                        RankingMode.MODE_WEEKLY_R18,
-                }
-        )
-        ;
-
-        String typeName;
-
-        private final RankingMode[] supportedMode;
-
-        RankingContentType(String typeName, RankingMode[] supportedMode){
-            this.typeName = typeName;
-            this.supportedMode = supportedMode;
-        }
-
-        /**
-         * 检查指定RankingMode是否支持
-         * @param mode 要检查的RankingMode项
-         * @return 如果支持返回true
-         */
-        @SuppressWarnings("BooleanMethodIsAlwaysInverted")
-        public boolean isSupportedMode(RankingMode mode) {
-            return Arrays.binarySearch(supportedMode, mode) >= 0;
-        }
-
-    }
-
 }

src/main/java/net/lamgc/cgj/pixiv/RankingContentType.java

@@ -0,0 +1,75 @@
+package net.lamgc.cgj.pixiv;
+
+import java.util.Arrays;
+
+/**
+ * 排名榜类型
+ */
+public enum RankingContentType{
+    /**
+     * 所有类型.
+     * 支持所有Mode.
+     */
+    TYPE_ALL("", RankingMode.values()),
+    /**
+     * 插画
+     * 支持的时间类型: 每天, 每周, 每月, 新人
+     */
+    TYPE_ILLUST("illust",
+            new RankingMode[]{
+                    RankingMode.MODE_DAILY,
+                    RankingMode.MODE_MONTHLY,
+                    RankingMode.MODE_WEEKLY,
+                    RankingMode.MODE_ROOKIE,
+                    RankingMode.MODE_DAILY_R18,
+                    RankingMode.MODE_WEEKLY_R18,
+            }
+    ),
+    /**
+     * 动图
+     * 支持的时间类型:每天, 每周
+     */
+    TYPE_UGOIRA("ugoira",
+            new RankingMode[]{
+                    RankingMode.MODE_DAILY,
+                    RankingMode.MODE_WEEKLY,
+                    RankingMode.MODE_DAILY_R18,
+                    RankingMode.MODE_WEEKLY_R18
+            }
+    ),
+    /**
+     * 漫画
+     * 支持的时间类型: 每天, 每周, 每月, 新人
+     */
+    TYPE_MANGA("manga",
+            new RankingMode[]{
+                    RankingMode.MODE_DAILY,
+                    RankingMode.MODE_MONTHLY,
+                    RankingMode.MODE_WEEKLY,
+                    RankingMode.MODE_ROOKIE,
+                    RankingMode.MODE_DAILY_R18,
+                    RankingMode.MODE_WEEKLY_R18,
+            }
+    )
+    ;
+
+    String typeName;
+
+    private final RankingMode[] supportedMode;
+
+    RankingContentType(String typeName, RankingMode[] supportedMode){
+        this.typeName = typeName;
+        this.supportedMode = supportedMode;
+    }
+
+    /**
+     * 检查指定RankingMode是否支持
+     * @param mode 要检查的RankingMode项
+     * @return 如果支持返回true
+     */
+    @SuppressWarnings("BooleanMethodIsAlwaysInverted")
+    public boolean isSupportedMode(RankingMode mode) {
+        return Arrays.binarySearch(supportedMode, mode) >= 0;
+    }
+
+}

src/main/java/net/lamgc/cgj/pixiv/RankingMode.java

@@ -0,0 +1,58 @@
+package net.lamgc.cgj.pixiv;
+
+/**
+ * 排名榜模式
+ */
+public enum RankingMode{
+    /**
+     * 每天
+     */
+    MODE_DAILY("daily"),
+    /**
+     * 每周
+     */
+    MODE_WEEKLY("weekly"),
+    /**
+     * 每月
+     */
+    MODE_MONTHLY("monthly"),
+    /**
+     * 新人
+     */
+    MODE_ROOKIE("rookie"),
+    /**
+     * 原创
+     */
+    MODE_ORIGINAL("original"),
+    /**
+     * 受男性喜欢
+     */
+    MODE_MALE("male"),
+    /**
+     * 受女性喜欢
+     */
+    MODE_FEMALE("female"),
+
+    /**
+     * 每天 - R18
+     */
+    MODE_DAILY_R18("daily_r18"),
+    /**
+     * 每周 - R18
+     */
+    MODE_WEEKLY_R18("weekly_r18"),
+    /**
+     * 受男性喜欢 - R18
+     */
+    MODE_MALE_R18("male_r18"),
+    /**
+     * 受女性喜欢 - R18
+     */
+    MODE_FEMALE_R18("female_r18"),
+    ;
+    public String modeParam;
+
+    RankingMode(String modeParamName){
+        this.modeParam = modeParamName;
+    }
+}

src/main/java/net/lamgc/cgj/util/PixivUtils.java

@@ -0,0 +1,84 @@
+package net.lamgc.cgj.util;
+
+import com.google.common.base.Strings;
+import net.lamgc.cgj.pixiv.PixivSearchLinkBuilder;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * Pixiv工具类
+ */
+public final class PixivUtils {
+
+    private final static Logger log = LoggerFactory.getLogger(PixivUtils.class);
+
+    private PixivUtils() {}
+
+    /**
+     * 快速构造一个PixivSearchLinkBuilder
+     * @param content 搜索内容
+     * @param type 搜索类型
+     * @param area 搜索范围
+     * @param includeKeywords 包含关键词
+     * @param excludeKeywords 排除关键词
+     * @param contentOption 内容级别选项
+     * @param pageIndex 搜索页数
+     * @return 返回PixivSearchLinkBuilder对象
+     * @see PixivSearchLinkBuilder
+     */
+    public static PixivSearchLinkBuilder buildSearchLinkBuilderFromString(
+            String content,
+            String type,
+            String area,
+            String includeKeywords,
+            String excludeKeywords,
+            String contentOption,
+            int pageIndex
+    ) {
+        PixivSearchLinkBuilder searchBuilder = new PixivSearchLinkBuilder(Strings.isNullOrEmpty(content) ? "" : content);
+        if (type != null) {
+            try {
+                searchBuilder.setSearchType(PixivSearchLinkBuilder.SearchType.valueOf(type.trim().toUpperCase()));
+            } catch (IllegalArgumentException e) {
+                log.warn("不支持的SearchType: {}", type);
+            }
+        }
+        if (area != null) {
+            try {
+                searchBuilder.setSearchArea(PixivSearchLinkBuilder.SearchArea.valueOf(area.trim().toUpperCase()));
+            } catch (IllegalArgumentException e) {
+                log.warn("不支持的SearchArea: {}", area);
+            }
+        }
+        if (contentOption != null) {
+            try {
+                searchBuilder.setSearchContentOption(
+                        PixivSearchLinkBuilder.SearchContentOption.valueOf(contentOption.trim().toUpperCase()));
+            } catch (IllegalArgumentException e) {
+                log.warn("不支持的SearchContentOption: {}", contentOption);
+            }
+        }
+
+        if (!Strings.isNullOrEmpty(includeKeywords)) {
+            for (String keyword : includeKeywords.split(";")) {
+                searchBuilder.removeExcludeKeyword(keyword.trim());
+                searchBuilder.addIncludeKeyword(keyword.trim());
+                log.trace("已添加关键字: {}", keyword);
+            }
+        }
+        if (!Strings.isNullOrEmpty(excludeKeywords)) {
+            for (String keyword : excludeKeywords.split(";")) {
+                searchBuilder.removeIncludeKeyword(keyword.trim());
+                searchBuilder.addExcludeKeyword(keyword.trim());
+                log.trace("已添加排除关键字: {}", keyword);
+            }
+        }
+
+        if(pageIndex > 0) {
+            searchBuilder.setPage(pageIndex);
+        }
+
+        return searchBuilder;
+    }
+
+}

src/test/java/net/lamgc/cgj/pixiv/PixivDownloadTest.java

@@ -133,7 +133,7 @@ public class PixivDownloadTest {
         zos.setLevel(9);
         log.info("正在调用方法...");
         try {
-            pixivDownload.getRankingAsInputStream(null, PixivURL.RankingMode.MODE_DAILY_R18, queryDate, 500, PixivDownload.PageQuality.ORIGINAL, (rank, link, rankInfo, inputStream) -> {
+            pixivDownload.getRankingAsInputStream(null, RankingMode.MODE_DAILY_R18, queryDate, 500, PixivDownload.PageQuality.ORIGINAL, (rank, link, rankInfo, inputStream) -> {
                 try {
                     ZipEntry entry = new ZipEntry("Rank" + rank + "-" + link.substring(link.lastIndexOf("/") + 1));
                     entry.setComment(rankInfo.toString());