[changes] dashscope applies patches and modifies prompts

api/app/plugins/dashscope_patch.py

@@ -0,0 +1,73 @@
+"""
+DashScope SDK 补丁：修复 __getattr__ 违反 Python 属性访问协议的 bug。
+
+背景
+----
+DashScope SDK 的 DictMixin（所有响应类的基类）的 __getattr__ 实现为：
+
+    def __getattr__(self, attr):
+        return self[attr]
+
+当属性/键不存在时，它抛出 KeyError。但按照 Python 数据模型规范，
+__getattr__ 应当抛出 AttributeError，否则 hasattr()/getattr(obj, name, default)
+等内置函数会失效。
+
+实际影响
+--------
+requests 库在构造 HTTPError 时会调用 hasattr(response, "request")
+（见 requests/exceptions.py:22），当 DashScope 响应对象参与异常链路时，
+hasattr 会因 KeyError 直接崩溃，掩盖了真正的 HTTP 错误（如 429 限流、超时）。
+
+此时抛出的异常表现为 KeyError('request')，极具误导性，并导致项目内已有的
+429 自动重试逻辑无法捕获真正的限流错误。
+
+参考
+----
+DashScope SDK 官方 Issue #114：
+https://github.com/dashscope/dashscope-sdk-python/issues/114
+
+修复
+----
+对 DictMixin.__getattr__ 进行 monkey-patch，将 KeyError 转换为 AttributeError，
+使其符合 Python 语义。补丁应用于基类，因此所有派生响应类型（DashScopeAPIResponse、
+GenerationResponse、MultiModalConversationResponse 等）都能一次性受益。
+
+使用方式
+--------
+在应用入口（main.py / celery_worker.py）的最顶部导入本模块，
+在任何 DashScope 调用发生前完成补丁注入：
+
+    import app.plugins.dashscope_patch  # noqa: F401
+"""
+
+import logging
+
+logger = logging.getLogger(__name__)
+
+try:
+    from dashscope.api_entities.dashscope_response import DictMixin
+
+    # 防止被重复应用（例如 main 和 celery worker 都导入时）
+    if not getattr(DictMixin, "_redbear_getattr_patched", False):
+        _orig_getattr = DictMixin.__getattr__
+
+        def _safe_getattr(self, attr):
+            """符合 Python 语义的 __getattr__：键缺失抛 AttributeError 而非 KeyError。"""
+            try:
+                return _orig_getattr(self, attr)
+            except KeyError as e:
+                # 使用 `from None` 抑制 KeyError 链，避免异常信息里出现误导性的
+                # "During handling of the above exception..." 堆栈
+                raise AttributeError(attr) from None
+
+        DictMixin.__getattr__ = _safe_getattr
+        DictMixin._redbear_getattr_patched = True  # type: ignore[attr-defined]
+        logger.info(
+            "DashScope SDK 补丁已生效：DictMixin.__getattr__ 在缺失键时抛 AttributeError"
+        )
+except ImportError:
+    # DashScope SDK 未安装时跳过，不影响其他 provider
+    logger.debug("未安装 dashscope，跳过 DashScope SDK 补丁")
+except Exception as e:
+    # 补丁失败不应阻止应用启动
+    logger.warning(f"应用 DashScope SDK 补丁失败，将继续启动: {e}")