sycommon-python-lib 0.2.1b3__tar.gz → 0.2.1b4__tar.gz

{sycommon_python_lib-0.2.1b3 → sycommon_python_lib-0.2.1b4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sycommon-python-lib
-Version: 0.2.1b3
+Version: 0.2.1b4
 Summary: Add your description here
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -19,11 +19,13 @@ Requires-Dist: langchain-core>=1.2.20
 Requires-Dist: langchain-openai>=1.1.11
 Requires-Dist: langfuse>=4.0.1
 Requires-Dist: langgraph>=1.1.3
+Requires-Dist: langgraph-checkpoint-redis>=0.4.0
 Requires-Dist: ldap3>=2.9.1
 Requires-Dist: loguru>=0.7.3
 Requires-Dist: mysql-connector-python>=9.6.0
 Requires-Dist: nacos-sdk-python<3.0,>=2.0.9
 Requires-Dist: psutil>=7.2.2
+Requires-Dist: pyxxl>=0.4.6
 Requires-Dist: pydantic>=2.12.5
 Requires-Dist: python-dotenv>=1.2.2
 Requires-Dist: python-multipart>=0.0.22

{sycommon_python_lib-0.2.1b3 → sycommon_python_lib-0.2.1b4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sycommon-python-lib"
-version = "0.2.1b3"
+version = "0.2.1b4"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -20,11 +20,13 @@ dependencies = [
     "langchain-openai>=1.1.11",
     "langfuse>=4.0.1",
     "langgraph>=1.1.3",
+    "langgraph-checkpoint-redis>=0.4.0",
     "ldap3>=2.9.1",
     "loguru>=0.7.3",
     "mysql-connector-python>=9.6.0",
     "nacos-sdk-python>=2.0.9,<3.0",
     "psutil>=7.2.2",
+    "pyxxl>=0.4.6",
     "pydantic>=2.12.5",
     "python-dotenv>=1.2.2",
     "python-multipart>=0.0.22",

{sycommon_python_lib-0.2.1b3 → sycommon_python_lib-0.2.1b4}/src/sycommon/agent/sandbox/file_ops.py

@@ -140,15 +140,19 @@ class FileOperationsMixin:
         """列出目录内容"""
         try:
             self._ensure_synced_sync()
+            print(f"[Sandbox-DEBUG] ls() called with path={repr(path)}, user_id={repr(self.user_id)}", flush=True)
             SYLogger.info(f"[Sandbox] 列出目录: {path}")
             result = self._post_sync(f"{SANDBOX_API_PREFIX}/ls", {
                 "path": path,
                 "user_id": self.user_id
             })
+            print(f"[Sandbox-DEBUG] ls() raw result type={type(result).__name__}, repr={repr(result)[:500]}", flush=True)
             entries = [FileInfo(**item) for item in result]
+            print(f"[Sandbox-DEBUG] ls() parsed entries={len(entries)}", flush=True)
             SYLogger.info(f"[Sandbox] 目录内容: {len(entries)} 项")
             return LsResult(entries=entries)
         except Exception as e:
+            print(f"[Sandbox-DEBUG] ls() EXCEPTION: {type(e).__name__}: {e}", flush=True)
             SYLogger.error(f"[Sandbox] 列出目录失败: {e}")
             return LsResult(error=str(e))
 
@@ -156,15 +160,19 @@ class FileOperationsMixin:
         """异步列出目录内容（真正的异步实现）"""
         try:
             await self._ensure_synced_async()
+            print(f"[Sandbox-DEBUG] als() called with path={repr(path)}, user_id={repr(self.user_id)}, base_url={repr(self._base_url if hasattr(self, '_base_url') else 'N/A')}", flush=True)
             SYLogger.info(f"[Sandbox] 异步列出目录: {path}")
             result = await self._post_async_with_failover(f"{SANDBOX_API_PREFIX}/ls", {
                 "path": path,
                 "user_id": self.user_id
             })
+            print(f"[Sandbox-DEBUG] als() raw result type={type(result).__name__}, repr={repr(result)[:500]}", flush=True)
             entries = [FileInfo(**item) for item in result]
+            print(f"[Sandbox-DEBUG] als() parsed entries={len(entries)}, first 3 paths={[e.get('path','?') if isinstance(e, dict) else getattr(e, 'path','?') for e in entries[:3]]}", flush=True)
             SYLogger.info(f"[Sandbox] 目录内容: {len(entries)} 项")
             return LsResult(entries=entries)
         except Exception as e:
+            print(f"[Sandbox-DEBUG] als() EXCEPTION: {type(e).__name__}: {e}", flush=True)
             SYLogger.error(f"[Sandbox] 异步列出目录失败: {e}")
             return LsResult(error=str(e))
 

{sycommon_python_lib-0.2.1b3 → sycommon_python_lib-0.2.1b4}/src/sycommon/agent/sandbox/http_sandbox_backend.py

@@ -101,6 +101,7 @@ class HTTPSandboxBackend(FileOperationsMixin, SandboxBackendProtocol):
         self._sync_dirs = sync_dirs or []
         self._auto_sync = auto_sync
         self._synced = False
+        self._workspace_verified = False
 
         # Nacos 配置（用于故障转移）
         self._nacos_service_name = nacos_service_name
@@ -485,15 +486,22 @@ class HTTPSandboxBackend(FileOperationsMixin, SandboxBackendProtocol):
             return False
 
     async def _sync_async(self) -> dict:
-        """同步目录（异步版本）"""
+        """同步目录（异步版本）
+
+        sync_dirs 条目支持两种格式:
+            (local_path, remote_path)               -> 全量覆盖
+            (local_path, remote_path, mode)          -> mode="full" 全量覆盖, mode="partial" 跳过已有子目录
+        """
         if not self._sync_dirs:
             SYLogger.info("[Sandbox] 没有配置同步目录")
             return {}
 
         SYLogger.info(f"[Sandbox] _sync_async 开始, 共 {len(self._sync_dirs)} 个目录")
         results = {}
-        for idx, (local_path, remote_path) in enumerate(self._sync_dirs):
-            SYLogger.info(f"[Sandbox] 同步目录 [{idx+1}/{len(self._sync_dirs)}]: {local_path} -> {remote_path}")
+        for idx, entry in enumerate(self._sync_dirs):
+            local_path, remote_path = entry[0], entry[1]
+            mode = entry[2] if len(entry) > 2 else "full"
+            SYLogger.info(f"[Sandbox] 同步目录 [{idx+1}/{len(self._sync_dirs)}]: {local_path} -> {remote_path} (mode={mode})")
             local_dir = Path(local_path)
 
             if not local_dir.exists():
@@ -503,7 +511,7 @@ class HTTPSandboxBackend(FileOperationsMixin, SandboxBackendProtocol):
 
             if local_dir.is_dir():
                 SYLogger.info(f"[Sandbox] 开始上传目录: {local_path}")
-                result = await self._upload_directory_async(str(local_dir), remote_path)
+                result = await self._upload_directory_async(str(local_dir), remote_path, mode=mode)
                 results[local_path] = result
                 SYLogger.info(f"[Sandbox] 目录上传完成: {local_path}, 成功={result['success']}, 失败={result['failed']}")
             else:
@@ -520,8 +528,16 @@ class HTTPSandboxBackend(FileOperationsMixin, SandboxBackendProtocol):
         SYLogger.info("[Sandbox] _sync_async 完成")
         return results
 
-    async def _upload_directory_async(self, local_dir: str, remote_path: str = "/") -> dict:
-        """上传整个目录到沙箱（异步版本）"""
+    async def _upload_directory_async(self, local_dir: str, remote_path: str = "/", *, mode: str = "full") -> dict:
+        """上传整个目录到沙箱（异步版本）
+
+        Args:
+            local_dir: 本地目录路径
+            remote_path: 沙箱目标路径
+            mode: 同步模式
+                - "full": 全量覆盖（默认），上传所有文件
+                - "partial": 部分覆盖，查询沙箱已有子目录并跳过同名目录
+        """
         local_path = Path(local_dir)
         if not local_path.exists():
             raise FileNotFoundError(f"本地目录不存在: {local_dir}")
@@ -529,7 +545,24 @@ class HTTPSandboxBackend(FileOperationsMixin, SandboxBackendProtocol):
         if not local_path.is_dir():
             raise NotADirectoryError(f"路径不是目录: {local_dir}")
 
-        SYLogger.info(f"[Sandbox] _upload_directory_async 开始: {local_dir} -> {remote_path}")
+        SYLogger.info(f"[Sandbox] _upload_directory_async 开始: {local_dir} -> {remote_path} (mode={mode})")
+
+        # partial 模式：查询沙箱已有子目录并跳过
+        existing_subdirs = set()
+        if mode == "partial":
+            try:
+                ls_result = await self._post_async(f"{SANDBOX_API_PREFIX}/ls", {
+                    "path": remote_path,
+                    "user_id": self._user_id
+                })
+                if ls_result and not ls_result.get("error"):
+                    for item in ls_result.get("files", ls_result.get("children", [])):
+                        if item.get("is_dir", False):
+                            existing_subdirs.add(item.get("name", ""))
+                    if existing_subdirs:
+                        SYLogger.info(f"[Sandbox] partial 模式，跳过已有子目录: {existing_subdirs}")
+            except Exception as e:
+                SYLogger.warning(f"[Sandbox] 查询沙箱目录失败，将全量同步: {e}")
 
         exclude_patterns = [".git", "__pycache__", ".pyc", ".DS_Store", "node_modules"]
 
@@ -547,6 +580,19 @@ class HTTPSandboxBackend(FileOperationsMixin, SandboxBackendProtocol):
         for root, dirs, files in os.walk(local_path):
             dirs[:] = [d for d in dirs if not should_exclude(d)]
 
+            # 对于 /skills 目录，跳过沙箱中已存在的子目录（只检查最外层）
+            if existing_subdirs:
+                try:
+                    rel = Path(root).relative_to(local_path)
+                    if str(rel) == ".":
+                        before = len(dirs)
+                        skipped_names = [d for d in dirs if d in existing_subdirs]
+                        dirs[:] = [d for d in dirs if d not in existing_subdirs]
+                        if skipped_names:
+                            SYLogger.info(f"[Sandbox] 跳过已有技能目录: {skipped_names}")
+                except ValueError:
+                    pass
+
             for file in files:
                 if should_exclude(file):
                     continue
@@ -558,32 +604,34 @@ class HTTPSandboxBackend(FileOperationsMixin, SandboxBackendProtocol):
 
         SYLogger.info(f"[Sandbox] 准备上传 {len(files_to_upload)} 个文件到沙箱")
 
-        success_count = 0
-        failed_count = 0
-        errors = []
+        semaphore = asyncio.Semaphore(10)
 
-        for idx, (sandbox_path, local_file) in enumerate(files_to_upload):
-            try:
+        async def _upload_one(idx, sandbox_path, local_file):
+            async with semaphore:
                 if idx % 10 == 0:
                     SYLogger.info(f"[Sandbox] 上传进度: {idx}/{len(files_to_upload)}")
+                try:
+                    content = await asyncio.to_thread(lambda f=local_file: open(f, "rb").read())
+                    result = await self._post_async(f"{SANDBOX_API_PREFIX}/upload", {
+                        "path": sandbox_path,
+                        "content": base64.b64encode(content).decode(),
+                        "user_id": self._user_id
+                    })
+                    if result.get("error"):
+                        return {"ok": False, "path": sandbox_path, "error": result["error"]}
+                    return {"ok": True}
+                except Exception as e:
+                    return {"ok": False, "path": sandbox_path, "error": str(e)}
 
-                content = await asyncio.to_thread(lambda f=local_file: open(f, "rb").read())
+        upload_tasks = [
+            _upload_one(idx, sandbox_path, local_file)
+            for idx, (sandbox_path, local_file) in enumerate(files_to_upload)
+        ]
+        upload_results = await asyncio.gather(*upload_tasks)
 
-                result = await self._post_async(f"{SANDBOX_API_PREFIX}/upload", {
-                    "path": sandbox_path,
-                    "content": base64.b64encode(content).decode(),
-                    "user_id": self._user_id
-                })
-
-                if result.get("error"):
-                    failed_count += 1
-                    errors.append({"path": sandbox_path, "error": result["error"]})
-                else:
-                    success_count += 1
-
-            except Exception as e:
-                failed_count += 1
-                errors.append({"path": sandbox_path, "error": str(e)})
+        success_count = sum(1 for r in upload_results if r["ok"])
+        failed_count = sum(1 for r in upload_results if not r["ok"])
+        errors = [{"path": r["path"], "error": r["error"]} for r in upload_results if not r["ok"]]
 
         SYLogger.info(f"[Sandbox] _upload_directory_async 完成: 成功={success_count}, 失败={failed_count}")
         return {"success": success_count, "failed": failed_count, "errors": errors}

sycommon_python_lib-0.2.1b4/src/sycommon/config/XxlJobConfig.py

@@ -0,0 +1,17 @@
+from pydantic import BaseModel
+
+
+class XxlJobDstcConfig(BaseModel):
+    """XXL-JOB 调度中心地址配置"""
+    address: str
+
+
+class XxlJobExecutorConfig(BaseModel):
+    """XXL-JOB 执行器配置"""
+    appname: str
+    dstc: XxlJobDstcConfig
+
+
+class XxlJobConfig(BaseModel):
+    """XXL-JOB 配置模型，对应 Nacos 共享配置中的 task 节点"""
+    executor: XxlJobExecutorConfig

{sycommon_python_lib-0.2.1b3 → sycommon_python_lib-0.2.1b4}/src/sycommon/logging/kafka_log.py

@@ -287,7 +287,7 @@ class SYLogger:
         else:
             logger.info(log_json)
 
-        if check_env_flag(['DEV-LOG']):
+        if check_env_flag(['DEV_LOG']):
             print(log_json)
 
     @staticmethod

{sycommon_python_lib-0.2.1b3 → sycommon_python_lib-0.2.1b4}/src/sycommon/middleware/sandbox.py

@@ -619,14 +619,18 @@ COMMAND_EOF
     async def ls_info(req: LsRequest):
         """列出目录内容"""
         workspace = get_user_workspace(req.user_id)
+        print(f"[Sandbox-Server-DEBUG] /ls called: path={repr(req.path)}, user_id={repr(req.user_id)}, workspace={repr(workspace)}", flush=True)
         try:
             target_path = resolve_sandbox_path(req.path, workspace)
+            print(f"[Sandbox-Server-DEBUG] resolved target_path={repr(target_path)}", flush=True)
         except ValueError as e:
             SYLogger.error(f"[Sandbox Server] 列目录失败: {e}")
+            print(f"[Sandbox-Server-DEBUG] resolve_sandbox_path FAILED: {e}", flush=True)
             return []
 
         if not os.path.isdir(target_path):
             SYLogger.error(f"[Sandbox Server] 列目录失败: 目录不存在 {target_path}")
+            print(f"[Sandbox-Server-DEBUG] target_path is NOT a dir: {target_path}", flush=True)
             return []
 
         SYLogger.info(f"[Sandbox Server] 列出目录: {target_path}")
@@ -634,7 +638,11 @@ COMMAND_EOF
         try:
             with os.scandir(target_path) as it:
                 for entry in it:
-                    info = FileInfo(path=os.path.join(target_path, entry.name))
+                    # 返回虚拟路径（相对于用户工作空间），而不是绝对文件系统路径
+                    # 这样 AI 后续操作（ls、read_file 等）能正确解析路径
+                    abs_path = os.path.join(target_path, entry.name)
+                    virtual_path = "/" + os.path.relpath(abs_path, workspace)
+                    info = FileInfo(path=virtual_path)
                     try:
                         info.is_dir = entry.is_dir(follow_symlinks=False)
                         if not info.is_dir:
@@ -646,6 +654,7 @@ COMMAND_EOF
         except Exception as e:
             SYLogger.error(f"[Sandbox Server] 列目录异常: {e}")
 
+        print(f"[Sandbox-Server-DEBUG] returning {len(results)} entries: {[r.path for r in results[:10]]}", flush=True)
         SYLogger.info(f"[Sandbox Server] 目录内容: {len(results)} 项")
         return results
 
@@ -849,7 +858,9 @@ COMMAND_EOF
 
         results = []
         for m in matches:
-            info = FileInfo(path=m)
+            # 返回虚拟路径，与 ls 保持一致
+            virtual_path = "/" + os.path.relpath(m, workspace)
+            info = FileInfo(path=virtual_path)
             try:
                 info.is_dir = os.path.isdir(m)
                 if not info.is_dir:
@@ -903,6 +914,11 @@ COMMAND_EOF
                 continue
 
             path_part = line[:first_colon]
+            # 将绝对路径转换为虚拟路径
+            try:
+                virtual_path_part = "/" + os.path.relpath(path_part, workspace)
+            except ValueError:
+                virtual_path_part = path_part
             try:
                 line_num = int(line[first_colon + 1:second_colon])
             except ValueError:
@@ -910,7 +926,7 @@ COMMAND_EOF
             text_part = line[second_colon + 1:]
 
             matches.append(GrepMatch(
-                path=path_part,
+                path=virtual_path_part,
                 line=line_num,
                 text=text_part
             ))
@@ -941,7 +957,9 @@ COMMAND_EOF
         try:
             for item in os.listdir(target_path):
                 item_path = os.path.join(target_path, item)
-                info = FileInfo(path=item_path)
+                # 返回虚拟路径
+                virtual_path = "/" + os.path.relpath(item_path, workspace)
+                info = FileInfo(path=virtual_path)
                 try:
                     info.is_dir = os.path.isdir(item_path)
                     if not info.is_dir:
@@ -971,7 +989,8 @@ COMMAND_EOF
                                 return LsResponse(files=files, warning=f"Results truncated at {MAX_FILES} files")
 
                             filepath = os.path.join(root, filename)
-                            file_info = FileInfo(path=filepath)
+                            virtual_filepath = "/" + os.path.relpath(filepath, workspace)
+                            file_info = FileInfo(path=virtual_filepath)
                             try:
                                 file_info.is_dir = False
                                 file_info.size = os.path.getsize(filepath)

sycommon_python_lib-0.2.1b4/src/sycommon/models/xxljob_handler_config.py

@@ -0,0 +1,11 @@
+from typing import Callable, Coroutine
+from pydantic import BaseModel, Field
+
+
+class XxlJobHandlerConfig(BaseModel):
+    """XXL-JOB 任务处理器配置模型"""
+    name: str = Field(..., description="任务处理器名称")
+    handler: Callable[..., Coroutine] = Field(..., description="异步任务处理函数")
+
+    class Config:
+        arbitrary_types_allowed = True

{sycommon_python_lib-0.2.1b3 → sycommon_python_lib-0.2.1b4}/src/sycommon/services.py

@@ -10,6 +10,7 @@ from sycommon.config.Config import SingletonMeta
 from sycommon.logging.logger_levels import setup_logger_levels
 from sycommon.models.mqlistener_config import RabbitMQListenerConfig
 from sycommon.models.mqsend_config import RabbitMQSendConfig
+from sycommon.models.xxljob_handler_config import XxlJobHandlerConfig
 from sycommon.rabbitmq.rabbitmq_service import RabbitMQService
 from sycommon.tools.docs import custom_redoc_html, custom_swagger_ui_html
 from sycommon.sentry.sy_sentry import sy_sentry_init
@@ -18,6 +19,7 @@ from sycommon.synacos.feign import close_all_feign_sessions
 from sycommon.synacos.feign_client import close_all_feign_client_sessions
 from sycommon.database.elasticsearch_service import ElasticsearchService
 from sycommon.database.redis_service import RedisService
+from sycommon.xxljob.xxljob_service import XxlJobService
 
 # 延迟导入的类型（避免循环导入）
 AgentConfig = Any  # type: ignore[misc]
@@ -27,8 +29,10 @@ TeamConfig = Any  # type: ignore[misc]
 # - bool: True 启用默认配置，False 不启用
 # - dict: 使用字典配置
 # - AgentConfig/TeamConfig 对象: 使用配置对象
-AgentServiceConfig = Union[bool, Dict[str, Any], "AgentConfig"]  # type: ignore[misc]
-TeamServiceConfig = Union[bool, Dict[str, Any], "TeamConfig"]  # type: ignore[misc]
+AgentServiceConfig = Union[bool, Dict[str, Any],
+                           "AgentConfig"]  # type: ignore[misc]
+TeamServiceConfig = Union[bool, Dict[str, Any],
+                          "TeamConfig"]  # type: ignore[misc]
 
 
 class Services(metaclass=SingletonMeta):
@@ -90,6 +94,7 @@ class Services(metaclass=SingletonMeta):
     _enable_es: bool = True
     _enable_redis: bool = True
     _enable_sandbox: bool = False
+    _enable_xxljob: bool = False
 
     def __init__(self, config: dict, app: FastAPI):
         super().__init__()
@@ -135,6 +140,7 @@ class Services(metaclass=SingletonMeta):
         sandbox_service: bool = False,
         deep_agent_service: bool = False,
         multi_agent_service: bool = False,
+        xxljob_service: Optional[List[XxlJobHandlerConfig]] = None,
     ) -> FastAPI:
         load_dotenv()
         setup_logger_levels()
@@ -166,6 +172,7 @@ class Services(metaclass=SingletonMeta):
         cls._enable_es = elasticsearch_service is not None
         cls._enable_redis = redis_service is not None
         cls._enable_sandbox = sandbox_service or deep_agent_service or multi_agent_service
+        cls._enable_xxljob = xxljob_service is not None
 
         # 将服务开关写入 config，供 middleware 和其他组件使用
         if cls._config:
@@ -196,6 +203,10 @@ class Services(metaclass=SingletonMeta):
         if redis_service:
             redis_service()
 
+        # 初始化 XXL-JOB 执行器服务
+        if xxljob_service:
+            XxlJobService.setup(cls._config, xxljob_service)
+
         @asynccontextmanager
         async def combined_lifespan(app_instance: FastAPI) -> AsyncGenerator[None, None]:
             # 获取 Services 实例
@@ -256,7 +267,7 @@ class Services(metaclass=SingletonMeta):
 
                 app_instance.state.services = instance
 
-                # 4. 执行用户定义的生命周期
+                # 5. 执行用户定义的生命周期
                 if cls._user_lifespan:
                     async with cls._user_lifespan(app_instance):
                         yield
@@ -414,6 +425,13 @@ class Services(metaclass=SingletonMeta):
                 except Exception as e:
                     logging.debug(f"关闭 RedisService 时发生异常: {e}")
 
+            # 关闭 XXL-JOB 执行器（仅当启用时）
+            if cls._enable_xxljob:
+                try:
+                    XxlJobService.shutdown()
+                except Exception as e:
+                    logging.debug(f"关闭 XxlJobService 时发生异常: {e}")
+
             cls._initialized = False
 
             # 清理实例数据

{sycommon_python_lib-0.2.1b3 → sycommon_python_lib-0.2.1b4}/src/sycommon/synacos/nacos_service.py

@@ -20,6 +20,7 @@ class NacosService(metaclass=SingletonMeta):
     # 进程模式标记
     _use_process_mode: bool = False
     _heartbeat_process_started: bool = False
+
     def __init__(self, config):
         if config:
             self.config = config
@@ -29,7 +30,7 @@ class NacosService(metaclass=SingletonMeta):
             self.port = config['Port']
             self.version = get_env_var('VERSION')
             self.enable_register_nacos = check_env_flag(
-                ['REGISTER-NACOS'], 'true')
+                ['REGISTER_NACOS'], 'true')
 
             # 检查是否启用进程模式
             self._check_process_mode()
@@ -200,7 +201,8 @@ class NacosService(metaclass=SingletonMeta):
                 port=self.port,
                 version=self.version,
                 heartbeat_interval=self.heartbeat_interval,
-                heartbeat_timeout=self.nacos_config.get('heartbeatTimeout', 15),
+                heartbeat_timeout=self.nacos_config.get(
+                    'heartbeatTimeout', 15),
                 username=self.nacos_config.get('username'),
                 password=self.nacos_config.get('password')
             )

