PyPI - illusion-code - Versions diffs - 0.1.0__py3-none-any.whl - Mend

illusion-code 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (214) hide show

illusion/__init__.py +24 -0
illusion/__main__.py +15 -0
illusion/_frontend/dist/index.mjs +39208 -0
illusion/_frontend/package.json +27 -0
illusion/_frontend/src/App.tsx +624 -0
illusion/_frontend/src/components/CommandPicker.tsx +98 -0
illusion/_frontend/src/components/Composer.tsx +55 -0
illusion/_frontend/src/components/ComposerController.tsx +128 -0
illusion/_frontend/src/components/ConversationView.tsx +750 -0
illusion/_frontend/src/components/Footer.tsx +25 -0
illusion/_frontend/src/components/MarkdownContent.tsx +537 -0
illusion/_frontend/src/components/MarkdownTable.tsx +245 -0
illusion/_frontend/src/components/ModalHost.tsx +425 -0
illusion/_frontend/src/components/MultilineTextInput.tsx +250 -0
illusion/_frontend/src/components/PromptInput.tsx +64 -0
illusion/_frontend/src/components/SelectModal.tsx +78 -0
illusion/_frontend/src/components/SidePanel.tsx +175 -0
illusion/_frontend/src/components/Spinner.tsx +77 -0
illusion/_frontend/src/components/StatusBar.tsx +142 -0
illusion/_frontend/src/components/SwarmPanel.tsx +141 -0
illusion/_frontend/src/components/TodoPanel.tsx +126 -0
illusion/_frontend/src/components/ToolCallDisplay.tsx +202 -0
illusion/_frontend/src/components/TranscriptPane.tsx +79 -0
illusion/_frontend/src/components/WelcomeBanner.tsx +37 -0
illusion/_frontend/src/hooks/useBackendSession.ts +468 -0
illusion/_frontend/src/hooks/useTerminalSize.ts +9 -0
illusion/_frontend/src/i18n.ts +78 -0
illusion/_frontend/src/index.tsx +42 -0
illusion/_frontend/src/theme/ThemeContext.tsx +19 -0
illusion/_frontend/src/theme/builtinThemes.ts +89 -0
illusion/_frontend/src/types.ts +110 -0
illusion/_frontend/src/utils/markdown.ts +33 -0
illusion/_frontend/src/utils/thinking.ts +191 -0
illusion/_frontend/tsconfig.json +13 -0
illusion/_web_dist/assets/index-BseIw-ik.css +10 -0
illusion/_web_dist/assets/index-C_0ZWMuW.js +82 -0
illusion/_web_dist/index.html +16 -0
illusion/api/__init__.py +36 -0
illusion/api/client.py +568 -0
illusion/api/codex_client.py +563 -0
illusion/api/compat.py +138 -0
illusion/api/effort.py +128 -0
illusion/api/errors.py +57 -0
illusion/api/openai_client.py +819 -0
illusion/api/provider.py +148 -0
illusion/api/registry.py +479 -0
illusion/api/usage.py +45 -0
illusion/auth/__init__.py +50 -0
illusion/auth/copilot.py +419 -0
illusion/auth/external.py +612 -0
illusion/auth/flows.py +58 -0
illusion/auth/manager.py +214 -0
illusion/auth/storage.py +372 -0
illusion/bridge/__init__.py +38 -0
illusion/bridge/manager.py +190 -0
illusion/bridge/session_runner.py +84 -0
illusion/bridge/types.py +113 -0
illusion/bridge/work_secret.py +131 -0
illusion/cli.py +1228 -0
illusion/commands/__init__.py +32 -0
illusion/commands/registry.py +1934 -0
illusion/config/__init__.py +39 -0
illusion/config/i18n.py +522 -0
illusion/config/paths.py +259 -0
illusion/config/settings.py +564 -0
illusion/coordinator/__init__.py +41 -0
illusion/coordinator/agent_definitions.py +1093 -0
illusion/coordinator/coordinator_mode.py +127 -0
illusion/engine/__init__.py +95 -0
illusion/engine/cost_tracker.py +55 -0
illusion/engine/messages.py +369 -0
illusion/engine/query.py +632 -0
illusion/engine/query_engine.py +343 -0
illusion/engine/stream_events.py +169 -0
illusion/hooks/__init__.py +67 -0
illusion/hooks/events.py +43 -0
illusion/hooks/executor.py +397 -0
illusion/hooks/hot_reload.py +74 -0
illusion/hooks/loader.py +133 -0
illusion/hooks/schemas.py +121 -0
illusion/hooks/types.py +86 -0
illusion/mcp/__init__.py +104 -0
illusion/mcp/client.py +377 -0
illusion/mcp/config.py +140 -0
illusion/mcp/types.py +175 -0
illusion/memory/__init__.py +36 -0
illusion/memory/manager.py +94 -0
illusion/memory/memdir.py +58 -0
illusion/memory/paths.py +57 -0
illusion/memory/scan.py +120 -0
illusion/memory/search.py +83 -0
illusion/memory/types.py +43 -0
illusion/output_styles/__init__.py +15 -0
illusion/output_styles/loader.py +64 -0
illusion/permissions/__init__.py +39 -0
illusion/permissions/checker.py +174 -0
illusion/permissions/modes.py +38 -0
illusion/platforms.py +148 -0
illusion/plugins/__init__.py +71 -0
illusion/plugins/bundled/__init__.py +0 -0
illusion/plugins/installer.py +59 -0
illusion/plugins/loader.py +301 -0
illusion/plugins/schemas.py +51 -0
illusion/plugins/types.py +56 -0
illusion/prompts/__init__.py +29 -0
illusion/prompts/claudemd.py +74 -0
illusion/prompts/context.py +187 -0
illusion/prompts/environment.py +189 -0
illusion/prompts/system_prompt.py +155 -0
illusion/py.typed +0 -0
illusion/sandbox/__init__.py +29 -0
illusion/sandbox/adapter.py +174 -0
illusion/services/__init__.py +59 -0
illusion/services/compact/__init__.py +1015 -0
illusion/services/cron.py +338 -0
illusion/services/cron_scheduler.py +715 -0
illusion/services/file_history.py +258 -0
illusion/services/lsp/__init__.py +455 -0
illusion/services/session_storage.py +237 -0
illusion/services/token_estimation.py +72 -0
illusion/skills/__init__.py +60 -0
illusion/skills/bundled/__init__.py +110 -0
illusion/skills/bundled/content/batch.md +86 -0
illusion/skills/bundled/content/coding-guidelines.md +70 -0
illusion/skills/bundled/content/debug.md +38 -0
illusion/skills/bundled/content/loop.md +82 -0
illusion/skills/bundled/content/remember.md +105 -0
illusion/skills/bundled/content/simplify.md +53 -0
illusion/skills/bundled/content/skillify.md +113 -0
illusion/skills/bundled/content/stuck.md +54 -0
illusion/skills/bundled/content/update-config.md +329 -0
illusion/skills/bundled/content/verify.md +74 -0
illusion/skills/loader.py +219 -0
illusion/skills/registry.py +40 -0
illusion/skills/types.py +24 -0
illusion/state/__init__.py +18 -0
illusion/state/app_state.py +67 -0
illusion/state/store.py +93 -0
illusion/swarm/__init__.py +71 -0
illusion/swarm/agent_executor.py +857 -0
illusion/swarm/in_process.py +259 -0
illusion/swarm/subprocess_backend.py +136 -0
illusion/swarm/team_helpers.py +123 -0
illusion/swarm/types.py +159 -0
illusion/swarm/worktree.py +347 -0
illusion/tasks/__init__.py +33 -0
illusion/tasks/local_agent_task.py +42 -0
illusion/tasks/local_shell_task.py +27 -0
illusion/tasks/manager.py +377 -0
illusion/tasks/stop_task.py +21 -0
illusion/tasks/types.py +88 -0
illusion/tools/__init__.py +126 -0
illusion/tools/agent_tool.py +388 -0
illusion/tools/ask_user_question_tool.py +186 -0
illusion/tools/base.py +149 -0
illusion/tools/bash_tool.py +413 -0
illusion/tools/config_tool.py +90 -0
illusion/tools/cron_tool.py +473 -0
illusion/tools/enter_plan_mode_tool.py +147 -0
illusion/tools/enter_worktree_tool.py +188 -0
illusion/tools/exit_plan_mode_tool.py +69 -0
illusion/tools/exit_worktree_tool.py +225 -0
illusion/tools/file_edit_tool.py +283 -0
illusion/tools/file_read_tool.py +294 -0
illusion/tools/file_write_tool.py +184 -0
illusion/tools/glob_tool.py +165 -0
illusion/tools/grep_tool.py +190 -0
illusion/tools/list_mcp_resources_tool.py +80 -0
illusion/tools/lsp_tool.py +333 -0
illusion/tools/mcp_auth_tool.py +100 -0
illusion/tools/mcp_tool.py +75 -0
illusion/tools/notebook_edit_tool.py +242 -0
illusion/tools/powershell_tool.py +334 -0
illusion/tools/read_mcp_resource_tool.py +63 -0
illusion/tools/repl_tool.py +100 -0
illusion/tools/send_message_tool.py +112 -0
illusion/tools/shell_common.py +187 -0
illusion/tools/skill_tool.py +86 -0
illusion/tools/sleep_tool.py +62 -0
illusion/tools/structured_output_tool.py +58 -0
illusion/tools/task_create_tool.py +98 -0
illusion/tools/task_get_tool.py +94 -0
illusion/tools/task_list_tool.py +94 -0
illusion/tools/task_output_tool.py +55 -0
illusion/tools/task_stop_tool.py +52 -0
illusion/tools/task_update_tool.py +224 -0
illusion/tools/team_create_tool.py +236 -0
illusion/tools/team_delete_tool.py +104 -0
illusion/tools/todo_write_tool.py +198 -0
illusion/tools/tool_search_tool.py +156 -0
illusion/tools/web_fetch_tool.py +264 -0
illusion/tools/web_search_tool.py +186 -0
illusion/ui/__init__.py +23 -0
illusion/ui/app.py +258 -0
illusion/ui/backend_host.py +1180 -0
illusion/ui/input.py +86 -0
illusion/ui/output.py +363 -0
illusion/ui/permission_dialog.py +47 -0
illusion/ui/permission_store.py +99 -0
illusion/ui/protocol.py +384 -0
illusion/ui/react_launcher.py +280 -0
illusion/ui/runtime.py +787 -0
illusion/ui/textual_app.py +603 -0
illusion/ui/web/__init__.py +10 -0
illusion/ui/web/server.py +87 -0
illusion/ui/web/ws_host.py +1197 -0
illusion/utils/__init__.py +0 -0
illusion/utils/ripgrep.py +299 -0
illusion/utils/shell.py +248 -0
illusion_code-0.1.0.dist-info/METADATA +1159 -0
illusion_code-0.1.0.dist-info/RECORD +214 -0
illusion_code-0.1.0.dist-info/WHEEL +4 -0
illusion_code-0.1.0.dist-info/entry_points.txt +2 -0
illusion_code-0.1.0.dist-info/licenses/LICENSE +21 -0

