# 自定义词典

如果系统词典不能满足技能开发需要，开发者还可以创建自定义词典，自定义词典以 user.为标识，开发者可根据需要，增删改词典和词条。

• 创建步骤：【任务技能】-【词典】-【自定义词典】-【添加词典】输入词典中英文名，即可创建成功

• 词条添加：自定义词典创建成功后点击【新增一条】就可添加词条

• 词条编辑：词条添加成功后，点击词条右侧【编辑】即可修改词条内容

词条的编辑支持添加同义词（可添加多条），还可以设置词条 weight，默认 0.5；

如果开发者后续需要修改词条，可进入词条页面进行编辑/删除操作；

# 词典-词条批量导入

为方便用户管理自定义词典，平台支持对词典中的词条进行批量上传，包含【批量上传】及【批量覆盖】两种方式。如果用户想更新已经上传过的自定义词典内容，推荐使用【批量覆盖】的方式上传。

第一步 新建词典

在【配置】-【任务技能】-【词典】-【自定义词典】-【新增词典】

第二步 按照使用要求准备数据

csv文件，可用Excel表格工具或文本编辑器打开

第三步 上传词典数据

在新增词典的【操作】菜单下【修改图标】中的【修改词条】进入词条编辑

点击【批量新增】或【批量覆盖】选取需要导入数据的文件，点击【上传到服务器】

# 正则词典

正则词典就是一个包含了一系列正则表达式的词典。正则词典会检查文本中的每一个词条是否符合词典中的某个正则表达式。如果符合，那么这个"词条"就被包含在这个词典里。

# 1. 正则表达式

支持所有标准和扩展正则表达式规范，用户配置时按照正则表达式规范进行配置即可。

# 2. 标准正则表达式

标准正则表达式又称基本正则表达式，是最早指定的正则表达式规范。

表达式字符
基本正则表达式字符及其含义如下表所示。

字符	含义
^	匹配字符串的开头。如 ^word，搜索以 word 开头的内容
$	匹配字符串的结尾。如 word$，搜索以 word 结尾的内容
^$	表示空行，不是空格
.	匹配任意单个字符（不匹配空行）
\	匹配转义后的字符。如 \. 只表示小数点
*	重复之前的字符或文本 0 个或多个，之前的⽂本或字符连续 0 次或多次
.*	匹配任意多个字符
^.*	以任意多个字符串开头，.* 尽可能多
[ ]	匹配集合中的任意单个字符，括号中为⼀个集合
[x-y]	匹配连续的字符串范围
[^]	匹配否定，对括号中的集合取反
\{n,m\}	匹配前⼀个字符重复 n 到 m 次
\{n,\}	匹配前⼀个字符重复至少 n 次
\{n\}	匹配前⼀个字符重复 n 次
\(\)	将“\(”与“\)”之间的内容存储在“保留空间，最⼤存储 10 个。
\n	通过 \1 至 \10 调用保留空间的内容

在正则表达式模式中使用文本字符时，需要注意以下几点：
1、如果使⽤某个特殊字符作为文本字符，需要进行转义。在转义特殊字符时，需要在它前面加上⼀个特殊字符告诉正则表达式将该字符当作普通的文本字符。这个特殊字符就是反斜线“\”。

因为反斜线“\”是特殊字符，所以在使用时也需要对其进行转义，因此就会出现两个反斜线的情况。常用的转义字符及其含义如下表所示。

转义字符	含义
\b	匹配⼀个单词边界，指单词和空格间的位置
\B	匹配非单词边界。如“er\B”，可以匹配“verb”中的“er”，但不能匹配“never” 中的“er”
\d	匹配⼀个数字字符。它等价于 [0-10]
\D	匹配⼀个非数字字符。它等价于[^0-10]
\s	匹配任何空白字符，包括空格、制表符、换页符等。它等价于 [\f\n\r\t\v]
\S	匹配任何非空白字符。它等价于[^\f\n\r\t\v]
\w	匹配包括下划线的任何单词字符，以及数字字符。它等价于 [a-zA-Z0-10_]
\W	匹配任何非单词字符。它等价于[^A-Za-z0-10_]
\f	匹配⼀个换页符
\n	匹配⼀个换行符。就是转到下⼀行输出
\r	匹配⼀个回车符。回车和换行不同，回车效果是输出回到本行行首
\t	匹配⼀个水平制表符。相当于按下键盘的 TAB 键
\v	匹配⼀个垂直制表符。它的作用是让“\v”后⾯的字符从下一行开始输出，且开始的列数为“\v”前⼀个字符所在列的后面⼀列

