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

ksadk/cli/cmd_web.py

@@ -1,10 +1,13 @@
 """ksadk web - 启动统一本地 Web UI。"""
 
-import click
+import asyncio
+import os
 import webbrowser
 from pathlib import Path
-import os
+
+import click
 import yaml
+
 from ksadk.cli.error_utils import ensure_json_output_supported, print_exception
 from ksadk.cli.local_runtime import reexec_with_project_venv_if_needed
 from ksadk.cli.ui import (
@@ -13,12 +16,12 @@ from ksadk.cli.ui import (
     print_kv,
     print_success,
     print_title,
+    print_warn,
 )
 from ksadk.configs import setup_environment
 from ksadk.detection import FrameworkDetector
 from ksadk.runners.factory import create_runner
 
-
 _PERSISTENT_STM_FRAMEWORKS = {"adk", "langgraph", "langchain", "deepagents"}
 _STM_ENV_NAMES = (
     "KSADK_STM_BACKEND",
@@ -179,6 +182,47 @@ def _default_project_stm_if_unset(
         )
 
 
+def configure_local_runtime_persistence(
+    agent_path: Path,
+    framework: str,
+    *,
+    explicit_session_env_names: set[str] | None = None,
+    explicit_checkpoint_env_names: set[str] | None = None,
+    explicit_local_ui_env_names: set[str] | None = None,
+) -> None:
+    """Bind locally-run agent state to its project unless the shell overrides it."""
+
+    project_dotenv = _project_dotenv_values(agent_path)
+    if explicit_session_env_names is None:
+        explicit_session_env_names = _explicit_env_names_excluding_project_dotenv(
+            (*_STM_ENV_NAMES, *_SESSION_ENV_NAMES),
+            project_dotenv,
+        )
+    if explicit_checkpoint_env_names is None:
+        explicit_checkpoint_env_names = _explicit_env_names_excluding_project_dotenv(
+            _CHECKPOINT_ENV_NAMES,
+            project_dotenv,
+        )
+    if explicit_local_ui_env_names is None:
+        explicit_local_ui_env_names = _explicit_env_names_excluding_project_dotenv(
+            _LOCAL_UI_ENV_NAMES,
+            project_dotenv,
+        )
+
+    os.environ["KSADK_PROJECT_DIR"] = str(agent_path)
+    local_ui_dir = str(agent_path / ".agentengine" / "ui")
+    if "AGENTENGINE_UI_DIR" not in explicit_local_ui_env_names:
+        os.environ["AGENTENGINE_UI_DIR"] = local_ui_dir
+    else:
+        os.environ.setdefault("AGENTENGINE_UI_DIR", local_ui_dir)
+    _default_project_stm_if_unset(
+        framework,
+        agent_path,
+        explicit_session_env_names=explicit_session_env_names,
+        explicit_checkpoint_env_names=explicit_checkpoint_env_names,
+    )
+
+
 @click.command(context_settings=dict(help_option_names=["-h", "--help"]))
 @click.argument("agent_dir", default=".", type=click.Path(exists=True))
 @click.option("--port", "-p", default=8080, help="Web UI 端口")
@@ -197,13 +241,18 @@ def web(agent_dir: str, port: int, model: str, no_open: bool):
     """
     ensure_json_output_supported(
         "agentengine web",
-        suggestion="请改用 `agentengine dashboard open` 或 `agentengine agent status --output json`。",
+        suggestion=(
+            "请改用 `agentengine dashboard open` 或 " "`agentengine agent status --output json`。"
+        ),
     )
 
     agent_path = Path(agent_dir).resolve()
     command_args = ["web", str(agent_path), "--port", str(port)]
     if model:
         command_args.extend(["--model", model])
+    if no_open:
+        # re-exec 进项目 venv 时透传 --no-open,否则子进程仍会打开浏览器
+        command_args.append("--no-open")
     reexec_with_project_venv_if_needed(agent_path, command_args)
     project_dotenv = _project_dotenv_values(agent_path)
     explicit_session_env_names = _explicit_env_names_excluding_project_dotenv(
@@ -238,28 +287,55 @@ def web(agent_dir: str, port: int, model: str, no_open: bool):
         print_error("未检测到支持的框架")
         raise SystemExit(1)
 
+    if result.type.value == "codex":
+        raw_config = getattr(result, "raw_config", None) or {}
+        if str(raw_config.get("artifact_type") or "").strip().lower() == "managedruntime":
+            from ksadk.managed_runtime import (
+                ManagedRuntimeError,
+                resolve_local_managed_runtime,
+            )
+
+            try:
+                resolved_runtime = asyncio.run(
+                    resolve_local_managed_runtime(
+                        raw_config,
+                        region=os.getenv("KSYUN_REGION", "cn-beijing-6"),
+                    )
+                )
+            except ManagedRuntimeError as exc:
+                print_error(str(exc))
+                raise SystemExit(1) from exc
+            runtime_config = raw_config.setdefault("runtime", {})
+            if isinstance(runtime_config, dict):
+                runtime_config["version"] = resolved_runtime.version
+            print_kv(
+                "Runtime",
+                f"{resolved_runtime.name}@{resolved_runtime.version}",
+                value_style="#58a6ff",
+            )
+            if resolved_runtime.source == "installed-unlocked":
+                print_warn(
+                    "离线使用本机已安装 Runtime；云端构建前请显式锁定版本"
+                    "或连接 AgentEngine 获取默认版本"
+                )
+
     # Map framework types to display names
     framework_map = {
         "adk": "ADK",
         "langchain": "LangChain",
         "langgraph": "LangGraph",
         "deepagents": "DeepAgents",
+        "codex": "Codex",
     }
     display_name = framework_map.get(result.type.value, result.name)
     print_kv("框架", display_name, value_style="#2da44e")
 
-    # 本地 UI 的持久化目录与项目根绑定
-    os.environ["KSADK_PROJECT_DIR"] = str(agent_path)
-    local_ui_dir = str(agent_path / ".agentengine" / "ui")
-    if "AGENTENGINE_UI_DIR" not in explicit_local_ui_env_names:
-        os.environ["AGENTENGINE_UI_DIR"] = local_ui_dir
-    else:
-        os.environ.setdefault("AGENTENGINE_UI_DIR", local_ui_dir)
-    _default_project_stm_if_unset(
-        result.type.value,
+    configure_local_runtime_persistence(
         agent_path,
+        result.type.value,
         explicit_session_env_names=explicit_session_env_names,
         explicit_checkpoint_env_names=explicit_checkpoint_env_names,
+        explicit_local_ui_env_names=explicit_local_ui_env_names,
     )
     launch_path = _configure_custom_ui_env(agent_path)
 

ksadk/cli/deploy_utils.py

@@ -1,28 +1,28 @@
 import os
+
 import click
+
 from ksadk.api import AgentEngineClient
 
+
 async def auto_release_version(agent_id: str, region: str, deploy_name: str):
     """部署成功后自动创建版本快照"""
-    from datetime import datetime
-    
+
     access_key = os.getenv("KSYUN_ACCESS_KEY") or os.getenv("KS3_ACCESS_KEY")
     secret_key = os.getenv("KSYUN_SECRET_KEY") or os.getenv("KS3_SECRET_KEY")
-    
+
     client = AgentEngineClient(
         access_key=access_key,
         secret_key=secret_key,
         region=region,
     )
-    
+
     try:
         description = "部署后自动发布"
         result = await client.release_version(
-            agent_id=agent_id,
-            tag=None,  # 自动生成
-            description=description
+            agent_id=agent_id, tag=None, description=description  # 自动生成
         )
-        
+
         click.echo("")
         click.secho(f"✓ 版本快照已创建: {result.get('tag')}", fg="green")
     except Exception as e:
@@ -34,53 +34,53 @@ async def auto_release_version(agent_id: str, region: str, deploy_name: str):
 
 async def auto_rollback_to_previous(agent_id: str, region: str):
     """部署失败时自动回滚到上一版本"""
-    
+
     access_key = os.getenv("KSYUN_ACCESS_KEY") or os.getenv("KS3_ACCESS_KEY")
     secret_key = os.getenv("KSYUN_SECRET_KEY") or os.getenv("KS3_SECRET_KEY")
-    
+
     client = AgentEngineClient(
         access_key=access_key,
         secret_key=secret_key,
         region=region,
     )
-    
+
     try:
         # 获取版本列表，找到最近的历史版本
         versions_result = await client.list_versions(agent_id, page=1, size=5)
         versions = versions_result.get("versions", [])
-        
+
         # 找到需要回滚的目标版本 (统一 snake_case)
         target_version = None
         for v in versions:
             if (v.get("status") or "").lower() == "current":
                 target_version = v
                 break
-        
+
         # 如果没有 Current，则找最新的 Historical
         if not target_version:
             for v in versions:
                 if (v.get("status") or "").lower() == "historical":
                     target_version = v
                     break
-        
+
         if not target_version:
             click.secho("⚠ 无可用稳定版本，跳过自动回滚", fg="yellow")
             return
-        
+
         target_tag = target_version.get("tag")
         click.echo("")
         click.secho(f"⏪ 正在自动回滚到版本: {target_tag}...", fg="yellow")
-        
+
         # 执行回滚
-        result = await client.rollback_version(
+        await client.rollback_version(
             agent_id=agent_id,
             target_tag=target_tag,
             ks3_access_key=access_key,
-            ks3_secret_key=secret_key
+            ks3_secret_key=secret_key,
         )
-        
+
         click.secho(f"✓ 已回滚到版本: {target_tag}", fg="green")
-        
+
     except Exception as e:
         click.secho(f"⚠ 自动回滚失败: {e}", fg="red")
     finally:

ksadk/cli/dry_run.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 import asyncio
 import json
 import os
-from typing import Any, Awaitable, Callable, Optional, TypeVar
+from typing import Any, Callable, Coroutine, Optional, TypeVar
 
 import click
 from click.core import ParameterSource
@@ -172,7 +172,7 @@ def sanitize_dry_run_request(payload: dict[str, Any] | None) -> dict[str, Any]:
 
 
 def run_async_with_dry_run(
-    coro: Awaitable[_T],
+    coro: Coroutine[Any, Any, _T],
     *,
     dry_run: bool,
     done_message: str = _DEFAULT_DONE_MSG,
@@ -200,7 +200,9 @@ def run_async_with_dry_run(
             )
         elif safe_payload:
             click.echo("=" * 60)
-            click.echo(f"Dry Run Mode: {safe_payload.get('method', 'REQUEST')} {safe_payload.get('url', '')}")
+            method = safe_payload.get("method", "REQUEST")
+            url = safe_payload.get("url", "")
+            click.echo(f"Dry Run Mode: {method} {url}")
             click.echo("=" * 60)
             click.echo(f"Headers: {safe_payload.get('headers')}")
             if safe_payload.get("body") is not None:

ksadk/cli/error_utils.py

@@ -2,10 +2,10 @@
 
 from __future__ import annotations
 
-from dataclasses import dataclass, field
 import os
 import re
 import sys
+from dataclasses import dataclass, field
 from typing import Any, Optional, Sequence, Tuple
 
 import click
@@ -128,9 +128,16 @@ def _looks_like_invalid_cloud_credentials(details: dict[str, Any], msg_lower: st
     return any(marker in msg_lower for marker in markers)
 
 
-def _looks_like_runtime_permission_error(details: dict[str, Any], msg_lower: str, code: int | None) -> bool:
+def _looks_like_runtime_permission_error(
+    details: dict[str, Any], msg_lower: str, code: int | None
+) -> bool:
     remote_code = str(details.get("remote_error_code") or "").strip().lower()
-    if remote_code in {"accessdenied", "accessdeniedexception", "unauthorized", "unauthorizedoperation"}:
+    if remote_code in {
+        "accessdenied",
+        "accessdeniedexception",
+        "unauthorized",
+        "unauthorizedoperation",
+    }:
         return True
     if code in {401, 403} and (
         ("权限" in msg_lower)
@@ -145,7 +152,8 @@ def _looks_like_runtime_permission_error(details: dict[str, Any], msg_lower: str
 
 def _credential_setup_hints() -> list[str]:
     return [
-        "请检查当前 shell 或项目 `.env` 中是否设置了 `KSYUN_ACCESS_KEY` / `KSYUN_SECRET_KEY`（兼容 `KS3_ACCESS_KEY` / `KS3_SECRET_KEY`）。",
+        "请检查当前 shell 或项目 `.env` 中是否设置了 `KSYUN_ACCESS_KEY` / "
+        "`KSYUN_SECRET_KEY`（兼容 `KS3_ACCESS_KEY` / `KS3_SECRET_KEY`）。",
         "先到 AgentEngine Runtime 控制台确认账号是否具备运行时权限: https://ksp.console.ksyun.com/#/agentEngineRuntime",
         "如当前子账号没有权限，请到 IAM 授权页授权: https://uc.console.ksyun.com/pro/iam/#/permission/authorize",
         "如果还没有金山云 AK/SK，请让主账号先到 IAM 控制台创建子账号并生成访问密钥: https://uc.console.ksyun.com/pro/iam/",
@@ -154,7 +162,8 @@ def _credential_setup_hints() -> list[str]:
 
 def _invalid_credential_hints() -> list[str]:
     return [
-        "请检查当前 shell 或项目 `.env` 中的 `KSYUN_ACCESS_KEY` / `KSYUN_SECRET_KEY` 是否填写正确，且没有多余空格。",
+        "请检查当前 shell 或项目 `.env` 中的 `KSYUN_ACCESS_KEY` / "
+        "`KSYUN_SECRET_KEY` 是否填写正确，且没有多余空格。",
         "确认该 AK/SK 未被禁用、删除或重置，并且属于当前要操作的金山云账号。",
         "如需确认账号是否具备 AgentEngine Runtime 权限，可先查看: https://ksp.console.ksyun.com/#/agentEngineRuntime",
         "如果凭证属于子账号但仍然被拒绝，请到 IAM 授权页检查授权: https://uc.console.ksyun.com/pro/iam/#/permission/authorize",
@@ -188,7 +197,9 @@ def _matches_resource_not_found(msg_lower: str, args: Sequence[str], *, resource
     return args[0] == resource
 
 
-def explain_exception(err: Exception, argv: Optional[Sequence[str]] = None) -> Tuple[str, list[str]]:
+def explain_exception(
+    err: Exception, argv: Optional[Sequence[str]] = None
+) -> Tuple[str, list[str]]:
     cli_error = cli_error_from_exception(err, argv=argv)
     return cli_error.message, cli_error.hints
 
@@ -384,7 +395,9 @@ def cli_error_from_exception(
 
     if code == 404 and len(args) >= 2 and args[0] == "dashboard" and args[1] == "share":
         summary = "未找到 Dashboard 分享链接或目标 Agent。"
-        hints.append("请先执行 `agentengine dashboard share list --agent <AgentName|AgentId>` 查看分享链接。")
+        hints.append(
+            "请先执行 `agentengine dashboard share list --agent <AgentName|AgentId>` 查看分享链接。"
+        )
         hints.append("如需先确认 Agent，请执行 `agentengine agent list`。")
         error_code = "resolution_error"
         exit_code = EXIT_CODE_RESOLUTION
@@ -396,22 +409,34 @@ def cli_error_from_exception(
         exit_code = EXIT_CODE_RESOLUTION
     elif code == 404 and _matches_resource_not_found(msg_lower, args, resource="agent"):
         summary = "未找到 Agent。"
-        hints.append("请确认 Agent 名称/ID 是否正确，可先执行 `agentengine agent list` 查看已部署 Agent。")
+        hints.append(
+            "请确认 Agent 名称/ID 是否正确，可先执行 `agentengine agent list` 查看已部署 Agent。"
+        )
         if len(args) >= 2 and args[0] == "dashboard" and args[1] == "list":
             hints.append("`agentengine dashboard list` 不是有效命令。")
-            hints.append("如果要查看分享链接，请使用 `agentengine dashboard share list --agent <AgentName|AgentId>`。")
+            hints.append(
+                "如果要查看分享链接，请使用 "
+                "`agentengine dashboard share list --agent <AgentName|AgentId>`。"
+            )
         elif args and args[0] == "dashboard":
-            hints.append("可显式指定 Agent：`agentengine dashboard open --agent <AgentName|AgentId>`。")
+            hints.append(
+                "可显式指定 Agent：`agentengine dashboard open --agent <AgentName|AgentId>`。"
+            )
         error_code = "resolution_error"
         exit_code = EXIT_CODE_RESOLUTION
     elif code == 404 and _matches_resource_not_found(msg_lower, args, resource="mcp"):
         summary = "未找到 MCP。"
-        hints.append("请确认 MCP 名称/ID 是否正确，可先执行 `agentengine mcp list` 查看已部署 MCP。")
+        hints.append(
+            "请确认 MCP 名称/ID 是否正确，可先执行 `agentengine mcp list` 查看已部署 MCP。"
+        )
         error_code = "resolution_error"
         exit_code = EXIT_CODE_RESOLUTION
     elif code == 404 and _matches_resource_not_found(msg_lower, args, resource="openclaw"):
         summary = "未找到 OpenClaw。"
-        hints.append("请确认 OpenClaw 名称/ID 是否正确，可先执行 `agentengine openclaw list` 查看已部署实例。")
+        hints.append(
+            "请确认 OpenClaw 名称/ID 是否正确，可先执行 "
+            "`agentengine openclaw list` 查看已部署实例。"
+        )
         error_code = "resolution_error"
         exit_code = EXIT_CODE_RESOLUTION
     elif _looks_like_missing_cloud_credentials(details, msg_lower):

ksadk/cli/global_options.py

@@ -10,8 +10,7 @@ from ksadk.cli.ui import build_no_color_click_option, build_output_click_option
 
 def _has_long_option(command: click.Command, option_name: str) -> bool:
     return any(
-        isinstance(param, click.Option) and option_name in param.opts
-        for param in command.params
+        isinstance(param, click.Option) and option_name in param.opts for param in command.params
     )
 
 

ksadk/cli/local_runtime.py

@@ -3,12 +3,11 @@
 from __future__ import annotations
 
 import os
-from pathlib import Path
 import site
 import sys
+from pathlib import Path
 from typing import Sequence
 
-
 LOCAL_RUNTIME_VENV_REEXEC_ENV = "AGENTENGINE_LOCAL_RUNTIME_VENV_REEXEC"
 LEGACY_WEB_VENV_REEXEC_ENV = "AGENTENGINE_WEB_VENV_REEXEC"
 

ksadk/cli/model_catalog.py

@@ -116,7 +116,9 @@ async def fetch_provider_model_catalog(
     normalized: list[dict[str, Any]] = []
     for raw_model in _extract_catalog_items(payload):
         item = normalize_model_metadata(raw_model)
-        item["_provider_raw_model"] = raw_model if isinstance(raw_model, Mapping) else {"id": str(raw_model)}
+        item["_provider_raw_model"] = (
+            raw_model if isinstance(raw_model, Mapping) else {"id": str(raw_model)}
+        )
         normalized.append(item)
     return normalized
 
@@ -128,7 +130,9 @@ async def fetch_provider_model_metadata(
     model: str | None,
     timeout: float = 10.0,
 ) -> dict[str, Any] | None:
-    catalog = await fetch_provider_model_catalog(api_base=api_base, api_key=api_key, timeout=timeout)
+    catalog = await fetch_provider_model_catalog(
+        api_base=api_base, api_key=api_key, timeout=timeout
+    )
     raw_models = [item.get("_provider_raw_model") or item for item in catalog]
     raw_match = find_model_in_catalog(raw_models, model)
     if raw_match is None:

ksadk/cli/network_options.py

@@ -38,7 +38,10 @@ def network_options(func):
         click.option(
             "--enable-public-access/--disable-public-access",
             default=None,
-            help="是否开启公网访问；创建时默认开启，更新已有 Agent 时未指定则保留现有配置（显式传入才覆盖）",
+            help=(
+                "是否开启公网访问；创建时默认开启，更新已有 Agent 时未指定则保留现有配置"
+                "（显式传入才覆盖）"
+            ),
         ),
         click.option("--enable-vpc-access", is_flag=True, default=False, help="开启 VPC 私网访问"),
         click.option("--vpc-id", default=None, help="VPC ID（开启 VPC 访问时必填）"),
@@ -75,7 +78,8 @@ def extract_network_config(config: Mapping[str, Any] | None) -> dict[str, Any]:
     """Read network from top-level `network` or `deploy.network`."""
     if not isinstance(config, Mapping):
         return {}
-    deploy_config = config.get("deploy") if isinstance(config.get("deploy"), Mapping) else {}
+    deploy_value = config.get("deploy")
+    deploy_config: Mapping[str, Any] = deploy_value if isinstance(deploy_value, Mapping) else {}
     raw_network = config.get("network") or deploy_config.get("network") or {}
     return dict(raw_network) if isinstance(raw_network, Mapping) else {}
 
@@ -98,7 +102,12 @@ def apply_network_config(config: Mapping[str, Any] | None, deploy_target: "Deplo
     if _picked_public_access is not None:
         deploy_target.network.enable_public_access = bool(_picked_public_access)
     deploy_target.network.enable_vpc_access = bool(
-        _pick("enable_vpc_access", "enableVpcAccess", "EnableVpcAccess", default=deploy_target.network.enable_vpc_access)
+        _pick(
+            "enable_vpc_access",
+            "enableVpcAccess",
+            "EnableVpcAccess",
+            default=deploy_target.network.enable_vpc_access,
+        )
     )
     deploy_target.network.vpc_id = str(
         _pick("vpc_id", "vpcId", "VpcId", default=deploy_target.network.vpc_id) or ""
@@ -136,7 +145,9 @@ def apply_network_cli_overrides(deploy_target: "DeployTarget", **network_kwargs:
         value = network_kwargs.get(field)
         if value is not None:
             setattr(deploy_target.network, field, str(value or "").strip())
-    if any(str(getattr(deploy_target.network, field, "") or "").strip() for field in _VPC_ID_FIELDS):
+    if any(
+        str(getattr(deploy_target.network, field, "") or "").strip() for field in _VPC_ID_FIELDS
+    ):
         deploy_target.network.enable_vpc_access = True
 
 
@@ -145,7 +156,9 @@ def validate_deploy_target_network(deploy_target: "DeployTarget") -> None:
     values = {
         "vpc_id": str(getattr(deploy_target.network, "vpc_id", "") or "").strip(),
         "subnet_id": str(getattr(deploy_target.network, "subnet_id", "") or "").strip(),
-        "security_group_id": str(getattr(deploy_target.network, "security_group_id", "") or "").strip(),
+        "security_group_id": str(
+            getattr(deploy_target.network, "security_group_id", "") or ""
+        ).strip(),
     }
     has_any_vpc_id = any(values.values())
     if not (bool(getattr(deploy_target.network, "enable_vpc_access", False)) or has_any_vpc_id):
@@ -156,7 +169,8 @@ def validate_deploy_target_network(deploy_target: "DeployTarget") -> None:
             "开启 VPC 访问时必须同时提供 VpcId、SubnetId、SecurityGroupId。",
             details={"missing": missing},
             hints=[
-                "请同时传入 `--vpc-id`、`--subnet-id`、`--security-group-id`，或在配置文件 network/deploy.network 中同时设置这三个字段。",
+                "请同时传入 `--vpc-id`、`--subnet-id`、`--security-group-id`，"
+                "或在配置文件 network/deploy.network 中同时设置这三个字段。",
                 "`--availability-zone` 是可选字段，不替代子网或安全组。",
             ],
         )
@@ -191,8 +205,7 @@ def resolve_deploy_target_network(
         print_info(f"已根据子网 {subnet_id} 自动推断可用区: {availability_zone}")
     else:
         print_warn(
-            "未能根据子网自动推断可用区；如私网 ENI 调度失败，请显式传入 "
-            "`--availability-zone`。"
+            "未能根据子网自动推断可用区；如私网 ENI 调度失败，请显式传入 " "`--availability-zone`。"
         )
 
 
@@ -234,7 +247,9 @@ def _validate_network_payload(payload: Mapping[str, Any]) -> None:
         )
 
 
-def _fill_network_availability_zone(payload: dict[str, Any], network_kwargs: Mapping[str, Any]) -> None:
+def _fill_network_availability_zone(
+    payload: dict[str, Any], network_kwargs: Mapping[str, Any]
+) -> None:
     if str(payload.get("availability_zone") or "").strip():
         return
     if not bool(payload.get("enable_vpc_access")):
@@ -254,8 +269,7 @@ def _fill_network_availability_zone(payload: dict[str, Any], network_kwargs: Map
         print_info(f"已根据子网 {subnet_id} 自动推断可用区: {availability_zone}")
     else:
         print_warn(
-            "未能根据子网自动推断可用区；如私网 ENI 调度失败，请显式传入 "
-            "`--availability-zone`。"
+            "未能根据子网自动推断可用区；如私网 ENI 调度失败，请显式传入 " "`--availability-zone`。"
         )
 
 
@@ -270,7 +284,9 @@ def _resolve_subnet_availability_zone(*, subnet_id: str, region: str) -> str | N
         return None
 
     try:
-        VpcClient, DescribeSubnetsRequest, Credential, ClientProfile, HttpProfile = _import_vpc_sdk()
+        VpcClient, DescribeSubnetsRequest, Credential, ClientProfile, HttpProfile = (
+            _import_vpc_sdk()
+        )
     except Exception as exc:
         print_warn(f"缺少 VPC 子网查询 SDK，跳过可用区自动推断: {exc}")
         return None
@@ -328,8 +344,12 @@ def _resolve_ksyun_credentials() -> tuple[str, str]:
     except Exception:
         global_env = {}
 
-    access_key = access_key or global_env.get("KSYUN_ACCESS_KEY") or global_env.get("KS3_ACCESS_KEY") or ""
-    secret_key = secret_key or global_env.get("KSYUN_SECRET_KEY") or global_env.get("KS3_SECRET_KEY") or ""
+    access_key = (
+        access_key or global_env.get("KSYUN_ACCESS_KEY") or global_env.get("KS3_ACCESS_KEY") or ""
+    )
+    secret_key = (
+        secret_key or global_env.get("KSYUN_SECRET_KEY") or global_env.get("KS3_SECRET_KEY") or ""
+    )
     return str(access_key or "").strip(), str(secret_key or "").strip()
 
 

ksadk/cli/resource_common.py

@@ -2,8 +2,8 @@
 
 from __future__ import annotations
 
-from dataclasses import dataclass, field
 import re
+from dataclasses import dataclass, field
 from typing import Any, Callable, Iterable, Sequence, TypeVar
 
 import click
@@ -181,6 +181,7 @@ def confirm_destructive(
                 details={"prompt": prompt},
             )
         )
+        return False
     if click.confirm(prompt):
         return True
     from ksadk.cli.error_utils import abort_with_cli_error, cancelled_error
@@ -192,6 +193,7 @@ def confirm_destructive(
             details={"prompt": prompt},
         )
     )
+    return False
 
 
 def print_list_summary(*, total: int, page: int, size: int, noun: str) -> None:
@@ -244,7 +246,9 @@ def get_descriptor_resource_key(descriptor: ResourceDescriptor) -> str:
     return descriptor.resource_key or _resource_key(descriptor.name) or "resource"
 
 
-def _legacy_action_descriptors(descriptor: ResourceDescriptor) -> tuple[ResourceActionDescriptor, ...]:
+def _legacy_action_descriptors(
+    descriptor: ResourceDescriptor,
+) -> tuple[ResourceActionDescriptor, ...]:
     action_set = descriptor.actions
     if not isinstance(action_set, ResourceActionSet):
         return tuple(action_set)

ksadk/cli/storage.py

@@ -6,7 +6,6 @@ from typing import Optional
 
 import click
 
-
 DEFAULT_STORAGE_SIZE_GI = 20
 MIN_STORAGE_SIZE_GI = 20
 MAX_STORAGE_SIZE_GI = 500

ksadk/cli/ui.py

@@ -2,12 +2,12 @@
 
 from __future__ import annotations
 
-from contextlib import contextmanager, redirect_stderr, redirect_stdout
-from dataclasses import dataclass
 import io
 import json
 import os
 import sys
+from contextlib import contextmanager, redirect_stderr, redirect_stdout
+from dataclasses import dataclass
 from typing import Iterator
 
 import click
@@ -303,7 +303,9 @@ def no_color_option(*, hidden: bool = False, expose_value: bool = False):
     )
 
 
-def build_no_color_click_option(*, hidden: bool = False, expose_value: bool = False) -> click.Option:
+def build_no_color_click_option(
+    *, hidden: bool = False, expose_value: bool = False
+) -> click.Option:
     """Build a shared no-color option for command injection."""
     return click.Option(
         ["--no-color", "no_color"],