# @g1cloud/entity-modeler-next 中文文档

规范地址：https://npmcn.com/package/%40g1cloud/entity-modeler-next/

版本：5\.5\.4
npm 元数据更新时间：2026-11-12T04:13:56.107Z
中文译文更新时间：2026-11-15T20:08:29.230Z
软件包许可：LicenseRef-LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40g1cloud/entity-modeler-next
原文对照：https://npmcn.com/package/%40g1cloud/entity-modeler-next/?lang=original

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

- 包体积（解压后）：3 MB，142 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>= 24\.10\.0
- 运行依赖：4 个
- peer 依赖：vue ^3\.5\.0，@g1cloud/bluesea \>=5\.0\.0-beta\.31 \<6\.0\.0
- 首次发布：2026-06-30T05:23:47.633Z
- 最新版本发布：2026-11-12T04:13:55.924Z
- 近 30 天下载量：3064（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：165（近 12 个月 165 个）

## 中文简介

Vue 3 视觉实体建模/ 类图表编辑器

## 安装

```sh
npm install @g1cloud/entity-modeler-next
```

也可以使用：`pnpm add @g1cloud/entity-modeler-next`、`yarn add @g1cloud/entity-modeler-next`、`bun add @g1cloud/entity-modeler-next`

## README

# 下一个实体建模

Vue 3 视觉实体-建模 / class-diagram 编辑器. 以图书包形式分发( U)`@g1cloud/entity-modeler-next`并嵌入其中 `bluework4-tool` (纳克特语/Vue/蒙戈语).

## 堆栈

类型脚本 ^ Vue 3 → **Vue 流量** · Pinia (opt-in) · Vite (图书馆模式) · Vitest · 以 `@g1cloud/open-bluesea-core` (BS)组件

## 安装

```bash
pnpm add @g1cloud/entity-modeler-next
```

需要同伴的依赖关系 `vue ^3.5.0` 财务报告和审定财务报表 `@g1cloud/bluesea` `>=5.0.0-beta.31 <6.0.0` (由主机安装).

## 使用量

```ts
import { EntityModeler } from '@g1cloud/entity-modeler-next'
import '@g1cloud/entity-modeler-next/style.css'  // required — components render unstyled without it
```

## 结构

```
src/
  core/      logical/layout types (separated) · resolve (consistency) · routing · autolayout · propagation · validation · type catalogs. Framework-agnostic
  command/   Command (do/undo) · CommandStack · op/opSync (semantic op emit + CAS concurrency)
  editor/    reactive controller (composable wrapping CommandStack, EDITOR inject key) + axis modules split out of it
             (commandPlans · clipboardImport · hostSync · selection — each takes a minimal injected context)
  view/      Vue Flow components (DiagramCanvas · EntityNode · GroupNode · AssociationEdge · PropertyPanel · ValidationPanel, etc.)
             plus composables (useAttributeEditing · useResizableWidth · useTreeCollapse) and pure helpers
  adapter/   storage-schema mapping (persisted v1/v2 · fromPersisted/toPersisted/toPersistedV2 round-trip)
  agent/     natural-language → op track (symbolicOp · resolver · schema · buildAgentBatch)
  dev/       demo harness (excluded from the library build)
```

核心设计: **布局引用逻辑模型 `modelId` (单向)**。逻辑模型没有地理/出行点/类型.

## 脚本

```bash
pnpm dev            # demo harness dev server (src/dev)
pnpm test           # Vitest (unit)
pnpm test:coverage  # Vitest + v8 coverage report (no threshold — report only)
pnpm typecheck      # vue-tsc --noEmit
pnpm build          # library build (dist/)
pnpm verify         # headless GUI probe suite (scripts/verify-*.mjs) — boots the dev harness once, runs all probes
pnpm verify:floor    # raise the per-probe assertion-count floor to current (never lowers)
pnpm check          # CI gate: test && build
```

`check` 是CI的切入点; `verify` 运行浏览器并保持分离,因为它需要一个 dev 服务器并使用~100s.

`verify` 还执行每个检测器 **实数底数** (单位:千美元)`scripts/probe-assertion-floor.json`探测器 即使剩下的每个断言都通过——删除 `ok()` 否则也会缩小分母,然后通过 `0/0`添加断言不需要记账 刻意减少需要用手编辑JSON,而diff是审查信号.

## 常见问题

### @g1cloud/entity-modeler-next 是什么？

Vue 3 视觉实体建模/ 类图表编辑器

### 如何安装 @g1cloud/entity-modeler-next？

在项目目录运行 npm install @g1cloud/entity-modeler-next，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vue（^3\.5\.0）、@g1cloud/bluesea（\>=5\.0\.0-beta\.31 \<6\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @g1cloud/entity-modeler-next 支持 TypeScript 吗？

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

### @g1cloud/entity-modeler-next 支持 ESM 还是 CommonJS？

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

### @g1cloud/entity-modeler-next 需要什么版本的 Node\.js？

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

### @g1cloud/entity-modeler-next 可以商用吗？

@g1cloud/entity-modeler-next 使用 LicenseRef-LICENSE 许可。声明的许可为 LicenseRef-LICENSE，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @g1cloud/entity-modeler-next 的下载量有多少？

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

### @g1cloud/entity-modeler-next 还在维护吗？

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