jettask 0.2.14__py3-none-any.whl → 0.2.16__py3-none-any.whl

jettask/{webui/backend → backend}/main.py

@@ -12,15 +12,19 @@ JetTask Monitor 独立后端API服务
    - PostgreSQL：任务结果存储
    - 由JetTask worker使用
 """
-from fastapi import FastAPI, HTTPException, Request
-from fastapi.middleware.cors import CORSMiddleware
-from contextlib import asynccontextmanager
+from fastapi import HTTPException, Request
 from datetime import datetime, timedelta, timezone
 from typing import List, Dict, Optional
-from pydantic import BaseModel
 from sqlalchemy import text
 import logging
 import traceback
+from jettask.schemas import (
+    TimeRangeQuery, 
+    QueueTimelineResponse, 
+    TrimQueueRequest, 
+    ScheduledTaskRequest, 
+    AlertRuleRequest
+)
 
 import sys
 import os
@@ -28,88 +32,26 @@ import os
 sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
 
 from data_access import JetTaskDataAccess
-from namespace_data_access import get_namespace_data_access
-from data_api import router as data_router
-from namespace_api import router as namespace_router
-from queue_stats_v2 import QueueStatsV2
-from queue_backlog_api import router as backlog_router
-from redis_monitor_api import router as redis_monitor_router
+from jettask.backend.namespace_data_access import get_namespace_data_access
+from jettask.backend.queue_stats_v2 import QueueStatsV2
 
 # 设置日志
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
 
-# 创建数据访问实例（保留旧的实例，用于兼容）
+# 从api包导入已配置的app
+from jettask.api import app
+
+# 创建全局数据访问实例供路由使用
 data_access = JetTaskDataAccess()
-# 新的命名空间数据访问
 namespace_data_access = get_namespace_data_access()
 
+# 将数据访问实例注入到app.state
+app.state.data_access = data_access
+app.state.namespace_data_access = namespace_data_access
 
-@asynccontextmanager
-async def lifespan(app: FastAPI):
-    """应用生命周期管理"""
-    # 启动时初始化
-    try:
-        # 1. 初始化JetTask数据访问（用于查询任务数据）
-        await data_access.initialize()
-        
-        # 2. 记录任务中心配置
-        from jettask.webui.backend.config import task_center_config
-        logger.info("=" * 60)
-        logger.info("任务中心配置:")
-        logger.info(f"  元数据库: {task_center_config.meta_db_host}:{task_center_config.meta_db_port}/{task_center_config.meta_db_name}")
-        logger.info(f"  API服务: {task_center_config.api_host}:{task_center_config.api_port}")
-        logger.info(f"  基础URL: {task_center_config.base_url}")
-        logger.info("=" * 60)
-        
-        logger.info("JetTask Monitor API 启动成功")
-    except Exception as e:
-        logger.error(f"启动失败: {e}")
-        traceback.print_exc()
-        raise
-    
-    yield
-    
-    # 关闭时清理资源
-    try:
-        await data_access.close()
-        logger.info("JetTask Monitor API 关闭完成")
-    except Exception as e:
-        logger.error(f"关闭时出错: {e}")
-        traceback.print_exc()
 
-
-app = FastAPI(
-    title="JetTask Monitor API", 
-    version="1.0.0",
-    lifespan=lifespan
-)
-
-# 配置CORS
-app.add_middleware(
-    CORSMiddleware,
-    allow_origins=["*"],  # 生产环境应该配置具体的前端地址
-    allow_credentials=True,
-    allow_methods=["*"],
-    allow_headers=["*"],
-)
-
-
-class TimeRangeQuery(BaseModel):
-    start_time: Optional[datetime] = None
-    end_time: Optional[datetime] = None
-    time_range: Optional[str] = "15m"  # 默认15分钟
-    queues: Optional[List[str]] = None
-    filters: Optional[List[Dict]] = None  # 筛选条件
-
-
-class QueueTimelineResponse(BaseModel):
-    data: List[Dict]
-    granularity: str
-
-
-class TrimQueueRequest(BaseModel):
-    max_length: int
+# 模型已从 schemas 模块导入
 
 
 @app.get("/")
@@ -440,18 +382,7 @@ async def health_check():
 
 # ============= 定时任务管理API =============
 
-class ScheduledTaskRequest(BaseModel):
-    """定时任务请求模型"""
-    namespace: str  # 命名空间
-    name: str
-    queue_name: str
-    task_data: dict
-    schedule_type: str  # cron, interval, daily, weekly, monthly
-    schedule_config: dict  # 根据schedule_type的不同配置
-    is_active: bool = True
-    description: Optional[str] = None
-    max_retry: int = 3
-    timeout: Optional[int] = None
+# ScheduledTaskRequest 已从 schemas 模块导入
 
 
 @app.get("/api/scheduled-tasks")
@@ -834,16 +765,7 @@ async def get_scheduled_task_execution_trend(
         raise HTTPException(status_code=500, detail=str(e))
 
 
-# ============= 命名空间管理API (任务中心) =============
-
-# 导入命名空间API路由
-from jettask.webui.backend.namespace_api import router as namespace_router
-
-# 注册命名空间路由
-app.include_router(namespace_router)
-app.include_router(data_router)
-app.include_router(backlog_router)
-app.include_router(redis_monitor_router)
+# 路由已在 api/__init__.py 中注册
 
 
 
@@ -853,17 +775,7 @@ app.include_router(redis_monitor_router)
 
 # ============= 告警管理API =============
 
-class AlertRuleRequest(BaseModel):
-    """告警规则请求模型"""
-    name: str
-    rule_type: str  # queue_size, error_rate, response_time, custom
-    target_queues: List[str]  # 监控的队列列表
-    condition: dict  # 触发条件配置
-    action_type: str  # webhook, email, sms
-    action_config: dict  # 通知配置
-    is_active: bool = True
-    description: Optional[str] = None
-    check_interval: int = 60  # 检查间隔（秒）
+# AlertRuleRequest 已从 schemas 模块导入
 
 
 @app.get("/api/alert-rules")

jettask/{webui/backend → backend}/main_unified.py

@@ -14,7 +14,7 @@ try:
     from unified_api_router import router as api_router
 except ImportError:
     # 如果相对导入失败，尝试绝对导入
-    from jettask.webui.backend.unified_api_router import router as api_router
+    from jettask.backend.unified_api_router import router as api_router
 
 # 设置日志
 logging.basicConfig(

jettask/{webui/backend → backend}/namespace_api_old.py

@@ -3,12 +3,12 @@
 使用数据库持久化命名空间数据
 """
 from fastapi import APIRouter, HTTPException, Query
