agentengine-sdk-python 0.7.0__py3-none-any.whl → 0.8.0__py3-none-any.whl

ksadk/cli/cmd_launch.py

@@ -2,14 +2,26 @@
 agentengine launch - 一键完成构建和部署
 """
 
-import click
-import asyncio
 from pathlib import Path
+from typing import Any
+
+import click
+
 from ksadk.api.client import DryRunExit
-from ksadk.cli.cmd_deploy import _apply_network_config, _resolve_artifact_type_input, _resolve_ui_config_inputs
+from ksadk.cli.cmd_deploy import (
+    _apply_network_config,
+    _resolve_artifact_type_input,
+    _resolve_ui_config_inputs,
+)
 from ksadk.cli.dry_run import effective_dry_run, run_async_with_dry_run
 from ksadk.cli.env_options import env_options, resolve_explicit_env_vars
-from ksadk.cli.error_utils import cli_error_from_exception, is_debug_mode_enabled, remote_error, usage_error, validation_error
+from ksadk.cli.error_utils import (
+    cli_error_from_exception,
+    is_debug_mode_enabled,
+    remote_error,
+    usage_error,
+    validation_error,
+)
 from ksadk.cli.network_options import (
     apply_network_cli_overrides,
     network_cli_kwargs,
@@ -18,6 +30,18 @@ from ksadk.cli.network_options import (
     validate_deploy_target_network,
 )
 from ksadk.cli.storage import build_storage_config
+from ksadk.cli.ui import (
+    capture_standard_output,
+    is_json_output,
+    print_info,
+    print_kv,
+    print_rule,
+    print_success,
+    print_warn,
+)
+from ksadk.cli.ui import (
+    output_option as cli_output_option,
+)
 from ksadk.cli.workflow_common import (
     build_workflow_local_plan,
     clear_build_metadata,
@@ -31,17 +55,10 @@ from ksadk.cli.workflow_common import (
     resolve_artifact_build_plan,
 )
 from ksadk.deployment.ui_config import SUPPORTED_UI_PROFILES
-from ksadk.cli.ui import (
-    capture_standard_output,
-    is_json_output,
-    output_option as cli_output_option,
-    print_error,
-    print_info,
-    print_kv,
-    print_rule,
-    print_success,
-    print_warn,
-)
+
+
+def _dict_or_none(value: object) -> dict[str, Any] | None:
+    return dict(value) if isinstance(value, dict) and value else None
 
 
 @click.command(context_settings=dict(help_option_names=["-h", "--help"]))
@@ -54,8 +71,12 @@ from ksadk.cli.ui import (
     help="部署目标 (default: serverless)",
 )
 @click.option("--name", "-n", help="部署名称")
-@click.option("--region", "-r", default="cn-beijing-6", envvar="KSYUN_REGION", help="区域 (serverless)")
-@click.option("--account-id", envvar="KSYUN_ACCOUNT_ID", help="金山云账号 ID（可选；未设置时从 AK/SK 反查）")
+@click.option(
+    "--region", "-r", default="cn-beijing-6", envvar="KSYUN_REGION", help="区域 (serverless)"
+)
+@click.option(
+    "--account-id", envvar="KSYUN_ACCOUNT_ID", help="金山云账号 ID（可选；未设置时从 AK/SK 反查）"
+)
 @click.option("--observability/--no-observability", default=True, help="是否启用可观测性")
 @click.option("--no-cache", is_flag=True, help="强制重新构建，不使用缓存")
 @click.option("--port", "-p", default=8000, help="服务端口 (default: 8000)")
@@ -71,7 +92,10 @@ from ksadk.cli.ui import (
 @click.option(
     "--storage-mount-path",
     default=None,
-    help="PVC 挂载目录（hermes/openclaw 默认按框架推导；adk/langgraph 等其他框架默认不挂盘，需显式指定）",
+    help=(
+        "PVC 挂载目录（hermes/openclaw 默认按框架推导；"
+        "adk/langgraph 等其他框架默认不挂盘，需显式指定）"
+    ),
 )
 @click.option("--no-storage", is_flag=True, help="禁用默认 PVC 挂载")
 @network_options
@@ -181,7 +205,7 @@ def launch(
             lambda exc: render_workflow_dry_run(
                 action="launch",
                 request=dict(exc.payload or {}),
-                plan=dict(dry_run_context.get("plan") or {}) or None,
+                plan=_dict_or_none(dry_run_context.get("plan")),
             )
         ),
     )
@@ -223,8 +247,8 @@ async def _launch_async(
     env_file: str | None = None,
     dry_run_context: dict[str, object] | None = None,
 ):
-    from ksadk.detection import FrameworkDetector
     from ksadk.deployment import DeploymentManager, DeployTarget
+    from ksadk.detection import FrameworkDetector
 
     agent_path = Path(agent_dir).resolve()
     config = _load_config(agent_path)
@@ -236,7 +260,11 @@ async def _launch_async(
         )
     except ValueError as e:
         raise validation_error(str(e))
-    effective_artifact_type = _resolve_artifact_type_input(config, artifact_type) if target == "serverless" else artifact_type
+    effective_artifact_type = (
+        _resolve_artifact_type_input(config, artifact_type)
+        if target == "serverless"
+        else artifact_type
+    )
     print_workflow_header(
         title="Agent Launch",
         subtitle=f"target: {target}",
@@ -337,7 +365,9 @@ async def _launch_async(
     explicit_artifact_reference = ks3_path if normalized_artifact_type == "code" else image
     cached_artifact_reference = None
     if not artifact_plan.should_clear_metadata:
-        cached_artifact_reference = load_cached_artifact_reference(agent_path, effective_artifact_type)
+        cached_artifact_reference = load_cached_artifact_reference(
+            agent_path, effective_artifact_type
+        )
     resolved_artifact_plan = resolve_artifact_build_plan(
         plan=artifact_plan,
         target=target,
@@ -381,7 +411,7 @@ async def _launch_async(
                 package_info.metadata["image"] = resolved_artifact_plan.reference
             else:
                 package_info.metadata["ks3_path"] = resolved_artifact_plan.reference
-        
+
         print_kv("构建目录", str(package_info.build_dir))
     except Exception as e:
         raise cli_error_from_exception(e, context="打包失败")
@@ -412,7 +442,7 @@ async def _launch_async(
                 if ks3:
                     print_kv("KS3 路径", ks3)
             else:
-                print_kv("镜像", package_info.image)
+                print_kv("镜像", package_info.image or "-")
 
         except Exception as e:
             raise cli_error_from_exception(e, context="构建失败")
@@ -458,10 +488,11 @@ async def _launch_async(
                 print_warn("请妥善保存此 API Key，它仅在首次部署时显示")
             if result.message:
                 print_kv("信息", result.message)
-            
+
             # 9. 自动创建版本快照 (除非指定 --no-version)
             if result.agent_id and not no_version and not dry_run:
                 from ksadk.cli.deploy_utils import auto_release_version
+
                 with capture_standard_output():
                     await auto_release_version(result.agent_id, region, deploy_name)
 
@@ -494,7 +525,11 @@ async def _launch_async(
             }
         else:
             if result.status.name == "SKIPPED":
-                dry_run_request = result.metadata.get("dry_run_request") if isinstance(result.metadata, dict) else None
+                dry_run_request = (
+                    result.metadata.get("dry_run_request")
+                    if isinstance(result.metadata, dict)
+                    else None
+                )
                 if dry_run and dry_run_request:
                     raise DryRunExit(result.message or "Dry Run finished.", payload=dry_run_request)
                 print_warn(f"部署状态: {result.status.value}")
@@ -531,10 +566,11 @@ async def _launch_async(
             )
             if result.message:
                 print_info(result.message)
-            
+
             # 10. 自动回滚
             if auto_rollback and result.agent_id and result.status.name not in ["SKIPPED"]:
                 from ksadk.cli.deploy_utils import auto_rollback_to_previous
+
                 with capture_standard_output():
                     await auto_rollback_to_previous(result.agent_id, region)
 
@@ -558,7 +594,7 @@ def _load_config(agent_path: Path) -> dict:
 
     if config_path.exists():
         # 使用 utf-8-sig 自动处理 BOM，确保 Windows 兼容性
-        with open(config_path, encoding='utf-8-sig') as f:
+        with open(config_path, encoding="utf-8-sig") as f:
             return yaml.safe_load(f) or {}
 
     return {}

ksadk/cli/cmd_mcp.py

@@ -4,13 +4,23 @@ import os
 from dataclasses import asdict, is_dataclass, replace
 from datetime import datetime
 from pathlib import Path
+from typing import Any
 
 import click
 
 from ksadk.api.client import DryRunExit
+from ksadk.builders.container_builder import (
+    registry_kind_label,
+    resolve_registry_credentials,
+)
 from ksadk.cli.agent_ref import resolve_mcp_ref
-from ksadk.cli.dry_run import dry_run_option, run_async_with_dry_run, effective_dry_run
-from ksadk.cli.error_utils import abort_with_cli_error, remote_error, resolution_error, usage_error, validation_error
+from ksadk.cli.dry_run import dry_run_option, effective_dry_run, run_async_with_dry_run
+from ksadk.cli.error_utils import (
+    abort_with_cli_error,
+    remote_error,
+    resolution_error,
+    validation_error,
+)
 from ksadk.cli.network_options import build_network_payload, network_cli_kwargs, network_options
 from ksadk.cli.resource_common import (
     CONTEXT_SETTINGS,
@@ -22,24 +32,24 @@ from ksadk.cli.resource_common import (
     confirm_destructive,
     confirm_options,
     pagination_options,
-    print_next_action_hint,
+    region_option,
     render_descriptor_list,
     render_descriptor_status,
-    region_option,
 )
 from ksadk.cli.ui import (
     capture_standard_output,
     get_console,
     is_json_output,
-    output_option as cli_output_option,
     print_info,
     print_kv,
     print_rule,
     print_success,
-    print_title,
     print_warn,
     status_rich_style,
 )
+from ksadk.cli.ui import (
+    output_option as cli_output_option,
+)
 from ksadk.cli.workflow_common import (
     build_workflow_local_plan,
     clear_build_metadata,
@@ -51,10 +61,6 @@ from ksadk.cli.workflow_common import (
     render_workflow_result,
     resolve_artifact_build_plan,
 )
-from ksadk.builders.container_builder import (
-    registry_kind_label,
-    resolve_registry_credentials,
-)
 
 console = get_console()
 
@@ -127,14 +133,14 @@ def mcp():
 @click.option("--tag", help="镜像标签 (Container 模式)")
 @click.option("--registry", help="镜像仓库地址 (Container 模式)")
 @click.option(
-    "--region", "-r",
+    "--region",
+    "-r",
     default="cn-beijing-6",
     envvar="KSYUN_REGION",
     help="构建使用的区域 (Code 模式用于 KS3，Container 模式用于默认镜像仓库推断)",
 )
 @click.option(
-    "--ks3-bucket",
-    help="KS3 存储桶名称 (Code 模式，默认: agentengine-{account_id}-{region})"
+    "--ks3-bucket", help="KS3 存储桶名称 (Code 模式，默认: agentengine-{account_id}-{region})"
 )
 @click.option(
     "--no-cache",
@@ -177,28 +183,18 @@ def build(
         render_workflow_result(action="build", result=result)
 
 
-@mcp.command("deploy", context_settings=CONTEXT_SETTINGS)
+@mcp.command("deploy", context_settings=CONTEXT_SETTINGS, short_help="部署 MCP Server 到云端")
 @click.argument("mcp_dir", default=".", type=click.Path(exists=True))
+@click.option("--name", "-n", help="MCP Server 名称 (默认: 目录名)")
 @click.option(
-    "--name", "-n",
-    help="MCP Server 名称 (默认: 目录名)"
-)
-@click.option(
-    "--region", "-r",
+    "--region",
+    "-r",
     default="cn-beijing-6",
     envvar="KSYUN_REGION",
-    help="部署区域 (default: cn-beijing-6)"
-)
-@click.option(
-    "--ks3-bucket",
-    help="KS3 存储桶名称 (默认: agentengine-{region})"
-)
-@click.option(
-    "--enable-auth",
-    is_flag=True,
-    default=False,
-    help="启用 API Key 保护 (可选)"
+    help="部署区域 (default: cn-beijing-6)",
 )
+@click.option("--ks3-bucket", help="KS3 存储桶名称 (默认: agentengine-{region})")
+@click.option("--enable-auth", is_flag=True, default=False, help="启用 API Key 保护 (可选)")
 @dry_run_option("仅显示请求内容，不实际部署")
 @click.option(
     "--artifact-type",
@@ -232,10 +228,10 @@ def deploy(
     output_mode: str | None,
 ):
     """部署 MCP Server 到云端
