# @dile/scanner 中文文档

规范地址：https://npmcn.com/package/%40dile/scanner/

版本：0\.1\.11
npm 元数据更新时间：2026-11-11T22:40:04.121Z
中文译文更新时间：2026-11-12T09:44:23.026Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dile/scanner
原文对照：https://npmcn.com/package/%40dile/scanner/?lang=original
项目主页：https://dile-components.com/
源码仓库：https://github.com/Polydile/dile-components

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：66.8 kB，13 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：6 个
- 首次发布：2026-10-19T19:23:23.465Z
- 最新版本发布：2026-11-11T22:40:03.942Z
- 近 30 天下载量：2860（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

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

## 安装

```sh
npm install @dile/scanner
```

也可以使用：`pnpm add @dile/scanner`、`yarn add @dile/scanner`、`bun add @dile/scanner`

## README

# @ dile/ scanner

扫描浏览器中文档的 Web 组件:边缘检测、视角校正和多页 PDF 或 JPEG 输出,由 [扫描](https://www.npmjs.com/package/scanic) 财务报告和审定财务报表 [页:1](https://www.npmjs.com/package/jspdf)。 。 。 .

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

```html
<dile-scanner multipage max-bytes="5242880"></dile-scanner>
```

```javascript
import '@dile/scanner/scanner.js';

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

## 文档和演示

读取文件并找到演示文稿 [dile 组件场地](https://dile-components.com/components/dile-scanner/)

## 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 :

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

export default { plugins: [scannerMlAssets()] };
```

```javascript
import { mlAssetsUrl } from 'virtual:dile-scanner-ml';

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

## 在PWA中使用它

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

```javascript
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 },
      },
    }],
  },
})
```

版本的文件夹可以确保更新永远不会混合不同版本的缓存文件. 见 [文档](https://dile-components.com/components/dile-scanner/#pwa) 关于细节.

## 维修附注

`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 是什么？

在浏览器中扫描文档的 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 和提交记录判断。