帮助:Bot

发条狐狸 于3个月前修改了此页面。
帮助:Bot
机器人 编程 管理 数据更新
版权信息(CC BY-NC)版权信息(CC BY-SA)建站评估Huiji缓存维基化页面图片邀请新用户站点评分站点等级保护页面Bot重定向页面恶意编辑短域名选择封禁公告模板灰机workshop历史与回退快速插入项修改站点页脚消歧义修改站点导航页面分类移动页面用户权限站长指南变量AWB机器人CSS样式库BOOTSTRAPExcel灰机Wiki数据更新器HTML简繁处理建站心得解析器扩展标签魔术字命名空间解析器函数模板模板参数使用CSS变量Tab切换素材库SMongo灰机停机坪文本处理工具XnView预设模板用户组限定的CSS/JS站点JS编辑折叠站点CSS编辑自动翻译字体主题编辑器API复杂模板灰机Wiki数据更新器\使用VS Code维护代码机器人开发者101零件模块PythonMongoDB支持Mustache模板Semantic MediaWiki使用SPASemantic FormsSemantic Result Formats/echarts提升访问速度推土机架构用Git管理MediaWiki在灰机使用Vue.js
简单
入门
进阶
复杂
开发
灰机帮助中心

Bot，即通常MediaWiki用户口中所说的“机器人”，但他并不是“robot”或者“android”的意思。

概括的说，bot一般指的是在MediaWiki或其他维基软件中，通过调用系统接口（API）来实现的action（例如edit、delete、info、purge等等）的自动化。
  • bot通常来说伴随着大批量、大规模的重复性操作。与人为的构思条目、编辑内容有着较大的区别，为了避免对正常编辑者编辑行为的误导、混淆，我们通常会在软件层将bot操作进行特殊标记，不会在默认的贡献列表、修改记录中出现；
    • 在灰机，bot行为不会被统计为编辑数量，因此也不会进入用户编辑次数排行榜的统计之中，在最近更改中，通过点选“显示机器人”可以查看bot操作。
  • 同时为了避免混淆个人贡献，我们一般不鼓励使用默认的用户身份进行bot操作，而是鼓励创建专门的bot账号，并授予bot权限，专门处理bot行为。

bot的操作

使用已有的bot框架

  • AutoWikiBrowser，简称“AWB”，是一个适用于所有编辑者，特别是站长、数据管理员的自动批处理bot软件。
  • 灰机Wiki数据更新器，简称“Updater”，是一个针对灰机构建的，python编写的GUI功能bot软件，与AWB功能互补。

在编程语言中使用bot

在Python、JS（线下）、MediaWiki JS（线上）或者其他编程语言，比如C#中，用户可以自行调用MediaWiki的API来进行脚本操作，通过对编辑行为的edit中添加bot=True的字段，来进行bot操作。

  • Python中使用requests库进行直接通信，endpoint的书写请严格对照MediaWiki的官方文档。
  • Python中使用mwclient库来进行操作，mwclient是已经封装过的官方API脚本，底层使用requests实现，可以简化代码的书写。

关于pywikibot

出于以下原因，我们不推荐使用pywikibot

  1. 没有GUI
  2. 需要编程基础
  3. 功能与AWB、Updater重叠
  4. 配置环境繁琐

AWB、Updater与python脚本的比较

建议使用AWB的场景

我们推荐在以下场景使用AWB、

  • 大规模的维护页面，比如清洁页面（删除冗余的杂碎内容，对齐模板参数，修改分类，批量删除分类，添加消歧义和重定向）
  • 批量替换链接，或者模板，常见于译名出现变更时，用以搜索和替换。
  • 获取引用了特定模板的页面列表

建议使用Updater的场景

以下情况我们建议使用帮助:灰机Wiki数据更新器

  • 上传、更新模板内的参数
  • 批量传图，批量创建data页面
  • 批量删除页面

建议使用本地脚本的场景

以下情况我们建议使用自定义的python脚本

  • 您会写python
    • 有过于具体的修改、替换方案，尤其是带着本地数据对照修改页面时
avatar