# @anaralabs/lector 中文文档

规范地址：https://npmcn.com/package/%40anaralabs/lector/

版本：3\.17\.0
npm 元数据更新时间：2026-11-05T22:44:27.391Z
中文译文更新时间：2026-11-06T01:59:53.931Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：395 kB，7 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：7 个
- peer 依赖：react \>=19，pdfjs-dist ^5\.5\.207
- 首次发布：2025-03-20T15:46:29.459Z
- 最新版本发布：2026-11-05T22:44:27.056Z
- 近 30 天下载量：277645（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：77（近 12 个月 53 个）

## 中文简介

反应的无头 PDF 查看器

## 安装

```sh
npm install @anaralabs/lector
```

也可以使用：`pnpm add @anaralabs/lector`、`yarn add @anaralabs/lector`、`bun add @anaralabs/lector`

## README

# 莱克特

**React的无头PDF查看器.** 将页面、文本选择、搜索和说明写入自己的阅读经验。 Lector处理PDF.js渲染和页面虚拟化;您控制了布局和UI.

[文档](https://anara.com/lector/docs) • 妇女 [现场演示](https://anara.com/lector) • 妇女 [无](https://www.npmjs.com/package/@anaralabs/lector) • 妇女 [捐款](https://github.com/anaralabs/lector/blob/main/CONTRIBUTING.md)

## 在屏幕上获取 PDF

使用回放19+. 当前来源预计 `pdfjs-dist` `^5.5.207`。这些文档轨道 `main`; 检查 [释放](https://github.com/anaralabs/lector/releases) 与您安装的软件包版本相对应.

```bash
npm install @anaralabs/lector pdfjs-dist@^5.5.207
```

复制 PDF.js 的工人 从您的应用程序安装的依赖性到它的公共资产。 当您更新 PDF.js 时, 复制它, 这样运行时间和工人版本匹配 .

```bash
mkdir -p public/pdfjs
cp node_modules/pdfjs-dist/legacy/build/pdf.worker.min.mjs public/pdfjs/
```

设置 PDF 位址 `public/sample.pdf`,然后添加此浏览器已交付的组件 :

```tsx
import { CanvasLayer, Page, Pages, Root, TextLayer } from "@anaralabs/lector";
import { GlobalWorkerOptions } from "pdfjs-dist/legacy/build/pdf.mjs";
import "pdfjs-dist/web/pdf_viewer.css";

GlobalWorkerOptions.workerSrc = "/pdfjs/pdf.worker.min.mjs";

export default function PDFViewer() {
  return (
    <Root
      source="/sample.pdf"
      style={{ height: 600 }}
      loader={<p role="status">Loading PDF…</p>}
    >
      <Pages>
        <Page>
          <CanvasLayer />
          <TextLayer />
        </Page>
      </Pages>
    </Root>
  );
}
```

对于 **下一个.js**,通过客户端组件使用 `dynamic(..., { ssr: false })`; 将 PDF.js 设置在动态加载模块内。 见 [安装](https://anara.com/lector/docs/installation) 用于全包装,维特工人设置,以及路径前缀下方的部署.

`Root` 装入文档并提供其状态. `Pages` 拥有滚动和克隆一个 `Page` 可见页面模板. `CanvasLayer` 绘制PDF; `TextLayer` 添加可选文本 。 给取景者一个确定的高度并导入 PDF.js 样式表, 使其分层对齐 .

## 构建您的应用需要的阅读器

| 特性 | 从这里开始 |
| --- | --- |
| 工具栏、页面输入和布局 | [你的第一个观众](https://anara.com/lector/docs/basic-usage) |
| 认证的 URL、 本地文件、 错误和自寄资产 | [正在装入文档](https://anara.com/lector/docs/document-loading) |
| 页面导航和适应宽度 | [导航](https://anara.com/lector/docs/code/page-navigation), (中文(简体) ), [缩放](https://anara.com/lector/docs/code/zoom-control) |
| 页面预览 | [缩略图](https://anara.com/lector/docs/code/thumbnails) |
| 文本搜索和突出显示的结果 | [搜索](https://anara.com/lector/docs/code/search) |
| 甄选和引用区域 | [选择](https://anara.com/lector/docs/code/select), (中文(简体) ), [突出内容](https://anara.com/lector/docs/code/highlight) |
| PDF 链接和可编辑窗体字段 | [链接](https://anara.com/lector/docs/code/links), (中文(简体) ), [表单](https://anara.com/lector/docs/code/pdf-form) |
| 暗页渲染 | [黑暗模式](https://anara.com/lector/docs/dark-mode) |
| 道具、钩子和默认 | [API 参考](https://anara.com/lector/docs/api) |

Lector是一个工具包,而不是一个完成的工具栏或PDF编辑器. 您的应用程序提供可访问控制、 错误 UI 和用户说明的存储 。 搜索需要嵌入式文本;它不执行OCR. 自定义亮度覆盖不会自动修改 PDF 文件 。 见 [排除出问题](https://anara.com/lector/docs/troubleshooting) 包括工人错误、空白页和排版问题.

## 使用编码助手

连接 MCP 客户端 `https://anara.com/lector/mcp` 使用可流取的 HTTP,没有 API 密钥。 它可以通过工具和资源搜索和阅读每一个指南。 见 [人工智能特工和MCP](https://anara.com/lector/docs/agents) 用于设置和实例请求.

直接取取时, 首先 [页:1](https://anara.com/lector/llms.txt)读取 [个人马克下线指南](https://anara.com/lector/docs/installation.md),或使用 [完整文档](https://anara.com/lector/llms-full.txt)。这些出口来自与网站相同的来源.

## 关于Lector的工作

从寄存器根起,有节点.js 22.13+和pnpm 9.5.0:

```bash
pnpm install --frozen-lockfile
pnpm --filter @anaralabs/lector build
pnpm --filter docs dev
```

打开 [本地主机 : 000/ docs](http://localhost:3000/docs)。 Docs 应用程序使用本地工作空间软件包。 将表模式、验证命令和另一个应用程序中的测试改为 [捐款额](https://github.com/anaralabs/lector/blob/main/CONTRIBUTING.md)。 。 。 .

## 鸣谢

灵感来自 [无头反应- pdf](https://github.com/jkgenser/react-pdf-headless) 财务报告和审定财务报表 [pdf阅读器](https://github.com/OnedocLabs/pdfreader)。在 [PDF.js (英语)](https://mozilla.github.io/pdf.js/) 财务报告和审定财务报表 [反应](https://react.dev/)。 。 。 .

## 许可证

[麻省理工学院](https://github.com/anaralabs/lector/blob/main/LICENSE) © [阿纳拉](https://anara.com/)

## 常见问题

### @anaralabs/lector 是什么？

反应的无头 PDF 查看器

### 如何安装 @anaralabs/lector？

在项目目录运行 npm install @anaralabs/lector，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=19）、pdfjs-dist（^5\.5\.207）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @anaralabs/lector 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @anaralabs/lector 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @anaralabs/lector 可以商用吗？

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

### @anaralabs/lector 的下载量有多少？

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

### @anaralabs/lector 还在维护吗？

最新版本 3\.17\.0 发布于 2026/11/06（1 天前）；至今共发布 77 个版本，其中过去 12 个月发布了 53 个；首次发布于 2025/03/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。