neverlib 0.2.8__py3-none-any.whl → 0.3.0__py3-none-any.whl

neverlib/tests/__init__.py

@@ -4,7 +4,7 @@
 from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
-    # 仅在类型检查时导入，提供IDE补全支持
+    # 仅在类型检查时导入, 提供IDE补全支持
     from .test_preprocess import test_NS_shape, test_pre_emphasis
     from .test_vad import test_vad2nad
 
@@ -30,4 +30,4 @@ if TYPE_CHECKING:
         'test_NS_shape',
         'test_pre_emphasis',
         'test_vad2nad',
-    ]
+    ]

neverlib/tests/test_imports.py

@@ -11,7 +11,7 @@ import time
 from neverlib.utils import get_path_list
 from neverlib.data_analyze.dataset_analyzer import AudioFileInfo
 
-# 确保当前目录在Python路径中，以便导入neverlib
+# 确保当前目录在Python路径中, 以便导入neverlib
 # sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
 sys.path.append("../..")
 print("开始测试neverlib导入功能...")

neverlib/utils/README.md

@@ -0,0 +1,29 @@
+prsync
+来源：https://github.com/nathanhaigh/parallel-rsync
+用法
+如果您的命令如下所示：rsync
+
+```bash
+rsync \
+  --times --recursive --progress \
+  --exclude "raw_reads" --exclude ".snakemake" \
+  user@example.com:/my_remote_dir/ /my_local_dir/
+```
+只需替换此脚本的可执行文件：rsync
+```bash
+./prsync \
+  --times --recursive --progress \
+  --exclude "raw_reads" --exclude ".snakemake" \
+  user@example.com:/my_remote_dir/ /my_local_dir/
+  ```
+
+并行作业数
+默认情况下, 脚本将为计算机上的每个处理器使用 1 个并行作业.  这是由确定的, 如果失败, 我们将回退到并行作业来传输文件.  
+可以通过使用作为脚本的第一个命令行参数来覆盖此行为：```nproc 10 --parallel```
+```bash
+./prsync \
+  --parallel=20 \
+  --times --recursive --progress \
+  --exclude "raw_reads" --exclude ".snakemake" \
+  user@example.com:/my_remote_dir/ /my_local_dir/
+```

neverlib/utils/__init__.py

@@ -4,14 +4,15 @@
 from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
-    # 仅在类型检查时导入，提供IDE补全支持
+    # 仅在类型检查时导入, 提供IDE补全支持
     from .audio_split import audio_split_VADfunasr, audio_split_VADsilero, audio_split_ffmpeg, audio_split_np, audio_split_pydub, audio_split_random, audio_split_sox
-    from .checkGPU import get_gpu_utilization, is_gpu_idle, monitor_gpu_utilization
+    from .checkGPU import get_gpu_utilization, get_gpu_utilization2, monitor_gpu_utilization
+    from .floder import change_path, del_empty_folders, get_leaf_folders, rename_files_and_folders
     from .lazy_expose import attach_and_expose_all
     from .lazy_module import LazyModule
     from .message import send_QQEmail, send_QQEmail_with_images
-    from .utils import DatasetSubfloderSplit, TrainValSplit, TrainValTestSplit, del_empty_folders, get_audio_segments, get_file_time, \
-        get_leaf_folders, get_path_list, pcm2wav, read_pcm, rename_files_and_folders, save_weight_histogram, wav2pcm, EPS
+    from .pcm import pcm2wav, read_pcm, wav2pcm
+    from .utils import DatasetSubfloderSplit, TrainValSplit, TrainValTestSplit, del_duplicate_path, get_audio_segments, get_file_time, get_path_list, log_time, merge_tensorboard, remove_parent_dir_prefix, save_weight_histogram
 
 # 运行时使用懒加载
 from lazy_loader import attach
