Release/v2.2.1

.github/workflows/auto-unit-test.yml

@@ -36,7 +36,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
-          python-version: '3.10'
+          python-version: '3.11'
 
       - name: Install uv
         run: pip install --upgrade uv

.github/workflows/sdk_publish.yml

@@ -21,7 +21,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
+          python-version: '3.11'
 
       - name: Install build dependencies
         run: |

.gitignore

@@ -61,4 +61,9 @@ data/
 sdk/benchmark/.env
 /docker/.env.bak
 
-.venv
+.venv
+
+.pytest-tmp
+doc/mermaid
+
+.claude/skills/python-import-triage

backend/adapters/__init__.py

@@ -0,0 +1,13 @@
+from adapters.exception import JiuwenSDKError, JiuwenSDKUnavailableError, NexentCapabilityError
+
+try:
+    from adapters.jiuwen_sdk_adapter import JiuwenSDKAdapter
+except ModuleNotFoundError:
+    JiuwenSDKAdapter = None  # type: ignore[assignment, misc]
+
+__all__ = [
+    "JiuwenSDKError",
+    "JiuwenSDKUnavailableError",
+    "NexentCapabilityError",
+    "JiuwenSDKAdapter",
+]

backend/adapters/exception.py

@@ -0,0 +1,13 @@
+class JiuwenSDKError(Exception):
+    """Jiuwen SDK 调用失败的通用异常"""
+    pass
+
+
+class JiuwenSDKUnavailableError(JiuwenSDKError):
+    """Jiuwen SDK 不可用（依赖缺失或未启用）"""
+    pass
+
+
+class NexentCapabilityError(Exception):
+    """nexent 原生模式不支持该能力"""
+    pass