-    
+
     \b
     MCP_DIR: MCP 项目目录 (默认: 当前目录)
-    
+
     \b
     示例:
         # 1) 默认部署 (Code 模式)
@@ -244,7 +240,7 @@ def deploy(
         agentengine mcp deploy ./my-mcp --name my-tools --artifact-type Container
         # 3) 显式指定区域
         KSYUN_REGION=cn-beijing-6 agentengine mcp deploy . --dry-run
-    
+
     \b
     部署后的 endpoint 兼容标准 MCP 协议，可以被:
         - LangGraph/LangChain (via langchain-mcp-adapters)
@@ -255,6 +251,15 @@ def deploy(
     _ = output_mode
     dry_run = effective_dry_run(dry_run)
     dry_run_context: dict[str, object] = {}
+
+    def render_mcp_deploy_dry_run(exc: DryRunExit) -> None:
+        plan_value = dry_run_context.get("plan")
+        render_workflow_dry_run(
+            action="deploy",
+            request=dict(exc.payload) if isinstance(exc.payload, dict) else {},
+            plan=dict(plan_value) if isinstance(plan_value, dict) else None,
+        )
+
     try:
         result = run_async_with_dry_run(
             _deploy_mcp_async(
@@ -277,13 +282,7 @@ def deploy(
                 dry_run_context=dry_run_context,
             ),
             dry_run=dry_run,
-            on_dry_run=(
-                lambda exc: render_workflow_dry_run(
-                    action="deploy",
-                    request=dict(exc.payload or {}),
-                    plan=dict(dry_run_context.get("plan") or {}) or None,
-                )
-            ),
+            on_dry_run=render_mcp_deploy_dry_run,
         )
     except Exception as e:
         _abort_mcp_error(e, context="部署失败", argv=["mcp", "deploy"])
@@ -403,9 +402,11 @@ def _print_mcp_build_summary(
         print_kv("工具", ", ".join(build_result.metadata["tools"]))
 
 
-def _persist_mcp_build_metadata(mcp_path: Path, build_result, *, artifact_type: str, artifact_reference: str) -> None:
+def _persist_mcp_build_metadata(
+    mcp_path: Path, build_result, *, artifact_type: str, artifact_reference: str
+) -> None:
     metadata_file = mcp_path / ".agentengine" / "build-metadata.json"
-    if is_dataclass(build_result):
+    if is_dataclass(build_result) and not isinstance(build_result, type):
         payload = asdict(build_result)
     else:
         payload = {
@@ -462,8 +463,11 @@ async def _build_code_artifact(
         uploader = KS3Uploader(region=upload_region, bucket=ks3_bucket)
         timestamp = datetime.now().strftime("%Y%m%d%H%M%S")
         object_key = f"mcps/{mcp_name}/code_{timestamp}.zip"
+        artifact_path = build_result.artifact_path
+        if artifact_path is None:
+            raise validation_error("构建成功但未生成 artifact_path")
         with capture_standard_output():
-            ks3_path = await uploader.upload(build_result.artifact_path, object_key)
+            ks3_path = await uploader.upload(artifact_path, object_key)
         if not ks3_path:
             raise remote_error("KS3 上传失败")
         artifact_reference = ks3_path
@@ -528,7 +532,7 @@ def _build_mcp_request_data(
 ) -> dict:
     resources = config.get("resources") or {}
     scaling = config.get("scaling") or {}
-    request_data = {
+    request_data: dict[str, Any] = {
         "name": mcp_name,
         "type": "mcp",
         "artifact_type": artifact_type,
@@ -564,15 +568,19 @@ def _build_mcp_request_data(
     else:
         kcr_username, kcr_password, registry_kind = resolve_registry_credentials(artifact_reference)
         if kcr_username and kcr_password:
-            request_data["image_credential"] = {
+            image_credential = {
                 "endpoint": artifact_reference.split("/", 1)[0],
                 "username": kcr_username,
                 "password": kcr_password,
             }
-            print_kv("镜像凭证", f"{kcr_username}@{request_data['image_credential']['endpoint']}")
+            request_data["image_credential"] = image_credential
+            print_kv("镜像凭证", f"{kcr_username}@{image_credential['endpoint']}")
         else:
             if registry_kind == "personal_kcr":
-                print_warn("未配置个人版 KCR 镜像凭证 (KSYUN_ACCOUNT_ID/KCR_PASSWORD)，私有镜像可能无法拉取")
+                print_warn(
+                    "未配置个人版 KCR 镜像凭证 "
+                    "(KSYUN_ACCOUNT_ID/KCR_PASSWORD)，私有镜像可能无法拉取"
+                )
             else:
                 print_warn(
                     f"未配置{registry_kind_label(registry_kind)} 镜像凭证 "
@@ -670,8 +678,7 @@ async def _build_mcp_async(
         "artifact_source": (
             "built_and_uploaded"
             if normalized_artifact_type == "Code" and push
-            else "built_and_pushed" if normalized_artifact_type == "Container" and push
-            else "built"
+            else "built_and_pushed" if normalized_artifact_type == "Container" and push else "built"
         ),
         "artifact_reused": bool(build_result.metadata.get("reused", False)),
         "artifact_built": True,
@@ -753,7 +760,9 @@ async def _deploy_mcp_async(
 
     cached_artifact_reference = None
     if not artifact_plan.should_clear_metadata:
-        cached_artifact_reference = load_cached_artifact_reference(mcp_path, normalized_artifact_type)
+        cached_artifact_reference = load_cached_artifact_reference(
+            mcp_path, normalized_artifact_type
+        )
 
     resolved_artifact_plan = resolve_artifact_build_plan(
         plan=artifact_plan,
@@ -869,7 +878,7 @@ async def _deploy_mcp_async(
             res = await client.update_mcp(existing_mcp_id, request_data)
             mcp_id = existing_mcp_id
         else:
-            # create 默认开公网（network 未显式 enable_public_access 时补 True）；update 分支用原始 request_data（network 缺省=保留服务端现有配置）
+            # create 默认开公网；update 缺省 network 时保留服务端配置。
             create_network = dict(request_data.get("network") or {})
             if "enable_public_access" not in create_network:
                 create_network["enable_public_access"] = True
@@ -935,7 +944,7 @@ def list_mcps(region: str, page: int, size: int, dry_run: bool, output_mode: str
     _ = output_mode
     dry_run = effective_dry_run(dry_run)
     from ksadk.api import AgentEngineClient
-    
+
     async def _list():
         async with AgentEngineClient(region=region, dry_run=dry_run) as client:
             resp = await client.list_mcps(region=region, page=page, page_size=size)
@@ -984,14 +993,14 @@ def list_mcps(region: str, page: int, size: int, dry_run: bool, output_mode: str
         _abort_mcp_error(e, context="获取列表失败", argv=["mcp", "list"])
 
 
-@mcp.command("status", context_settings=CONTEXT_SETTINGS)
+@mcp.command("status", context_settings=CONTEXT_SETTINGS, short_help="查看 MCP 状态")
 @click.argument("mcp_ref", required=False)
 @region_option(default=None, envvar=None, help_text="区域 (默认优先读取 .agentengine.state)")
 @dry_run_option()
 @cli_output_option()
 def status(mcp_ref: str | None, region: str | None, dry_run: bool, output_mode: str | None):
     """查看 MCP 状态
-    
+
     MCP_ID: MCP 的 ID
     """
     _ = output_mode
@@ -1015,7 +1024,7 @@ def status(mcp_ref: str | None, region: str | None, dry_run: bool, output_mode:
     target_ref = resolved.value
     if resolved.source != "cli":
         print_info(f"未显式指定 MCP，使用 {resolved.source_text}: {target_ref}")
-    
+
     async def _get():
         async with AgentEngineClient(region=region, dry_run=dry_run) as client:
             mcp = None
@@ -1027,7 +1036,7 @@ def status(mcp_ref: str | None, region: str | None, dry_run: bool, output_mode:
                 mcp = await client.get_mcp_by_name(target_ref, region=region)
             if not mcp:
                 raise resolution_error(f"未找到 MCP: {target_ref}", hints=["agentengine mcp list"])
-            
+
             status_text = (mcp.get("status") or "UNKNOWN").upper()
             fields = [
                 ("ID", str(mcp.get("mcp_id", "-")), None),
@@ -1037,7 +1046,7 @@ def status(mcp_ref: str | None, region: str | None, dry_run: bool, output_mode:
                 ("MCP URL", str(mcp.get("mcp_endpoint", "N/A")), "#58a6ff"),
                 ("认证", "已开启" if mcp.get("enable_auth") else "未开启", None),
             ]
-            if mcp.get('tools'):
+            if mcp.get("tools"):
                 fields.append(("工具", ", ".join(mcp["tools"]), None))
             fields.extend(
                 [
@@ -1088,19 +1097,32 @@ def _delete_impl(mcp_ids: tuple[str, ...], region: str, assume_yes: bool, dry_ru
         prompt=f"确定要删除这 {len(mcp_ids)} 个 MCP 吗?",
     ):
         return
-    
+
     async def _delete():
         async with AgentEngineClient(region=region, dry_run=dry_run) as client:
             failed_ids: list[str] = []
             deleted_ids: list[str] = []
+            failure_reasons: dict[str, str] = {}
             for mcp_id in mcp_ids:
-                success = await client.delete_mcp(mcp_id)
+                try:
+                    success = await client.delete_mcp(mcp_id)
+                except DryRunExit:
+                    raise
+                except Exception as exc:
+                    failed_ids.append(mcp_id)
+                    reason = str(exc)
+                    request_id = str(getattr(exc, "details", {}).get("request_id") or "")
+                    if request_id:
+                        reason = f"{reason} (RequestId: {request_id})"
+                    failure_reasons[mcp_id] = reason
+                    continue
                 if success:
                     deleted_ids.append(mcp_id)
                     print_success(f"MCP 已删除: {mcp_id}")
 
                     # 尝试清理本地状态文件 (如果在项目目录中)
                     from ksadk.deployment.state import clear_state
+
                     try:
                         removed = clear_state(Path("."), key=mcp_id)
                         if removed:
@@ -1111,11 +1133,19 @@ def _delete_impl(mcp_ids: tuple[str, ...], region: str, assume_yes: bool, dry_ru
                         pass
                 else:
                     failed_ids.append(mcp_id)
+                    failure_reasons[mcp_id] = "服务端未确认删除"
 
             if failed_ids:
+                reason_text = "; ".join(
+                    f"{mcp_id}: {failure_reasons[mcp_id]}" for mcp_id in failed_ids
+                )
                 raise remote_error(
-                    f"以下 MCP 删除失败: {', '.join(failed_ids)}",
-                    details={"deleted": deleted_ids, "failed": failed_ids},
+                    f"以下 MCP 删除失败: {', '.join(failed_ids)}。原因: {reason_text}",
+                    details={
+                        "deleted": deleted_ids,
+                        "failed": failed_ids,
+                        "errors": failure_reasons,
+                    },
                 )
             return {
                 "targets": list(mcp_ids),
@@ -1123,7 +1153,7 @@ def _delete_impl(mcp_ids: tuple[str, ...], region: str, assume_yes: bool, dry_ru
                 "failed": failed_ids,
             }
 
-    dry_run_kwargs = {"dry_run": dry_run}
+    dry_run_kwargs: dict[str, Any] = {"dry_run": dry_run}
     if is_json_output():
         dry_run_kwargs.update(
             dry_run_resource="mcp",
@@ -1161,7 +1191,9 @@ def _delete_impl(mcp_ids: tuple[str, ...], region: str, assume_yes: bool, dry_ru
 @confirm_options()
 @dry_run_option()
 @cli_output_option()
-def delete(mcp_ids: tuple[str, ...], region: str, assume_yes: bool, dry_run: bool, output_mode: str | None):
+def delete(
+    mcp_ids: tuple[str, ...], region: str, assume_yes: bool, dry_run: bool, output_mode: str | None
+):
     """删除 MCP。"""
     _ = output_mode
     _delete_impl(mcp_ids=mcp_ids, region=region, assume_yes=assume_yes, dry_run=dry_run)
@@ -1173,7 +1205,9 @@ def delete(mcp_ids: tuple[str, ...], region: str, assume_yes: bool, dry_run: boo
 @confirm_options()
 @dry_run_option()
 @cli_output_option()
-def destroy(mcp_ids: tuple[str, ...], region: str, assume_yes: bool, dry_run: bool, output_mode: str | None):
+def destroy(
+    mcp_ids: tuple[str, ...], region: str, assume_yes: bool, dry_run: bool, output_mode: str | None
+):
     """删除 MCP。"""
     _ = output_mode
     _delete_impl(mcp_ids=mcp_ids, region=region, assume_yes=assume_yes, dry_run=dry_run)

ksadk/cli/cmd_model.py

@@ -3,15 +3,20 @@ agentengine model - 切换模型
 """
 
 import os
+from pathlib import Path
+
 import click
 import httpx
 import questionary
 import yaml
-from pathlib import Path
 from dotenv import set_key
-from ksadk.deployment.state import load_state
+
 from ksadk.cli.error_utils import abort_with_cli_error, print_exception, usage_error
-from ksadk.cli.resource_common import CONTEXT_SETTINGS, CompatibilityAliasCommand, print_compatibility_hint
+from ksadk.cli.resource_common import (
+    CONTEXT_SETTINGS,
+    CompatibilityAliasCommand,
+    print_compatibility_hint,
+)
 from ksadk.cli.ui import (
     is_color_disabled,
     is_stdout_tty,
@@ -22,6 +27,7 @@ from ksadk.cli.ui import (
     print_title,
     print_warn,
 )
+from ksadk.deployment.state import load_state
 
 
 def _parse_model_selection(raw: str | None) -> list[str]:
@@ -71,7 +77,9 @@ def _write_default_model(selected_model: str) -> Path:
     if not selected_model:
         raise click.ClickException("未选择模型")
     env_file = _resolve_env_file()
-    success, _key, _value = set_key(env_file, "OPENAI_MODEL_NAME", selected_model, quote_mode="never")
+    success, _key, _value = set_key(
+        env_file, "OPENAI_MODEL_NAME", selected_model, quote_mode="never"
+    )
     if not success:
         raise click.ClickException("更新 OPENAI_MODEL_NAME 失败")
     return env_file
@@ -145,7 +153,8 @@ def run_model_command(
                 hints=[
                     "查看当前模型配置请使用 `agentengine config show`。",
                     "非交互修改请使用 `agentengine config set OPENAI_MODEL_NAME=<model>`。",
-                    "为 Agent/deploy 生成环境变量请使用 `agentengine config model --env <model[,model...]>`。",
+                    "为 Agent/deploy 生成环境变量请使用 "
+                    "`agentengine config model --env <model[,model...]>`。",
                 ],
             ),
             argv=["config", "model"],