帮助:滥用过滤器使用指导/规则格式 - 萌娘百科万物皆可萌的百科全书

所有情况下可用的变量
描述	名称	数据类型	可能的值
动作	`action`	string	edit, move, createaccount, autocreateaccount, delete, upload^[1], stashupload^[2]
用户的编辑次数	`user_editcount`	string	对未注册用户来说是空值。
用户名	`user_name`	string
用户电子邮件地址的确认时间	`user_emailconfirm`	string	YYYYMMDDHHMMSS
用户账号年龄	`user_age`		按秒计算。 IP 用户为 0。
用户是否被封禁	`user_blocked`	boolean	被封禁用户的值是 1。
用户当前是否使用移动版界面编辑	`user_mobile`	boolean	移动版编辑的值是 1。
用户组别	`user_groups`
用户所拥有的权限	`user_rights`
页面ID （可从 HTML 源代码找到 - 搜索 wgArticleId）	`article_articleid`	integer	理论上新页面的值应该是 0，但是这个判断不可靠。应当使用 "old_size==0" 来判断是否为新页面创建。
文章命名空间	`article_namespace`	integer	请参考命名空间索引
不包含命名空间的页面标题	`article_text`	string
完整页面标题	`article_prefixedtext`	string
页面编辑保护级别	`article_restrictions_edit`
页面移动保护级别	`article_restrictions_move`
页面上传保护级别	`article_restrictions_upload`
页面创建保护级别	`article_restrictions_create`
最后十个该页面的贡献者	`article_recent_contributors`		如果用户为唯一贡献者，则为空值。只检查最近 100 个历史版本。
页面的第一个贡献者	`article_first_contributor`

对于某些操作可用的变量
描述	名称	数据类型	可能的值
编辑摘要	`summary`	string
编辑是否被标记为小编辑	`minor_edit`	string
编辑前旧页面源代码	`old_wikitext`
编辑后新页面源代码	`new_wikitext`
因编辑造成的统一差异对比	`edit_diff`
因编辑造成的统一差异对比（保存前预处理后的版本）	`edit_diff_pst`
新页面大小	`new_size`	integer
新页面大小	`old_size`	integer
页面大小差值	`edit_delta`
保存前预处理后的增加行数	`added_lines_pst`
增加行数	`added_lines`
减少行数	`removed_lines`
新文字里的所有外部链接	`all_links`
编辑前页面链接数量	`old_links`
编辑后增加的外部链接数量	`added_links`
编辑后减少的外部链接数量	`removed_links`
保存前预处理后的维基文本	`new_pst`
新版本解析后的HTML文本	`new_html`
去除了标签的新页面文字	`new_text`
已禁用	`old_html`
已禁用	`old_text`
编辑是否从 Tor 网络出口发送	`tor_exit_node`	boolean	0, 1 （仅在 TorBlock 安装后可用）
编辑的 UNIX 时间戳	`timestamp`	string	int(timestamp) 将会给阁下呈现可用于年月日计算的数字。
文件内容的 SHA1 哈希值	`file_sha1`	^[1]
文件大小	`file_size`	integer	文件大小，按字节算^[1]
移动目的地页面的页面ID	`moved_to_articleid`
移动目的地页面的完整标题	`moved_to_prefixedtext`
移动目的地页面的命名空间	`moved_to_namespace`
移动原始页面的命名空间	`moved_from_namespace`
移动原始页面的完整标题	`moved_from_prefixedtext`
移动原始页面的页面ID	`moved_from_articleid`
账号名（账号创建时）	`accountname`
旧版本的内容模型	`old_content_model`	string	关于内容模型变更的更多信息，详见 Help:ChangeContentModel
新版本的内容模型	`new_content_model`	string	关于内容模型变更的更多信息，详见 Help:ChangeContentModel

英文维基百科命名空间
基本命名空间	讨论页命名空间
0	Main 主命名空间	Talk 讨论页	1
2	User 用户页	User talk 用户讨论页	3
4	Wikipedia 维基百科	Wikipedia talk 维基百科讨论页	5
6	File 文件	File talk 文件讨论页	7
8	MediaWiki	MediaWiki talk MediaWiki 讨论页	9
10	Template 模板	Template talk 模板讨论页	11
12	Help 帮助	Help talk 帮助讨论页	13
14	Category 分类	Category talk 分类讨论页	15
100	Portal 门户	Portal talk 门户讨论页	101
108	Book 书籍	Book talk 书籍讨论页	109
虚拟命名空间
-1	Special 特殊页
-2	Media 媒体

例子	结果
`1 == 2`	false
`1 <= 2`	true
`1 >= 2`	false
`1 != 2`	true
`1 < 2`	true
`1 > 2`	false
`2 = 2`	true
`'' == false`	true
`'' === false`	false
`1 = true`	true
`1 === true`	false

例子	结果
`1 + 1`	2
`2 * 2`	4
`1 / 2`	0.5
`9 ** 2`	81
`6 % 5`	1

