用途:本技能用于在 AI 智能体中安装和配置 Xiaomi-OCR-0 Skill 及其配套本地 MCP 服务,面向文档 OCR、KIE(JSON 关键字段抽取)与 VQA(文档图像问答)三类任务。
主要能力:
- 全局安装 xiaomi-ocr Skill:npx skills add SeerRay-Lab/Xiaomi-OCR-0 --skill xiaomi-ocr --full-depth --global --agent <current-agent> --yes,其中 <current-agent> 替换为当前智能体的 Skills CLI 标识,不安装到所有智能体,也不修改项目本地技能目录。
- 检查当前智能体的 MCP 配置与本机环境,按运行时 Skill 的后端选择流程,依据现有配置、硬件与精度要求选择服务。
- 运行时从完整仓库导入共享的 evaluation_pipeline/ 与 postprocess/ 模块;需复用完整检出或克隆 https://github.com/SeerRay-Lab/Xiaomi-OCR-0.git 到用户自有代码目录,并从该检出运行 skills/xiaomi-ocr/install.sh;若未设置 XIAOMI_OCR_REPO 指向检出目录,不要运行分离的技能副本。
- Codex 使用 bash install.sh --agent=codex;其他智能体使用 bash install.sh,并将生成的配置仅合并到当前智能体。
- 完整代理辅助安装包含 region 模式:说明需要 PaddlePaddle、PaddleX 与 PP-DocLayoutV3 权重,并在已有授权下将其安装到 MCP 环境;按运行时 Skill 第 5 步选择兼容的 CPU/GPU 构建,安装 requirements-paddlex.txt,并验证真实的 mode="region" 请求。
使用方式:
- 唯一面向用户的安装提示为:Read and execute https://raw.githubusercontent.com/SeerRay-Lab/Xiaomi-OCR-0/main/SKILL.md。
- 运行 install.sh 前需说明:它会创建私有 .venv、下载 requirements.txt 中的 MCP 依赖,并在适用时向 Codex 配置注册一个 MCP 服务器条目;如用户尚未授权环境创建与依赖安装,应先请求授权。保留其他所有 MCP 条目。
- 除非用户授权覆盖这些变更,否则不要安装 SGLang/vLLM、创建推理环境或下载模型权重;需明确说明是否将下载引擎或检查点,并尽量复用已有兼容安装。
- 推理监听保持绑定回环地址;在图像请求成功前不得声称推理已就绪。
- 尊重仅页面模式的请求;若平台不支持或安装失败,报告 region 模式不可用,并说明哪些基础功能已通过验证。
任务选择:ocr_image/ocr_pdf 用于文档解析,kie_image 用于 JSON 关键字段抽取,vqa_image 用于文档图像问答。印刷文档优先使用 region 模式;场景文字、手写、书法、历史文档等非标准版式使用整页模式,避免区域切割损坏上下文。
运行时:模型通过 SGLang、vLLM 或可选 Ollama 后端在本地提供服务;MCP 服务负责任务特定提示、页面/区域预处理与结果组装。
限制:需用户授权环境创建、依赖安装及可能的权重下载;region 模式依赖 PaddlePaddle、PaddleX 与 PP-DocLayoutV3 权重,平台不支持或安装失败时不可用;需从完整仓库检出运行,不能使用分离副本。