test: 式舆防卫战/快捷手册 fixture + vision_hint 断言

test/zzz_od/backend/test_backend_context.py

@@ -106,6 +106,7 @@ def test_analyze_maps_ocr_results() -> None:
     assert result.success is True
     assert [t.text for t in result.ocr_texts] == ["体力", "设定"]
     assert result.ocr_texts[0].width == 3
+    assert result.vision_hint is not None  # success 时带能力边界提示
 
 
 def test_analyze_returns_error_when_screenshot_none() -> None:
@@ -116,6 +117,7 @@ def test_analyze_returns_error_when_screenshot_none() -> None:
     result = backend.analyze()
     assert result.success is False
     assert "截图失败" in (result.error or "")
+    assert result.vision_hint is None  # 失败时不带提示
 
 
 def test_analyze_returns_screens_and_writes_back_on_precise(monkeypatch) -> None:

test/zzz_od/backend/test_http_routes.py

@@ -100,6 +100,7 @@ async def test_handle_game_analyze_ok() -> None:
     assert resp.status_code == 200
     data = json.loads(resp.body.decode("utf-8"))
     assert data["success"] is True
+    assert data["vision_hint"] is None  # HTTP 显式补字段(P11 对称);mock 未设 → None
 
 
 @pytest.mark.asyncio

test/zzz_od/backend/test_mcp_app.py

@@ -110,13 +110,14 @@ def test_analyze_screen_tool_returns_screens_field() -> None:
     )
     match = ScreenMatch(screen_name='菜单', is_precise=True, areas=[detail])
     backend.analyze.return_value = AnalyzeScreenResult(
-        success=True, ocr_texts=[], error=None, screens=[match])
+        success=True, ocr_texts=[], error=None, screens=[match], vision_hint='提示透传')
     tool = mcp._tool_manager._tools['analyze_screen']
     fn = getattr(tool, 'fn', None) or getattr(tool, 'func', None)
     result = fn()
     assert result.success is True
     assert result.screens[0].screen_name == '菜单'
     assert result.screens[0].areas[0].area_type == AreaType.TEXT
+    assert result.vision_hint == '提示透传'  # tool 直接 return backend 结果,字段透传
 
 
 def test_check_game_window_returns_window_status() -> None:

test/zzz_od/backend/test_schemas.py

@@ -73,3 +73,18 @@ def test_analyze_result_default_screenshot_path_none() -> None:
     """AnalyzeScreenResult 默认 screenshot_path=None。"""
     r = AnalyzeScreenResult(success=True, ocr_texts=[], error=None)
     assert r.screenshot_path is None
+
+
+def test_analyze_result_default_vision_hint_none() -> None:
+    """AnalyzeScreenResult 默认 vision_hint=None(失败 / 未设时)。"""
+    r = AnalyzeScreenResult(success=True, ocr_texts=[], error=None)
+    assert r.vision_hint is None
+    r2 = AnalyzeScreenResult(success=False, ocr_texts=[], error='截图失败')
+    assert r2.vision_hint is None
+
+
+def test_analyze_result_vision_hint_settable() -> None:
+    """AnalyzeScreenResult.vision_hint 可赋值非空(success 时的能力边界提示)。"""
+    r = AnalyzeScreenResult(success=True, ocr_texts=[], error=None,
+                            vision_hint='部分识别,请用视觉工具再看')
+    assert r.vision_hint == '部分识别,请用视觉工具再看'