本项目是 Flandre 的 wiki 组件，经简单修改成为独立插件发布

本插件在1.0版本进行了一次重构，同时更改了设置命令的语法（查询不受影响），请阅读文档的相应部分

这个插件是我很久之前写的，由于个人精力有限，目前并未积极跟进上游更新，也没有进行兼容性测试。如果你在最新版的nonebot2上使用它时出现了问题，请在issue区指出。

功能更新会在后续有时间的时候在进行。当前计划中的有：跟进最新版nonebot，解除onebot适配器依赖，添加条目跟踪等功能，以及简化命令、优化管理相关操作，并对整个项目进行重构以优化性能、提升可维护性。

ETA：无

查询条目： [[条目名]] [[prefix:条目名]]

查询条目（方法2）： wiki 条目名 wiki prefix:条目名

查询模板： {{模板名}} {{prefix:模板名}}

绕过api查询条目： ((条目名)) ((prefix:条目名))

页面截图： wiki.shot prefix:条目名

添加：wiki.add <前缀> <api地址（可选）> <通用url地址> < -g（添加该参数表示操作全局wiki)>

删除：wiki.delete <前缀> < -g >

列表：wiki.list < -g >

设置默认：wiki.default <前缀> < -g >

其中所有非全局指令均需要在目标群中进行，所有全局指令（除查询）均只有Bot管理员能执行

查询功能的语法和标准的mediawiki内链格式基本一致：

使用半角中括号包裹要查询的条目名，如 [[帮助]]

使用半角大括号包裹要查询的模板名，如 {{测试模板}}

（PS：直接使用[[Template:模板名]]也是可行的）

此外，方便起见，也可以用wiki 条目名 wiki prefix:条目名的方法查询

使用wiki.shot prefix:条目名可以获取对应页面的截图 （测试版功能，使用时请注意安全风险，如调取敏感条目，泄漏服务器ip，或者使用浏览器漏洞对服务器进行攻击。如不需要本功能，请先使用pypi上的正式版）

Bot会尝试去调取目标wiki的api,并获取对应标题的页面信息（默认允许重定向、跨wiki、简繁转换）。如果未找到对应条目，或者对应页面是消歧义页面， 则会提供数字来选择。如果调用api失败或者未配置api，会回落到字符串拼接的方式生成链接。

Tip：如果api返回的结果不是你想要的，可以使用半角小括号包裹条目名以绕过api，如 ((帮助))

当绑定了多个wiki时，需要指定前缀以查询默认wiki之外的wiki，例如，假如将某个wiki的前缀设置为flan，且不是默认wiki，则查询命令对应为[[flan:帮助]]

• wiki列表

  • 权限：所有人可用
  • 语法：wiki.list
  • 返回：当前群绑定的wiki列表，以及全局wiki列表

• 添加wiki

  • 语法 wiki.add

  • 参数：

    • 前缀：用于区分wiki的前缀，仅支持字母、数字和下划线，不能和本群已有的重复，但可以和全局已有的重复，此时本地设置优先。另外，为了防止和mediawiki的名字空间冲突，bot默认屏蔽了部分名字空间名作为前缀的能力，也请在绑定前先了解目标wiki的名字空间情况。
    • api地址（可选）：目标wiki的mediawiki api的地址。某些wiki可能限制api调用，此时可以不设置api。该地址通常可以在目标wiki的Special:版本#接入点URL页面中找到。或者也可以尝试这些一般的格式：

    https://www.example.org/api.php （如萌娘百科）

    https://www.example.org/w/api.php (如维基百科）

    • 通用url：目标wiki的条目路径。通常来讲，在该url后加上正确的条目名即可访问目标条目。可以在目标wiki的Special:版本#接入点URL中找到（“条目路径”中的$1即条目名）

    例如，对维基百科：https://www.example.org/wiki

    对萌百等：https://www.example.org/

• 删除wiki

  • 语法 wiki.delete
  • 参数：
    • 前缀：要删除的wiki的前缀

• 设置默认wiki

  • 语法 wiki.default
    • 参数：
      • 前缀：要设置默认的wiki的前缀

  Tip：本群/全局绑定的的一个wiki将被自动设置为本地/全局的默认wiki,当本地/全局绑定的默认wiki被删除时会自动清除对应的默认wiki设置，无需手动操作。

bot管理员可以设置全局的wiki，全局wiki的设计意图在于回落，换句话说，本地设置无条件优先于全局设置。当且仅当在以下情况下，全局设置会被应用：

1. 本地没有绑定任何wiki
2. 本地没有设置默认前缀，而查询请求中又不包含前缀

注意：如果本地有和全局默认前缀相同的wiki时，本地的wiki仍将被优先调用

3. 本地设置了默认前缀，但是本地不存在该wiki

注意：当前缀在全局中也不存在时，前缀将被视为名字空间，直接和条目名一并传入api进行查询

4. 查询请求中包含的前缀在本地不存在

为了提供更准确的结果，默认情况下bot会调用mediawiki api查询条目。当api无法正常调用时，会使用通用url和条目名拼接作为回落。 如果返回了错误的结果，可以使用小括号查询来绕过api。

本插件支持截图功能，但是需要额外安装依赖。如果你不需要截图功能，可以跳过这一节。

• 如果你还没安装该插件

pip install nonebot-plugin-mediawiki[shot] 

这样，pip会在安装该插件时自动安装截图功能所需的依赖（目前仅有playwright）

• 如果你已经安装了该插件，则需要在安装了该插件的虚拟环境中安装playwright

# 激活虚拟环境
# linux, venv
source venv/bin/activate
# windows, venv
venv\Scripts\activate.bat
# 安装playwright
pip install playwright

• 然后再安装chromium

# 安装chromium
playwright install chromium
# 对于无头linux服务器，建议在系统中安装完整的chromium以补全缺失的依赖
# Debian / Ubuntu
sudo apt install chromium-browser
# CentOS
sudo yum install chromium
# Arch
sudo pacman -S chromium

需要注意的是，当前版本的插件硬编码使用chromium。如果您确实需要使用其他浏览器，可以自行修改worker.py中的相关语句。

当前该功能仍处于测试阶段，不建议在生产环境中使用。以下是一些您可能需要注意的问题：

• chromium会占用大量服务器资源，如果您的服务器配置较低，建议不要使用截图功能。
• 本插件对输出的内容没有过滤，您可能需要考虑安全性问题（例如，如果您的bot在公开群中使用，可能会被恶意利用来发送一些不适合在某些地区显示的内容）。
• 某些wiki有奇怪的弹窗、广告等，也有些wiki的防火墙比较严格，或者有人机验证等，可能会导致无头浏览器无法正常获取页面。
• 恶意的群成员可能会利用一些wiki的特殊页面来获取bot的服务器ip等敏感信息
• 攻击者可能会利用浏览器漏洞来入侵服务器，建议定期更新playwright和chromium