更新记录

1.0.0(2026-11-21)

  • 支持从 TXT、MD、LOG、JSON、CSV、TSV、DOCX 和带文本层的 PDF 中提取文本。
  • 微信小程序示例支持从聊天中选择文件,并分页查看长文本。
  • 修复 Web 开发模式下首次选择 PDF 时页面自动刷新的问题。

平台兼容性

uni-app(5.24)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
√ √ √ √ √ √ √ √ √
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
√ √ √ √ √ √ √ √ √ √ √ √

uni-app x(5.24)

Chrome Safari Android iOS 鸿蒙 微信小程序
√ √ √ √ √ √

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
× × × √

omn-text-extractor

在 uni-app x 中从 TXT、MD、LOG、JSON、CSV、TSV、DOCX 和带文本层的 PDF 文件提取文本。支持微信小程序、Web、Android、iOS 和 HarmonyOS。

广告

· 魔法上网20元/月,包年100元; · Codex、Calude Code、Muse等AI账号充值等服务,诚信经营;有需要联系我

安装

运行示例项目需要 HBuilderX 5.31 或更高版本。先在示例项目根目录执行 npm ci 安装依赖。接入其他项目时,请复制 uni_modules/omn-text-extractor 整个目录(已包含原生 PDF 实现),并参照示例项目的 package.json、vite.config.js 和 manifest.json 配置依赖和目标平台。各端均使用下文的导入路径。Android 编译为 Kotlin 时从插件的 Android 入口加载接口,使用 JavaScript 的目标通过示例中的 textExtractorPlugin() 加载共享实现。

测试

推荐使用真机测试。使用模拟器测试时,请参照示例项目的配置。

  • Android 和 iOS 真机调试都需要自定义基座。 请先在 HBuilderX 中为目标平台制作包含本插件的自定义基座,再选择该基座运行示例,以加载原生 PDF 提取模块。
  • 也可使用包含本插件的正式安装包测试。从双插件版本升级时,请重新构建自定义基座或安装包,以加载合并后的原生模块。
  • 在微信小程序示例首页点击“从聊天选择”,即可选择微信会话中的文件。较长的提取结果可翻页查看。

调用

读取文件内容为 ArrayBuffer,携带文件名调用 extractText(buffer, fileName)。接口返回 Promise<string>,遇到不支持的扩展名、文件超限或解析错误时拒绝该 Promise。

import { extractText } from '@/uni_modules/omn-text-extractor'

async function extractSelectedFile(buffer: ArrayBuffer, fileName: string): Promise<string> {
  return await extractText(buffer, fileName)
}
  • TXT、MD、LOG、JSON、CSV、TSV 支持 UTF-8 编码,结果保留原文和换行,省略文件开头的 BOM。
  • DOCX 返回文档正文,保留段落换行、制表符和显式换行。
  • PDF 按页顺序返回文本,页间以空行分隔。没有文本层的扫描件或纯图片 PDF 会提示没有可提取的文本。多栏文档的阅读顺序和字符显示取决于 PDF 本身。
  • 文件扩展名不区分大小写。单个文件最大为 16 MB,DOCX 正文也有 16 MB 的上限。可导入 maxFileSize 在读取文件前检查大小。
  • 可导入 supportedFileExtensions 配置文件选择器,列表中的扩展名包含前导点。

第三方许可见 licenses/。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。