# @datalayer/core 中文文档

规范地址：https://npmcn.com/package/%40datalayer/core/

版本：1\.2\.28
npm 元数据更新时间：2026-11-03T16:11:23.435Z
中文译文更新时间：2026-11-11T14:51:52.027Z
软件包许可：未声明

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

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

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

- 包体积（解压后）：5.1 MB，1443 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：72 个
- peer 依赖：react-router-dom ^6\.0\.0
- 首次发布：2025-07-03T13:40:53.066Z
- 最新版本发布：2026-11-03T16:11:23.038Z
- 近 30 天下载量：8377（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：78（近 12 个月 57 个）

## 中文简介

[![Datalayer](https://images.datalayer.io/legacy/datalayer-25.svg)](https://datalayer.ai/)

## 安装

```sh
npm install @datalayer/core
```

也可以使用：`pnpm add @datalayer/core`、`yarn add @datalayer/core`、`bun add @datalayer/core`

## README

[![Datalayer](https://images.datalayer.io/legacy/datalayer-25.svg)](https://datalayer.ai/)

[![Become a Sponsor](https://img.shields.io/static/v1?label=Become%20a%20Sponsor&message=%E2%9D%A4&logo=GitHub&style=flat&color=1ABC9C)](https://github.com/sponsors/datalayer)

# 数据层核心

**用于 Datalayer 的 Python 和 Typescript 库**

[![PyPI version](https://img.shields.io/pypi/v/datalayer-core.svg)](https://pypi.org/project/datalayer-core/) [![Python versions](https://img.shields.io/pypi/pyversions/datalayer-core.svg)](https://pypi.org/project/datalayer-core/) [![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://github.com/datalayer/core/blob/main/LICENSE) [![Documentation](https://img.shields.io/badge/docs-datalayer.app-blue)](https://datalayer.ai/docs/) [![Units Tests](https://github.com/datalayer/core/actions/workflows/py-tests.yaml/badge.svg)](https://github.com/datalayer/core/actions/workflows/py-tests.yaml)[![Units Tests](https://github.com/datalayer/core/actions/workflows/ts-tests.yaml/badge.svg)](https://github.com/datalayer/core/actions/workflows/ts-tests.yaml)

## 概览

数据层 Core 是赋予 [数据层 AI 平台](https://datalayer.ai/). 它提供了TypeScript和Python软件包作为指令行接口(CLI),供AI工程师,数据科学家和研究人员将可扩展计算运行时间无缝地整合到他们的工作流程中.

这个软件包是许多其他Datalayer软件包使用的基础基础,包含核心应用程序类,配置,以及统一的API,用于认证,运行时间管理,以及基于云环境的代码执行.

## 关键特性

-   **简单认证**: 环境变量支持的基于符号的简单认证
-   **保密管理**: 在工作流程中安全处理敏感数据和证书
-   **QQ Python 客户端**: 与上下文管理人员和清洁资源管理一起对数据编制器平台进行程序访问
-   **QQ 类型脚本/ 反应客户端**: 用于构建基于Jupyter的应用程序的响应组件和服务
-   **QQ 命令行接口**:用于账户和平台操作的CLI工具
-   **基本类**: 核心应用程序类别和配置由其他数据层项目继承
-   **· Jupyter 整合**: 笔记本经验服务经理和协作提供者
-   **环球导航**:自动检测并与React Router, Next.js 或本地浏览器合作的智能导航钩

## 安装

### Python 客户端

使用 pip 安装数据层核心 :

```bash
pip install datalayer-core
```

### 类型脚本/ 反应客户端

作为 npm 软件包安装 :

```bash
npm install @datalayer/core
```

### 开发安装

```bash
git clone https://github.com/datalayer/core.git
cd core

# Python development
pip install -e .[test]

# TypeScript development
npm install
```

## 用 Python 快速启动

### 1\. 认证

将您的数据显示器设置为环境变量 :

```bash
export DATALAYER_API_KEY="your-api-key"
```

或者直接传给客户:

```python
from datalayer_core import DatalayerClient

# Using environment variable
client = DatalayerClient()

# Or pass token directly
client = DatalayerClient(api_key="your-api-key-here")

if client.authenticate():
    print("Successfully authenticated!")
```

### 2\. 运行时间、快照和Evals

运行时间执行、快照工作流程和电子记录CLI现在被记录和维护于:

-   [代理运行时间](https://github.com/datalayer/agent-runtimes/blob/main/README.md)
-   [代理运行时间 CLI 文件](https://agent-runtimes.datalayer.tech/cli)

使用 `agent-runtimes` 周转时间工作量(`RuntimeClient`, (中文(简体) ), `@datalayer`,快照,和 evals),并使用 `datalayer-core` 用于账户/平台操作(认证、秘密、API密钥、使用、配置).

## 实例

这个 [实例](https://npmcn.com/package/%40datalayer/core/examples/README.md) 显示工作的数据生成客户端 :

-   [OpenTeleometry 可观察性](https://npmcn.com/package/%40datalayer/core/examples/otel/README.md):具有OpenTeleometry痕迹和度量衡的仪器数据显示器使用,并有一个小型的FastAPI服务和一个可视化的反光UI(UI)`make` 目标 [实例/数字](https://npmcn.com/package/%40datalayer/core/examples/otel)) (中文(简体) ).

关于客户端的代理、聊天和沙盒,见 [代理运行时间示例](https://github.com/datalayer/agent-runtimes/tree/main/examples)。 。 。 .

## 平台整合

Datalayer在您的开发工作流程中增加了AI能力和可缩放的运行时间. 该平台旨在无缝地整合到您现有的流程中,并用您所需的处理功率对您的计算进行超充电.

通过此客户端和 CLI 可访问的关键平台功能 :

-   **远程运行时间**: 在有CPU、RAM和GPU资源的强大远程机器上执行代码
-   **多个接口**: 通过 Python 客户端、 CLI 或其他综合工具访问和消耗运行时间
-   **可缩放计算**: 根据工作量需求动态调整计算资源

## 文档

-   **命令行接口( CLI)**数字 : [https://datalayer.ai/docs/cli/ (中文(简体) )](https://datalayer.ai/docs/cli/)
-   **核心 Python 客户端**数字 : [核心.数据编制器.tech/python/](https://core.datalayer.tech/python/)
-   **平台文档**数字 : [文档.datalayer.app](https://datalayer.ai/docs/)
-   **API 参考**数字 : [API 文档](https://datalayer.ai/docs/api/)

## 发展

### 图书馆的建设

```bash
# Build TypeScript library
npm run build:lib

# Build Python package
python -m build
```

### 设置

```bash
# Install Python dependencies
pip install -e .[test]

# Install TypeScript dependencies
npm install
```

### 代码质量

这个项目保持高码质量标准,并有自动起伏、格式化和类型检查:

```bash
# Run all checks (format, lint, type-check)
npm run check

# Auto-fix all issues
npm run check:fix

# Individual commands
npm run lint          # ESLint with React/TypeScript rules
npm run lint:fix      # Auto-fix linting issues
npm run format        # Prettier formatting
npm run format:check  # Check formatting without changes
npm run type-check    # TypeScript compilation check
```

承诺前的钩子会通过Husky和lint-staged在已上演的文件上自动运行格式化和linting.

### 运行测试

```bash
# Python tests
pip install -e .[test]
pytest datalayer_core/tests/

# TypeScript tests
npm run test

# TypeScript type checking
npm run type-check
npm run test:watch    # Watch mode
npm run test:coverage # With coverage
```

### 捐款

此客户端的设计简单且可扩展. 我们欢迎捐款! 请:

1.  叉子存储器
2.  创建特性分支
3.  做你的改变
4.  添加新功能测试
5.  提交拉动请求

关于问题和改进请求,请使用 [GitHub 问题跟踪器](https://github.com/datalayer/core/issues)。 。 。 .

## 建筑

核心是整个数据层生态系统的基础:

-   **基础类**: 其他数据层软件包继承的核心应用程序类别
-   **配置管理**:所有数据层组件的集中配置系统
-   **认证层**: 在所有数据层服务中统一认证
-   **运行时间抽象**: 不同类型计算运行时间的共同接口
-   **资源管理**:自动清理和生命周期管理

## 使用大小写

-   **AI/ML 发展**: 使用客户端或 CLI 用云计算缩放您的机器学习工作流程
-   **数据分析**: 用强大的远程运行时间处理大数据集
-   **研究**: 与可复制环境合作进行计算研究
-   **自动化**: 利用CLI工具将数据编制器纳入CI/CD管道和自动化工作流程
-   **原型制作**: 快速测试没有本地硬件限制的想法

## 许可证

本项目根据以下规定获得许可证: [BSD 3- 标签许可证](https://github.com/datalayer/core/blob/main/LICENSE)。 。 。 .

## 支助

-   **文档**数字 : [数据层平台文档](https://datalayer.ai/docs/)
-   **问题**数字 : [GitHub 问题](https://github.com/datalayer/core/issues)
-   **社区**数字 : [数据层平台](https://datalayer.ai/)

* * *

![Datalayer Logo](https://assets.datalayer.tech/datalayer-25.svg)

**AI 数据分析代理人**  
  
[今天从Datalayer开始!](https://datalayer.ai/)

## 常见问题

### 如何安装 @datalayer/core？

在项目目录运行 npm install @datalayer/core，或使用 pnpm add / yarn add / bun add。

### @datalayer/core 支持 TypeScript 吗？

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

### @datalayer/core 支持 ESM 还是 CommonJS？

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

### @datalayer/core 可以商用吗？

@datalayer/core 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @datalayer/core 的下载量有多少？

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

### @datalayer/core 还在维护吗？

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