@dile/scanner

中文文档
0.1.11发布于 2026/11/12MITES Module近 30 天下载 2860

在浏览器中扫描文档的 Web 组件:边缘检测、视角校正和多页 PDF 或 JPEG 输出,由 scanic 和 jsPDF 供电

中文使用文档
文档目录4 节
  1. 文档和演示
  2. ML 检测器文件
  3. 在PWA中使用它
  4. 维修附注

@ dile/ scanner

扫描浏览器中文档的 Web 组件:边缘检测、视角校正和多页 PDF 或 JPEG 输出,由 扫描 财务报告和审定财务报表 页:1。 。 。 .

一切运行在客户端上:不需要后端. 组件不上传任何内容;它会发送一个事件与产生的文件.

<dile-scanner multipage max-bytes="5242880"></dile-scanner>
import '@dile/scanner/scanner.js';

const scanner = document.querySelector('dile-scanner');
scanner.addEventListener('dile-document-scanned', (e) => upload(e.detail.file));
scanner.open();

文档和演示

读取文件并找到演示文稿 dile 组件场地

ML 检测器文件

ML探测器是可选和默认关闭的. 无 ml-detector 您的用户没有下载它。 与 ml-detector 该组件使用扫描仪的神经探测器,浏览器在背景中下载其文件(3.5 MB,约2.2 MB有gzip),这是扫描仪第一次打开.

默认文件来自jsDelivr. 软件包安装匹配 scanic-ml 版本(3.5 MB 在 node_modules,因此您可以使用包含 Vite 插件服务自己的副本。 放在一个文件夹里 scanic-ml 版本 (/dile-scanner-ml/0.2.0/在虚拟模块中导出 URL :

// vite.config.js
import { scannerMlAssets } from '@dile/scanner/vite-plugin.js';

export default { plugins: [scannerMlAssets()] };
import { mlAssetsUrl } from 'virtual:dile-scanner-ml';

scanner.mlDetector = true;
scanner.mlAssetsUrl = mlAssetsUrl;

在PWA中使用它

ML文件可以被服务人员缓存,因此只能下载一次,这是扫描仪第一次被打开. 不要预先切除它们(它们会在安装应用程序时被下载), 而要添加运行时缓存规则 。 与花生相接:

VitePWA({
  workbox: {
    globIgnores: ['**/dile-scanner-ml/**'],
    runtimeCaching: [{
      urlPattern: ({ url }) => url.pathname.includes('/dile-scanner-ml/'),
      handler: 'CacheFirst',
      options: {
        cacheName: 'dile-scanner-ml',
        cacheableResponse: { statuses: [200] },
        expiration: { maxEntries: 3 },
      },
    }],
  },
})

版本的文件夹可以确保更新永远不会混合不同版本的缓存文件. 见 文档 关于细节.

维修附注

scanic 被钉入精确的版本,因为 src/corner-editor-styles.js 复制其角编辑器的样式(scanic注入到 document.head,它不会到达阴影根。 更新扫描时,请对照 node_modules/scanic/dist/scanic.js (检索) .scanic-corner-editor)和更新 scanic-ml (也被绑定)到扫描所期望的版本(参见jsDelivr URL in node_modules/scanic/dist/scanic-mlDetector.js) (中文(简体) ).

版本与发布记录

@dile/scanner 共发布 22 个版本,首次发布于 2026/10/20;过去 12 个月发布了 22 个版本。

版本发布日期距今
0.1.11latest2026/11/12今天
0.1.102026/11/12今天
0.1.92026/11/101 天前
0.1.82026/11/102 天前
0.1.72026/11/075 天前
0.1.62026/11/075 天前

关于 @dile/scanner 的常见问题

@dile/scanner 是什么?

在浏览器中扫描文档的 Web 组件:边缘检测、视角校正和多页 PDF 或 JPEG 输出,由 scanic 和 jsPDF 供电

如何安装 @dile/scanner?

在项目目录运行 npm install @dile/scanner,或使用 pnpm add / yarn add / bun add。

@dile/scanner 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/dile__scanner 是否存在。

@dile/scanner 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@dile/scanner 可以商用吗?

@dile/scanner 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@dile/scanner 的下载量有多少?

根据 npm 官方下载统计,@dile/scanner 在 2026/10/12 – 2026/11/10 这 30 天内被下载 2,860 次,日均约 95 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dile/scanner 还在维护吗?

最新版本 0.1.11 发布于 2026/11/12(今天);至今共发布 22 个版本,其中过去 12 个月发布了 22 个;首次发布于 2026/10/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。