小孙OCR 1.2

小孙OCR

本地离线 OCR 工具。识别全部在本机完成，无需联网、无需登录、无统计、无广告。

面向自动化场景：三种截屏方式自动挑选、本地 HTTP 接口、MacroDroid / Tasker 插件能力，
并内置边缘滑动手势触发器（含跟手滑出菜单）。

功能一览

• 文字识别 — 三档本地模型：tiny（轻量快速）/ small（高精度）/ rapid（ML Kit 捆绑版，中英）
• 截屏识别 — 无障碍截图（Android 11+，免 root 免授权）/ root screencap / MediaProjection，按序自动挑选与回退
• 图片识别 — 指定路径直接识别，支持纯文本 / 含坐标 / 含包围盒三种输出
• 本地接口 — http://127.0.0.1:1666，支持 JSON / form / query 三种传参
• 自动化插件 — 完整 Tasker / Locale 协议，异步变量回传，MacroDroid 与 Tasker 均可调用
• 边缘手势 — 屏幕边缘悬浮手柄，8 方向滑动触发，每方向可独立调触发距离与行为
• 滑动菜单 — 滑过手柄跟手弹出一排图标，选中某项才向宏发事件
• 手柄黑名单 — 按前台应用隐藏手柄，同一份名单支持黑 / 白两种语义
• 防烧屏 — 手柄定时小幅垂直漂移，降低 OLED 残影
• 从最近任务隐藏 — 多任务界面不显示卡片，服务与手势照常运行
• 日志 — 崩溃自动记录，一键分享，便于反馈问题

系统要求

项	要求
Android 版本	8.0（API 24）及以上
架构	arm64-v8a / armeabi-v7a
必需权限	所有文件访问（用于读写图片）
可选权限	无障碍（免授权截屏、手柄黑名单）、悬浮窗（后台弹截屏授权框）、root（免授权截屏）
存储占用	约 46 MB（含本地模型）

安装

下载 XiaoSunOCR-1.2.apk 直接安装。首次启动会申请「所有文件访问权限」，
打开 App 即自动启动 OCR 服务，后台加载模型约 1~3 秒。

覆盖安装：versionCode 3，可升级 1.1 及更早版本。

文档

安装使用、三种截屏方式、手势与菜单配置、插件变量、接口协议等完整说明见
README。

小孙OCR 1.1

本地离线 OCR 工具，识别全部在本机完成，无需联网。

本版要点

三种截屏，免 root
无障碍截图（Android 11+，免授权弹窗）→ root screencap → 录屏授权兜底，自动挑选降级。

边缘手柄手势
屏幕边缘放手柄，八个方向中的任意一个滑过设定距离即触发（滑过即响应，不必抬手）。
方向可选、触发距离可调、支持防烧屏的像素漂移。

跟手滑动菜单
滑过距离后弹出一排图标，继续滑到某一项上（跟手高亮），抬手即选中。
排列方式、图标大小、间距、配色、命中热区全部可调。

完整的 Tasker / MacroDroid 插件协议
作为「触发器」出现在宿主列表里；菜单选中结果通过 %xsocr_menu_index /
%xsocr_menu_text / %xsocr_menu_action 回传。
另提供本地 HTTP 接口 127.0.0.1:1666。

本次更新（相对上次上传的 1.1 包）

• 滑动菜单没选中图标 → 连通知都不发：抬手不在任何图标上，或触摸被系统抢走，
  不再广播 REQUEST_QUERY，宏根本不会被触发。不再出现「触发了但变量是空的」。
• 触发器方向改成排他覆盖：MacroDroid 触发器里选哪个方向，手柄上就只留哪个，
  其余七个自动关掉。从「左下」改成「左上」后，左下不会残留。
• 主界面菜单卡片状态跟随：改完滑动菜单开关返回，卡片副标题立刻重读，不再是旧状态。
• 手势触发时机收敛为一种：只保留「滑动超过距离时触发」，
  去掉「按下即触发」与「未达距离抬手触发」两个易误触的选项。
• 插件变量 Tasker 兼容性修复：菜单索引/坐标改用字符串回传
  （Tasker 只认 String / String[] / ArrayList<String>，putInt 会被静默丢弃）；
  signalFinish 改为从 completionIntent 读回调三件套。
• 其他：新增应用内日志与崩溃记录、从最近任务隐藏、无障碍截图
  （Android 11+，免 root 免授权弹窗）、滑动菜单空菜单越界闪退修复。

环境

• 模型档位：tiny / small / rapid（ML Kit 捆绑版，中英，不依赖 Google Play 服务）
• 无登录、无统计、无广告

小孙OCR 1.0

小孙OCR 1.0

本地离线 OCR，无需联网。

本版新增

• 三种截屏识别：无障碍截图（API 30+，免 root 免授权）/ root screencap / 录屏授权，自动挑选
• 边缘滑动手势触发器：8 方向判定，可跟手滑出菜单
• 主界面整理：去掉接口文档页，开关与在线调试合并为「OCR 设置」
• 内置 MacroDroid / Tasker 插件，变量异步回传

小孙OCR 2.1

基于 PaddleOCR 的本地离线 OCR 应用，无需联网，识别在本机完成。

功能

• 截屏识别 / 图片文件识别
• 三种模型档位：tiny（快）、small（高精度）、rapid（RapidOCR）
• 本地 HTTP 接口：127.0.0.1:1666
• MacroDroid / Tasker 插件支持

插件变量

变量	说明
%xsocr_text	识别出的全部文本
%xsocr_match	指定文本是否找到（true/false）
%xsocr_x	命中处 x 坐标（整数）
%xsocr_y	命中处 y 坐标（整数）
%xsocr_error	出错信息（失败时）
%xsocr_time	耗时(ms)
%xsocr_tier	使用的档位

插件特性

• 异步变量回传：不受宿主 11 秒超时限制，长耗时的识别也能可靠回传
• 指定文本查找：支持「包含文本」与「匹配文本（完全一致）」两种方式
• 坐标回传：命中后直接给出可点击的坐标

安装

下载 XiaoSunOCR-2.1.apk 直接安装（需允许「安装未知来源应用」）。

使用提示

• 首次使用请在 App 内点一次「开启截屏授权」
• 从最近任务划掉 App 后服务会停止，下次打开自动恢复
• MacroDroid 里配置插件后，记得在 Output variables 里映射需要的变量