regex-assistant

# 正则表达式助手 (Regex Tester)

正则表达式测试与调试工具，帮助开发者快速验证正则表达式、提取匹配结果和执行替换操作。

## 技能目的

提供便捷的正则表达式测试环境，帮助用户：
- 验证正则表达式是否正确匹配目标文本
- 查看捕获分组的内容
- 执行替换操作并预览结果
- 获取详细的匹配信息

## 何时使用此技能

在以下情况下使用此技能：

- 需要测试或调试正则表达式
- 需要从文本中提取特定模式的内容
- 需要进行批量文本替换
- 需要了解正则表达式的匹配行为
- 需要生成常用正则表达式模式

## 功能特性

### 1. 基本匹配测试

测试正则表达式在目标文本中的匹配情况。

```bash
python3 script/main.py match "<正则>" "<文本>"
```

**示例：**
```bash
# 测试邮箱匹配
python3 script/main.py match "[\w.+-]+@[\w-]+\.[\w.-]+" "contact@example.com"

# 测试手机号匹配（中国大陆）
python3 script/main.py match "1[3-9]\d{9}" "13800138000"
```

### 2. 提取所有匹配

获取文本中所有匹配正则表达式的内容。

```bash
python3 script/main.py findall "<正则>" "<文本>"
```

**示例：**
```bash
# 提取所有URL
python3 script/main.py findall "https?://\S+" "访问 https://example.com 和 http://test.org"

# 提取所有数字
python3 script/main.py findall "\d+" "价格: 99, 数量: 100, 总计: 9900"
```

### 3. 分组捕获

查看正则表达式中的捕获分组内容。

```bash
python3 script/main.py groups "<正则>" "<文本>"
```

**示例：**
```bash
# 解析日志格式
python3 script/main.py groups "\[(.*?)\] \[(.*?)\] (.*)" "[2024-02-14] [INFO] 启动服务"

# 解析日期时间
python3 script/main.py groups "(\d{4})-(\d{2})-(\d{2})" "今天是2024-02-14"
```

### 4. 文本替换

使用正则表达式进行文本替换。

```bash
python3 script/main.py sub "<正则>" "<替换内容>" "<文本>"
```

**示例：**
```bash
# 隐藏手机号中间四位
python3 script/main.py sub "(\d{3})\d{4}(\d{4})" "\1****\2" "联系13800138000"

# 去除HTML标签
python3 script/main.py sub "<[^>]+>" "" "<p>你好<b>世界</b></p>"
```

### 5. 常用模式生成

生成常用场景的正则表达式模式。

```bash
python3 script/main.py pattern "<模式名称>"
```

**支持的模式：**
- `email` - 邮箱地址
- `phone` - 中国手机号
- `idcard` - 中国身份证号
- `ipv4`...