用途:为 xberg 的文档提取能力提供网页接口和 MCP 协议接入层。网页服务基于 Axum,协议接入使用相应的服务实现。
网页接口支持直接提取、排队提取、任务查询和取消,也提供格式、健康、版本及缓存等接口。网址作为提取请求中的字段传入,不应猜造单独的网址提取路由;批处理同样应按已有异步任务与查询接口组织。
缓存采用文件系统后端,以内容散列作为键,并根据保留时间、容量和可用空间淘汰,不是简单的内存缓存。上传需要检查类型、大小和文件实际内容,限制值从配置读取。
MCP 通过一个嵌套服务提供工具、资源和提示,不能把它理解成许多独立的网页路径。较长提取任务应走异步接口。跨来源访问默认较宽松,生产接入需要配置 XBERG_CORS_ORIGINS;具体接口、环境变量和错误处理方式应按当前参考文档核对。