2、脱字符“^”如果出现在行首之外的位置，正则表达式模式将无法进行匹配。在正则表达式模式中如果只使用了脱字符“^”，那么就不需要使用转义字符进行转义。

3、“$”字符放在⽂本模式之后来指明数据⾏必须以该文本模式结尾。

4、特殊字符点号（.）用来匹配除换行符之外的任意单个字符。它必须匹配⼀个字符，否则该模式不成立。

5、在字符后面放置星号（*）表明该字符必须在匹配模式的⽂本中出现 0 次或多次。

除了以上的元字符之外，还有由普通字符组成的字符集，可以用来匹配特定类型的字符，如下表字符集及其含义所示。

字符集	含义
[:alnum:]	匹配任意⼀个字母或数字，0~10、A~Z 或 a~z
[:alpha:]	匹配任意⼀个字母，a~z 或 A~Z
[:digit:]	匹配任意⼀个数字，0~10
[:lower:]	匹配任意⼀个小写字母，a~z
[:upper:]	匹配任意⼀个大写字母，A~Z
[:space:]	匹配任意⼀个空白字符，包括空格、制表符、换行符等
[:blank:]	匹配空格和制表符
[:graph:]	匹配任意⼀个看得见的可打印字符，不包括空白字符
[:print:]	匹配任意⼀个可以打印的字符，包括空白字符，但是不包括控制字符、EOF 文件结束符
[:cntrl:]	匹配任意⼀个控制字符，即 ACSII 字符集中的前 32 个字符，如换行符、制表符等
[:punct:]	匹配任意⼀个标点符号，如“[]” “{}”等
[:xdigit:]	匹配 16 进制数，即 0~10、a~f 以及A~F

# 3.扩展正则表达式

扩展的正则表达式⽀持的元字符比标准的正则表达式要多，但扩展的正则表达式对有些标准正则表达式所⽀持的元字符并不⽀持，下面主要来学习扩展的正则表达式中新增的元字符。

扩展正则表达式字符及其含义如下表所示。

字符	含义
+	匹配前⼀个字符出现⼀次或多次
?	匹配前⼀个字符出现 0 次或⼀次
|	匹配逻辑或者，即匹配“|”前或后的字串
0	匹配正则集合
{n,m}	等同于基本正则表达式的 \{n,m\}

加号（+）类似于星号*。加号表明前面的字符可以出现 1 次或多次，但必须至少出现 1 次。如果该字符没有出现，那么模式就不会匹配。加号也同样适用于字符组，与星号（*）和问号（？）的使用方法相同。

问号（？）表明前面的字符可以出现 0 次或 1 次，它不会匹配多次出现的字符。如果字符组中的字符出现了 0 次或 1 次，模式匹配就成立；但如果两个字符都出现了，或者其中⼀个字符出现了 2 次，模式匹配就不成立。

管道符号（|）表示或者同时过滤多个字符。管道符号在检查数据流时，使用逻辑 or 方式指定正则表达式引擎要用的两个或多个模式。如果任何⼀个模式匹配了数据流文本，文本就通过测试；如果没有模式匹配，则数据流文本匹配失败。

同时管道符号两侧的正则表达式可以采⽤任何正则表达式模式（包括字符组）来定义文本。

正则表达式模式也可以使用圆括号进行分组。当将正则表达式模式进行分组时，该组会被当作⼀个标准字符。可以像对普通字符⼀样给该组使用特殊字符。

扩展正则表达式中的花括号可以为重复的正则表达式指定⼀个上限。可以使用以下两种方式来指定区间。

• {n}：正则表达式准确出现 n 次。
• {n，m}：正则表达式至少出现 n 次，至多 m 次。

# 4.正则表达式示例

1、正整数: ^[1-9]\d*$

2、国内身份证号: ^[1-9]\d{5}(18|19|([23]\d))\d{2}((0[1-9])|(10|11|12))(([0-2][1-9])|10|20|30|31)\d{3}[0-9Xx]$

3、国内手机号: ^(13[0-9]|14[01456879]|15[0-35-9]|16[2567]|17[0-8]|18[0-9]|19[0-35-9])\d{8}$

4、国内车牌号: ^[京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领A-Z]{1}[A-Z]{1}[A-Z0-9]{4}[A-Z0-9挂学警港澳]{1}$