@@ -21,19 +22,22 @@ __getattr__, __dir__, __all__ = attach(
     submodules=[
         "audio_split",
         "checkGPU",
+        "floder",
         "lazy_expose",
         "lazy_module",
         "message",
+        "pcm",
         "utils",
     ],
     submod_attrs={
         "audio_split": ['audio_split_VADfunasr', 'audio_split_VADsilero', 'audio_split_ffmpeg', 'audio_split_np', 'audio_split_pydub', 'audio_split_random', 'audio_split_sox'],
-        "checkGPU": ['get_gpu_utilization', 'is_gpu_idle', 'monitor_gpu_utilization'],
+        "checkGPU": ['get_gpu_utilization', 'get_gpu_utilization2', 'monitor_gpu_utilization'],
+        "floder": ['change_path', 'del_empty_folders', 'get_leaf_folders', 'rename_files_and_folders'],
         "lazy_expose": ['attach_and_expose_all'],
         "lazy_module": ['LazyModule'],
         "message": ['send_QQEmail', 'send_QQEmail_with_images'],
-        "utils": ['DatasetSubfloderSplit', 'TrainValSplit', 'TrainValTestSplit', 'del_empty_folders', 'get_audio_segments', 'get_file_time', 'get_leaf_folders',
-                  'get_path_list', 'pcm2wav', 'read_pcm', 'rename_files_and_folders', 'save_weight_histogram', 'wav2pcm', "EPS"],
+        "pcm": ['pcm2wav', 'read_pcm', 'wav2pcm'],
+        "utils": ['DatasetSubfloderSplit', 'TrainValSplit', 'TrainValTestSplit', 'del_duplicate_path', 'get_audio_segments', 'get_file_time', 'get_path_list', 'log_time', 'merge_tensorboard', 'remove_parent_dir_prefix', 'save_weight_histogram'],
     }
 )
 
@@ -48,24 +52,28 @@ if TYPE_CHECKING:
         'audio_split_random',
         'audio_split_sox',
         'get_gpu_utilization',
-        'is_gpu_idle',
+        'get_gpu_utilization2',
         'monitor_gpu_utilization',
+        'change_path',
+        'del_empty_folders',
+        'get_leaf_folders',
+        'rename_files_and_folders',
         'attach_and_expose_all',
         'LazyModule',
         'send_QQEmail',
         'send_QQEmail_with_images',
+        'pcm2wav',
+        'read_pcm',
+        'wav2pcm',
         'DatasetSubfloderSplit',
         'TrainValSplit',
         'TrainValTestSplit',
-        'del_empty_folders',
+        'del_duplicate_path',
         'get_audio_segments',
         'get_file_time',
-        'get_leaf_folders',
         'get_path_list',
-        'pcm2wav',
-        'read_pcm',
-        'rename_files_and_folders',
+        'log_time',
+        'merge_tensorboard',
+        'remove_parent_dir_prefix',
         'save_weight_histogram',
-        'wav2pcm',
-        'EPS',
-    ]
+    ]

neverlib/utils/audio_split.py

@@ -12,20 +12,20 @@ import numpy as np
 from .utils import get_path_list
 
 
-def audio_split_ffmpeg(source_path, target_path, sr, channel_num, duration, endwith="*.pcm"):
+def audio_split_ffmpeg(source_dir, target_dir, sr, channel_num, duration, endwith="*.pcm"):
     """ 切割音频切不准, 会留点尾巴0.016s
     使用ffmpeg分割音频, 分割为短音频(单位:秒), 似乎无法非常准确的分割到指定长度
-    :param source_path: 源音频路径
-    :param target_path: 目标音频路径
+    :param source_dir: 源音频路径
+    :param target_dir: 目标音频路径
     :param sr: 源音频采样率
     :param channel_num: 源音频声道数
     :param duration: 分割为时长(短音频)(单位:秒)
     :param endwith: 音频格式(支持pcm和wav)
     """
-    wav_path_list = get_path_list(source_path, end=endwith)
+    wav_path_list = get_path_list(source_dir, end=endwith)
     print("待分割的音频数: ", len(wav_path_list))
     for wav_path in wav_path_list:
-        wav_folder = wav_path[:-4].replace(source_path, target_path)
+        wav_folder = wav_path[:-4].replace(source_dir, target_dir)
         os.makedirs(wav_folder, exist_ok=True)
 
         if endwith == "*.pcm":
