coze-coding-dev-sdk 0.5.18__tar.gz → 0.5.20__tar.gz

{coze_coding_dev_sdk-0.5.18/coze_coding_dev_sdk.egg-info → coze_coding_dev_sdk-0.5.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coze-coding-dev-sdk
-Version: 0.5.18
+Version: 0.5.20
 Summary: Coze Coding Dev SDK - 优雅的多功能 AI SDK，支持图片生成、视频生成、语音合成、语音识别、大语言模型、联网搜索和文本/多模态 Embedding。包含命令行工具 coze-coding-ai，支持 Context 上下文追踪
 Author-email: Coze Coding Integration Team <support@coze.com>
 Maintainer-email: Coze Coding Integration Team <support@coze.com>
@@ -44,8 +44,13 @@ Requires-Dist: click>=8.0.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: supabase==2.27.3
 Requires-Dist: httpx==0.28.1
+Requires-Dist: beautifulsoup4>=4.12.0
 Requires-Dist: markdown>=3.0.0
+Requires-Dist: numpy>=1.26.0
+Requires-Dist: openpyxl>=3.1.0
+Requires-Dist: Pillow>=10.0.0
 Requires-Dist: python-docx>=1.0.0
+Requires-Dist: python-pptx>=1.0.0
 Requires-Dist: reportlab>=4.0.0
 Requires-Dist: cssutils>=2.0.0
 Provides-Extra: dev
@@ -107,7 +112,7 @@ pip install -e ".[dev]"
 #### 必需配置
 
 ```bash
-export COZE_WORKLOAD_IDENTITY_API_KEY="your_api_key"
+export COZE_API_TOKEN="your_user_token"
 export COZE_INTEGRATION_BASE_URL="https://api.coze.com"
 export COZE_INTEGRATION_MODEL_BASE_URL="https://model.coze.com"
 ```

{coze_coding_dev_sdk-0.5.18 → coze_coding_dev_sdk-0.5.20}/README.md

@@ -50,7 +50,7 @@ pip install -e ".[dev]"
 #### 必需配置
 
 ```bash
-export COZE_WORKLOAD_IDENTITY_API_KEY="your_api_key"
+export COZE_API_TOKEN="your_user_token"
 export COZE_INTEGRATION_BASE_URL="https://api.coze.com"
 export COZE_INTEGRATION_MODEL_BASE_URL="https://model.coze.com"
 ```

coze_coding_dev_sdk-0.5.20/coze_coding_dev_sdk/cli/db.py

@@ -0,0 +1,96 @@
+"""
+数据库 CLI 命令
+"""
+
+import os
+
+import click
+from rich.console import Console
+
+# 默认路径
+DEFAULT_MODEL_OUTPUT = "src/storage/database/shared/model.py"
+DEFAULT_MODEL_IMPORT_PATH = "storage.database.shared.model"
+DEFAULT_MODEL_PATH = "src"
+
+console = Console()
+
+
+def _get_workspace_path() -> str:
+    """获取工程根目录：`.env` 的 PROJECT_PATH 优先，其次环境变量 WORKSPACE_PATH。
+
+    两者都读不到即明确报错（不静默退回 cwd，避免把文件写到错误目录）。
+    """
+    from coze_coding_dev_sdk.core.runtime import resolve_workspace_path
+
+    workspace = resolve_workspace_path()
+    if not workspace:
+        console.print(
+            "[red]未能确定工程根目录：请在当前目录 .env 中设置 PROJECT_PATH"
+            "（或由运行时注入 WORKSPACE_PATH）。[/red]"
+        )
+        raise SystemExit(1)
+    return workspace
+
+
+@click.group()
+def db():
+    """Database management commands."""
+    pass
+
+
+@db.command()
+@click.argument("output_path", required=False, default=None)
+@click.option("--verbose", "-v", is_flag=True, help="Verbose output")
+def generate_models(output_path: str, verbose: bool):
+    """
+    Generate ORM models from database.
+
+    OUTPUT_PATH: Path to output model file (default: src/storage/database/shared/model.py)
+    """
+    from coze_coding_dev_sdk.database import generate_models as _generate_models
+
+    if output_path is None:
+        workspace = _get_workspace_path()
+        output_path = os.path.join(workspace, DEFAULT_MODEL_OUTPUT)
+
+    try:
+        _generate_models(output_path, verbose=verbose)
+        click.echo(f"Models generated at {output_path}")
+    except Exception as e:
+        click.echo(f"Error: {e}", err=True)
+        raise SystemExit(1)
+
+@db.command()
+@click.option(
+    "--model-import-path",
+    default=DEFAULT_MODEL_IMPORT_PATH,
+    help=f"Model import path (default: {DEFAULT_MODEL_IMPORT_PATH})",
+)
+@click.option(
+    "--model-path",
+    default=None,
+    help=f"Path to add to sys.path for model import (default: $WORKSPACE_PATH/{DEFAULT_MODEL_PATH})",
+)
+@click.option("--verbose", "-v", is_flag=True, help="Verbose output")
+def upgrade(model_import_path: str, model_path: str, verbose: bool):
+    """
+    Run database migrations.
+
+    Automatically generates migration and upgrades to head.
+    """
+    from coze_coding_dev_sdk.database import upgrade as _upgrade
+
+    if model_path is None:
+        workspace = _get_workspace_path()
+        model_path = os.path.join(workspace, DEFAULT_MODEL_PATH)
+
+    try:
+        _upgrade(
+            model_import_path=model_import_path,
+            model_path=model_path,
+            verbose=verbose,
+        )
+        click.echo("Database upgraded successfully")
+    except Exception as e:
+        click.echo(f"Error: {e}", err=True)
+        raise SystemExit(1)

coze_coding_dev_sdk-0.5.20/coze_coding_dev_sdk/cli/supabase.py

@@ -0,0 +1,139 @@
+"""Supabase Edge Function and Auth CLI; Storage CRUD uses the dedicated S3 command."""
+
+import json
+from typing import Optional
+
+import click
+from rich.console import Console
+
+from ..core.config import Config
+from ..supabase import SupabaseClient
+from .utils import parse_headers
+
+console = Console()
+
+
+@click.group()
+def supabase():
+    """Supabase Edge Functions 与 Auth 配置管理命令。"""
+
+
+@supabase.group("functions")
+def functions():
+    """Edge Functions 管理命令。"""
+
+
+@functions.command("list")
+@click.option("--header", "-H", multiple=True, help="自定义 HTTP 请求头")
+def functions_list(header: tuple):
+    """列出 Edge Functions。"""
+    response = SupabaseClient(Config(), custom_headers=parse_headers(header) or {}).list_functions()
+    if response.code != 0:
+        raise click.ClickException(response.msg)
+    console.print_json(json.dumps([item.__dict__ for item in response.functions], ensure_ascii=False))
+
+
+@functions.command("get")
+@click.argument("slug")
+@click.option("--header", "-H", multiple=True, help="自定义 HTTP 请求头")
+def functions_get(slug: str, header: tuple):
+    """获取 Edge Function 详情和源码。"""
+    response = SupabaseClient(Config(), custom_headers=parse_headers(header) or {}).get_function(slug)
+    if response.code != 0:
+        raise click.ClickException(response.msg)
+    console.print_json(json.dumps({"function": response.function.__dict__ if response.function else None, "files": [item.__dict__ for item in response.files]}, ensure_ascii=False))
+
+
+@functions.command("deploy")
+@click.argument("slug")
+@click.option("--code", help="单文件函数源码")
+@click.option("--file", "files", multiple=True, nargs=2, help="多文件函数的名称和内容对，可重复传入")
+@click.option("--name")
+@click.option("--entrypoint")
+@click.option("--verify-jwt/--no-verify-jwt", default=None)
+@click.option("--header", "-H", multiple=True, help="自定义 HTTP 请求头")
+def functions_deploy(slug: str, code: Optional[str], files: tuple, name: Optional[str], entrypoint: Optional[str], verify_jwt: Optional[bool], header: tuple):
+    """部署或更新 Edge Function。"""
+    if not code and not files:
+        raise click.UsageError("必须提供 --code 或 --file")
+    options = {"code": code, "files": [{"name": item[0], "content": item[1]} for item in files] or None, "name": name, "entrypoint": entrypoint, "verify_jwt": verify_jwt}
+    response = SupabaseClient(Config(), custom_headers=parse_headers(header) or {}).deploy_function(slug, **{key: value for key, value in options.items() if value is not None})
+    if response.code != 0 or not response.success:
+        raise click.ClickException(response.msg or "Edge Function deployment failed")
+    console.print_json(json.dumps(response.__dict__, ensure_ascii=False))
+
+
+@functions.command("delete")
+@click.argument("slug")
+@click.option("--header", "-H", multiple=True, help="自定义 HTTP 请求头")
+def functions_delete(slug: str, header: tuple):
+    """删除 Edge Function。"""
+    response = SupabaseClient(Config(), custom_headers=parse_headers(header) or {}).delete_function(slug)
+    if response.code != 0 or not response.success:
+        raise click.ClickException(response.msg or "Edge Function deletion failed")
+    console.print_json(json.dumps(response.__dict__, ensure_ascii=False))
+
+
+@supabase.group("auth")
+def auth():
+    """Auth（认证配置）管理命令。"""
+
+
+@auth.command("get-config-v2")
+@click.option("--mock", is_flag=True, help="使用 mock 模式（测试运行，不会真正执行操作）")
+@click.option("--header", "-H", multiple=True, help="自定义 HTTP 请求头")
+def auth_get_config(mock: bool, header: tuple):
+    """获取 Auth 认证配置。"""
+    if mock:
+        console.print_json(json.dumps({"config": {}, "mock": True}))
+        return
+    response = SupabaseClient(Config(), custom_headers=parse_headers(header) or {}).get_auth_config_v2()
+    if response.code != 0 or response.status != 3:
+        raise click.ClickException(response.msg or f"Auth status={response.status}")
+    config = response.config
+    console.print_json(json.dumps({"status": response.status, "config": {
+        "project_id": config.project_id,
+        "icon_url": config.icon_url,
+        "name": config.name,
+        "email_config": config.email_config.__dict__ if config.email_config else None,
+        "phone_config": config.phone_config.__dict__ if config.phone_config else None,
+    }} if config else None, ensure_ascii=False))
+
+
+@auth.command("update-config-v2")
+@click.option("--name")
+@click.option("--site-url")
+@click.option("--disable-signup/--enable-signup", default=None)
+@click.option("--external-email-enabled/--external-email-disabled", default=None)
+@click.option("--external-phone-enabled/--external-phone-disabled", default=None)
+@click.option("--mock", is_flag=True, help="使用 mock 模式（测试运行，不会真正执行操作）")
+@click.option("--header", "-H", multiple=True, help="自定义 HTTP 请求头")
+def auth_update_config(
+    name: Optional[str], site_url: Optional[str], disable_signup: Optional[bool],
+    external_email_enabled: Optional[bool], external_phone_enabled: Optional[bool],
+    mock: bool, header: tuple,
+):
+    """更新 Auth 认证配置（V2）。"""
+    payload = {}
+    if name is not None:
+        payload["app_name"] = name
+    email_config = {}
+    if site_url is not None:
+        email_config["site_url"] = site_url
+    if disable_signup is not None:
+        email_config["disable_signup"] = disable_signup
+    if external_email_enabled is not None:
+        email_config["external_email_enabled"] = external_email_enabled
+    if email_config:
+        payload["email_config"] = email_config
+    if external_phone_enabled is not None:
+        payload["phone_config"] = {"external_phone_enabled": external_phone_enabled}
+    if not payload:
+        raise click.UsageError("至少需要提供一个配置项")
+    if mock:
+        console.print_json(json.dumps({"success": True, "should_update_ui": False, "mock": True}))
+        return
+    response = SupabaseClient(Config(), custom_headers=parse_headers(header) or {}).update_auth_config_v2(payload)
+    if response.code != 0:
+        raise click.ClickException(response.msg)
+    console.print_json(json.dumps({"success": response.success, "should_update_ui": response.should_update_ui}))

{coze_coding_dev_sdk-0.5.18 → coze_coding_dev_sdk-0.5.20}/coze_coding_dev_sdk/core/__init__.py

@@ -1,5 +1,11 @@
 from .client import BaseClient
 from .config import Config
+from .endpoints import (
+    IDE_API_BASE_URL,
+    INTEGRATION_BASE_URL,
+    INTEGRATION_MODEL_BASE_URL,
+    S3_PROXY_ENDPOINT_URL,
+)
 from .exceptions import (
     CozeSDKError,
     ConfigurationError,
@@ -8,6 +14,7 @@ from .exceptions import (
     ValidationError
 )
 from .url_utils import validate_url, URLValidationError
+from .runtime import runtime_platform
 
 try:
     from .. import __version__
@@ -17,10 +24,15 @@ except ImportError:
 __all__ = [
     "BaseClient",
     "Config",
+    "INTEGRATION_BASE_URL",
+    "INTEGRATION_MODEL_BASE_URL",
+    "IDE_API_BASE_URL",
+    "S3_PROXY_ENDPOINT_URL",
     "CozeSDKError",
     "ConfigurationError",
     "APIError",
     "NetworkError",
     "ValidationError",
+    "runtime_platform",
     "__version__",
 ]

{coze_coding_dev_sdk-0.5.18 → coze_coding_dev_sdk-0.5.20}/coze_coding_dev_sdk/core/client.py

@@ -14,6 +14,17 @@ from .exceptions import APIError, NetworkError
 console = Console()
 
 
+def sanitize_payload_for_log(value):
+    if isinstance(value, dict):
+        return {
+            key: "[REDACTED]" if key.lower() in {"smtp_pass", "password", "secret"} else sanitize_payload_for_log(item)
+            for key, item in value.items()
+        }
+    if isinstance(value, list):
+        return [sanitize_payload_for_log(item) for item in value]
+    return value
+
+
 class BaseClient:
     def __init__(
         self,
@@ -41,8 +52,9 @@ class BaseClient:
         if self.custom_headers:
             request_headers.update(self.custom_headers)
 
-        config_headers = self.config.get_headers(headers)
-        request_headers.update(config_headers)
+        if headers:
+            request_headers.update(headers)
+        request_headers = self.config.get_headers(request_headers)
 
         response = self._make_request(
             method=method, url=url, headers=request_headers, **kwargs
@@ -61,8 +73,9 @@ class BaseClient:
         if self.custom_headers:
             request_headers.update(self.custom_headers)
 
-        config_headers = self.config.get_headers(headers)
-        request_headers.update(config_headers)
+        if headers:
+            request_headers.update(headers)
+        request_headers = self.config.get_headers(request_headers)
 
         response = self._make_request(
             method=method, url=url, headers=request_headers, **kwargs
@@ -81,8 +94,9 @@ class BaseClient:
         if self.custom_headers:
             request_headers.update(self.custom_headers)
 
-        config_headers = self.config.get_headers(headers)
-        request_headers.update(config_headers)
+        if headers:
+            request_headers.update(headers)
+        request_headers = self.config.get_headers(request_headers)
 
         kwargs["stream"] = True
         return self._make_request(
@@ -91,14 +105,14 @@ class BaseClient:
 
     def _sanitize_headers(self, headers: Dict[str, str]) -> Dict[str, str]:
         sanitized = headers.copy()
-        if "Authorization" in sanitized:
-            token = sanitized["Authorization"]
-            if token.startswith("Bearer "):
-                token = token[7:]
-                if len(token) > 16:
-                    sanitized["Authorization"] = f"Bearer {token[:8]}...{token[-4:]}"
-                else:
-                    sanitized["Authorization"] = "Bearer ****"
+        for key in list(sanitized):
+            if key.lower() not in {"authorization", "x-coze-token", "x-storage-token"}:
+                continue
+            token = str(sanitized[key])
+            if key.lower() == "authorization" and token.startswith("Bearer "):
+                sanitized[key] = "Bearer ****"
+            else:
+                sanitized[key] = "****"
         return sanitized
 
     def _log_request(self, method: str, url: str, **kwargs):
@@ -119,7 +133,7 @@ class BaseClient:
         if "json" in kwargs and kwargs["json"]:
             parts.append("[bold]Body:[/bold]")
             try:
-                json_str = json.dumps(kwargs["json"], ensure_ascii=False, indent=2)
+                json_str = json.dumps(sanitize_payload_for_log(kwargs["json"]), ensure_ascii=False, indent=2)
                 parts.append("")
             except Exception:
                 json_str = str(kwargs["json"])
@@ -136,7 +150,7 @@ class BaseClient:
 
         if "json" in kwargs and kwargs["json"]:
             try:
-                json_str = json.dumps(kwargs["json"], ensure_ascii=False, indent=2)
+                json_str = json.dumps(sanitize_payload_for_log(kwargs["json"]), ensure_ascii=False, indent=2)
                 console.print(
                     Syntax(json_str, "json", theme="monokai", line_numbers=False)
                 )
@@ -184,16 +198,10 @@ class BaseClient:
         )
 
         try:
-            response_data = response.json()
-            json_str = json.dumps(response_data, ensure_ascii=False, indent=2)
-            if len(json_str) > 2000:
-                json_str = json_str[:2000] + "\n... (truncated)"
-            console.print(Syntax(json_str, "json", theme="monokai", line_numbers=False))
+            response.json()
+            console.print("  [response body redacted]")
         except Exception:
-            body_text = response.text[:500]
-            if len(response.text) > 500:
-                body_text += "... (truncated)"
-            console.print(f"  {body_text}")
+            console.print("  [non-JSON response body redacted]")
 
         console.print()
 
@@ -226,10 +234,10 @@ class BaseClient:
     def _handle_response(self, response: requests.Response) -> dict:
         try:
             data = response.json()
-        except Exception as e:
+        except Exception:
             logid = response.headers.get("X-Tt-Logid")
             raise APIError(
-                f"响应解析失败: {str(e)}, logid: {logid}, 响应内容: {response.text[:200]}",
+                f"响应解析失败: status={response.status_code}, logid: {logid}",
                 status_code=response.status_code,
             )
 
@@ -237,11 +245,9 @@ class BaseClient:
             response.raise_for_status()
         except requests.exceptions.HTTPError as e:
             logid = response.headers.get("X-Tt-Logid")
-            error_msg = f"HTTP 错误: {str(e)}, logid: {logid}"
-            if data:
-                error_msg += f", 响应数据: {data}"
+            error_msg = f"HTTP 错误: status={response.status_code}, logid: {logid}"
             raise APIError(
-                error_msg, status_code=response.status_code, response_data=data
+                error_msg, status_code=response.status_code
             )
 
         return data

coze_coding_dev_sdk-0.5.20/coze_coding_dev_sdk/core/config.py

@@ -0,0 +1,97 @@
+import os
+from typing import Optional
+
+from . import runtime
+from .desktop_credential import desktop_pat_token
+from .endpoints import INTEGRATION_BASE_URL, INTEGRATION_MODEL_BASE_URL
+from .exceptions import ConfigurationError
+
+class Config:
+    DEFAULT_RETRY_TIMES = 1
+    DEFAULT_RETRY_DELAY = 1.0
+    DEFAULT_TIMEOUT = 900
+
+    def __init__(
+        self,
+        api_key: Optional[str] = None,
+        base_url: Optional[str] = None,
+        base_model_url: Optional[str] = None,
+        retry_times: int = DEFAULT_RETRY_TIMES,
+        retry_delay: float = DEFAULT_RETRY_DELAY,
+        timeout: int = DEFAULT_TIMEOUT,
+    ):
+        # 确保「当前目录 .env 优先、环境变量兜底」的加载已完成，再读取任何配置。
+        runtime.ensure_env_loaded()
+
+        project_runtime_auth = runtime.uses_project_runtime_auth()
+        project_id_from_runtime = runtime.get_project_id()
+        api_token = runtime.get_api_token()
+        desktop_token = desktop_pat_token()
+
+        self._explicit_api_key = api_key is not None
+        self.api_key = desktop_token or (
+            api_token if project_runtime_auth else api_key or api_token or runtime.get_legacy_workload_token()
+        )
+        self._uses_user_access_token = project_runtime_auth and bool(desktop_token or api_token)
+
+        # 本地/云端由运行环境决定，不根据 token 来源猜测：COZE_DEVBOX_ENV
+        # 非空表示云端 Devbox，空或未设置表示本地。
+        self.runtime_platform = runtime.runtime_platform()
+        self.base_url = (
+            base_url or os.getenv("COZE_INTEGRATION_BASE_URL") or INTEGRATION_BASE_URL
+        )
+        self.base_model_url = base_model_url or os.getenv(
+            "COZE_INTEGRATION_MODEL_BASE_URL"
+        ) or INTEGRATION_MODEL_BASE_URL
+        # 项目 scope 只能来自项目根目录 .coze，不能由环境变量或调用参数覆盖。
+        self.project_id = str(project_id_from_runtime) if project_id_from_runtime else None
+        self.app_id = runtime.get_app_id() if project_runtime_auth else None
+
+        self.retry_times = retry_times
+        self.retry_delay = retry_delay
+        self.timeout = timeout
+
+        self._validate()
+
+    def _validate(self):
+        if not self.api_key:
+            raise ConfigurationError(
+                "API Key 未配置：请设置 COZE_API_TOKEN 或提供 api_key"
+            )
+
+    def get_headers(self, ctx_headers: Optional[dict] = None) -> dict:
+        try:
+            from .. import __version__
+        except ImportError:
+            __version__ = "0.0.0"
+
+        headers = {}
+        if ctx_headers:
+            headers.update(ctx_headers)
+        for key, value in runtime.ppe_headers().items():
+            if not any(existing_key.lower() == key.lower() for existing_key in headers):
+                headers[key] = value
+        headers.setdefault("Content-Type", "application/json")
+        if self._uses_user_access_token:
+            headers["Authorization"] = f"Bearer {self.api_key}"
+        else:
+            headers.setdefault("Authorization", f"Bearer {self.api_key}")
+        headers.setdefault("X-Client-Sdk", f"coze-coding-dev-sdk-python/{__version__}")
+        if runtime.project_resource_env() != runtime.PROJECT_ENV_PROD:
+            for key in list(headers):
+                if key.lower() == runtime.APP_ID_HEADER.lower():
+                    del headers[key]
+        if self.uses_user_runtime_auth():
+            for key in list(headers):
+                if key.lower() == runtime.APP_ID_HEADER.lower():
+                    del headers[key]
+                if key.lower() == runtime.PROJECT_ID_HEADER.lower():
+                    del headers[key]
+            headers.update(runtime.request_headers())
+        return headers
+
+    def uses_user_runtime_auth(self) -> bool:
+        return (
+            runtime.uses_project_runtime_auth()
+            and self._uses_user_access_token
+        )

coze_coding_dev_sdk-0.5.20/coze_coding_dev_sdk/core/desktop_credential.py

@@ -0,0 +1,37 @@
+"""Developer credential published by the Coze Desktop runtime files."""
+
+import json
+import time
+from pathlib import Path
+from typing import Optional
+
+# Coze Desktop writes the beta lane first; either file may be absent or omit
+# patToken entirely, so both are optional candidates.
+RUNTIME_FILES = ("runtime.beta.json", "runtime.json")
+
+
+def _read_pat_token(path: Path) -> Optional[str]:
+    try:
+        payload = json.loads(path.read_text(encoding="utf-8"))
+    except (OSError, ValueError):
+        return None
+    pat_token = payload.get("patToken") if isinstance(payload, dict) else None
+    if not isinstance(pat_token, dict):
+        return None
+    access_token = pat_token.get("accessToken")
+    if not isinstance(access_token, str) or not access_token.strip():
+        return None
+    expires_in = pat_token.get("expiresIn")
+    # expiresIn is an absolute Unix second rather than a duration. A non-numeric
+    # value carries no expiry information, so the token stays usable.
+    if isinstance(expires_in, (int, float)) and expires_in <= time.time():
+        return None
+    return access_token.strip()
+
+
+def desktop_pat_token() -> Optional[str]:
+    for name in RUNTIME_FILES:
+        token = _read_pat_token(Path.home() / ".coze" / "desktop" / name)
+        if token:
+            return token
+    return None

coze_coding_dev_sdk-0.5.20/coze_coding_dev_sdk/core/developer_credential.py

@@ -0,0 +1,46 @@
+import json
+from pathlib import Path
+from typing import Callable, Optional
+
+from .desktop_credential import desktop_pat_token
+from .exceptions import ConfigurationError
+from .runtime import get_api_token, uses_project_runtime_auth
+
+_provider: Optional[Callable[[], str]] = None
+
+
+def set_developer_credential_provider(provider: Optional[Callable[[], str]]) -> None:
+    global _provider
+    _provider = provider
+
+
+def resolve_developer_credential() -> str:
+    desktop_token = desktop_pat_token()
+    if desktop_token:
+        return desktop_token
+    if uses_project_runtime_auth():
+        api_token = (get_api_token() or "").strip()
+        if api_token:
+            return api_token
+        raise ConfigurationError("项目必须设置 COZE_API_TOKEN")
+    if _provider:
+        value = (_provider() or "").strip()
+        if value:
+            return value
+    api_token = (get_api_token() or "").strip()
+    if api_token:
+        return api_token
+    bridge = Path.home() / ".coze" / "bridge" / "pat-token"
+    if bridge.exists():
+        value = bridge.read_text(encoding="utf-8").strip()
+        if value:
+            return value
+    config = Path.home() / ".coze" / "cli" / "config.json"
+    if config.exists():
+        try:
+            value = str(json.loads(config.read_text(encoding="utf-8")).get("accessToken") or "").strip()
+        except (OSError, ValueError, TypeError):
+            value = ""
+        if value:
+            return value
+    raise ConfigurationError("开发者凭证不可用，请先登录 Coze CLI")

coze_coding_dev_sdk-0.5.20/coze_coding_dev_sdk/core/endpoints.py

@@ -0,0 +1,8 @@
+"""Public online endpoint defaults for the Coze Coding Integration SDK."""
+
+INTEGRATION_BASE_URL = "https://integration.coze.cn"
+INTEGRATION_MODEL_BASE_URL = f"{INTEGRATION_BASE_URL}/api/v3"
+# Integration control-plane APIs share the public Integration gateway. The
+# API path is part of each endpoint declaration, so this base has no suffix.
+IDE_API_BASE_URL = INTEGRATION_BASE_URL
+S3_PROXY_ENDPOINT_URL = f"{INTEGRATION_BASE_URL}/coze-coding-s3proxy/v1"