illusion/_web_dist/index.html ADDED Viewed

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link href="https://fonts.googleapis.com/css2?family=Inter:opsz,wght@14..32,100..900&family=JetBrains+Mono:ital,wght@0,100..800;1,100..800&display=swap" rel="stylesheet" />
+    <title>Illusion Code</title>
+    <script type="module" crossorigin src="/assets/index-C_0ZWMuW.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-BseIw-ik.css">
+  </head>
+  <body class="bg-white">
+    <div id="root"></div>
+  </body>
+</html>

illusion/api/__init__.py ADDED Viewed

@@ -0,0 +1,36 @@
+"""
+API 模块
+========
+本模块提供 IllusionCode 与各种 LLM 提供商的 API 集成。
+主要组件：
+    - AnthropicApiClient: Anthropic API 客户端
+    - OpenAICompatibleClient: OpenAI 兼容 API 客户端
+    - CodexApiClient: OpenAI Codex 客户端
+    - IllusionCodeApiError: API 异常基类
+    - ProviderInfo: 提供商元数据
+    - UsageSnapshot: 使用量追踪
+使用示例：
+    >>> from illusion.api import AnthropicApiClient
+    >>> client = AnthropicApiClient(api_key="sk-...")
+"""
+from illusion.api.client import AnthropicApiClient
+from illusion.api.codex_client import CodexApiClient
+from illusion.api.errors import IllusionCodeApiError
+from illusion.api.openai_client import OpenAICompatibleClient
+from illusion.api.provider import ProviderInfo, auth_status, detect_provider
+from illusion.api.usage import UsageSnapshot
+__all__ = [
+    "AnthropicApiClient",
+    "CodexApiClient",
+    "OpenAICompatibleClient",
+    "IllusionCodeApiError",
+    "ProviderInfo",
+    "UsageSnapshot",
+    "auth_status",
+    "detect_provider",
+]

