# @darajs/core 中文文档

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

版本：1\.30\.0
npm 元数据更新时间：2026-10-26T17:07:54.148Z
中文译文更新时间：2026-11-11T11:39:54.564Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：12 MB，579 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：32 个
- 首次发布：2023-07-28T14:38:46.080Z
- 最新版本发布：2026-10-26T17:07:53.631Z
- 近 30 天下载量：2803（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：260（近 12 个月 55 个）

## 中文简介

达拉框架核心

## 安装

```sh
npm install @darajs/core
```

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

## README

# 达拉应用框架

![Dara Logo](https://github.com/causalens/dara/blob/master/img/dara_light.svg?raw=true)

![Master tests](https://github.com/causalens/dara/actions/workflows/tests.yml/badge.svg?branch=master) [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0) [![PyPI](https://img.shields.io/pypi/v/dara-core.svg?color=dark-green)](https://pypi.org/project/dara-core/) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/dara-core.svg?color=dark-green)](https://pypi.org/project/dara-core/) [![NPM](https://img.shields.io/npm/v/@darajs/components.svg?color=dark-green)](https://www.npmjs.com/package/@darajs/components)

### 在 Python 中构建决定应用程序

_通过将数据转换成交互式图表和应用,进入因果关系的力量_

达拉是一个动态应用框架,旨在轻松地创建交互式网络应用程序,全部在纯Python中. 过去两年来,达拉推动了上百个应用软件的开发,现在被我们的客户和内部团队广泛使用和赞赏!

## 快速启动

要开始与达拉,你可以使用 `create-dara-app` CLI 创建新应用程序的工具.

```bash
pip install create-dara-app
```

您还可以使用 [`pipx`](https://pypa.github.io/pipx/) 在孤立的环境中安装 CLI 工具.

然后只需运行以下命令来创建新的应用程序.

```bash
create-dara-app
```

默认情况下, CLI 会尝试安装您的工程的依赖性 [`uv`](https://docs.astral.sh/uv/) 但会回到 `pip` 若为 `uv` 没有.

工程创建后,可以使用:

```bash
cd my-dara-app

# with uv installation
uv run dara start

# with pip installation make sure to activate the new virtual environment
source .venv/bin/activate
dara start
```

![Dara App](https://github.com/causalens/dara/blob/master/img/components_gallery.png?raw=true)

说明: `pip` 安装用途 [PEP 660号卫星](https://peps.python.org/pep-0660/) `pyproject.toml`\- 需要基于编辑的安装 `pip >= 21.3` 财务报告和审定财务报表 `setuptools >= 64.0.0`。可以使用下列两种方法进行升级:

```bash
python -m pip install --upgrade pip
pip install --user --upgrade setuptools
```

详细情况请看我们 [文档](https://dara.causalens.com/docs/category/build-dara-apps)。 。 。 .

## Dara App 实例

探索一些我们最喜爱的应用——一个很好的开始和了解框架的方法!

| 达拉App | 说明 |
| --- | --- |
| ![Large Language Model](https://github.com/causalens/dara/blob/master/img/llm.png?raw=true) | 演示如何将 LLM 聊天框纳入您的决策应用程序,以理解模型的深刻见解 |
| ![Plot Interactivity](https://github.com/causalens/dara/blob/master/img/plot_interactivity.png?raw=true) | 演示如何让用户能够与地块互动,根据点击、鼠标移动和其他互动触发动作 `Bokeh` 或者说 `Plotly` 地块 |
| ![Graph Editor](https://github.com/causalens/dara/blob/master/img/graph_viewer.png?raw=true) | 演示如何使用 `CausalGraphViewer` 组件以显示您的图表或网络,通过颜色和工具提示自定义显示的信息,并根据用户互动更新页面. |

看看我们 [App 图片库](https://dara.causalens.com/gallery) 为了更多的灵感!

## 仓库介绍

此寄存器覆盖了 Dara 应用程序框架的一党包.

-   `dara-core`: Dara框架的核心,这包括创建应用程序的核心框架代码.
-   `dara-components`: 达拉框架的组成部分.
-   `create-dara-app`: 一个用于创建新的 Dara 应用程序的 CLI 工具.

以及支持的UI软件包和工具.

-   `eslint-config` - 共享的ESLint配置
-   `oxfmt-config` - 共享 Oxfmt 配置
-   `oxlint-config` - 共享 Oxlint 配置
-   `stylelint-config` - 基础样式林配置
-   `styled-components` - 样式 - 组件主题
-   `ui-causal-graph-editor` - 因果图编辑器组件
-   `ui-code-editor` - 代码编辑器组件
-   `ui-components` - 基本UI组件
-   `ui-hierarchy-viewer` - 等级查看器组件
-   `ui-icons` - 达拉包的图标组件
-   `ui-notifications` - 通知内容
-   `ui-utils` - 杂项公用事业职能
-   `ui-widgets` - 部件组件

关于存储器结构的更多信息,请访问 [捐款额](https://github.com/causalens/dara/blob/master/CONTRIBUTING.md) 文档.

## 许可证

Dara是开源的,根据 [Apache 2.0 许可证](https://github.com/causalens/dara/blob/master/LICENSE)。 。 。 .

## 常见问题

### @darajs/core 是什么？

达拉框架核心

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

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

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

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

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

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

### @darajs/core 需要什么版本的 Node\.js？

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

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

@darajs/core 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

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

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

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

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