代码	结果	注释
`"1234" like "12?4"`	True
`"1234" like "12*"`	True
`"foo" in "foobar"`	True
`"foo" regex "\w+"`	True
`"a\b" regex "a\\\\b"`	True	为了使用正则表达式查找转义反斜杠，阁下需要使用四个反斜杠或者两个\x5C。（两者皆可）
`"a\b" regex "a\x5C\x5Cb"`	True

函数名称	描述
`lcase`	返回转换为小写的参数。
`ucase`	返回转换为大写的参数。
`length`	返回作为参数给出的字符串的长度。
`string`	转换到字符串数据类型。
`int`	转换到整数数据类型。
`float`	转换到浮点数数据类型。
`bool`	转换到布尔值数据类型。
`norm`	等同于 `rmwhitespace(rmspecials(rmdoubles(ccnorm(arg1))))`.
`ccnorm`	常规化参数中令人疑惑的或相近的字符，并返回一个候选形式。一个关于这些字符和替代的列表可以在这里找到。^[3] 请注意为了让这个函数生效，扩展 AntiSpoof 需要被安装。如果没有安装，则字符串不会被变更。
`specialratio`	返回非字母数字字符的数量除以参数中的字符总数。
`rmspecials`	删除参数中的任何特殊字符，并返回结果。 (等同于 s/[^\p{L}\p{N}]//g)
`rmdoubles`	删除参数中的重复字符，并返回结果。
`rmwhitespace`	删除空格（空格，制表符，换行符）。
`count`	返回第一个字符串出现在第二个字符串中的次数。如果只给出一个参数，则用逗号分隔它并返回段数。
`rcount`	和 `count` 类似，但是第一个字符串使用正则表达式。可以在正则表达式开头加入 `(?i)` 来使得其大小写不敏感。
`ip_in_range`	如果用户的IP（第一个字符串）匹配指定的IP范围（第二个字符串），则返回真。仅适用于匿名用户。支持IPv4和IPv6地址。
`contains_any`	如果第一个字符串包含以下参数中的任何字符串（无限数量的参数），则返回真。
`substr`	返回第一个字符串的部分，从第二个参数（从0开始）和最大长度（可选的第三个参数）偏移。
`strlen`	和 `length` 相同。
`strpos`	返回第一个字符串中第二个字符串第一次出现的数字位置。函数可能在没有找到时返回0，因此可能被其他比较运算符误解为 false 。最佳方案应该是使用 `===` 或者 `!==` 来判断是否找到字符串。
`str_replace`	用替换字符串替换所有出现的搜索字符串。该函数采用三个以下顺序的参数：要执行搜索的文本，要查找的文本，替换文本。
`rescape`	返回带有转义字符 "\" 的某些字符的参数，以便该字符串可以在正则表达式中使用，但不包含具有特殊含义的字符。
`set`	设置一个变量（第一个字符串）的值为第二个变量（第二个参数）以用于过滤器的后期使用。另一种语法： `name := value`.
`set_var`	和 `set` 相同。

代码	结果	注释
`length( "Wikipedia" )`	9
`lcase( "WikiPedia" )`	wikipedia
`ccnorm( "w1k1p3d14" )`	WIKIPEDIA	`ccnorm` 返回的结果永远大写
`ccnorm( "ωɨƙɩᑭƐƉ1α" )`	WIKIPEDIA
`ccnorm( "ìíîïĩї!ľį₤ĺľḷĿóòôöõǒōŏǫőọ$śŝşšṣ" )`	ìíîïĩї!ľį₤ĺľḷĿóòôöõǒōŏǫőọ$śŝşšṣ	不是所有字符都被常规化了^[3]
`norm( "!!ω..ɨ..ƙ..ɩ..ᑭᑭ..Ɛ.Ɖ@@1%%α!!" )`	WIKIPEDIA
`norm( "F00 B@rr" )`	FOBR	`norm` 清除了空格、特殊字符和重复字符，然后使用`ccnorm`
`rmdoubles( "foobybboo" )`	fobybo
`specialratio( "Wikipedia!" )`	0.1
`count( "foo", "foofooboofoo" )`	3
`count( "foo,bar,baz" )`	3
`rmspecials( "FOOBAR!!1" )`	FOOBAR1
`rescape( "abc* (def)" )`	abc\* \(def\)
`str_replace( "foobarbaz", "bar", "-" )`	foo-baz
`ip_in_range( "127.0.10.0", "127.0.0.0/12" )`	true
`contains_any( "foobar", "x", "y", "f" )`	true

代码	结果
`1 \| 1`	true
`1 \| 0`	true
`0 \| 0`	false
`1 & 1`	true
`1 & 0`	false
`0 & 0`	false
`1 ^ 1`	false
`1 ^ 0`	true
`0 ^ 0`	false
`!1`	false

字面量

注释

变量

全部变量

备注

文章和页面命名空间

简单比较

算数符号

字符串拼接

关键字

函数（方法）

例子

布尔运算

运算数顺序

例子

条件判断计数

有用的链接

备注