illusion/api/client.py ADDED Viewed

@@ -0,0 +1,568 @@
+"""
+Anthropic API 客户端模块
+=======================
+本模块提供 Anthropic API 客户端封装，带有重试逻辑。
+主要功能：
+    - 流式文本增量生成
+    - 自动重试 transient 错误
+    - OAuth 支持
+    - 错误转换
+类说明：
+    - AnthropicApiClient: Anthropic 异步 SDK 封装类
+    - ApiMessageRequest: 模型调用输入参数
+    - ApiTextDeltaEvent: 增量文本事件
+    - ApiMessageCompleteEvent: 完整消息事件
+    - ApiRetryEvent: 重试事件
+使用示例：
+    >>> from illusion.api.client import AnthropicApiClient, ApiMessageRequest
+    >>> client = AnthropicApiClient(api_key="sk-...")
+    >>> request = ApiMessageRequest(model="claude-3-sonnet", messages=[])
+    >>> async for event in client.stream_message(request):
+    >>>     print(event)
+"""
+from __future__ import annotations
+import asyncio
+import json
+import logging
+import uuid
+from dataclasses import dataclass, field
+from typing import Any, AsyncIterator, Callable, Protocol
+from anthropic import APIError, APIStatusError, AsyncAnthropic
+from anthropic.types import ThinkingBlock as _SDKThinkingBlock
+# 兼容第三方 API（如 MiMo）返回 "signature": null 的情况
+# anthropic SDK 的 ThinkingBlock 要求 signature 为 str，但部分提供商返回 null
+_sdk_sig_field = _SDKThinkingBlock.model_fields["signature"]
+_sdk_sig_field.annotation = str | None
+_SDKThinkingBlock.model_rebuild()
+from illusion.api.effort import EffortLevel  # noqa: E402
+from illusion.api.errors import (  # noqa: E402
+    AuthenticationFailure,
+    IllusionCodeApiError,
+    RateLimitFailure,
+    RequestFailure,
+)
+from illusion.auth.external import (  # noqa: E402
+    claude_attribution_header,
+    claude_oauth_betas,
+    claude_oauth_headers,
+    get_claude_code_session_id,
+)
+from illusion.api.usage import UsageSnapshot  # noqa: E402
+from illusion.engine.messages import (  # noqa: E402
+    ConversationMessage,
+    _messages_have_media,
+    _strip_media_from_messages,
+    assistant_message_from_api,
+)
+# 模块级日志记录器
+log = logging.getLogger(__name__)
+# 重试配置常量
+MAX_RETRIES = 3  # 最大重试次数
+BASE_DELAY = 1.0  # 基础延迟（秒）
+MAX_DELAY = 30.0  # 最大延迟（秒）
+RETRYABLE_STATUS_CODES = {429, 500, 502, 503, 529}  # 可重试的状态码集合
+OAUTH_BETA_HEADER = "oauth-2025-04-20"  # OAuth beta 版本头
+@dataclass(frozen=True)
+class ApiMessageRequest:
+    """模型调用输入参数
+    包含调用模型所需的所有参数。
+    Attributes:
+        model: 模型名称
+        messages: 对话消息列表
+        system_prompt: 系统提示词（可选）
+        max_tokens: 最大令牌数（默认 4096）
+        tools: 工具定义列表（默认空列表）
+        effort: 推理强度级别（可选，支持 low/medium/high/xhigh/max）
+    """
+    model: str
+    messages: list[ConversationMessage]
+    system_prompt: str | None = None
+    max_tokens: int = 4096
+    tools: list[dict[str, Any]] = field(default_factory=list)
+    effort: EffortLevel | None = None
+@dataclass(frozen=True)
+class ApiTextDeltaEvent:
+    """增量文本事件
+    模型产生的增量文本输出。
+    Attributes:
+        text: 增量文本内容
+        reasoning: 增量思考内容（可选）
+    """
+    text: str
+    reasoning: str | None = None
+@dataclass(frozen=True)
+class ApiMessageCompleteEvent:
+    """完整消息事件
+    包含最终助手消息和完整使用量信息的事件。
+    Attributes:
+        message: 对话消息对象
+        usage: 使用量快照
+        stop_reason: 停止原因
+    """
+    message: ConversationMessage
+    usage: UsageSnapshot
+    stop_reason: str | None = None
+@dataclass(frozen=True)
+class ApiRetryEvent:
+    """重试事件
+    表示可恢复的上游错误，将自动重试。
+    Attributes:
+        message: 错误消息
+        attempt: 当前尝试次数
+        max_attempts: 最大尝试次数
+        delay_seconds: 延迟秒数
+    """
+    message: str
+    attempt: int
+    max_attempts: int
+    delay_seconds: float
+@dataclass(frozen=True)
+class ApiToolCallStartedEvent:
+    """工具调用开始生成事件
+    当模型开始生成工具调用时产生，包含工具名称和调用ID。
+    此事件在模型开始输出工具参数之前发出，使前端能够
+    立即显示工具调用指示器，而不必等待整个工具参数生成完毕。
+    Attributes:
+        tool_name: 工具名称
+        tool_use_id: 工具调用ID（可选）
+    """
+    tool_name: str
+    tool_use_id: str = ""
+# 流事件联合类型
+ApiStreamEvent = ApiTextDeltaEvent | ApiMessageCompleteEvent | ApiRetryEvent | ApiToolCallStartedEvent
+class SupportsStreamingMessages(Protocol):
+    """流式消息协议
+    查询引擎在测试和生产中使用的协议。
+    """
+    async def stream_message(self, request: ApiMessageRequest) -> AsyncIterator[ApiStreamEvent]:
+        """为请求产生流式事件"""
+def _is_media_related_error(exc: Exception) -> bool:
+    """检查错误是否可能由图片内容导致
+    Anthropic API 在不支持图片时可能返回：
+    - 400 invalid_request_error
+    - 404 "No endpoints found that support image input"
+    注意：错误可能已被 _translate_api_error 转为 IllusionCodeApiError，
+    此时 status_code 属性丢失，需从消息字符串中判断。
+    """
+    error_msg = str(exc).lower()
+    status = getattr(exc, "status_code", None)
+    # 从错误消息字符串中提取状态码（适配已翻译的异常）
+    if status is None:
+        for code in (404, 400):
+            if f"error code: {code}" in error_msg:
+                status = code
+                break
+    # 明确的图片不支持错误（404 或 400）
+    if status in {400, 404} and any(
+        kw in error_msg for kw in ("image", "media", "unsupported")
+    ):
+        return True
+    # 某些提供商返回的通用错误
+    if "does not support" in error_msg and "image" in error_msg:
+        return True
+    return False
+def _is_retryable(exc: Exception) -> bool:
+    """检查异常是否可重试
+    Args:
+        exc: 待检查的异常
+    Returns:
+        bool: 是否可重试
+    """
+    # API 状态错误：检查状态码
+    if isinstance(exc, APIStatusError):
+        return exc.status_code in RETRYABLE_STATUS_CODES
+    # API 错误：网络错误可重试
+    if isinstance(exc, APIError):
+        return True
+    # 连接错误可重试
+    if isinstance(exc, (ConnectionError, TimeoutError, OSError)):
+        return True
+    return False
+def _get_retry_delay(attempt: int, exc: Exception | None = None) -> float:
+    """计算指数退避延迟（带抖动）
+    Args:
+        attempt: 当前尝试次数
+        exc: 异常对象（可选）
+    Returns:
+        float: 延迟秒数
+    """
+    import random
+    # 检查 Retry-After 头
+    if isinstance(exc, APIStatusError):
+        retry_after = getattr(exc, "headers", {})
+        if hasattr(retry_after, "get"):
+            val = retry_after.get("retry-after")
+            if val:
+                try:
+                    return min(float(val), MAX_DELAY)
+                except (ValueError, TypeError):
+                    pass
+    # 指数退避计算
+    delay = min(BASE_DELAY * (2 ** attempt), MAX_DELAY)
+    # 添加随机抖动（0-25%）
+    jitter = random.uniform(0, delay * 0.25)
+    return delay + jitter
+class AnthropicApiClient:
+    """Anthropic 异步 SDK 封装类
+    带重试逻辑的 Anthropic API 薄封装。
+    Attributes:
+        _api_key: API 密钥
+        _auth_token: 认证令牌
+        _base_url: 基础 URL
+        _claude_oauth: 是否使用 OAuth
+        _auth_token_resolver: 认证令牌解析器
+        _session_id: 会话 ID
+        _client: AsyncAnthropic 客户端实例
+    """
+    def __init__(
+        self,
+        api_key: str | None = None,
+        *,
+        auth_token: str | None = None,
+        base_url: str | None = None,
+        claude_oauth: bool = False,
+        auth_token_resolver: Callable[[], str] | None = None,
+    ) -> None:
+        self._api_key = api_key
+        self._auth_token = auth_token
+        self._base_url = base_url
+        self._claude_oauth = claude_oauth
+        self._auth_token_resolver = auth_token_resolver
+        self._session_id = get_claude_code_session_id() if claude_oauth else ""
+        self._client = self._create_client()
+    def _create_client(self) -> AsyncAnthropic:
+        """创建 Anthropic 客户端
+        Returns:
+            AsyncAnthropic: 配置好的客户端实例
+        """
+        kwargs: dict[str, Any] = {}
+        if self._api_key:
+            kwargs["api_key"] = self._api_key
+        if self._auth_token:
+            kwargs["auth_token"] = self._auth_token
+            kwargs["default_headers"] = (
+                claude_oauth_headers()
+                if self._claude_oauth
+                else {"anthropic-beta": OAUTH_BETA_HEADER}
+            )
+        if self._base_url:
+            kwargs["base_url"] = self._base_url
+        return AsyncAnthropic(**kwargs)
+    def _refresh_client_auth(self) -> None:
+        """刷新客户端认证
+        如果使用 OAuth 且有令牌解析器，则刷新认证令牌。
+        """
+        if not self._claude_oauth or self._auth_token_resolver is None:
+            return
+        next_token = self._auth_token_resolver()
+        if next_token and next_token != self._auth_token:
+            self._auth_token = next_token
+            self._client = self._create_client()
+    async def stream_message(self, request: ApiMessageRequest) -> AsyncIterator[ApiStreamEvent]:
+        """流式生成文本增量并在 transient 错误时自动重试
+        当消息中包含图片但模型不支持时，自动降级为文本描述并重试。
+        Args:
+            request: API 消息请求
+        Yields:
+            ApiStreamEvent: 流式事件（文本增量或完整消息）
+        """
+        last_error: Exception | None = None
+        media_stripped = False
+        for attempt in range(MAX_RETRIES + 1):
+            try:
+                self._refresh_client_auth()
+                async for event in self._stream_once(request):
+                    yield event
+                return  # 成功
+            except IllusionCodeApiError as exc:
+                # 如果消息包含图片且错误可能是模型不支持图片导致的，尝试降级
+                if (
+                    not media_stripped
+                    and _messages_have_media(request.messages)
+                    and _is_media_related_error(exc)
+                ):
+                    log.warning(
+                        "Request failed, possibly due to unsupported image content. "
+                        "Retrying with text descriptions instead of images.",
+                    )
+                    request = ApiMessageRequest(
+                        model=request.model,
+                        messages=_strip_media_from_messages(request.messages),
+                        system_prompt=request.system_prompt,
+                        tools=request.tools,
+                        max_tokens=request.max_tokens,
+                        effort=request.effort,
+                    )
+                    media_stripped = True
+                    continue
+                raise
+            except Exception as exc:
+                last_error = exc
+                # 如果消息包含图片且错误可能是模型不支持图片导致的，尝试降级
+                if (
+                    not media_stripped
+                    and _messages_have_media(request.messages)
+                    and _is_media_related_error(exc)
+                ):
+                    log.warning(
+                        "Request failed, possibly due to unsupported image content. "
+                        "Retrying with text descriptions instead of images.",
+                    )
+                    request = ApiMessageRequest(
+                        model=request.model,
+                        messages=_strip_media_from_messages(request.messages),
+                        system_prompt=request.system_prompt,
+                        tools=request.tools,
+                        max_tokens=request.max_tokens,
+                        effort=request.effort,
+                    )
+                    media_stripped = True
+                    continue
+                # 超过最大重试次数或不可重试
+                if attempt >= MAX_RETRIES or not _is_retryable(exc):
+                    if isinstance(exc, APIError):
+                        raise _translate_api_error(exc) from exc
+                    raise RequestFailure(str(exc)) from exc
+                # 计算延迟并发送重试事件
+                delay = _get_retry_delay(attempt, exc)
+                status = getattr(exc, "status_code", "?")
+                log.warning(
+                    "API request failed (attempt %d/%d, status=%s), retrying in %.1fs: %s",
+                    attempt + 1, MAX_RETRIES + 1, status, delay, exc,
+                )
+                yield ApiRetryEvent(
+                    message=str(exc),
+                    attempt=attempt + 1,
+                    max_attempts=MAX_RETRIES + 1,
+                    delay_seconds=delay,
+                )
+                await asyncio.sleep(delay)
+        # 最终错误处理
+        if last_error is not None:
+            if isinstance(last_error, APIError):
+                raise _translate_api_error(last_error) from last_error
+            raise RequestFailure(str(last_error)) from last_error
+    async def _stream_once(self, request: ApiMessageRequest) -> AsyncIterator[ApiStreamEvent]:
+        """单次尝试流式消息
+        Args:
+            request: API 消息请求
+        Yields:
+            ApiStreamEvent: 流式事件
+        """
+        # 构建请求参数
+        params: dict[str, Any] = {
+            "model": request.model,
+            "messages": [message.to_api_param(provider_type="anthropic") for message in request.messages],
+            "max_tokens": request.max_tokens,
+        }
+        # 添加系统提示词
+        if request.system_prompt:
+            params["system"] = request.system_prompt
+        # OAuth 认证：添加归属头
+        if self._claude_oauth:
+            attribution = claude_attribution_header()
+            params["system"] = (
+                f"{attribution}\n{params['system']}"
+                if params.get("system")
+                else attribution
+            )
+        # 添加工具定义
+        if request.tools:
+            params["tools"] = request.tools
+        # Anthropic API 不支持 reasoning_effort 参数，effort 通过系统提示词传递
+        # OAuth 附加参数
+        if self._claude_oauth:
+            params["betas"] = claude_oauth_betas()
+            params["metadata"] = {
+                "user_id": json.dumps(
+                    {
+                        "device_id": "illusion",
+                        "session_id": self._session_id,
+                        "account_uuid": "",
+                    },
+                    separators=(",", ":"),
+                )
+            }
+            params["extra_headers"] = {"x-client-request-id": str(uuid.uuid4())}
+        try:
+            # 根据是否使用 OAuth 选择 API 端点
+            stream_api = self._client.beta.messages if self._claude_oauth else self._client.messages
+            async with stream_api.stream(**params) as stream:
+                async for event in stream:
+                    event_type = getattr(event, "type", None)
+                    # 处理工具调用开始事件：模型开始生成工具调用时立即通知
+                    if event_type == "content_block_start":
+                        block = getattr(event, "content_block", None)
+                        if getattr(block, "type", None) == "tool_use":
+                            yield ApiToolCallStartedEvent(
+                                tool_name=getattr(block, "name", ""),
+                                tool_use_id=getattr(block, "id", ""),
+                            )
+                        continue
+                    # 处理文本/思考增量事件
+                    if event_type != "content_block_delta":
+                        continue
+                    delta = getattr(event, "delta", None)
+                    delta_type = getattr(delta, "type", None)
+                    if delta_type == "text_delta":
+                        text = getattr(delta, "text", "")
+                        if text:
+                            yield ApiTextDeltaEvent(text=text)
+                        continue
+                    if delta_type == "thinking_delta":
+                        thinking = getattr(delta, "thinking", "") or getattr(delta, "text", "")
+                        if thinking:
+                            yield ApiTextDeltaEvent(text="", reasoning=thinking)
+                # 获取最终消息
+                final_message = await stream.get_final_message()
+        except APIError as exc:
+            # 检查是否为 effort 不支持错误
+            if _is_effort_unsupported_error(exc) and request.effort is not None:
+                # 直接向用户反馈错误，不进行降级
+                raise RequestFailure(
+                    f"当前模型不支持推理强度 '{request.effort.value}'，请尝试使用其他推理强度级别（如 low/medium/high）"
+                ) from exc
+            # 可重试状态码直接抛出，让重试逻辑处理
+            if isinstance(exc, APIStatusError) and exc.status_code in RETRYABLE_STATUS_CODES:
+                raise
+            raise _translate_api_error(exc) from exc
+        # 提取使用量并发送完成事件
+        usage = getattr(final_message, "usage", None)
+        yield ApiMessageCompleteEvent(
+            message=assistant_message_from_api(final_message),
+            usage=UsageSnapshot(
+                input_tokens=int(getattr(usage, "input_tokens", 0) or 0),
+                output_tokens=int(getattr(usage, "output_tokens", 0) or 0),
+            ),
+            stop_reason=getattr(final_message, "stop_reason", None),
+        )
+def _is_effort_unsupported_error(exc: Exception) -> bool:
+    """检测是否为 effort 字段不支持导致的错误
+    Args:
+        exc: 异常对象
+    Returns:
+        bool: 是否为 effort 不支持错误
+    """
+    error_msg = str(exc).lower()
+    # 检测常见的 effort 不支持错误消息
+    effort_keywords = ["effort", "reasoning_effort", "reasoning effort"]
+    unsupported_keywords = ["not supported", "unsupported", "invalid", "unknown"]
+    # 检查是否包含 effort 相关关键词
+    has_effort_keyword = any(keyword in error_msg for keyword in effort_keywords)
+    # 检查是否包含不支持相关关键词
+    has_unsupported_keyword = any(keyword in error_msg for keyword in unsupported_keywords)
+    # 检查特定的错误模式：unknown variant `max`/`xhigh` 等
+    has_variant_error = "unknown variant" in error_msg and any(
+        level in error_msg for level in ["max", "xhigh", "low", "medium", "high"]
+    )
+    return (has_effort_keyword and has_unsupported_keyword) or has_variant_error
+def _translate_api_error(exc: APIError) -> IllusionCodeApiError:
+    """转换 API 错误为统一异常类型
+    Args:
+        exc: Anthropic API 错误
+    Returns:
+        IllusionCodeApiError: 统一异常类型
+    """
+    name = exc.__class__.__name__
+    # 认证错误
+    if name in {"AuthenticationError", "PermissionDeniedError"}:
+        return AuthenticationFailure(str(exc))
+    # 速率限制错误
+    if name == "RateLimitError":
+        return RateLimitFailure(str(exc))
+    # 请求失败
+    return RequestFailure(str(exc))