../ writing

OCRASR 里,本地和云端各做什么

这个项目跑在本地,识别却交给腾讯云。文件从哪里进、结果怎么回来,我想把这条线讲清楚。

本地服务负责什么

OCRASR 是一个本地运行的文件处理入口。Python 后端使用 FastAPI 与 Uvicorn,提供浏览器操作界面和 HTTP 接口;独立的 stdio MCP 服务则把同一组能力开放给支持该协议的客户端。

“本地运行”描述的是服务入口与文件工作流。图片 OCR 和音频 ASR 通过腾讯云完成,本机不运行识别模型。把入口的位置与识别的位置区分开,才能清楚理解数据的去向。

识别与文档提取走不同路径

图片文字、图片表格和音频识别进入云端识别流程。PDF、DOCX、TXT 与 Markdown 文档则走本地提取路径,得到便于整理的 Markdown 内容。

本地文件
  ├─ 图片 / 音频 → HTTP 服务 → 腾讯云 OCR / ASR
  └─ 文本类文档 → 本地解析
                                  ↓
                         文本 / Markdown 结果

因此,文档类型本身会影响处理路径。文本 PDF 与扫描 PDF 不能简单视为同一类输入。

让界面与工具使用同一能力

浏览器界面适合手动选择文件与查看结果,MCP 适合由客户端调用本地文件处理能力。二者面向不同的使用方式,也都需要给调用者清晰的任务状态和结果。

技术展示可以围绕三个问题展开:输入是什么、数据经过哪里、结果如何返回。比堆叠技术名词更容易看清一个项目的边界。

next长音频转写,光等结果还不够