Merge branch 'main' of http://182.92.86.220:8300/wx44wx/ZNJJ-api-server

# Conflicts:
#	docs/视频快处智能信息采集机器人交互接口文档V1.0.10.docx
#	src/api/endpoints.py
#	src/core/fastgpt_client.py

test/api/fastapi-browser-addon.http

@@ -0,0 +1,82 @@
+@baseUrl = http://127.0.0.1:8000
+###
+@sessionId = a1123
+@timeStamp = 202603310303
+@clientMode = browser_addon
+###
+GET {{baseUrl}}
+
+HTTP/1.1 200  - OK
+date: Tue, 28 Jul 2026 00:36:56 GMT
+server: uvicorn
+content-length: 32
+content-type: application/json
+connection: close
+###
+DELETE {{baseUrl}}/delete_session
+content-type: application/json
+
+{
+    "sessionId": "{{sessionId}}",
+    "timeStamp": "{{$timestamp}}"
+}
+
+HTTP/1.1 200  - OK
+date: Tue, 28 Jul 2026 00:36:57 GMT
+server: uvicorn
+content-length: 71
+content-type: application/json
+connection: close
+###
+POST {{baseUrl}}/chat?stream=true
+content-type: application/json
+
+{
+    "sessionId": "{{sessionId}}",
+    "timeStamp": "{{timeStamp}}",
+    "text": "hi",
+    "clientMode": "{{clientMode}}",
+    "needFormUpdate": true,
+    "useTextChunk": true
+}
+
+HTTP/1.1 200  - OK
+date: Tue, 28 Jul 2026 00:36:58 GMT
+server: uvicorn
+content-type: text/event-stream; charset=utf-8
+connection: close
+transfer-encoding: chunked
+###
+POST {{baseUrl}}/get_info
+content-type: application/json
+
+{
+    "sessionId": "{{sessionId}}",
+    "timeStamp": "{{timeStamp}}",
+    "key": "hphm1"
+}
+
+HTTP/1.1 200  - OK
+date: Tue, 28 Jul 2026 00:37:07 GMT
+server: uvicorn
+content-length: 97
+content-type: application/json
+connection: close
+###
+POST {{baseUrl}}/set_info
+content-type: application/json
+
+{
+    "sessionId": "{{sessionId}}",
+    "timeStamp": "{{timeStamp}}",
+    "key": "hphm1",
+    "value": "沪A8939"
+}
+
+HTTP/1.1 200  - OK
+date: Tue, 28 Jul 2026 00:37:00 GMT
+server: uvicorn
+content-length: 70
+content-type: application/json
+connection: close
+###

test/test_client_mode.py

@@ -0,0 +1,61 @@
+import pytest
+from pydantic import ValidationError
+
+from src.api.endpoints import external_stage_code
+from src.schemas.models import ProcessRequest_chat
+
+
+def test_client_mode_defaults_to_direct():
+    request = ProcessRequest_chat(
+        sessionId="session-1",
+        timeStamp="1",
+        text="你好",
+    )
+
+    assert request.clientMode == "direct"
+
+
+def test_browser_addon_client_mode_is_accepted():
+    request = ProcessRequest_chat(
+        sessionId="session-1",
+        timeStamp="1",
+        text="你好",
+        clientMode="browser_addon",
+    )
+
+    assert request.clientMode == "browser_addon"
+
+
+def test_unknown_client_mode_is_rejected():
+    with pytest.raises(ValidationError):
+        ProcessRequest_chat(
+            sessionId="session-1",
+            timeStamp="1",
+            text="你好",
+            clientMode="unknown",
+        )
+
+
+@pytest.mark.parametrize("client_mode", ["", "  ", None])
+def test_empty_client_mode_defaults_to_direct(client_mode):
+    request = ProcessRequest_chat(
+        sessionId="session-1",
+        timeStamp="1",
+        text="你好",
+        clientMode=client_mode,
+    )
+
+    assert request.clientMode == "direct"
+
+
+@pytest.mark.parametrize(
+    ("client_mode", "raw_code", "expected"),
+    [
+        ("direct", "0001", "0001"),
+        ("direct", "1002", "1002"),
+        ("browser_addon", "0001", "browser_addon.0001"),
+        ("browser_addon", "1002", "browser_addon.1002"),
+    ],
+)
+def test_external_stage_code(client_mode, raw_code, expected):
+    assert external_stage_code(client_mode, raw_code) == expected