# @crvouga/mockingbird-service-textract 中文文档

规范地址：https://npmcn.com/package/%40crvouga/mockingbird-service-textract/

版本：3\.11\.0
npm 元数据更新时间：2026-11-11T02:46:22.938Z
中文译文更新时间：2026-11-11T09:57:02.055Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40crvouga/mockingbird-service-textract
原文对照：https://npmcn.com/package/%40crvouga/mockingbird-service-textract/?lang=original
项目主页：https://github.com/crvouga/mockingbird/tree/main/packages/service/textract#readme
源码仓库：https://github.com/crvouga/mockingbird

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

- 包体积（解压后）：4.3 MB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-09-23T00:02:58.893Z
- 最新版本发布：2026-11-11T02:46:22.514Z
- 近 30 天下载量：2305（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：37（近 12 个月 37 个）

## 中文简介

具有文档分析任务、图表块、页码和决定性通知的状态亚马逊文本复制模拟器.

## 安装

```sh
npm install @crvouga/mockingbird-service-textract
```

也可以使用：`pnpm add @crvouga/mockingbird-service-textract`、`yarn add @crvouga/mockingbird-service-textract`、`bun add @crvouga/mockingbird-service-textract`

## README

# @crvouga/ mockingbird-service-textraft (英语)

> 本地模拟器。 真正的API合同. 部分 [嘲笑鸟](https://github.com/crvouga/mockingbird)。 。 。 .

用于官方SDK v3客户端的 stateful Amazon Textract模拟器. 它模拟同步和同步的文档分析,相接的块图,稳定的平面图,一能和完成通知.

## 安装

```bash
npm install -D @crvouga/mockingbird-service-textract
```

仅限无害环境管理。 节点22+或Bun 1.2+.

## 使用量

```ts
import { AnalyzeDocumentCommand, TextractClient } from "@aws-sdk/client-textract"
import { createServer } from "@crvouga/mockingbird-service-textract/server"

// Test setup: start the emulator with a seeded document and point the SDK's endpoint at it.
const server = await createServer({
  corpora: [
    {
      bucket: "fixtures",
      name: "invoice.pdf",
      pages: 1,
      blocks: [{ id: "line-1", blockType: "LINE", page: 1, text: "Total due 42.00", confidence: 99 }],
    },
  ],
})
const textract = new TextractClient({
  endpoint: server.url,
  region: "us-east-1",
  credentials: { accessKeyId: "fixture", secretAccessKey: "fixture" },
})

// Application code: the Textract SDK calls it already makes.
const analysis = await textract.send(
  new AnalyzeDocumentCommand({
    Document: { S3Object: { Bucket: "fixtures", Name: "invoice.pdf" } },
    FeatureTypes: ["FORMS"],
  }),
)
console.log(analysis.Blocks?.map((block) => block.Text)) // [ "Total due 42.00" ]

await server.close()
```

点 `TextractClient.endpoint` 时间 `server.url` 有固定的SigV4证书。 支持的操作有分析文件,开始文件分析,以及GetDocument分析. 块记录保留了 PAGE, LINE, WORD, nube VALUE SET, Table, CELL, 和SelectCition Election 图表字段,包括几何,信心,实体类型,文本,和关系.

## 控件

-   `GET/POST /__admin/corpora` 按 S3 桶、密钥和可选版本列出块图或种子.
-   `GET /__admin/jobs` 财务报告和审定财务报表 `GET /__admin/jobs/:id` 检查提交的准确工作.
-   `POST /__admin/jobs/:id/transition` 移动任务到 `SUCCEEDED`, (中文(简体) ), `PARTIAL_SUCCESS`,或 `FAILED`,带有可选 `statusMessage`。 。 。 .
-   选择公司固定装置 `pageSize` 以强制决定的页面边界,并可能包含低自信块、错误的关系和警告.
-   错误预设为 `throttled`, (中文(简体) ), `throughput_exceeded`,以及 `unavailable`。 。 。 .

有通知频道的终端任务通过共享的webhook中枢发布一个SNS相容的Textract状态机构. 共享运行时间还提供重置,时钟,日记,度量衡,断层,和名空间隔离.

## API 密码

-   `TextractAPI`, (中文(简体) ), `TextractAPIOptions`, (中文(简体) ), `TextractNotification`: 处理者和通知合同.
-   `TextractBlock`, (中文(简体) ), `TextractCorpus`, (中文(简体) ), `TextractJob`, (中文(简体) ), `TextractJobStatus`:固定和持久状态.
-   `createRuntime`, (中文(简体) ), `TextractRuntime`, (中文(简体) ), `TextractRuntimeOptions`:完整的"鸟"跑步时间和"网球"中枢.
-   `TEXTRACT_NAMESPACE`, (中文(简体) ), `TEXTRACT_PRESETS`, (中文(简体) ), `accessKeyCredential`:常数和故障控制.
-   `document`, (中文(简体) ), `operationIds`, (中文(简体) ), `supportedOperationIds`: 生成了 OpenAPI 元数据.
-   `createServer`, (中文(简体) ), `TextractServerOptions`, (中文(简体) ), `DEFAULT_PORT`, (中文(简体) ), `serveTarget` 从 `./server`:节点HTTP适配器和CLI集成.

## 故意不模拟

OCR、S3访问、IAM评价、适配器、产出交付、生产限制、计费、仪表板、以及文件子集以外的文本格式操作没有模型化.

官方预言: [Amazon Textract API 参考文献](https://docs.aws.amazon.com/textract/latest/dg/API_Reference.html)。 。 。 .

## 常见问题

### @crvouga/mockingbird-service-textract 是什么？

具有文档分析任务、图表块、页码和决定性通知的状态亚马逊文本复制模拟器\.

### 如何安装 @crvouga/mockingbird-service-textract？

在项目目录运行 npm install @crvouga/mockingbird-service-textract，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mockingbird-textract，可以用 npx mockingbird-textract 直接运行。

### @crvouga/mockingbird-service-textract 支持 TypeScript 吗？

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

### @crvouga/mockingbird-service-textract 支持 ESM 还是 CommonJS？

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

### @crvouga/mockingbird-service-textract 可以商用吗？

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

### @crvouga/mockingbird-service-textract 的下载量有多少？

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

### @crvouga/mockingbird-service-textract 还在维护吗？

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