# @bluemarble/bi 中文文档

规范地址：https://npmcn.com/package/%40bluemarble/bi/

版本：0\.9\.6
npm 元数据更新时间：2026-11-06T19:27:11.001Z
中文译文更新时间：2026-11-08T08:49:07.194Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40bluemarble/bi
原文对照：https://npmcn.com/package/%40bluemarble/bi/?lang=original
项目主页：https://github.com/bluemarble-network/bm-bi#readme
源码仓库：https://github.com/bluemarble-network/bm-bi

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

- 包体积（解压后）：1.7 MB，24 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：react ^19，recharts ^3，react-dom ^19，@mui/material ^7
- 首次发布：2026-10-14T14:08:40.849Z
- 最新版本发布：2026-11-06T19:27:10.832Z
- 近 30 天下载量：3428（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：33（近 12 个月 33 个）

## 中文简介

Camada semântica (定型模型) + 仪表板组件 e devotols para substitir o Power BI

## 安装

```sh
npm install @bluemarble/bi
```

也可以使用：`pnpm add @bluemarble/bi`、`yarn add @bluemarble/bi`、`bun add @bluemarble/bi`

## README

# bm-bi (中文(简体) )`@bluemarble/bi`(中文(简体) )

Camada semântica para 仪表板 em React, no lugar do Power BI: o modelo (tabelas, p, (原始内容存档于2018-09-29) (中文(简体) ). relacionamentos, dineses e medidas). . . . `defineModel`), o servidor compila作为 sQL(MySQL/MariaDB) e os 组件 filtro e gráfico compaream o modelo pelo 没有 Vem com um devtools (diagrama do modelo,编辑器去布局,操场, reversionão).

```ts
import { defineModel, formula, sum } from '@bluemarble/bi/server'

export const vendas = defineModel({
  name: 'vendas',
  tables: {
    pedidos: { key: 'id', sql: 'SELECT id, loja, criado_em FROM pedidos' },
    itens: { sql: 'SELECT pedido_id, valor FROM itens' }
  },
  relationships: [{ from: 'itens.pedido_id', to: 'pedidos.id' }],
  dimensions: { loja: { sql: 'pedidos.loja', type: 'string' } },
  measures: { valor: sum('itens.valor', { format: 'currency' }) }
})
```

| 导入 | 奥德·罗达 |
| --- | --- |
| `@bluemarble/bi/server` | 无侍从 |
| `@bluemarble/bi/client` | 浏览器 |
| `@bluemarble/bi/types` | 蓝宝 |

```bash
npm install @bluemarble/bi   # peer: react 19, @mui/material 7, recharts 3
```

无 npm já compilado (英语)`dist/`,无害环境管理+ `.d.ts`(原始内容存档于2018-03-26) (中文(简体) ). sem precisar de `transpilePackages`。 。 。 . Conceitos, API, devtools e Configuração do app estão em 互联网档案馆的存檔,存档日期2013-12-20 [`docs/dashboard-substituicao-powerbi.md`](https://npmcn.com/package/%40bluemarble/bi/docs/dashboard-substituicao-powerbi.md)。 。 。 .

## 德森沃尔维门托

Projeto Vite+ com bun. 中国植物物种信息数据库.

```bash
vp install        # dependências
vp test           # testes (vitest, sem banco)
vp run typecheck  # tsc
vp check          # formatação (oxfmt) + lint (oxlint)
vp run playground # dashboard + devtools em http://localhost:5180 (precisa do .env)
```

### 游戏场

`playground/` {\\fn华文楷体\\fs20\\bord1\\shad1\\1cHE0E0E0\\2cH000000}"相去不遠" `src/` (通过) (原始内容存档于2018-07-21). Pelo app. O 端点 `/api/dashboard/query` (原始内容存档于2013-10-12) (英语). roda no próprio servido do Vite e conferencea o MySQL do `DATABASE_URL` 对 `.env` na raiz (模范 em) `.env.example`页:1 `.env` não é versionado). 维基百科中的相关条目: 维基语录链接:名人名言.

-   `playground/models/` 建模者(`defineModel`), registrados em (英语) `models/index.ts`· ;
-   `playground/layouts/` ——布局为JSON dos gráficos/膜;
-   `playground/dashboards.ts` ——lista do seletor no topo(模型+布局+filtros iniciais) e格式化器.

O “Salvar no arquivo” 写道: `vp fmt`eos快照vão 段 次 页 次 `playground/snapshots/`Mudanças em modelos valem na conserva seguinte, sem reiciar. 中国植物物种信息数据库.

### 测试无 app antes de publicar

使用 versão 本地纳姆应用程序( 例如: o) `custo` 对 `rocha-pr`)),支持依附者(esta) 面条(`"@bluemarble/bi": "file:../../../bm-bi"` + 键 `npm install`e deixe (中文(简体) ) `vp run dev` 罗干多 (单位:千美元)`vp pack --watch`: o app lêo `dist/`. com o 链接, o 下个 pricisa de `turbopack.root` 电子 `turbopack.resolveAlias` - 欧 `next.config.js` 对 `custo` 丽加是sozinho quando 探测连接.

## 宣传

```bash
vp run verify     # o mesmo que o CI roda: check, typecheck, testes e build
vp run release    # bumpp: escolhe a versão, commita, cria a tag vX.Y.Z e faz push
```

标签解码 `.github/workflows/publish.yml`标记 x `package.json`,罗达o `verify` 电子 公共通讯 `bun publish` (非公开) `NPM_TOKEN`) (中文(简体) ). Depois, 没有应用程序 : `npm install @bluemarble/bi@X.Y.Z`。 。 。 .

## 常见问题

### @bluemarble/bi 是什么？

Camada semântica \(定型模型\) \+ 仪表板组件 e devotols para substitir o Power BI

### 如何安装 @bluemarble/bi？

在项目目录运行 npm install @bluemarble/bi，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19）、recharts（^3）、react-dom（^19）、@mui/material（^7）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 bm-bi，可以用 npx bm-bi 直接运行。

### @bluemarble/bi 支持 TypeScript 吗？

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

### @bluemarble/bi 支持 ESM 还是 CommonJS？

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

### @bluemarble/bi 可以商用吗？

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

### @bluemarble/bi 的下载量有多少？

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

### @bluemarble/bi 还在维护吗？

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