{sycommon_python_lib-0.2.1b3 → sycommon_python_lib-0.2.1b4}/src/sycommon/tools/env.py

@@ -15,7 +15,7 @@ def _normalize_env_key(key: str) -> str:
 def check_env_flag(target_keys: list, default: str = 'false') -> bool:
     """
     检查环境变量是否为"true"（自动兼容：大小写、中划线/下划线）
-    :param target_keys: 目标变量名列表（如 ['REGISTER-NACOS']，无需传双key）
+    :param target_keys: 目标变量名列表（如 ['REGISTER_NACOS']，无需传双key）
     :param default: 默认值（未找到变量时使用）
     :return: 布尔值
     """
@@ -36,7 +36,7 @@ def check_env_flag(target_keys: list, default: str = 'false') -> bool:
 def get_env_var(key: str, default='', case_insensitive: bool = True) -> str:
     """
     获取环境变量值（自动兼容：大小写、中划线/下划线）
-    :param key: 目标环境变量名（如 'REGISTER-NACOS'/'version'）
+    :param key: 目标环境变量名（如 'REGISTER_NACOS'/'version'）
     :param default: 无匹配时的默认值，默认空字符串
     :param case_insensitive: 是否忽略变量名大小写（默认True，建议保持）
     :return: 匹配到的环境变量值 / 默认值

sycommon_python_lib-0.2.1b4/src/sycommon/xxljob/__init__.py

@@ -0,0 +1,3 @@
+from sycommon.xxljob.xxljob_service import XxlJobService
+
+__all__ = ['XxlJobService']