找到
6
篇与
轻量级
相关的结果
-
ZRouter {card-default label="📦 项目信息"} 🔧 项目名称：ZRouter 💻 开发语言：TypeScript ⭐ Star数：186 | 🍴 Fork数：35 📜 开源协议：Apache-2.0 🔗 项目地址：https://gitee.com/common-apps/ZRouter {/card-default} 项目介绍 ZRouter是一款轻量级且非侵入性的鸿蒙动态路由框架，可解决HAR/HSP业务模块间的耦合与通信问题，提供了自定义拦截器、服务路由、转场动画、生命周期函数管理、NavDestination模板化等功能。 项目详情 介绍 ZRouter是一款轻量级且非侵入性的鸿蒙动态路由框架，可解决HAR/HSP业务模块间的耦合与通信问题。主要特性： 简化Navigation使用，无需关注路由表的配置，对Navigation及NavDestination组件保持零侵入； 支持API链式调用，让API更简洁直观； 为了进一步简化使用，支持NavDestination页面模板化，是一个可选项； 注解参数支持使用静态常量，可跨模块定义； 支持自定义拦截器，可实现页面重定向、登录验证、数据预取、埋点等业务场景。 支持服务路由，可实现Har/Hsp模块间的通信； 支持全局及单个页面的生命周期函数管理，可使任意类都能享有与组件相同的生命周期特性，可用于页面埋点统计等业务场景； 支持跨多级页面参数携带返回监听； 支持自定义URL路径跳转，可在拦截器内自行解析URL实现业务逻辑； 内置多种转场动画效果（平移、旋转、渐变、缩放、高斯模糊、共享一镜到底动画），并支持自定义动画； 支持启动模式、混淆、嵌套Navigation、Hap、元服务； 支持与您现有项目中的Navigation无缝融合，实现零成本向本库迁移； 支持ArkUI-X跨平台上使用； 支持第三方应用Navigation的使用本库API； 使用十分简单，没有繁琐的配置，两行代码就可以完成页面的跳转，如下: WX20250805 102507 ZRouter已上架录入到华为鸿蒙生态伙伴组件专区 使用收集 为了持续优化鸿蒙ZRouter路由库，恳请您花一点时间填写下应用名称。您的每一次反馈，都是我们持续改进的重要动力。 https://wj.qq.com/s2/25201566/76c1/ 快速入门 ZRouter快速入门 router-register-plugin编译插件 — 很重要 下载安装 在项目根目录的hvigor目录下的hvigor-config.json5文件中配置安装 pEovcrt.png "dependencies": { "router-register-plugin":"x.x.x" },编译插件最新版本: Static Badge npm 最后记得Sync Now或重新build让插件安装生效。 或者使用hvigorw命令行工具执行任一命令，命令行工具会自动执行安装构建依赖。 hvigorw --sync配置 支持两种配置方式： 工程级配置: 即在工程根目录下的hvigorfile.ts文件中全局配置； 模块级配置：即在每个模块目录下的hvigorfile.ts文件中单独配置； 不建议一个项目同时使用两种配置方式，虽然是这种混合方式也是支持的，但容易出现配置冲突。模块级配置相对繁琐些，但配置项会更精细化些。步骤： // 1、导入 import { routerRegisterPlugin, OptionalPluginConfig } from 'router-register-plugin' // 2、初始化配置 const config: OptionalPluginConfig = { scanDirs: ['src/main/ets/pages', 'src/main/ets/views'], // 扫描的目录，如果不设置，默认是扫描src/main/ets目录 logEnabled: true, // 查看日志 viewNodeInfo: false, // 查看节点信息 ignoredModules:['RouterApi','common','xxx'], // 忽略的参与构建的模块，根据自己项目自行设置 enableUiPreviewBuild: false, // 启用UI预览构建，不建议启动 } export default { // 3、添加插件 plugins:[routerRegisterPlugin(config)] } 注意：hvigorfile.ts文件中默认配置不要删除了。配置参数说明： 参数名类型默认值描述scanDirsstring[]['src/main/ets']扫描的目录，如果不设置，默认是扫描src/main/ets目录。建议配置该字段，避免扫描所有目录，影响工程编译效率** logEnabledbooleantrue是否打印日志 viewNodeInfobooleanfalse查看节点信息，只有与logEnable同时为true才会打印输出isAutoDeleteHistoryFilesbooleanfalse是否在构建时删除编译产物，已弃用，在项目clean自动删除无用编译产物，请不要设置此参数。 lifecycleObserverAttributeNamestringlifecycleObserver如果使用了NavDest页面模板化功能，该配置字段会生效，默认属性名是lifecycleObserver，也可以在@Route注解上单独设置这个属性ignoredModulesstring[][]忽略需要扫描的模块，填写模块名称，默认是全部模块；插件在工程级时使用，该字段才会生效。建议配置该字段，避免扫描所有模块，影响工程编译效率enableUiPreviewBuildbooleanfalse是否在ui预览构建时生成，默认不启用, 会降低ui预览构建效率注意： 以上配置参数都是可选的，建议配置scanDirs和ignoredModules字段，避免扫描所有目录和模块，影响工程编译效率。编译阶段会自动生成一些文件，建议在git的.gitignore忽略掉这些文件。 _generated **/route_map.json **/router_map.jsonZRouter的基本使用 下载安装 在每个har/hsp模块中，通过ohpm工具下载安装库： ohpm install @hzw/zrouter页面跳转 新建三个模块分别是harA、harB、hspC，三者之间没有依赖关系，entry模块依赖了这三个模块，通过ZRouter可以在四个模块间相互跳转，从而达到模块解耦效果。模块关系图如下图： ohos zrouter 1 1、在EntryAbility的onCreate()方法中初始化ZRouter，建议使用initialize()方法进行初始化，init()方法已弃用 onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void { // 如果项目中存在hsp模块则传入true ZRouter.initialize((config) => { config.isLoggingEnabled = BuildProfile.DEBUG config.isHSPModuleDependent = true }) } 建议在AbilityStage的onCreate()方法中完成初始化 export class AppAbilityStage extends AbilityStage{ onCreate(): void { // 应用HAP首次加载时触发，可以在此执行该Module的初始化操作（例如资源预加载、线程创建等）。 // 在module.json5配置文件中，通过配置 srcEntry 参数来指定模块对应的代码路径，以作为HAP加载的入口。 // 初始化路由 ZRouter.initialize((config) => { // 设置context config.context = this.context config.isLoggingEnabled = BuildProfile.DEBUG config.isHSPModuleDependent = true // 服务路由初始化配置，如果没有使用服务路由，可不设置 config.loadDynamicModule = ['@hzw/hara', 'harb', 'hspc'] config.onDynamicLoadComplete = () => { console.log("已完成所有模块的加载") } }) } }2、在Index页面使用Navigation作为根视图，通过ZRouter的getNavStack()方法获取NavPathStack实例，将其传入到Navigation的构造函数中。 如果在Index入口文件中启动Splash页面，建议放在Navigation的onAppear方法中进行启动，或者组件的onPageShow方法，具体可参考demo // Index 中使用 aboutToAppear 生命周期函数会因为 Navigation 还没初始化完成导致无法有效跳转,可使用替换成 onPageShow @Entry @Component struct Index { build() { // 获取NavPathStack实例对象 Navigation(ZRouter.getNavStack()){ Column({space:12}){ Button('toHarAMainPage').onClick((event: ClickEvent) => { // 跳转页面 ZRouter.push("harAMainPage") }) } } .title('Main') .height('100%') .width('100%') .onAppear(() => { // 启动Splash页面 ZRouter.push("SplashPage") }) } }通过ZRouter的pushXX()方法进行页面跳转，参数是@Route装饰器上的name属性值；或者用ZRouter的getNavStack()方法来执行页面跳转。 3、在NavDestination子页的使用自定义@Route或@ZRoute注解标注页面，其中name属性是必填的，页面跳转需要用到name值，还有另外三个可选属性分别是： description：页面描述，没有功能作用； needLogin：如果页面需要登录，可以将值设置为true，然后在拦截器中做页面重定向到登录页； extra：额外的值可以通过该属性设置 @Route/@Service/@ZAttribute/@ZLifecycle等自定义注解上的name属性支持使用静态常量，在后面文档有详细介绍代码如下： @Route({ name: 'hspCPage1', needLogin:true ,extra: 'hsp'}) @Component export struct Page1 { @State message: string = 'Hello World'; build() { NavDestination(){ Column({space:12}){ Button('toHarAPage1').onClick((event: ClickEvent) => { ZRouter.push("harAPage1") }) } } .title('hspCPage1') .width('100%') .height('100%') } } 如果觉得每个页面都要用NavDestination组件包裹太麻烦，可以使用NavDestination模板化功能。建议通过ZRouter.getInstance()方式来操作路由的跳转与关闭，使用会更灵活简洁，之前的ZRouter的静态方法依然保留着，在1.2.0版本起将标记为过期状态了。 ZRouter.getInstance() .setParam("root data") .setLunchMode(LaunchMode.STANDARD) // 启动模式 .setAnimate(true) .setPopListener((r) => { LogUtil.log("index result: ", r.data ," from: ", r.from); }) .navigation("harAPage3")全局拦截器 全局拦截器每个页面跳转都会触发，可以拦截器中做页面跳转的拦截，比如跳转前拦截、数据预取、登录拦截，404拦截、埋点、自定义URL路径等等。 代码示例： export class GlobalNavigateInterceptor implements IGlobalNavigateInterceptor{ static count = 0 onNavigateBefore: (destInfo: DestinationInfo) => Promise = (destInfo) => { console.log("IInterceptor Global onNavigateBefore -> ", destInfo.name) return new Promise((resolve, _) => { if (destInfo.name === RouterConstants.PAGE_BEFORE_PUSH) { // 拦截跳转到ParamPage页面 if (GlobalNavigateInterceptor.count === 0) { destInfo.param = ' 在拦截器onNavigateBefore中已替换参数 ' destInfo.next() // 继续跳转 默认的 ，可以不写 } else if (GlobalNavigateInterceptor.count === 1) { ToastUtils.show("拦截器onNavigateBefore中已拦截, 再点一次会继续执行") destInfo.block() // 拦截跳转 } else if (GlobalNavigateInterceptor.count === 2) { destInfo.name = RouterConstants.LIFECYCLE_CASE_VIEW } GlobalNavigateInterceptor.count += 1 } resolve(destInfo) }) } onRootWillShow: ((fromContext: NavDestinationContext) => void) | undefined = (fromContext) => { console.log("IInterceptor Global onRootWillShow: ", fromContext.pathInfo.name) } onPageWillShow: ((fromContext: NavDestinationContext, toContext: NavDestinationContext) => void) | undefined = (from ,to)=>{ console.log("IInterceptor Global onPageWillShow: ", from, to.pathInfo.name, to.pathInfo.param) } onNavigate: ((context: InterceptorInfo) => void) | undefined = (info)=>{ if (info.notRegistered) return console.log("IInterceptor Global onNavigate -> ", info.name) let isLogin = AppStorage.get("isLogin") if (info.isNeedLogin && !isLogin) { let param = info.param ZRouter.getInstance() .setParam(param) .setAnimate(true) .setPopListener((result) => { if (result.data) { // 登录成功 promptAction.showToast({ message: `登录成功` }) return true // 返回true 则继续跳转登录前的页面 } else { return false } }) .redirect("LoginPage", RedirectType.REPLACE) } } } // 添加拦截器 ZRouter.setGlobalInterceptor(new GlobalNavigateInterceptor()) 当页面未注册时，可以通过以下方式处理： 跳转到404页面：使用 redirect() 方法直接重定向到404页面 跳转到登录页面：使用 redirect() 方法跳转到登录页，并可以设置回调函数处理登录结果 登录setPopListener的回调函数工作流程： 登录成功时，回调函数返回 true，继续跳转到原来的目标页面 登录失败或取消时，回调函数返回 false，停止跳转 登录页面代码示例： @Route({ name: 'LoginPage'}) @Component export struct LoginPage{ build() { NavDestination(){ Column({space:15}){ Button('登录成功').onClick((event: ClickEvent) => { // 模拟登录 AppStorage.setOrCreate('isLogin', true) ZRouter.finishWithResult(true) }) } .width('100%') .height('100%') } .width('100%') .height('100%') .title('LoginPage') } }在登录成功后通过ZRouter.finishWithResult()方法携带数据关闭页面，内部会将状态传递给redirectForResult2()方法中的回调函数，最终在setPopListener中接收处理。 NavDestination页面模板化 在介绍基本使用的流程中，我们知道每个页面都需要通过NavDestination来包裹，这样会造成代码的冗余，因此可通过ZRouter的模板化能力将NavDestination层去除。 具体使用见详细文档 自定义URL路径跳转 在项目中一般会设计一套统一的URL路径跳转规范，通过URL路径跳转到不同原生页面。比如下面的URL路径： hzw://hello?id=69&name=harAPage3获取URL路径上的name参数进行跳转原生页面，可以设置一个拦截器来拦截URL路径跳转。代码示例： 跳转： Button('https://www.baidu.com?id=66&name=hspCIndex').onClick((event: ClickEvent) => { ZRouter.getInstance() .navigation("https://www.baidu.com?id=66&name=hspCIndex") }) Button('hzw://hello?id=69&name=harAPage3').onClick((event: ClickEvent) => { ZRouter.getInstance() .navigation("hzw://hello?id=69&name=harAPage3") })拦截器： export class UrlInterceptor implements IInterceptor { // 设置拦截器优先级，数值越大则优先执行 priority: number = 10000; process: (context: InterceptorInfo) => InterceptorInfoOrNull = (context) => { console.log("IInterceptor process: ", this.priority , context.name) // 自定义URL路径是没有注册的 if (context.notRegistered) { // 如果是URL路径跳转 if (this.isLink(context.name)) { // 拦截到URL路径跳转，进行处理 const map = this.parseQueryString(context.name) const name = map.get('name') if (name) { // 跳转原生页面 ZRouter.getInstance() .setParam(map.get("id")) .navigation(name) } } else { ZRouter.getInstance().redirect("PageNotFound2") } return null // 返回null则拦截掉 } return context }; isLink(str: string): boolean { const linkRegex = /^(hzw:\/\/|http:\/\/|https:\/\/|www\.).+/; return linkRegex.test(str); } parseQueryString(queryString: string) { let params = new HashMap(); let queryStringWithoutQuestionMark = queryString.split('?')[1]; if (queryStringWithoutQuestionMark) { let keyValues = queryStringWithoutQuestionMark.split('&'); keyValues.forEach((keyValue) => { let pair = keyValue.split('='); let key = decodeURIComponent(pair[0]); let value = decodeURIComponent(pair[1]); params.set(key, value) }) } return params; } }上面的逻辑也可以放在全局拦截器的onNavigateBefore()方法中处理。 注解上使用静态常量，可跨模块定义 router-register-plugin插件1.0.7版本起，@Route与@Service注解的name属性可使用静态常量，方便统一管理路由名称；静态常量支持当前模块或跨模块定义，常量的定义模版如下： export class RouterConstants { public static readonly URL_TEST_PAGE: string = "url_test"; public static readonly HARA_MAIN_PAGE :string = "harAMainPage" }如果路由常量在一个公共模块定义，建议在模块的Index.ets文件导出，另外RouterConstants的文件必须是.ets后缀，不支持ts后缀文件。具体可参考案例服务路由-模块间通信 服务路由主要用于实现模块之间的通信，模块间是相互独立且不直接依赖于彼此。 1.0.9版本开始支持，具体使用可见详情文档 或者参考demo生命周期函数管理 ZRouter的组件生命周期管理能力，主要有两个特点： 不影响你原有的生命周期业务逻辑，对NavDestination页面保持着零侵入性，整合了组件通用生命周期函数和NavDestination生命周期函数 可以让任何一个类具备有与组件的生命周期能力； 具体使用见详细文档 路由转场动画 从1.1.1版本起内置了转场动画（平移、旋转、渐变、缩放、高斯模糊），也支持自定义转场动画；具体使用见详细文档 第三方Navigation实例使用本库的API 如果第三方Navigation实例使用本库的API，需要将第三方Navigation的NavPathStack实例注册到ZRouter中，代码示例： aboutToAppear(): void { // 在合适的时机注册导航栈 // let s = ZRouter.getNavStackByName(NAV_STACK_NAME) ZRouter.registerNavStack(NAV_STACK_NAME, this.stack) } aboutToDisappear(): void { ZRouter.unregisterNavStack(NAV_STACK_NAME) } 上面是模拟代码，具体注册的时机需要根据实际情况来定。NAV_STACK_NAME是一个自定义常量，用于标识导航栈的名称。 页面跳转： Column({ space: 15 }) { Text(this.msg) Button("harAMainPage").onClick((event: ClickEvent) => { ZRouter.getInstance(NAV_STACK_NAME) .setAnimate(true) .setPopListener((v) => { this.msg = v.data?.toString() + ' ' + v.from?.toString() }) .navigation("harAMainPage") }) }把标识导航栈的名称NAV_STACK_NAME，入参到ZRouter.getInstance()方法中，就可使用ZRouter的API。 在ArkUI-X项目上的使用 router-register插件在ArkUI-X项目的配置有所不同，需要使用者自己手动修改下hvigorfile.ts文件，详细见ArkuiX-ZRouter，或者issues IB35F5 混淆 生产环境需要在每个模块的obfuscation-rules.txt文件添加混淆配置： -keep-file-name Index _generated ZR*工作原理 路由注册流程代码是由插件在编译阶段自动化生成，其原理是不难的，通过Hvigor插件扫描指定目录的ets文件，递归解析ets文件的语法树节点，查找解析注解上的参数，然后将这些信息通过模板引擎生成对应的代码逻辑。 与Java注解处理器原理是类似的ZRouter库是对NavPathStack对进行高度封装的，包括了页面跳转、自定义拦截器、服务路由、生命周期回调、转场动画、NavDestination模板化等功能，提供了更简洁易用的API，其中部分思想参考了Android ARouter路由框架。 编译插件的基本流程图： WX20250805 103406 接口列表 查看详细文档 FQA 查看详细文档 源码 gitee：https://gitee.com/common-apps/ZRouter github：https://github.com/751496032/ZRouter 参与贡献 Fork 本仓库 新建分支 提交代码 新建 Pull Request 待优化项 服务路由：支持在entry模块动态注册； 拦截器： onNavigateBefore()兼容系统push 等api拦截； onNavigateBefore()支持获取注解中的参数； 页面模板化：在模板化下支持页面路由组件直接参数携带，非模板功能已支持了； * ...（内容过长，已截断，更多详情请访问项目地址） ⬇️ 下载地址 下载后请先检查文件完整性，如有问题请在评论区反馈
-
OnnxOCR {card-default label="📦 项目信息" /} 🔧 项目名称：OnnxOCR 💻 开发语言：Python ⭐ Star数：164 | 🍴 Fork数：43 📜 开源协议：Apache-2.0 🔗 项目地址：https://gitee.com/jingsongliujing/OnnxOCR {/card-default} 项目介绍 基于PaddleOCR重构，并且脱离PaddlePaddle深度学习训练框架的轻量级OCR，推理速度超快 —— A lightweight OCR system based on PaddleOCR, decoupled from the PaddlePaddle deep learning training framework, with ultra-fast inference speed. 项目详情 OnnxOCR 如果项目对您有帮助，欢迎点击右上角 Star 支撑！ onnx_logo 基于 ONNXRuntime 的高性能多语种 OCR 工程 GitHub stars GitHub forks GitHub license Python Version AtomGit Star English | 简体中文 | 日本語 版本更新 2026.05.27 新增 OCR + Qwen3.5-2B ONNX 信息抽取使用方法。 新增 onnxocr.qwen35_2b 包内模块，用于 Qwen3.5-2B ONNX 模型下载、校验和纯 Python 推理。 新增 examples/id_card_extract_with_qwen.py 端到端示例：先用 OnnxOCR 做全量文字识别，再用 Qwen3.5-2B 抽取身份证结构化字段。 Qwen3.5-2B ONNX 使用独立 ModelScope 仓库：supersong/qwen2bonnx。 2026.05.01 新增 ONNX 车牌检测与车牌号识别能力。 新增基于 RapidTable 的 ONNX 表格识别能力。 新增基于 RapidLayout 的中英文版面分析能力。 新增基于 RapidDoc 的文档版面分析与 Markdown 导出能力。 ONNXPaddleOcr 新增 use_plate_recognition、use_table_recognition、use_layout_analysis 参数，默认均为 False，原有通用 OCR 调用方式不受影响。 新增 /plate、/table、/layout、/layout_markdown 等 HTTP 接口。 2025.05.21 新增 PP-OCRv5 模型，单模型支撑简体中文、繁体中文、中文拼音、英文、日文。 整体识别精度相比 PP-OCRv4 提升。 识别效果与 PaddleOCR 3.0 保持一致。 核心优势 脱离深度学习训练框架：可直接用于部署的通用 OCR 工程。 跨架构支持：基于 PaddleOCR 转换的 ONNX 模型，可部署在 ARM 和 x86 架构设备上。 统一推理引擎：项目内 ONNX 模型统一通过 onnxocr/inference_engine.py 创建 ONNXRuntime Session。 多语种支持：单模型支持 5 种文字类型。 国产化适配友好：下游厂商适配 GPU/NPU 时，优先修改统一推理引擎即可。 环境安装 python>=3.8 pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt说明： 仓库默认只包含 tests/test_general_ocr.py 所需的 PP-OCRv5 通用 OCR 模型。 车牌识别、表格识别、版面分析、方向分类、RapidDoc Markdown 导出等扩展模型较大，国内优先从 ModelScope 下载，也可以使用 HuggingFace 或国内镜像站 https://hf-mirror.com。 PP-OCRv5 Server ONNX 模型也可下载后替换 onnxocr/models/ppocrv5/ 下的 det/rec 模型。 模型下载 扩展模型统一托管在 ModelScope 和 HuggingFace。国内网络建议优先使用 ModelScope models 目录： python scripts/download_models.py等价的 ModelScope 核心代码如下： from modelscope import snapshot_download model_dir = snapshot_download("supersong/onnxocr_model")如果希望从 HuggingFace 下载，可使用： python scripts/download_models.py --source huggingfaceHuggingFace 模型地址：jingsongliu/onnxocr_model。 国内访问 HuggingFace 较慢时，可使用镜像站 hf-mirror.com： python scripts/download_models.py --source huggingface --hf-endpoint https://hf-mirror.com脚本会把模型仓库中的 models/ 目录同步到本地 onnxocr/models/，并检查 RapidDoc 所需的 onnxocr/models/rapid_doc/layout/pp_doclayoutv2.onnx 等关键文件是否存在。 只检查本地模型是否齐全： python scripts/download_models.py --check-onlyQwen3.5-2B 信息抽取基座 OnnxOCR 也可以在 OCR 之后接入本地 Qwen3.5-2B ONNX 模型，作为信息抽取基座使用。典型流程是： 先用 OnnxOCR 对图片做全量文字识别，得到文本和文本框。 再把 OCR 文本交给 Qwen3.5-2B ONNX，抽取为结构化 JSON。 OCR 和抽取都在本地通过 Python + ONNXRuntime 运行，不依赖 JS。 Qwen3.5-2B ONNX 使用独立模型仓库，和车牌、表格、版面分析等可选 OCR 模型不是同一个下载地址： ModelScope：supersong/qwen2bonnx 本地目录：onnxocr/models/qwen_2b 准备 Qwen3.5-2B ONNX 模型： python examples/qwen35_2b_onnx.py download --variant q4 python examples/qwen35_2b_onnx.py verify模型默认放在： onnxocr/models/qwen_2b纯 Python 文本/图文推理冒烟测试： python examples/qwen35_2b_onnx.py run-python --prompt "你好，简易介绍一下你自己。" python examples/qwen35_2b_onnx.py run-python --onnxocr/models/qwen_2b/s/demo.jpeg --prompt "用一句话描述这张图片。"也可以直接调用包内 API： from onnxocr.qwen35_2b import Qwen35ONNX qwen = Qwen35ONNX("onnxocr/models/qwen_2b") text, stopped = qwen.generate("从下面 OCR 文本中抽取字段：...") print(text)扩展新的场景抽取模板： from onnxocr.qwen35_2b import ExtractionTemplate, QwenScenarioExtractor invoice_template = ExtractionTemplate( name="invoice_basic", description="发票 OCR", fields=["发票号码", "销售方", "购买方", "价税合计", "开票日期"], rules=[ "只根据 OCR 文本抽取，不要编造。", "缺失或不确定的字段填空字符串。", "只输出 JSON，不要解释。", ], ) extractor = QwenScenarioExtractor(model_dir="onnxocr/models/qwen_2b") fields, raw = extractor.extract(ocr_text, template=invoice_template) print(fields)基础包不内置任何垂直场景提示词。请把场景模板放在你的应用代码或 examples/ 中，再传给 QwenScenarioExtractor。你可以通过定义字段和规则，继续扩展发票、营业执照、合同、快递面单、医疗报告、质检单等垂直 OCR 场景。 一键运行通用 OCR python test_ocr.pytest_ocr.py 默认只运行通用 OCR。车牌识别、表格识别、版面分析、RapidDoc Markdown 导出示例已在文件中注释，下载对应模型后按需取消注释即可。 独立测试文件： python tests/test_general_ocr.py python tests/test_license_plate_ocr.py python tests/test_table_ocr.py python tests/test_layout_analysis.py python tests/test_layout_markdown.py测试输出默认写入 result_/，该目录已加入 .gitignore。 通用 OCR import cv2 from onnxocr.onnx_paddleocr import ONNXPaddleOcr = cv2.imread("onnxocr/test_s/715873facf064583b44ef28295126fa7.jpg") model = ONNXPaddleOcr(use_angle_cls=False, use_gpu=False) result = model.ocr() print(result)OCR + Qwen 信息抽取 examples/id_card_extract_with_qwen.py 是一个最小端到端垂直场景示例。可复用的 Qwen 推理和通用模板抽取代码位于 onnxocr.qwen35_2b，身份证字段和提示词规则只放在该示例脚本中。 默认示例： python examples/id_card_extract_with_qwen.py指定图片路径： python examples/id_card_extract_with_qwen.py --"onnxocr/test_s/8f113149-ff64-4c9f-8dc0-e34100365aa4.jpg"输出文件： result_/id_card_front_qwen_extract.json脚本默认不会在控制台打印身份证敏感字段，只会写入本地 JSON。仅在可信本地环境中使用 --show-sensitive 查看抽取明细。 车牌识别 车牌识别作为可选模式融合到 ONNXPaddleOcr 中，默认仍使用原来的通用 OCR 流程。 from onnxocr.onnx_paddleocr import ONNXPaddleOcr, sav2Plateplate_model = ONNXPaddleOcr( use_angle_cls=True, use_gpu=False, use_plate_recognition=True, plate_min_score=0.4, ) plate_result = plate_model.ocr() sav2Plate![OnnxOCR 图片17](, plate_result, name="./result_/test_plate_vis.jpg")模型文件： onnxocr/models/license_plate/car_plate_detect.onnx onnxocr/models/license_plate/plate_rec.onnx表格识别 表格识别集成自 RapidTable，复用通用 OCR 的文字检测和识别结果，再进行表格结构还原，输出 HTML、单元格框和逻辑行列坐标。 from onnxocr.onnx_paddleocr import ONNXPaddleOcr, sav2Tabletable_model = ONNXPaddleOcr( use_angle_cls=True, use_gpu=False, use_table_recognition=True, table_model_type="slanet_plus", ) table_result = table_model.ocr() print(table_result["html"]) sav2Table![OnnxOCR 图片22](, table_result, name="./result_/test_table_vis.jpg")模型文件： onnxocr/models/table/slanet-plus.onnx onnxocr/models/table/ch_ppstructure_mobile_v2_SLANet.onnx onnxocr/models/table/en_ppstructure_mobile_v2_SLANet.onnx中英文版面分析 版面分析集成自 RapidLayout，用于定位文档图像中的标题、正文、表格、图片、页眉页脚等元素。 from onnxocr.onnx_paddleocr import ONNXPaddleOcr, sav2Layoutlayout_model = ONNXPaddleOcr( use_gpu=False, use_layout_analysis=True, layout_model_type="pp_layout_cdla", ) layout_result = layout_model.ocr() sav2Layout![OnnxOCR 图片27](, layout_result, name="./result_/test_layout_vis.jpg")英文版面模型可将 layout_model_type 设置为 pp_layout_publaynet。 模型文件： onnxocr/models/layout/layout_cdla.onnx onnxocr/models/layout/layout_publaynet.onnx文档转 Markdown 文档转 Markdown 集成自 RapidDoc，支持根据版面分析结果识别标题、段落、表格和图片等内容，并保存为 Markdown 文件。 from onnxocr.layout_markdown import LayoutMarkdownConverter converter = LayoutMarkdownConverter( layout_model_type="pp_doclayoutv2", formula_enable=False, table_enable=True, ) result = converter.convert_file( "onnxocr/test_s/layout_cdla.jpg", output_md_path="./result_/test_layout_markdown.md", ) print(result["markdown_path"])RapidDoc 模型文件： onnxocr/models/rapid_doc/layout/pp_doclayoutv2.onnx onnxocr/models/rapid_doc/table/q_cls.onnx onnxocr/models/rapid_doc/table/unet.onnx onnxocr/models/rapid_doc/table/slanet-plus.onnx推理引擎适配 项目中的通用 OCR、车牌识别、表格识别、版面分析和 RapidDoc 文档解析都通过 onnxocr/inference_engine.py 创建 ONNXRuntime Session。 如果需要适配下游厂商 GPU/NPU，通常只需要修改： from onnxocr.inference_engine import create_session核心扩展点： create_session(model_path, providers=None, use_gpu=False, gpu_id=0, sess_options=None) build_providers(use_gpu=False, gpu_id=0, providers=None) build_providers_from_engine_cfg(engine_cfg) ProviderConfig(engine_cfg) 当前项目只有 onnxocr/inference_engine.py 直接 import onnxruntime，业务模块不直接依赖 ONNXRuntime API。 API 服务 app-service.py 是用于部署的 JSON API 服务，webui.py 是浏览器可视化服务。两者分离后，项目更容易部署、测试和维护。 启动 API 服务： python app-service.py环境变量： ONNXOCR_PORT：服务端口，默认 5005。 ONNXOCR_USE_GPU：设为 1 / true 时启用 GPU provider。 ONNXOCR_DEBUG：设为 1 / true 时启用 Flask debug。 ONNXOCR_OUTPUT_DIR：Markdown 和资源输出目录，默认 result_。 ONNXOCR_MAX_UPLOAD_MB：最大上传大小，单位 MB，默认 200。 主要接口支持 JSON base64 图片，也支持 multipart 文件上传： /health：服务健康检查。 /ocr：通用 OCR。 /plate：车牌识别。 /table：表格识别。 /layout：版面分析。 /layout_markdown：图片或 PDF 转 Markdown。 JSON 示例： curl -X POST http://127.0.0.1:5005/ocr \ -H "Content-Type: application/json" \ -d "{\"\":\"\"}"multipart 示例： curl -X POST http://127.0.0.1:5005/ocr \ -F "=@onnxocr/test_s/715873facf064583b44ef28295126fa7.jpg"启动 WebUI： python webui.pyDocker 镜像环境 docker build -t ocr-service . docker run -itd --name onnxocr-service -p 5006:5005 ocr-serviceDocker 构建通过 .dockerignore 排除缓存、运行输出和可选大模型文件。车牌、表格、版面分析、RapidDoc 等扩展模型可以在镜像内按需下载，也可以运行时挂载。 代码结构 app-service.py # 可部署 JSON API 服务 webui.py # 浏览器可视化服务 test_ocr.py # 本地一键 OCR 示例 requirements.txt # 运行依赖 Dockerfile # API 服务容器镜像 .dockerignore # 排除缓存、输出和大模型文件 Readme.md # 英文文档 Readme_cn.md # 中文文档 Readme_ja.md # 日文文档 onnxocr/ inference_engine.py # 唯一 ONNXRuntime 入口 onnx_paddleocr.py # 用户统一调用入口 predict_det.py # 通用 OCR 检测 predict_rec.py # 通用 OCR 识别 orientation.py # 本地 RapidOrientation ONNX 适配 license_plate.py # 车牌识别 table_recognition.py # 表格识别封装 layout_recognition.py # 版面分析封装 layout_markdown.py # RapidDoc Markdown 导出封装 rapid_layout/ # RapidLayout 源码级 ONNX 集成 rapid_table/ # RapidTable 源码级 ONNX 集成 rapid_doc/ # RapidDoc 源码级 ONNX 集成 models/ # 本地 ONNX 模型 scripts/ download_models.py # 可选模型下载/检查脚本 tests/ # 独立功能测试和 API 烟测效果展示 示例 1示例 2 示例 3示例 4 联系与交流 OnnxOCR 交流群 微信群 QQ群 致谢 非常感谢 PaddleOCR 提供的技术支持和模型参考。 非常感谢 RapidAI 开源社区，以及其中 RapidTable、RapidLayout、RapidDoc、RapidOrientation 等项目提供的优秀模型、代码和工程参考。 开源与捐赠 如果您认可本项目，可以通过支付宝或微信进行支持。 项目