-from pydantic import BaseModel
 from typing import Dict, Any, Optional, List
 from datetime import datetime
 import json
 from sqlalchemy import text
 import logging
+from jettask.schemas import NamespaceCreate, NamespaceUpdate, NamespaceResponse
 
 logger = logging.getLogger(__name__)
 
@@ -17,7 +17,7 @@ router = APIRouter(prefix="/api/namespaces", tags=["namespaces"])
 # 使用任务中心专用的元数据库连接
 from sqlalchemy.ext.asyncio import create_async_engine, AsyncSession
 from sqlalchemy.orm import sessionmaker
-from jettask.webui.backend.config import task_center_config
+from jettask.backend.config import task_center_config
 
 # 创建异步引擎 - 连接到任务中心元数据库
 # 注意：这是任务中心自己的数据库，不是JetTask应用的数据库
@@ -25,34 +25,7 @@ engine = create_async_engine(task_center_config.meta_database_url, echo=False)
 AsyncSessionLocal = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)
 
 
-class NamespaceCreate(BaseModel):
-    """创建命名空间请求"""
-    name: str
-    description: Optional[str] = None
-    redis_config: Dict[str, Any]
-    pg_config: Dict[str, Any]
-
-
-class NamespaceUpdate(BaseModel):
-    """更新命名空间请求"""
-    description: Optional[str] = None
-    redis_config: Optional[Dict[str, Any]] = None
-    pg_config: Optional[Dict[str, Any]] = None
-    is_active: Optional[bool] = None
-
-
-class NamespaceResponse(BaseModel):
-    """命名空间响应"""
-    id: int  # 改为整数类型
-    name: str
-    description: Optional[str]
-    redis_config: Dict[str, Any]
-    pg_config: Dict[str, Any]
-    is_active: bool
-    version: int  # 添加版本号
-    created_at: datetime
-    updated_at: datetime
-    connection_url: str
+# 模型已从 schemas 模块导入
 
 
 @router.get("", response_model=List[NamespaceResponse])

jettask/{webui/backend → backend}/namespace_data_access.py

