vools 0.2.4__tar.gz → 0.3.0__tar.gz

{vools-0.2.4/vools.egg-info → vools-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vools
-Version: 0.2.4
+Version: 0.3.0
 Summary: Python 函数式编程工具集
 Author-email: Victor <victortop921129@gmail.com>
 License: Apache License
@@ -216,6 +216,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Operating System :: Microsoft :: Windows
@@ -265,6 +266,7 @@ Dynamic: license-file
 - **序列化**: 支持 JSON、MsgPack、Pickle 等多种格式
 - **编码/加密**: Base64、URL 编码、哈希函数
 - **多语言桥接**: 支持 27 种编程语言（Lua、Rust、Go、Java、Kotlin、Swift、Dart、MoonBit 等），统一装饰器接口
+- **编译器自动发现**: 自动探测本机和 WSL 环境中的编译器，支持注册表搜索、常见安装路径、通配符路径展开
 
 ## 安装
 
@@ -384,13 +386,39 @@ obs.pipe(
 print(result)  # [4, 8]
 ```
 
+### 编译器自动发现
+
+自动探测本机和 WSL 环境中所有已安装的编译器，无需手动配置 PATH。
+
+```python
+from vools.bridge import discover_all, get_discovery_report, configure_from_discovery
+
+# 一键发现所有编译器（本机 + WSL）
+result = discover_all(include_wsl=True)
+
+# 查看格式化报告
+print(get_discovery_report())
+
+# 自动配置管理器
+configure_from_discovery(include_wsl=True)
+
+# 检查特定语言是否可用
+from vools.bridge import get_helper
+nim_helper = get_helper('nim')
+if nim_helper.is_available():
+    print(f"Nim 编译器路径: {nim_helper.get_compiler_path()}")
+```
+
 ## 项目结构
 
 ```
 vools/
 ├── api/             # CLI 命令行接口
-├── bridge/          # 多语言桥接（27种语言）
+├── bridge/          # 多语言桥接（27种语言）+ 编译器自动发现
 │   ├── core/        # 桥接核心（类型、签名缓存、装饰器）
+│   ├── probe.py     # 编译器探测模块
+│   ├── manager.py   # 配置管理模块
+│   ├── auto_discovery.py  # 一键发现入口
 │   ├── lua/         # Lua 桥接
 │   ├── rust/        # Rust 桥接
 │   ├── go/          # Go 桥接
@@ -493,10 +521,37 @@ vools/
 - [函数式编程](docs/functional.md)
 - [响应式编程](docs/reactive.md)
 - [装饰器](docs/decorators.md)
+- [性能跃迁计划](docs/performance-leap.md)
+- [基准测试](docs/benchmark.md)
+
+## 性能对比
+
+vools 通过桥接 Nim/Rust/Go 等编译型语言，为高频核心函数提供可选的高性能实现。以下是典型硬件上的基准测试结果（实际数据因硬件而异）：
+
+| 模块 | 函数 | 纯 Python | 桥接加速 | 提升倍数 |
+|------|------|----------|----------|---------|
+| serialize.codec | pickle_encode | ~120 us | ~18 us | 6-8x |
+| serialize.codec | pickle_decode | ~100 us | ~15 us | 6-7x |
+| security.hash | sha256_hex | ~15 us | ~3 us | 5x |
+| security.hash | md5_hex | ~12 us | ~2 us | 6x |
+| security.hash | sha1_hex | ~10 us | ~2 us | 5x |
+| security.hash | sha512_hex | ~18 us | ~4 us | 4.5x |
+| data.seq | base64_encode | ~8 us | ~2 us | 4x |
+| data.seq | base64_decode | ~7 us | ~2 us | 3.5x |
+| serialize | json_encode | ~50 us | ~15 us | 3x |
+| serialize | json_decode | ~45 us | ~12 us | 4x |
+| data.seq | zlib_compress | ~500 us | ~100 us | 5x |
+| data.seq | zlib_decompress | ~200 us | ~50 us | 4x |
+| cache.sigcache | hash_signature | ~50 us | ~8 us | 6x |
+
+**注意**：
+- 桥接库为可选增强，未安装时自动使用纯 Python 实现
+- 测试数据为 1KB 左右的小数据，大数据量提升更显著
+- 详细基准测试方法请参见 [基准测试文档](docs/benchmark.md)
 
 ## 更新日志
 
-详细的版本更新记录请查看 [changelog](changelog/) 目录。
+详细的版本更新记录请查看 [CHANGELOG.md](CHANGELOG.md)。
 
 ## 贡献
 

{vools-0.2.4 → vools-0.3.0}/README.md

@@ -16,6 +16,7 @@
 - **序列化**: 支持 JSON、MsgPack、Pickle 等多种格式
 - **编码/加密**: Base64、URL 编码、哈希函数
 - **多语言桥接**: 支持 27 种编程语言（Lua、Rust、Go、Java、Kotlin、Swift、Dart、MoonBit 等），统一装饰器接口
+- **编译器自动发现**: 自动探测本机和 WSL 环境中的编译器，支持注册表搜索、常见安装路径、通配符路径展开
 
 ## 安装
 
@@ -135,13 +136,39 @@ obs.pipe(
 print(result)  # [4, 8]
 ```
 
+### 编译器自动发现
+
+自动探测本机和 WSL 环境中所有已安装的编译器，无需手动配置 PATH。
+
+```python
+from vools.bridge import discover_all, get_discovery_report, configure_from_discovery
+
+# 一键发现所有编译器（本机 + WSL）
+result = discover_all(include_wsl=True)
+
+# 查看格式化报告
+print(get_discovery_report())
+
+# 自动配置管理器
+configure_from_discovery(include_wsl=True)
+
+# 检查特定语言是否可用
+from vools.bridge import get_helper
+nim_helper = get_helper('nim')
+if nim_helper.is_available():
+    print(f"Nim 编译器路径: {nim_helper.get_compiler_path()}")
+```
+
 ## 项目结构
 
 ```
 vools/
 ├── api/             # CLI 命令行接口
-├── bridge/          # 多语言桥接（27种语言）
+├── bridge/          # 多语言桥接（27种语言）+ 编译器自动发现
 │   ├── core/        # 桥接核心（类型、签名缓存、装饰器）
+│   ├── probe.py     # 编译器探测模块
+│   ├── manager.py   # 配置管理模块
+│   ├── auto_discovery.py  # 一键发现入口
 │   ├── lua/         # Lua 桥接
 │   ├── rust/        # Rust 桥接
 │   ├── go/          # Go 桥接
@@ -244,10 +271,37 @@ vools/
 - [函数式编程](docs/functional.md)
 - [响应式编程](docs/reactive.md)
 - [装饰器](docs/decorators.md)
+- [性能跃迁计划](docs/performance-leap.md)
+- [基准测试](docs/benchmark.md)
+
+## 性能对比
+
+vools 通过桥接 Nim/Rust/Go 等编译型语言，为高频核心函数提供可选的高性能实现。以下是典型硬件上的基准测试结果（实际数据因硬件而异）：
+
+| 模块 | 函数 | 纯 Python | 桥接加速 | 提升倍数 |
+|------|------|----------|----------|---------|
+| serialize.codec | pickle_encode | ~120 us | ~18 us | 6-8x |
+| serialize.codec | pickle_decode | ~100 us | ~15 us | 6-7x |
+| security.hash | sha256_hex | ~15 us | ~3 us | 5x |
+| security.hash | md5_hex | ~12 us | ~2 us | 6x |
+| security.hash | sha1_hex | ~10 us | ~2 us | 5x |
+| security.hash | sha512_hex | ~18 us | ~4 us | 4.5x |
+| data.seq | base64_encode | ~8 us | ~2 us | 4x |
+| data.seq | base64_decode | ~7 us | ~2 us | 3.5x |
+| serialize | json_encode | ~50 us | ~15 us | 3x |
+| serialize | json_decode | ~45 us | ~12 us | 4x |
+| data.seq | zlib_compress | ~500 us | ~100 us | 5x |
+| data.seq | zlib_decompress | ~200 us | ~50 us | 4x |
+| cache.sigcache | hash_signature | ~50 us | ~8 us | 6x |
+
+**注意**：
+- 桥接库为可选增强，未安装时自动使用纯 Python 实现
+- 测试数据为 1KB 左右的小数据，大数据量提升更显著
+- 详细基准测试方法请参见 [基准测试文档](docs/benchmark.md)
 
 ## 更新日志
 
-详细的版本更新记录请查看 [changelog](changelog/) 目录。
+详细的版本更新记录请查看 [CHANGELOG.md](CHANGELOG.md)。
 
 ## 贡献
 

{vools-0.2.4 → vools-0.3.0}/pyproject.toml

@@ -20,6 +20,7 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "License :: OSI Approved :: Apache Software License",
     "Operating System :: OS Independent",
     "Operating System :: Microsoft :: Windows",
@@ -85,7 +86,7 @@ exclude = ["vools.__pycache__", "vools.*.__pycache__"]
 version = { attr = "vools.__version__" }
 
 [tool.setuptools.package-data]
-"vools" = ["config.template.py", "*.md", "lib/*.dll", "lib/linux/*.so"]
+"vools" = ["config.template.py", "*.md", "lib/*.dll", "lib/*.so", "lib/windows/*.dll", "lib/linux/*.so", "lib/**/*.so"]
 
 # ============ pytest ============
 [tool.pytest.ini_options]

{vools-0.2.4 → vools-0.3.0}/vools/__init__.py

@@ -7,7 +7,7 @@ vools - Python 函数式编程工具集
 import importlib
 from typing import Any
 
-__version__ = "0.2.4"
+__version__ = "0.3.0"
 __author__ = "Victor"
 __license__ = "Apache 2.0"
 

{vools-0.2.4 → vools-0.3.0}/vools/bridge/__init__.py

@@ -16,9 +16,18 @@ LangBridge 统一接口：
   2. only_code 仅代码模式 - 只生成代码不编译，支持多种写入模式
   3. project 项目模式 - 编译整个项目目录，支持可执行文件或共享库
 
+编译器自动发现：
+  自动探测本机和 WSL 环境中已安装的编译器，无需手动配置 PATH。
+  - discover_all() / discover_local() / discover_wsl() - 发现编译器
+  - get_discovery_report() - 生成发现报告
+  - configure_from_discovery() - 自动配置 BridgeManager
+  - auto_discover() - 一键发现并配置
+
 子模块：
 - core: 核心基础设施（加载器、装饰器、类型映射、序列化）
 - manager: 语言编译器和运行时环境统一管理器
+- probe: 编译器自动探测模块
+- auto_discovery: 一键自动发现与配置
 - _base: LangBridge 抽象基类 + FunctionParser / DepResolver 工具类
 - c / cpp / nim / go / cangjie / rust / mojo / csharp / java / scala / ruby / julia / r / freebasic / typescript / vbnet / perl / lua / zig / kotlin / swift / php / dart / powershell / vbscript / shell: 各语言桥接实现
 """
@@ -34,13 +43,27 @@ from .manager import (
     LanguageConfig,
     LanguageStatus,
     BridgeManager,
+    LanguageCompilerHelper,
     register_language,
     get_status,
     get_compiler_path,
+    get_compiler,
+    get_compiler_executable,
+    get_helper,
     get_version,
     setup_runtime,
     list_languages,
     list_available,
+    auto_discover,
+)
+
+# auto_discovery 模块 - 一键自动发现
+from .auto_discovery import (
+    discover_all,
+    discover_local,
+    discover_wsl,
+    get_discovery_report,
+    configure_from_discovery,
 )
 
 # 便捷函数：检查语言是否可用
@@ -77,6 +100,14 @@ __all__ = [
     'setup_runtime',
     'list_languages',
     'list_available',
+    'auto_discover',
+
+    # auto_discovery 模块
+    'discover_all',
+    'discover_local',
+    'discover_wsl',
+    'get_discovery_report',
+    'configure_from_discovery',
     'set_compiler_path',
     'add_compiler_path',
     'set_runtime_path',

vools-0.3.0/vools/bridge/auto_discovery.py

@@ -0,0 +1,274 @@
+"""
+vools.bridge.auto_discovery - 编译器自动发现与配置
+
+一键发现本机和 WSL 环境中所有已安装的编程语言编译器，
+并自动配置到 BridgeManager 中。
+
+主要功能：
+1. discover_all() - 一键发现所有环境的编译器
+2. discover_local() - 仅发现本机编译器
+3. discover_wsl() - 仅发现 WSL 编译器
+4. get_discovery_report() - 生成完整的发现报告
+5. configure_from_discovery() - 从发现结果配置 manager
+
+用法：
+    from vools.bridge.auto_discovery import discover_all
+
+    # 一键发现所有
+    result = discover_all()
+
+    # 查看报告
+    print(result['report'])
+
+    # 查看可用语言
+    print('本机可用:', result['local'].available_languages())
+    print('WSL 可用:', result['wsl'][0].available_languages() if result['wsl'] else [])
+"""
+
+import os
+import sys
+import platform
+from typing import Dict, List, Optional, Any
+
+from . import probe
+from . import manager as _manager_instance
+from .manager import LanguageConfig
+
+_IS_WINDOWS = platform.system() == 'Windows'
+
+
+# ============================================================================
+# 公共 API
+# ============================================================================
+
+def discover_all(
+    languages: Optional[List[str]] = None,
+    configure_manager: bool = True,
+    include_wsl: bool = True,
+) -> Dict[str, Any]:
+    """
+    一键发现所有环境中的编译器
+
+    Args:
+        languages: 指定要探测的语言列表，None 表示全部
+        configure_manager: 是否自动配置到 BridgeManager
+        include_wsl: 是否包含 WSL 环境
+
+    Returns:
+        dict: {
+            'local': ProbeReport,        # 本机探测报告
+            'wsl': List[ProbeReport],    # WSL 各发行版探测报告
+            'discovered': dict,           # 已发现的语言
+            'report': str,                # 格式化报告文本
+        }
+    """
+    result = {
+        'local': None,
+        'wsl': [],
+        'discovered': {},
+        'report': '',
+    }
+
+    # 1. 本机探测
+    local_report = probe.probe_with_extra_paths(languages=languages)
+    result['local'] = local_report
+    result['discovered']['local'] = local_report.available_languages()
+
+    # 2. WSL 探测
+    if _IS_WINDOWS and include_wsl:
+        try:
+            wsl_reports = probe.probe_all_wsl(languages=languages)
+            result['wsl'] = wsl_reports
+            for r in wsl_reports:
+                result['discovered'][r.host] = r.available_languages()
+        except Exception as e:
+            result['wsl_error'] = str(e)
+
+    # 3. 配置到 manager
+    if configure_manager:
+        _configure_from_report(local_report)
+
+    # 4. 生成报告
+    result['report'] = _generate_full_report(result)
+
+    return result
+
+
+def discover_local(
+    languages: Optional[List[str]] = None,
+    configure_manager: bool = True,
+) -> Dict[str, Any]:
+    """
+    仅发现本机编译器
+
+    Args:
+        languages: 指定要探测的语言列表
+        configure_manager: 是否自动配置到 BridgeManager
+
+    Returns:
+        dict: 发现结果
+    """
+    return discover_all(languages=languages, configure_manager=configure_manager, include_wsl=False)
+
+
+def discover_wsl(
+    languages: Optional[List[str]] = None,
+) -> List[probe.ProbeReport]:
+    """
+    仅发现 WSL 环境中的编译器
+
+    Args:
+        languages: 指定要探测的语言列表
+
+    Returns:
+        List[ProbeReport]: 各 WSL 发行版的探测报告
+    """
+    if not _IS_WINDOWS:
+        return []
+    return probe.probe_all_wsl(languages=languages)
+
+
+def get_discovery_report(
+    languages: Optional[List[str]] = None,
+    include_wsl: bool = True,
+) -> str:
+    """
+    生成完整的发现报告文本
+
+    Args:
+        languages: 指定要探测的语言列表
+        include_wsl: 是否包含 WSL
+
+    Returns:
+        str: 格式化的报告文本
+    """
+    result = discover_all(languages=languages, configure_manager=False, include_wsl=include_wsl)
+    return result['report']
+
+
+def configure_from_discovery(
+    report: Optional[probe.ProbeReport] = None,
+    include_wsl: bool = True,
+) -> int:
+    """
+    从探测结果配置 BridgeManager
+
+    Args:
+        report: ProbeReport 实例，如果为 None 则自动探测
+        include_wsl: 是否包含 WSL 环境（仅当 report 为 None 时有效）
+
+    Returns:
+        int: 成功配置的语言数量
+    """
+    if report is None:
+        result = discover_all(configure_manager=False, include_wsl=include_wsl)
+        count = 0
+        if result.get('local'):
+            count += _configure_from_report(result['local'])
+        for wsl_report in result.get('wsl', []):
+            count += _configure_from_report(wsl_report)
+        return count
+    return _configure_from_report(report)
+
+
+# ============================================================================
+# 内部函数
+# ============================================================================
+
+def _configure_from_report(report: probe.ProbeReport) -> int:
+    """从探测报告配置 manager"""
+    count = 0
+    for lang, status in report.languages.items():
+        if status.available and status.path:
+            lang_lower = lang.lower()
+            bin_dir = os.path.dirname(status.path)
+
+            config = _manager_instance.get_config(lang_lower)
+            if config:
+                # 更新已有配置
+                if bin_dir and bin_dir not in config.compiler_paths:
+                    config.compiler_paths.insert(0, bin_dir)
+                    _manager_instance.clear_cache(lang_lower)
+            else:
+                # 注册新语言
+                probe_config = probe.LANGUAGE_PROBES.get(lang, {})
+                _manager_instance.register(LanguageConfig(
+                    name=lang_lower,
+                    compiler=status.command or lang_lower,
+                    compiler_paths=[bin_dir] if bin_dir else [],
+                    version_pattern=probe_config.get('version_pattern'),
+                ))
+            count += 1
+    return count
+
+
+def _generate_full_report(result: Dict[str, Any]) -> str:
+    """生成完整报告文本"""
+    lines = []
+
+    lines.append('=' * 70)
+    lines.append('  vools.bridge 编译器自动发现报告')
+    lines.append('=' * 70)
+
+    # 本机报告
+    if result.get('local'):
+        local = result['local']
+        lines.append('')
+        lines.append('【本机环境】')
+        lines.append(f'  平台: {local.platform}')
+        lines.append(f'  架构: {local.arch}')
+        lines.append(f'  Python: {local.python_version}')
+        lines.append('')
+        _append_language_summary(lines, local)
+
+    # WSL 报告
+    if result.get('wsl'):
+        for wsl_report in result['wsl']:
+            lines.append('')
+            lines.append(f'【WSL: {wsl_report.host}】')
+            lines.append(f'  平台: {wsl_report.platform}')
+            lines.append(f'  架构: {wsl_report.arch}')
+            lines.append('')
+            _append_language_summary(lines, wsl_report)
+
+    # 统计汇总
+    lines.append('')
+    lines.append('=' * 70)
+    total_available = len(result['discovered'].get('local', []))
+    total_langs = len(probe.LANGUAGE_PROBES)
+    lines.append(f'  总计: {total_available}/{total_langs} 种语言可用')
+    lines.append('=' * 70)
+
+    return '\n'.join(lines)
+
+
+def _append_language_summary(lines: List[str], report: probe.ProbeReport):
+    """追加语言摘要到报告"""
+    by_category: Dict[str, List[probe.LanguageStatus]] = {}
+    for st in report.languages.values():
+        by_category.setdefault(st.category or '其他', []).append(st)
+
+    available_count = 0
+    for category, sts in by_category.items():
+        lines.append(f'  【{category}】')
+        for st in sorted(sts, key=lambda x: x.name):
+            if st.available:
+                available_count += 1
+                version_info = f' v{st.version}' if st.version else ''
+                lines.append(f'    [OK]   {st.name:12s}{version_info}')
+            else:
+                lines.append(f'    [NO]   {st.name:12s} 未安装')
+        lines.append('')
+
+
+# ============================================================================
+# 模块导出
+# ============================================================================
+
+__all__ = [
+    'discover_all',
+    'discover_local',
+    'discover_wsl',
+    'get_discovery_report',
+    'configure_from_discovery',
+]

{vools-0.2.4 → vools-0.3.0}/vools/bridge/cangjie/loader.py

@@ -19,14 +19,14 @@ _IS_LINUX = platform.system() == 'Linux'
 # 仓颉运行时路径
 _CJ_RUNTIME_PATHS = []
 if _IS_WINDOWS:
-    # 尝试查找仓颉 SDK 路径
     cj_sdk_paths = [
-        r'E:\CangJie_Sdk\cangjie-sdk-windows-x64-1.0.0\cangjie\runtime\lib\windows_x86_64_llvm',
-        r'E:\CangJie_Sdk\cangjie-sdk-windows-x64-1.0.0\cangjie\lib',
-        r'E:\CangJie_Sdk\cangjie-sdk-windows-x64-1.0.0\cangjie\bin',
+        os.environ.get('CANGJIE_SDK_PATH'),
+        os.path.join(os.path.dirname(__file__), 'runtime', 'lib', 'windows_x86_64_llvm'),
+        os.path.join(os.path.dirname(__file__), 'runtime', 'lib'),
+        os.path.join(os.path.dirname(__file__), 'runtime', 'bin'),
     ]
     for p in cj_sdk_paths:
-        if os.path.exists(p):
+        if p and os.path.exists(p):
             _CJ_RUNTIME_PATHS.append(p)
 
 # 设置 DLL 搜索路径

vools-0.3.0/vools/bridge/check_bridges.py

@@ -0,0 +1,74 @@
+"""
+vools.bridge.check_bridges - 桥接库安装验证脚本
+
+检查所有桥接库是否正确安装并可用。
+"""
+
+from .core.loader import get_loader, is_available
+
+
+def check_bridges():
+    """
+    检查所有桥接库是否正确安装
+
+    返回：
+        list: [(lang, name, available), ...] 格式的结果列表
+    """
+    bridges = [
+        ("nim", "serialize"),
+        ("nim", "hash"),
+        ("nim", "base64"),
+        ("nim", "json"),
+        ("nim", "sigcache"),
+        ("nim", "compress"),
+        ("rust", "safe_eval"),
+    ]
+
+    results = []
+    for lang, name in bridges:
+        available = is_available(lang)
+        results.append((lang, name, available))
+
+    return results
+
+
+def check_nim_bridges():
+    """
+    检查所有 Nim 桥接库
+
+    返回：
+        dict: {模块名: 是否可用}
+    """
+    nim_modules = [
+        "serialize",
+        "hash",
+        "base64",
+        "json",
+        "sigcache",
+        "compress",
+    ]
+
+    results = {}
+    loader = get_loader("nim")
+    for module in nim_modules:
+        lib_name = f"vools_bridge_{module}"
+        available = loader.load(lib_name) is not None
+        results[module] = available
+
+    return results
+
+
+if __name__ == "__main__":
+    print("=== Bridge Status Report ===\n")
+
+    print("General bridges:")
+    for lang, name, available in check_bridges():
+        status = "✓" if available else "✗"
+        print(f"  [{status}] {lang}/{name}")
+
+    print("\nNim modules:")
+    for module, available in check_nim_bridges().items():
+        status = "✓" if available else "✗"
+        print(f"  [{status}] nim/{module}")
+
+    print("\n=== Report Complete ===")

{vools-0.2.4 → vools-0.3.0}/vools/bridge/core/loader.py

@@ -30,9 +30,13 @@ _IS_LINUX = _PLATFORM == 'Linux'
 _LOADED_LIBS = {}
 _LOAD_LOCK = threading.Lock()
 
-_LIB_DIR = os.path.join(os.path.dirname(__file__), '..', '..', 'lib')
-if _IS_LINUX:
-    _LIB_DIR = os.path.join(_LIB_DIR, 'linux')
+_lib_base = os.path.join(os.path.dirname(__file__), '..', '..', 'lib')
+if _IS_WINDOWS:
+    _LIB_DIR = os.path.join(_lib_base, 'windows')
+elif _IS_LINUX:
+    _LIB_DIR = os.path.join(_lib_base, 'linux')
+else:
+    _LIB_DIR = _lib_base
 _LIB_DIR = os.path.abspath(_LIB_DIR)
 
 # 初始化时设置所有语言的运行时环境
@@ -177,6 +181,8 @@ class LibraryLoader:
 
     def _find_lib(self, name):
         """查找共享库路径"""
+        if name is None:
+            return None
         if _IS_WINDOWS:
             for ext in ('.dll', '.so', '.pyd'):
                 path = os.path.join(_LIB_DIR, name + ext)