docs: 更新文档生成流程和内容

- 添加 adapter_gen.py 脚本到文档生成流程
- 更新 events.md 文件，添加新参数和说明
- 修改 plugin_gen.py 中的插件添加说明，指向 Pull Request 页面
- 在 mkdocs.yml 中添加第三方适配器文档链接

Author: HuoHuas001

.github/workflows/docs.yml

@@ -36,4 +36,5 @@ jobs:
         run: |
           pip install -r "./docs/requirements.txt"
           python ./docs/plugin_gen.py
+          python ./docs/adapter_gen.py
       - run: mkdocs gh-deploy --force

docs/Adapter/Third-Party.md

@@ -0,0 +1,34 @@
+---
+comments: true
+hide:
+  - navigation
+  - toc
+---
+
+# 第三方适配器
+
+本页包含一些HuHoBot的第三方适配器
+
+## 添加适配器
+
+您可以在网站上添加自己的插件，只需打开一个[新Pull Request](https://github.com/HuHoBot/HuHoBot.github.io/pulls)即可。
+
+## 可用适配器列表
+
+<div class="grid cards" markdown>
+
+-   **PocketMineAdapter** <small>by Sunch233</small>
+
+    ![Stars](https://img.shields.io/github/stars/Sunch233/HuHoBot-PocketMineAdapter?style=flat-square)
+    ![License](https://img.shields.io/github/license/Sunch233/HuHoBot-PocketMineAdapter?style=flat-square)
+    ![Last Commit](https://img.shields.io/github/last-commit/Sunch233/HuHoBot-PocketMineAdapter?style=flat-square)
+    ![Top Language](https://img.shields.io/github/languages/top/Sunch233/HuHoBot-PocketMineAdapter?style=flat-square)
+
+    ---
+
+    群服互通机器人huhubot的pm解释器，api5+
+
+    [**:octicons-arrow-right-24: GitHub**](https://github.com/Sunch233/HuHoBot-PocketMineAdapter)
+
+
+</div>

docs/Protocol/events.md

@@ -97,8 +97,10 @@
     ```json5
     {
         "key":"", //查询关键词
+        "page": 0 //页码
     }
     ```
+- 注: 传入的包体可能是`key`或者`page`两者其一，需要自行判断并做出选择
 - 回执消息： `是`
     - 见请求中的[查询白名单返回结果(queryWl)](requests.md)
 

docs/adapter.toml

@@ -0,0 +1,4 @@
+[PocketMineAdapter]
+description = "群服互通机器人huhubot的pm解释器，api5+"
+authors = ["Sunch233"]
+github = "https://github.com/Sunch233/HuHoBot-PocketMineAdapter"

docs/adapter_gen.py

@@ -0,0 +1,76 @@
+import toml
+import mkdocs_gen_files
+
+from urllib.parse import urlparse
+
+
+def parse_github_url(url):
+    parsed_url = urlparse(url)
+    
+    if parsed_url.netloc != "github.com":
+        raise ValueError("The provided URL is not a valid GitHub URL")
+
+    path_parts = parsed_url.path.strip("/").split("/")
+    
+    if len(path_parts) < 2:
+        raise ValueError("Invalid URL format. Unable to extract organization and repository names")
+    
+    organization = path_parts[0]
+    repository = path_parts[1]
+    
+    return organization, repository
+
+with mkdocs_gen_files.open("Adapter/Third-Party.md", "w") as f:
+    def fp(str):
+        print(str, file=f)
+
+    def el():
+        print("", file=f)
+
+    fp("---")
+    fp("comments: true")
+    fp("hide:")
+    fp("  - navigation")
+    fp("  - toc")
+    fp("---")
+    el()
+
+    fp("# 第三方适配器")
+    el()
+    fp("本页包含一些HuHoBot的第三方适配器")
+    el()
+
+    fp("## 添加适配器")
+    el()
+    fp("您可以在网站上添加自己的插件，只需打开一个[新Pull Request](https://github.com/HuHoBot/HuHoBot.github.io/pulls)即可。")
+    el()
+
+    fp("## 可用适配器列表")
+    el()
+    fp("<div class=\"grid cards\" markdown>")
+    el()
+
+    config = toml.load("docs/adapter.toml")
+    for name, info in config.items():
+        description = info["description"]
+        authors = info["authors"]
+        github = info["github"]
+        user, repo = parse_github_url(github)
+
+
+        fp(f"-   **{name}** <small>by {", ".join(authors)}</small>")
+        el()
+        fp(f"    ![Stars](https://img.shields.io/github/stars/{user}/{repo}?style=flat-square)")
+        fp(f"    ![License](https://img.shields.io/github/license/{user}/{repo}?style=flat-square)")
+        fp(f"    ![Last Commit](https://img.shields.io/github/last-commit/{user}/{repo}?style=flat-square)")
+        fp(f"    ![Top Language](https://img.shields.io/github/languages/top/{user}/{repo}?style=flat-square)")
+        el()
+        fp("    ---")
+        el()
+        fp(f"    {description}")
+        el()
+        fp(f"    [**:octicons-arrow-right-24: GitHub**]({github})")
+        el()
+
+    el()
+    fp("</div>")

docs/plugin_gen.py

@@ -42,7 +42,7 @@ def el():
 
     fp("## 添加插件")
     el()
-    fp("您可以在网站上添加自己的插件，只需打开一个新Issues即可。")
+    fp("您可以在网站上添加自己的插件，只需打开一个[新Pull Request](https://github.com/HuHoBot/HuHoBot.github.io/pulls)即可。")
     el()
 
     fp("## 可用插件列表")

mkdocs.yml

@@ -16,6 +16,7 @@ nav:
     - EndStone: Adapter/EndStone.md
     - Allay: Adapter/Allay.md
     - Nukkit-MOT: Adapter/Nukkit-MOT.md
+    - 第三方: Adapter/Third-Party.md
   - 附属插件开发指南:
     - Spigot: Develop/Spigot.md
     - LSE: Develop/LSE.md