@docling/docling-core

中文文档
2.106.0发布于 2026/11/06MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 8.4万

用于 Dockling 输出的 TypeScript 定义和函数 .

中文使用文档
文档目录7 节
  1. 开始
  2. 安装软件包
  3. 转换和获取
  4. 歧视
  5. 读取 DocLang
  6. 读取 DCLX 档案
  7. 限制

调试核心

TypeScript定义和用于使用Docling输出的功能,它简化了文档处理,解析了多种格式——包括先进的PDF理解. 此软件包支持整合 调试 输出到您的 Type-/JavaScript app 中,其类型定义和公用功能反映了 调试核心 Python 图书馆.

开始

安装软件包

npm i @docling/docling-core

转换和获取

要转换文档,您可以:

  • 使用单独的文档转换服务, 例如 导航服务。 。 。 .
  • 将 Docling 整合到您的 API 中, 或者使用 Docling CLI 快速网络服务 .
  • 转换前文档并将其作为静态资源,例如放在COS桶上.

下一个,获取(类型d)转换:

import { type DoclingDocument } from '@docling/docling-core';

async function fetchConversion(url: string) {
  const response = await fetch(url);

  return (await response.json()) as DoclingDocument;
}

歧视

使用工具功能和打字功能来方便访问已转换的文档内容 :

import { iterateDocumentItems, isDocling } from '@docling/docling-core';

for (const [item, level] of iterateDocumentItems(conversion)) {
  if (isDocling.TextItem(item)) {
    console.log(item.text);
  } else if (isDocling.TableItem(item)) {
    ...
  }
}

读取 DocLang

@docling/docling-core/doclang 将 DocLang XML 变成一个 DoclingDocument它是Python的港口 DocLangDocDeserializer,其JSON输出符合Python的.

import { deserializeDocLang } from '@docling/docling-core/doclang';

const doc = deserializeDocLang(doclangXml); // browser: uses the native DOMParser

在节点,通过一个 DOMParser。 。 。 . @xmldom/xmldom 是一个可选的对等依赖,所以浏览器捆绑永远不会包含它.

import { DOMParser } from '@xmldom/xmldom';

const doc = deserializeDocLang(doclangXml, { DOMParser });

选项映射 Python deserialize_str 关键字参数 :

  • pageNo: 首页前的内容页 <page_break/> (默认一).
  • maxXmlBytes, (中文(简体) ), maxDepth, (中文(简体) ), maxElements: 未经信任的投入的预算。 超越一掷.
  • repairUnescapedText: 逃脱赤裸裸的 &页:1 < 无法启动标记, 流浪者 ]]> 和非法控制字符在解析前。 默认关闭,所以输入必须是完善的XML.
  • onWarning: 收到警告( 默认) console.warn) (中文(简体) ). <track> 还没有被支持, 并且被跳过, 及其所有的内容, 一个警告.

读取 DCLX 档案

deserializeDclx 从字节读取一个 DCLX 归档( T)Uint8Array, (中文(简体) ), ArrayBuffer, (中文(简体) ), Blob 或者说 File) (中文(简体) ). 图像被嵌入到文档中作为 Base64 数据 URI.

import { deserializeDclx } from '@docling/docling-core/doclang';

const doc = await deserializeDclx(await (await fetch(url)).arrayBuffer());

在节点,通过一个 DOMParser 和DocLang一样.

限制

此软件包没有

  • 从 JavaScript 运行时间直接转换文档 。 这不是道克林港.
  • 支持除JSON和DocLang(只读)之外的其他Docling输出格式,如Markdown.

版本与发布记录

@docling/docling-core 共发布 18 个版本,首次发布于 2025/01/25;过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.106.0latest2026/11/067 天前
2.105.02026/11/0310 天前
2.104.02026/10/2519 天前
2.103.02026/10/2024 天前
2.102.02026/10/1925 天前
2.101.02026/10/081 个月前

关于 @docling/docling-core 的常见问题

@docling/docling-core 是什么?

用于 Dockling 输出的 TypeScript 定义和函数 .

如何安装 @docling/docling-core?

在项目目录运行 npm install @docling/docling-core,或使用 pnpm add / yarn add / bun add。

@docling/docling-core 支持 TypeScript 吗?

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

@docling/docling-core 支持 ESM 还是 CommonJS?

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

@docling/docling-core 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@docling/docling-core 可以商用吗?

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

@docling/docling-core 的下载量有多少?

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

@docling/docling-core 还在维护吗?

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