@@ -46,6 +46,7 @@ class NamespaceConnection:
                 if dsn.startswith('postgresql://'):
                     dsn = dsn.replace('postgresql://', 'postgresql+psycopg://', 1)
                 
+                print(f'{dsn=}')
                 self.async_engine = create_async_engine(
                     dsn,
                     pool_size=10,
@@ -185,7 +186,7 @@ class NamespaceDataAccessManager:
         base_url = self.task_center_base_url
         if 'localhost' in base_url:
             base_url = base_url.replace('localhost', '127.0.0.1')
-        url = f"{base_url}/api/namespaces/{namespace_name}"
+        url = f"{base_url}/api/v1/namespaces/{namespace_name}"
         
         try:
             session = await self._get_session()

jettask/{webui/backend → backend}/unified_api_router.py

@@ -5,7 +5,6 @@
 
 from fastapi import APIRouter, HTTPException, Query, Request, Depends
 from typing import List, Dict, Optional, Any, Union
-from pydantic import BaseModel, Field
 from datetime import datetime, timedelta, timezone
 import logging
 import time
@@ -16,6 +15,17 @@ from sqlalchemy import text
 from sqlalchemy.ext.asyncio import create_async_engine, AsyncSession
 from sqlalchemy.orm import sessionmaker
 import traceback
+from jettask.schemas import (
+    TimeRangeQuery,
+    QueueStatsResponse,
+    TaskDetailResponse,
+    DashboardOverviewRequest,
+    ScheduledTaskCreate,
+    ScheduledTaskUpdate,
+    AlertRuleCreate,
+    NamespaceCreate,
+    NamespaceUpdate
+)
 
 # 导入本地模块
 try:
@@ -23,8 +33,8 @@ try:
     from config import task_center_config
 except ImportError:
     # 如果相对导入失败，尝试绝对导入
-    from jettask.webui.backend.namespace_data_access import get_namespace_data_access
-    from jettask.webui.backend.config import task_center_config
+    from jettask.backend.namespace_data_access import get_namespace_data_access
+    from jettask.backend.config import task_center_config
 
 # 设置日志
 logger = logging.getLogger(__name__)
@@ -32,77 +42,7 @@ logger = logging.getLogger(__name__)
 # 创建统一的路由器
 router = APIRouter(prefix="/api", tags=["API"])
 
-# ==================== 数据模型定义 ====================
-
-class TimeRangeQuery(BaseModel):
-    """时间范围查询参数"""
-    namespace: str = "default"
-    queue_name: Optional[str] = None
-    time_range: str = "1h"
-    granularity: Optional[str] = None
-    
-class QueueStatsResponse(BaseModel):
-    """队列统计响应"""
-    queue_name: str
-    pending: int
-    running: int
-    completed: int
-    failed: int
-    
-class TaskDetailResponse(BaseModel):
-    """任务详情响应"""
-    task_id: str
-    status: str
-    created_at: datetime
-    started_at: Optional[datetime]
-    completed_at: Optional[datetime]
-    error_message: Optional[str]
-    
-class DashboardOverviewRequest(BaseModel):
-    """仪表板概览请求参数"""
-    time_range: str = "1h"
-    queues: Optional[List[str]] = None
-
-class ScheduledTaskCreate(BaseModel):
-    """创建定时任务的请求模型"""
-    task_name: str
-    queue_name: str
-    task_data: dict
-    cron_expression: Optional[str] = None
-    interval_seconds: Optional[int] = None
-    enabled: bool = True
-    
-class ScheduledTaskUpdate(BaseModel):
-    """更新定时任务的请求模型"""
-    task_name: Optional[str] = None
-    queue_name: Optional[str] = None
-    task_data: Optional[dict] = None
-    cron_expression: Optional[str] = None
-    interval_seconds: Optional[int] = None
-    enabled: Optional[bool] = None
-
-class AlertRuleCreate(BaseModel):
-    """创建告警规则的请求模型"""
-    name: str
-    metric: str
-    threshold: float
-    condition: str  # gt, lt, eq
-    duration: int  # 持续时间（秒）
-    notification_channels: List[str]
-    enabled: bool = True
-
-class NamespaceCreate(BaseModel):
-    """创建命名空间的请求模型"""
-    name: str
-    redis_url: str
-    pg_url: Optional[str] = None
-    description: Optional[str] = None
-
-class NamespaceUpdate(BaseModel):
-    """更新命名空间的请求模型"""
-    redis_url: Optional[str] = None
-    pg_url: Optional[str] = None
-    description: Optional[str] = None
+# ==================== 数据模型从 schemas 模块导入 ====================
 
 # ==================== 辅助函数 ====================
 

jettask/{core/cli.py → cli.py}

@@ -9,16 +9,17 @@ import importlib
 import importlib.util
 import json
 from pathlib import Path
+from dotenv import load_dotenv
 
-# 处理相对导入和直接运行的情况
-try:
-    from .app_importer import import_app, AppImporter
-except ImportError:
-    # 如果相对导入失败，添加父目录到路径并尝试绝对导入
-    parent_dir = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+# 处理直接运行时的路径问题
+if __name__ == '__main__':
+    parent_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
     if parent_dir not in sys.path:
         sys.path.insert(0, parent_dir)
-    from jettask.core.app_importer import import_app, AppImporter
+
+from jettask.config.nacos_config import config
+from jettask.core.app_importer import import_app, AppImporter
+
 
 @click.group()
 @click.version_option(version='0.1.0', prog_name='JetTask')
@@ -30,13 +31,28 @@ def cli():
 @click.option('--host', default='0.0.0.0', help='服务器监听地址')
 @click.option('--port', default=8001, type=int, help='服务器监听端口')
 @click.option('--jettask-pg-url', envvar='JETTASK_PG_URL', 
-              default='postgresql://jettask:123456@localhost:5432/jettask',
               help='PostgreSQL连接URL')
+@click.option('--use-nacos', is_flag=True, default=False, 
+              help='从Nacos配置中心读取配置')
+@click.option('--nacos-server', envvar='NACOS_SERVER', 
+              help='Nacos服务器地址')
+@click.option('--nacos-namespace', envvar='NACOS_NAMESPACE',
+              help='Nacos命名空间')
+@click.option('--nacos-username', envvar='NACOS_USERNAME',
+              help='Nacos用户名')
+@click.option('--nacos-password', envvar='NACOS_PASSWORD',
+              help='Nacos密码')
+@click.option('--nacos-group', envvar='NACOS_GROUP',
+              help='Nacos配置组')
+@click.option('--nacos-data-id', envvar='NACOS_DATA_ID',
+              help='Nacos配置ID')
 @click.option('--reload', is_flag=True, default=False, help='启用自动重载')
 @click.option('--log-level', default='info', 
               type=click.Choice(['debug', 'info', 'warning', 'error']),
               help='日志级别')
-def api(host, port, jettask_pg_url, reload, log_level):
+def api(host, port, jettask_pg_url, use_nacos, nacos_server, nacos_namespace, 
+        nacos_username, nacos_password, nacos_group, nacos_data_id, 
+        reload, log_level):
     """启动 API 服务和监控界面
     
     示例:
@@ -47,7 +63,15 @@ def api(host, port, jettask_pg_url, reload, log_level):
       # 指定端口和数据库
       jettask api --host 0.0.0.0 --port 8080 --jettask-pg-url postgresql://user:pass@host/db
       
-      # 通过环境变量配置
+      # 使用Nacos配置中心
+      jettask api --use-nacos --nacos-server 127.0.0.1:8848
+      
+      # 通过环境变量配置Nacos
+      export NACOS_SERVER=127.0.0.1:8848
+      export NACOS_NAMESPACE=tamar_console_dev
+      jettask api --use-nacos
+      
+      # 通过环境变量配置数据库
       export JETTASK_PG_URL=postgresql://jettask:123456@localhost:5432/jettask
       jettask api
       
@@ -57,12 +81,63 @@ def api(host, port, jettask_pg_url, reload, log_level):
     import os
     import uvicorn
     
+    print(f'{use_nacos=} {jettask_pg_url=}')
+    if not use_nacos and not jettask_pg_url:
+        raise ValueError("必须提供 --jettask-pg-url 或启用 --use-nacos")
+    # 如果使用Nacos，从Nacos获取配置
+    if use_nacos:
+        click.echo("正在从Nacos加载配置...")
+        load_dotenv()
+        # 设置Nacos环境变量
+        if nacos_server:
+            os.environ['NACOS_SERVER'] = nacos_server
+        if nacos_namespace:
+            os.environ['NACOS_NAMESPACE'] = nacos_namespace
+        if nacos_username:
+            os.environ['NACOS_USERNAME'] = nacos_username
+        if nacos_password:
+            os.environ['NACOS_PASSWORD'] = nacos_password
+        if nacos_group:
+            os.environ['NACOS_GROUP'] = nacos_group
+        if nacos_data_id:
+            os.environ['NACOS_DATA_ID'] = nacos_data_id
+        
+        nacos_server = os.environ['NACOS_SERVER']
+        nacos_namespace = os.environ['NACOS_NAMESPACE']
+        nacos_username = os.environ['NACOS_USERNAME']
+        nacos_password = os.environ['NACOS_PASSWORD']
+        nacos_group = os.environ['NACOS_GROUP']
+        nacos_data_id = os.environ['NACOS_DATA_ID']
+        # 尝试从配置中获取JETTASK_PG_URL
+        nacos_pg_url = config.config.get('JETTASK_PG_URL')
+        print(f'{nacos_pg_url=}')
+        if not nacos_pg_url:
+            # 如果没有直接的URL，尝试从独立的配置项构建
+            pg_host = config.config.get('PG_DB_HOST', 'localhost')
+            pg_port = config.config.get('PG_DB_PORT', 5432)
+            pg_user = config.config.get('PG_DB_USERNAME', 'jettask')
+            pg_password = config.config.get('PG_DB_PASSWORD', '123456')
+            pg_database = config.config.get('PG_DB_DATABASE', 'jettask')
+            nacos_pg_url = f'postgresql://{pg_user}:{pg_password}@{pg_host}:{pg_port}/{pg_database}'
+        
+        jettask_pg_url = nacos_pg_url
+        click.echo(f"✓ 从Nacos加载配置成功")
+        click.echo(f"  配置源: {nacos_server}/{nacos_namespace}/{nacos_group}/{nacos_data_id}")
+        
+        # 将其他Nacos配置也设置到环境变量中
+        for key, value in config.config.items():
+            if isinstance(value, (str, int, float, bool)):
+                os.environ[key] = str(value)
+
+    
     # 设置环境变量（供应用内部使用）
     os.environ['JETTASK_PG_URL'] = jettask_pg_url
-    os.environ['TASK_CENTER_PG_URL'] = jettask_pg_url  # 兼容旧版本配置名
+    
+    # 设置是否使用Nacos的标志
+    os.environ['USE_NACOS'] = 'true' if use_nacos else 'false'
     
     # 使用标准应用模块
-    app_module = "jettask.webui.backend.main:app"
+    app_module = "jettask.api:app"
     click.echo(f"Starting JetTask API Server on {host}:{port}")
     
     # 显示配置信息
@@ -73,6 +148,11 @@ def api(host, port, jettask_pg_url, reload, log_level):
     click.echo(f"Port:        {port}")
     click.echo(f"Auto-reload: {reload}")
     click.echo(f"Log level:   {log_level}")
+    click.echo(f"Nacos:       {'Enabled' if use_nacos else 'Disabled'}")
+    if use_nacos:
+        click.echo(f"  Server:    {nacos_server}")
+        click.echo(f"  Namespace: {nacos_namespace}")
+        click.echo(f"  Data ID:   {nacos_data_id}")
     click.echo(f"Database:    {jettask_pg_url}")
     click.echo("=" * 60)
     click.echo(f"API Endpoint: http://{host}:{port}/api")
@@ -284,7 +364,7 @@ def worker(app_str, queues, executor, concurrency, prefetch, reload, config):
 
 @cli.command('webui-consumer')
 @click.option('--task-center', '-tc', envvar='JETTASK_CENTER_URL', required=True,
-              help='任务中心URL，如: http://localhost:8001 或 http://localhost:8001/api/namespaces/default')
+              help='任务中心URL，如: http://localhost:8001 或 http://localhost:8001/api/v1/namespaces/default')
 @click.option('--check-interval', type=int, default=30,
               help='命名空间检测间隔（秒），默认30秒')
 @click.option('--debug', is_flag=True, help='启用调试模式')
@@ -292,7 +372,7 @@ def webui_consumer(task_center, check_interval, debug):
     """启动数据消费者（自动识别单/多命名空间）
     
     根据URL格式自动判断运行模式:
-    - 单命名空间: http://localhost:8001/api/namespaces/{name}
+    - 单命名空间: http://localhost:8001/api/v1/namespaces/{name}
     - 多命名空间: http://localhost:8001 或 http://localhost:8001/api
     
     示例:
@@ -302,7 +382,7 @@ def webui_consumer(task_center, check_interval, debug):
       jettask webui-consumer --task-center http://localhost:8001/api
       
       # 为单个命名空间启动消费者
-      jettask webui-consumer --task-center http://localhost:8001/api/namespaces/default
+      jettask webui-consumer --task-center http://localhost:8001/api/v1/namespaces/default
       
       # 自定义检测间隔
       jettask webui-consumer --task-center http://localhost:8001 --check-interval 60
@@ -312,7 +392,7 @@ def webui_consumer(task_center, check_interval, debug):
       jettask webui-consumer
     """
     import asyncio
-    from jettask.webui.unified_consumer_manager import UnifiedConsumerManager
+    from jettask.unified_consumer_manager import UnifiedConsumerManager
     
     # 运行消费者管理器
     async def run_manager():
@@ -333,23 +413,23 @@ def webui_consumer(task_center, check_interval, debug):
 def monitor():
     """启动系统监控器"""
     click.echo("Starting JetTask Monitor")
-    from jettask.webui.run_monitor import main as monitor_main
+    from jettask.run_monitor import main as monitor_main
     monitor_main()
 
 @cli.command()
 @click.option('--task-center', '-tc', envvar='JETTASK_CENTER_URL',
-              help='任务中心URL，如: http://localhost:8001/api/namespaces/default')
+              help='任务中心URL，如: http://localhost:8001/api/v1/namespaces/default')
 def init(task_center):
     """初始化数据库和配置
     
     示例:
     \b
       # 使用任务中心初始化
-      jettask init --task-center http://localhost:8001/api/namespaces/default
-      jettask init -tc http://localhost:8001/api/namespaces/production
+      jettask init --task-center http://localhost:8001/api/v1/namespaces/default
+      jettask init -tc http://localhost:8001/api/v1/namespaces/production
       
       # 使用环境变量
-      export JETTASK_CENTER_URL=http://localhost:8001/api/namespaces/default
+      export JETTASK_CENTER_URL=http://localhost:8001/api/v1/namespaces/default
       jettask init
       
       # 不使用任务中心（仅使用本地环境变量）
@@ -366,7 +446,7 @@ def init(task_center):
         
         # 尝试从任务中心获取数据库配置
         try:
-            from jettask.webui.task_center import TaskCenter
+            from jettask.task_center import TaskCenter
             tc = TaskCenter(task_center)
             if tc._connect_sync():
                 p_config = tc.pg_config
@@ -383,7 +463,7 @@ def init(task_center):
             click.echo("  Falling back to local environment variables")
     
     # 初始化数据库
-    from jettask.webui.db_init import init_database
+    from jettask.db_init import init_database
     click.echo("\nInitializing database...")
     init_database()
     
@@ -423,7 +503,7 @@ def status():
 
 @cli.command()
 @click.option('--task-center', '-tc', envvar='JETTASK_CENTER_URL', required=True,
-              help='任务中心URL，如: http://localhost:8001 或 http://localhost:8001/api/namespaces/default')
+              help='任务中心URL，如: http://localhost:8001 或 http://localhost:8001/api/v1/namespaces/default')
 @click.option('--interval', '-i', type=float, default=0.1, 
               help='调度器扫描间隔（秒），默认0.1秒')
 @click.option('--batch-size', '-b', type=int, default=100,
@@ -435,7 +515,7 @@ def scheduler(task_center, interval, batch_size, check_interval, debug):
     """启动定时任务调度器（自动识别单/多命名空间）
     
     根据URL格式自动判断运行模式:
-    - 单命名空间: http://localhost:8001/api/namespaces/{name}
+    - 单命名空间: http://localhost:8001/api/v1/namespaces/{name}
     - 多命名空间: http://localhost:8001 或 http://localhost:8001/api
     
     示例:
@@ -445,7 +525,7 @@ def scheduler(task_center, interval, batch_size, check_interval, debug):
       jettask scheduler --task-center http://localhost:8001/api
       
       # 为单个命名空间启动调度器
-      jettask scheduler --task-center http://localhost:8001/api/namespaces/default
+      jettask scheduler --task-center http://localhost:8001/api/v1/namespaces/default
       
       # 自定义配置
       jettask scheduler --task-center http://localhost:8001 --check-interval 60 --interval 0.5