feat(adapters): OCRProvider Protocol + MonkeyOCRClient 异步适配器
- app/ports.py: 新增 OCRProvider Protocol(runtime_checkable,与 EmbeddingProvider 同级),定义 async transcribe_frames 端口 - adapters/ocr.py: 从 TRM4 core/tree/ocr.py 保真迁移 MonkeyOCRClient - assert → ValueError(P5 防御性校验) - 公开方法改 async(asyncio.to_thread 包装同步 HTTP) - 内部逻辑不变:多端点轮询、线程安全 Session、单帧降级、行去重 - tests/unit/test_ocr_adapter.py: 17 个测试覆盖 Protocol 合规、 构造校验、健康检查、转录、降级、去重、轮询 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -2,6 +2,7 @@
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from pathlib import Path # noqa: TC003 — runtime_checkable Protocol 需运行时可见
|
||||
from typing import TYPE_CHECKING, Protocol, runtime_checkable
|
||||
|
||||
if TYPE_CHECKING:
|
||||
@@ -56,3 +57,20 @@ class QuestionGenerator(Protocol):
|
||||
*,
|
||||
exemplars: list[GeneratedQuestion],
|
||||
) -> GeneratedQuestion: ...
|
||||
|
||||
|
||||
@runtime_checkable
|
||||
class OCRProvider(Protocol):
|
||||
"""帧文字转录端口。
|
||||
|
||||
实现方负责将帧图像发送给 OCR 服务并返回拼接后的文本。
|
||||
单帧失败应降级跳过,不得抛出异常中断整体流程。
|
||||
|
||||
参数:
|
||||
frame_paths: 帧文件路径列表。
|
||||
|
||||
返回:
|
||||
"帧1: <行1> | <行2>\\n帧2: ..." 格式文本;无有效结果时空串。
|
||||
"""
|
||||
|
||||
async def transcribe_frames(self, frame_paths: list[Path]) -> str: ...
|
||||
|
||||
Reference in New Issue
Block a user