import re

def mask_phone(phone: str) -> str:
    """手機號脫敏：保留前3位和后4位，中間用*替換"""
    if not re.match(r'^1[3-9]\d{9}$', phone):  # 簡單校驗手機號格式
        raise ValueError("手機號格式錯誤")
    return re.sub(r'(\d{3})\d{4}(\d{4})', r'\1****\2', phone)

# 測試
print(mask_phone("13812345678"))  # 輸出：138****5678

def mask_id_card(id_card: str) -> str:
    """身份證號脫敏：保留前6位和后4位，中間用*替換"""
    if not re.match(r'^\d{17}[\dXx]$', id_card):  # 簡單校驗身份證格式
        raise ValueError("身份證號格式錯誤")
    return re.sub(r'^(\d{6})\d+(\d{4})$', r'\1********\2', id_card)

# 測試
print(mask_id_card("110101199001011234"))  # 輸出：110101********1234

def mask_email(email: str) -> str:
    """郵箱脫敏：保留首位字符和域名，中間用*替換"""
    if not re.match(r'^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$', email):
        raise ValueError("郵箱格式錯誤")
    name, domain = email.split('@')
    if len(name) == 1:  # 若用戶名只有1位，直接保留
        return f"{name}@****.{domain.split('.')[-1]}"
    return f"{name[0]}****@{domain}"

# 測試
print(mask_email("abcdef@example.com"))  # 輸出：a****@example.com
print(mask_email("a@test.com"))  # 輸出：a@****.com

def mask_address(address: str) -> str:
    """地址脫敏：保留省/市，隱藏詳細(xì)地址（按第一個“區(qū)/縣”后的內(nèi)容替換）"""
    # 簡單規(guī)則：保留到第一個“區(qū)”“縣”“市”后的內(nèi)容
    pattern = re.compile(r'^(.+?[市區(qū)縣])(.*)$')
    match = pattern.match(address)
    if match:
        return f"{match.group(1)}***"
    return "***"  # 若無法匹配，返回完全脫敏

# 測試
print(mask_address("北京市海淀區(qū)中關(guān)村大街1號"))  # 輸出：北京市海淀區(qū)***
print(mask_address("上海市浦東新區(qū)張江高科技園區(qū)"))  # 輸出：上海市浦東新區(qū)***

import random

# 常見姓氏（前100位）和名字常用字
FAMILY_NAMES = ["王", "李", "張", "劉", "陳", "楊", "趙", "黃", "周", "吳", 
                "徐", "孫", "胡", "朱", "高", "林", "何", "郭", "馬", "羅"]
GIVEN_NAMES = ["偉", "芳", "娜", "秀英", "敏", "靜", "強", "磊", "軍", "洋", 
               "勇", "艷", "杰", "娟", "麗", "濤", "明", "超", "秀蘭", "霞"]

def generate_chinese_name() -> str:
    """隨機生成中文姓名（姓氏+1-2字名字）"""
    family_name = random.choice(FAMILY_NAMES)
    given_name = random.choice(GIVEN_NAMES)
    # 隨機選擇1字或2字名字（從GIVEN_NAMES中取前1位或全部）
    given_name = given_name[0] if random.random() < 0.3 else given_name
    return family_name + given_name

# 測試
for _ in range(5):
    print(generate_chinese_name())  # 可能輸出：王磊、李娜、張偉、劉敏、陳杰

from datetime import datetime, timedelta

def generate_fake_id_card() -> str:
    """生成假身份證號（格式正確，地區(qū)碼和出生日期隨機）"""
    # 隨機地區(qū)碼（前6位，這里用常見地區(qū)碼示例）
    area_codes = ["110101", "110102", "310101", "310104", "440106", "440305"]
    area_code = random.choice(area_codes)
    
    # 隨機出生日期（1950-2000年）
    start_date = datetime(1950, 1, 1)
    end_date = datetime(2000, 12, 31)
    delta = end_date - start_date
    random_days = random.randint(0, delta.days)
    birth_date = start_date + timedelta(days=random_days)
    birth_str = birth_date.strftime("%Y%m%d")
    
    # 順序碼（3位，奇數(shù)為男，偶數(shù)為女，這里隨機）
    sequence_code = f"{random.randint(0, 999):03d}"
    
    # 校驗碼（簡化處理，隨機數(shù)字或X）
    check_code = random.choice("0123456789X")
    
    return area_code + birth_str + sequence_code + check_code

# 測試
for _ in range(3):
    print(generate_fake_id_card())  # 可能輸出：11010119850312456X、310101199211237890

def generate_fake_email() -> str:
    """生成隨機郵箱"""
    # 用戶名：6-12位字母+數(shù)字
    username_length = random.randint(6, 12)
    username = ''.join(random.choices("abcdefghijklmnopqrstuvwxyz0123456789", k=username_length))
    # 常見域名
    domains = ["gmail.com", "qq.com", "163.com", "outlook.com", "yahoo.com"]
    domain = random.choice(domains)
    return f"{username}@{domain}"

# 測試
for _ in range(3):
    print(generate_fake_email())  # 可能輸出：x7y3z9w@qq.com、abc123def@163.com

def generate_fake_ipv4() -> str:
    """生成隨機IPv4地址"""
    ip_segments = [str(random.randint(0, 255)) for _ in range(4)]
    return ".".join(ip_segments)

# 測試
for _ in range(3):
    print(generate_fake_ipv4())  # 可能輸出：192.168.1.100、10.0.0.1、255.255.255.255

class DataMasker:
    @staticmethod
    def mask_phone(phone): ...  # 手機號脫敏
    @staticmethod
    def mask_id_card(id_card): ...  # 身份證脫敏
    @staticmethod
    def generate_chinese_name(): ...  # 生成姓名
    # 其他方法...