@@ -45,19 +45,19 @@ def audio_split_ffmpeg(source_path, target_path, sr, channel_num, duration, endw
     print("分割完毕: done!")
 
 
-def audio_split_sox(source_path, target_path, duration, endwith="*.wav"):
+def audio_split_sox(source_dir, target_dir, duration, endwith="*.wav"):
     """
     使用sox分割音频, 分割为短音频(单位:秒), 可以非常准确的分割到指定长度
-    :param source_path: 源音频路径
-    :param target_path: 目标音频路径
+    :param source_dir: 源音频路径
+    :param target_dir: 目标音频路径
     :param duration: 分割为时长(短音频)(单位:秒)
     :param endwith: 音频格式(只支持wav)
     """
     assert endwith == "*.wav", "只支持wav格式的音频"
-    wav_path_list = get_path_list(source_path, end=endwith)
+    wav_path_list = get_path_list(source_dir, end=endwith)
 
     for wav_path in wav_path_list:
-        wav_folder = wav_path[:-4].replace(source_path, target_path)
+        wav_folder = wav_path[:-4].replace(source_dir, target_dir)
         os.makedirs(wav_folder, exist_ok=True)
 
         output_pattern = f"{wav_folder}/%.wav"
@@ -71,25 +71,25 @@ def audio_split_sox(source_path, target_path, duration, endwith="*.wav"):
     print("分割完毕: done!")
 
 
-def audio_split_np(source_path, target_path, sr, channel_num, duration, endwith="*.pcm"):
+def audio_split_np(source_dir, target_dir, sr, channel_num, duration, endwith="*.pcm"):
     """
     使用numpy读取pcm文件并切割保存为wav文件, 保持通道数一致, 保存不足30秒的最后一段音频
-    :param source_path: 源音频路径
-    :param target_path: 目标音频路径
+    :param source_dir: 源音频路径
+    :param target_dir: 目标音频路径
     :param sr: 采样率
     :param channel_num: 声道数
     :param duration: 分割的时长 (秒)
     :param endwith: 音频格式 (支持 pcm)
     """
     assert endwith == "*.pcm", "只支持pcm格式的音频"
-    wav_path_list = get_path_list(source_path, end=endwith)  # 获取音频文件列表
+    wav_path_list = get_path_list(source_dir, end=endwith)  # 获取音频文件列表
     print("待分割的音频数: ", len(wav_path_list))
 
     segment_length_samples = duration * sr  # 每个切片音频的采样点数
 
     for wav_path in wav_path_list:
         print("正在分割: ", wav_path)
-        wav_folder = wav_path[:-4].replace(source_path, target_path)
+        wav_folder = wav_path[:-4].replace(source_dir, target_dir)
         os.makedirs(wav_folder, exist_ok=True)
 
         # 注意读取时使用正确的dtype(例如int16表示16位PCM)
@@ -119,11 +119,11 @@ def audio_split_np(source_path, target_path, sr, channel_num, duration, endwith=
     print("分割完毕: done!")
 
 
-def audio_split_pydub(source_path, target_path, sr, channel_num, duration, endwith="*.pcm", sample_width=2):
+def audio_split_pydub(source_dir, target_dir, sr, channel_num, duration, endwith="*.pcm", sample_width=2):
     """
     使用pydub分割音频, 进行精确的分割
-    :param source_path: 源音频路径
-    :param target_path: 目标音频路径
+    :param source_dir: 源音频路径
+    :param target_dir: 目标音频路径
     :param sr: 源音频采样率
     :param channel_num: 源音频声道数
     :param duration: 分割为时长(短音频)(单位:秒), 必须是1s的整数倍
@@ -136,12 +136,12 @@ def audio_split_pydub(source_path, target_path, sr, channel_num, duration, endwi
         raise ImportError("需要安装 pydub 才能使用 audio_split_pydub: pip install pydub") from e
 
     assert duration % 1 == 0, "duration必须是1s的整数倍"
-    wav_path_list = get_path_list(source_path, end=endwith)  # 获取音频文件列表
+    wav_path_list = get_path_list(source_dir, end=endwith)  # 获取音频文件列表
     print("待分割的音频数: ", len(wav_path_list))
 
     for wav_path in wav_path_list:
         print("正在分割: ", wav_path)
-        wav_folder = wav_path[:-4].replace(source_path, target_path)  # 设置目标文件夹
+        wav_folder = wav_path[:-4].replace(source_dir, target_dir)  # 设置目标文件夹
         os.makedirs(wav_folder, exist_ok=True)
 
         # 使用pydub加载音频
@@ -170,7 +170,7 @@ def audio_split_pydub(source_path, target_path, sr, channel_num, duration, endwi
 
 def audio_split_random(source_dir, target_dir, min_duration=3, max_duration=10, sr=16000):
     """
-    将音频切割成 3 到 10 秒的多个片段并保存。
+    将音频切割成 3 到 10 秒的多个片段并保存. 
     参数:
     - input_audio_path: 输入音频文件路径
     - output_dir: 输出音频文件夹路径

neverlib/utils/checkGPU.py

@@ -1,43 +1,17 @@
-# -*- coding:utf-8 -*-
-# Author:凌逆战 | Never
-# Date: 2024/2/13
-"""
+'''
+Author: 凌逆战 | Never
+Date: 2025-09-24 14:28:42
+Description: 
 检查GPU时候空闲
 nohup python -u ./checkGPU.py > ./checkGPU.log 2>&1 &
 pid 5993
-"""
+'''
 import time
 import subprocess
 import numpy as np
 from .message import send_QQEmail
 
 
-def is_gpu_idle():
-    try:
-        import GPUtil
-    except ImportError:
-        raise ImportError(
-            "GPUtil is required for is_gpu_idle(). "
-            "Please install it via `pip install checkGPU`."
-        )
-    try:
-        # 获取所有可见的GPU设备列表
-        gpus = GPUtil.getGPUs()
-        # print(len(gpus), gpus)
-        gpu0, gpu1, gpu2, gpu3, gpu4, gpu5, gpu6, gpu7 = gpus  # 8块GPU
-        # gpu.memoryUtil表示GPU的内存利用率
-        # gpu.load表示GPU的计算利用率
-        # gpu.memoryTotal表示GPU的总内存
-        # gpu.memoryUsed表示GPU的已使用内存
-        # gpu.memoryFree表示GPU的空闲内存
-        if gpu0.load == 0.0 and gpu1 == 0.0 and gpu2 == 0.0 and gpu3 == 0.0:
-            return True
-        return False
-    except Exception as e:
-        print(f"Error checking GPU utilization: {e}")
-        return False
-
-
 def get_gpu_utilization():
     """
     Returns: 返回所有GPU利用率列表
@@ -53,9 +27,31 @@ def get_gpu_utilization():
         return None
 
 
+def get_gpu_utilization2(gpu_id=None):
+    try:
+        import GPUtil
+    except ImportError:
+        raise ImportError(
+            "GPUtil is required for is_gpu_idle(). "
+            "Please install it via `pip install gputil`."
+        )
+    gpus = GPUtil.getGPUs()  # 获取所有可见的GPU设备列表
+    # gpu.memoryUtil表示GPU的内存利用率
+    # gpu.load表示GPU的计算利用率
+    # gpu.memoryTotal表示GPU的总内存
+    # gpu.memoryUsed表示GPU的已使用内存
+    # gpu.memoryFree表示GPU的空闲内存
+    # 返回所有显卡的利用率列表
+    gpu_utilization = np.array([gpu.load * 100 for gpu in gpus])
+    if gpu_id is not None:
+        return gpu_utilization[gpu_id]
+    return gpu_utilization
+
+
 # 监控显卡利用率
-def monitor_gpu_utilization(check_interval=5, duration_limit=300, threshold=20,
-                            MonitorGPUs=[0, 1, 2, 3, 4, 5, 6, 7],
+def monitor_gpu_utilization(check_interval=600, duration_limit=1800, threshold=20,
+                            MonitorGPUs=None,
+                            from_name="凌逆战",
                             from_email="xxxxx@qq.com",
                             from_password="xxxxxxx",
                             to_email="xxxxx@qq.com"):
@@ -65,58 +61,35 @@ def monitor_gpu_utilization(check_interval=5, duration_limit=300, threshold=20,
     threshold = 20  # 利用率阈值
     Returns:
     """
-    alarm_times = 0  # 报警次数
-    max_alarm_times_1day = 10  # 24小时内最大报警次数
-
-    timer_start = time.time()
-    last_alarm_time = 0
-    host_ip = subprocess.check_output(['hostname', '-I']).decode('utf-8').split()[0]
-    print(f"Host IP: {host_ip}")
+    host_ip = subprocess.check_output(['hostname', '-I']).decode('utf-8').split()[0]    # 172.16.64.33
 
     while True:
-        utilization_mean = []
-        for i in range(duration_limit // check_interval):
-            utilization = get_gpu_utilization()
-            if utilization is None:
-                continue
+        utilization_mean = []   # 平均利用率
+        for i in range(duration_limit // check_interval):  # 30分钟平均一次, 每10分钟检查一次
+            utilization = get_gpu_utilization2(MonitorGPUs)
             utilization = np.array(utilization)
             utilization_mean.append(utilization)
-            time.sleep(check_interval)  # 每隔5秒检查一次
-
-        utilization_mean = np.mean(np.array(utilization_mean), axis=0)
+            time.sleep(check_interval)  # 每隔check_interval分钟检查一次
+        utilization_mean = np.mean(utilization_mean, axis=0)
         t_now = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
-        print(f"T:{t_now} GPU Utilization: {utilization}")
-
-        if utilization_mean is not None:
-            alarm_flag = False
-            for gpu_id in MonitorGPUs:
-                if utilization_mean[gpu_id] < threshold:
-                    alarm_flag = True
-                    break
+        print(f"{t_now} GPU Utilization: {utilization}")  # [95. 50. 91. 83. 84. 65. 95. 82.]
 
-            if alarm_flag and alarm_times < max_alarm_times_1day:
-                t_now = time.time()
-                if t_now - last_alarm_time > 3600.0:
-                    send_QQEmail(title=f"GPU利用率警告",
-                                 content=f"GPU 利用率低于 {threshold}% 在 {duration_limit} 秒内. "
-                                 f"host ip: {host_ip}, 当前GPU利用率为:{utilization_mean}.",
-                                 from_email=from_email,
-                                 from_password=from_password,
-                                 to_email=to_email)
-
-                    alarm_times += 1
-                    last_alarm_time = time.time()
-        # clean max_alarm_times_1day if 24 hours passed
-        if time.time() - timer_start > 24 * 3600.0:
-            alarm_times = 0
-            timer_start = time.time()
+        # 如果有GPU利用率低于阈值, 则发送邮件
+        if np.any(utilization_mean < threshold):
+            send_QQEmail(title=f"GPU利用率警告",
+                         content=f"服务器: {host_ip}\n {t_now} GPU利用率为:{utilization}. 低于阈值 {threshold}% \n",
+                         from_name=from_name,
+                         from_email=from_email,
+                         from_password=from_password,
+                         to_email=to_email)
+            print(f"Alarm sent: GPU utilization below {threshold}% for GPU(s) {utilization_mean}")
 
 
 if __name__ == "__main__":
-    while True:
-        if is_gpu_idle():
-            send_QQEmail("GPU", "GPU 处于空闲状态.")
-        else:
-            print("GPU 处于繁忙状态.")
-        # 休眠半个小时（1800秒）
-        time.sleep(30 * 60)
+    # print(get_gpu_utilization2(gpu_id=3))
+    monitor_gpu_utilization(check_interval=1, duration_limit=3, threshold=100,
+                            MonitorGPUs=[4, 5, 6, 7],
+                            from_name="xxx",
+                            from_email="xxxxxx@qq.com",
+                            from_password="xxxxxxx",
+                            to_email="xxxxxx@qq.com", )

neverlib/utils/floder.py

@@ -0,0 +1,115 @@
+'''
+Author: 凌逆战 | Never
+Date: 2025-03-26 22:13:21
+Description: 路径层级互换(支持 Windows / Linux / macOS)
+'''
+
+import os
+import shutil
+from pathlib import Path
+from neverlib.utils import get_path_list
+
+
+def get_leaf_folders(directory):
+    # 获取最底层的文件夹路径
+    leaf_folders = []
+    for root, dirs, _ in os.walk(directory):
+        if not dirs:  # 如果当前文件夹没有子文件夹
+            leaf_folders.append(root)
+    return leaf_folders
+
+
+def rename_files_and_folders(directory, replace='_-', replacement='_'):
+    # 将路径的指定字符替换为指定字符
+    for root, dirs, files in os.walk(directory):
+        for filename in files:
+            if replace in filename:
+                new_filename = filename.replace(replace, replacement)
+                old_path = os.path.join(root, filename)
+                new_path = os.path.join(root, new_filename)
+                os.rename(old_path, new_path)
+                print(f'Renamed file: {old_path} -> {new_path}')
+
+        for folder in dirs:
+            if replace in folder:
+                new_folder = folder.replace(replace, replacement)
+                old_path = os.path.join(root, folder)
+                new_path = os.path.join(root, new_folder)
+                os.rename(old_path, new_path)
+                print(f'Renamed folder: {old_path} -> {new_path}')
+
+
+def del_empty_folders(path):
+    """递归删除空文件夹(先删除子文件夹, 再删除父文件夹)"""
+    if not os.path.isdir(path):
+        return
+
+    # 获取子文件夹
+    subfolders = [
+        os.path.join(path, d) for d in os.listdir(path)
+        if os.path.isdir(os.path.join(path, d))
+    ]
+
+    # 递归处理子文件夹
+    for subfolder in subfolders:
+        del_empty_folders(subfolder)
+
+    # 如果文件夹为空, 则删除
+    if not os.listdir(path):
+        os.rmdir(path)
+        print(f"删除空文件夹: {path}")
+
+
+def change_path(source_dir, idx_1, idx_2):
+    # 统一路径类型
+    source_dir = Path(source_dir)
+    path_list = [Path(p) for p in get_path_list(str(source_dir), end="*.*")]
+
+    print("\n📂 文件路径变更预览(前 5 个):\n")
+    preview_count = min(5, len(path_list))
+
+    for i in range(preview_count):
+        path = path_list[i]
+        parts = list(path.parts)  # 各层级组成的元组
+        try:
+            # 交换指定索引层级
+            parts[idx_1], parts[idx_2] = parts[idx_2], parts[idx_1]
+        except IndexError:
+            print(f"[警告] 索引越界：文件 {path}")
+            continue
+
+        new_path = Path(*parts)
+        print(f"原路径: {path}")
+        print(f"新路径: {new_path}\n")
+
+    # 交互确认
+    user_input = input("是否确认对所有文件进行以上变更? (y/n): ").strip().lower()
+    if user_input != "y":
+        print("❌ 操作已取消. ")
+        return
+
+    print("\n🚀 开始批量处理文件...")
+    for path in path_list:
+        parts = list(path.parts)
+        try:
+            parts[idx_1], parts[idx_2] = parts[idx_2], parts[idx_1]
+        except IndexError:
+            print(f"[跳过] 索引错误：{path}")
+            continue
+
+        new_path = Path(*parts)
+        new_path.parent.mkdir(parents=True, exist_ok=True)
+        try:
+            shutil.move(str(path), str(new_path))
+        except Exception as e:
+            print(f"[错误] 无法移动 {path} -> {new_path}: {e}")
+
+    print("\n✅ 所有文件处理完成！")
+    del_empty_folders(str(source_dir))  # 清理空文件夹
+    print("🧹 已清空空目录. ")
+
+
+if __name__ == "__main__":
+    # 示例路径(自动根据系统适配)
+    source_dir = Path("/data01/never/Dataset/kws_data/Command_Word_NN_wrong_high/Crowdsourcing_wash/zh_kws/train/RealPerson")
+    change_path(source_dir, 10, 11)

neverlib/utils/lazy_expose.py

@@ -21,7 +21,7 @@ def attach_and_expose_all(pkg_name: str, g: dict, submodules, submod_attrs=None)
             raise
 
     def __dir__():
-        # 避免为补全而导入所有子模块，保持冷启动轻量
+        # 避免为补全而导入所有子模块, 保持冷启动轻量
         # 仅返回 attach 提供的名称 + 已经懒暴露过的名称
         return sorted(set(_dir()) | _all_set)
 

neverlib/utils/lazy_module.py

@@ -10,7 +10,7 @@ from typing import Dict, Tuple, Union, Iterable
 
 class LazyModule(ModuleType):
     """
-    一个懒加载模块，可以按需导入子模块或对象。
+    一个懒加载模块, 可以按需导入子模块或对象. 
     - 支持 name -> 'pkg.subpkg.module' 的懒导入(返回模块对象)
     - 支持 name -> ('pkg.subpkg.module', 'attr') 的懒导入(返回模块内的对象)
     - 透传 __spec__/__path__/__all__ 以兼容 import 系统和 IDE 补全
@@ -35,7 +35,7 @@ class LazyModule(ModuleType):
             self.__dict__["__spec__"] = module_spec
         if module_path is not None:
             self.__dict__["__path__"] = list(module_path)
-        # 若存在代理模块，则不预设 __all__，避免阻断 import * 的 dir() 行为
+        # 若存在代理模块, 则不预设 __all__, 避免阻断 import * 的 dir() 行为
         if not proxy_modules:
             self.__dict__["__all__"] = sorted(list(import_structure.keys()))
 
@@ -56,7 +56,7 @@ class LazyModule(ModuleType):
                 obj = getattr(module, attr_name)
                 setattr(self, name, obj)
                 return obj
-        # 若未在显式映射中，尝试到代理模块中查找公开符号
+        # 若未在显式映射中, 尝试到代理模块中查找公开符号
         for proxy_name in self.__dict__.get("_proxy_modules", []):
             mod_cache_key = f"__proxy__::{proxy_name}"
             module = self.__dict__["_modules"].get(mod_cache_key)
@@ -67,12 +67,12 @@ class LazyModule(ModuleType):
                 obj = getattr(module, name)
                 setattr(self, name, obj)
                 return obj
-        raise AttributeError(f"Module {self.__name__} has no attribute {name}")  # 如果模块没有属性，则抛出异常
+        raise AttributeError(f"Module {self.__name__} has no attribute {name}")  # 如果模块没有属性, 则抛出异常
 
     def __dir__(self):
-        # 将懒加载键与现有属性合并，便于 IDE 补全
+        # 将懒加载键与现有属性合并, 便于 IDE 补全
         keys = set(self.__dict__.keys()) | set(self.__dict__.get("_import_structure", {}).keys())
-        # 若配置了代理模块，将其公开符号加入补全(会触发代理模块导入)
+        # 若配置了代理模块, 将其公开符号加入补全(会触发代理模块导入)
         for proxy_name in self.__dict__.get("_proxy_modules", []):
             module = importlib.import_module(proxy_name)
             for n in dir(module):

neverlib/utils/message.py

@@ -26,10 +26,9 @@ def send_QQEmail(title, content, from_name, from_email, from_password, to_email)
     HOST = "smtp.qq.com"
 
     # 设置邮件正文
-    message = MIMEText(content, "plain", "utf-8")
+    message = MIMEText(content, "html", "utf-8")
     message["Subject"] = Header(title, charset="utf-8")
     message["From"] = formataddr((from_name, from_email))
-    # message["From"] = Header(from_email)
     message["To"] = Header(to_email)
 
     try:
@@ -48,7 +47,7 @@ def send_QQEmail_with_images(title, content, from_name, from_email, from_passwor
     """
     发送包含多张PNG图片附件的QQ邮件
     :param title: 邮件标题
-    :param content: 邮件正文内容（支持HTML格式）
+    :param content: 邮件正文内容(支持HTML格式)
     :param from_email: 发件人邮箱
     :param from_password: 发件人邮箱SMTP授权码
     :param to_email: 收件人邮箱

neverlib/utils/pcm.py

@@ -0,0 +1,42 @@
+
+import numpy as np
+import soundfile as sf
+
+
+def pcm2wav(pcm_path, wav_path, sr=16000, channels=1, subtype='PCM_16'):
+    """
+    将pcm文件转换为wav文件
+    :param pcm_path: pcm文件路径
+    :param wav_path: wav文件路径
+    :param sr: 采样率
+    :param channels: 声道数
+    :param subtype: 子类型
+    """
+    pcm_data = np.fromfile(pcm_path, dtype=np.int16)
+    pcm_data = pcm_data.reshape(-1, channels)  # 支持多通道
+    sf.write(wav_path, pcm_data, sr, subtype=subtype)
+
+
+def wav2pcm(wav_path, pcm_path):
+    """
+    将wav文件转换为pcm文件
+    :param wav_path: wav文件路径
+    :param pcm_path: pcm文件路径
+    """
+    data, _ = sf.read(wav_path, dtype='int16')
+    data.tofile(pcm_path)
+
+
+def read_pcm(file_path, channels=5, sample_rate=16000, sample_width=2):
+    # Read raw binary data from the PCM file
+    with open(file_path, 'rb') as f:
+        raw_data = f.read()
+
+    # Convert binary data to numpy array of the correct dtype
+    audio_data = np.frombuffer(raw_data, dtype=np.int16)
+
+    # Reshape the data into a 2D array with shape (num_frames, channels)
+    num_frames = len(audio_data) // channels
+    audio_data = audio_data.reshape((num_frames, channels))
+
+    return audio_data