@g1cloud/entity-modeler-next

中文文档
5.5.4发布于 2026/11/12LicenseRef-LICENSETypeScriptESM + CJS近 30 天下载 3064

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

中文使用文档
文档目录5 节
  1. 堆栈
  2. 安装
  3. 使用量
  4. 结构
  5. 脚本

下一个实体建模

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)组件

安装

pnpm add @g1cloud/entity-modeler-next

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

使用量

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 (单向)。逻辑模型没有地理/出行点/类型.

脚本

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 共发布 165 个版本,首次发布于 2026/06/30;过去 12 个月发布了 165 个版本。

版本发布日期距今
5.5.4latest2026/11/123 天前
5.5.32026/11/123 天前
5.5.22026/11/114 天前
5.5.12026/11/078 天前
5.5.02026/11/069 天前
5.4.02026/11/0510 天前

其他发布通道:alpha → 5.0.0-alpha.27,beta → 5.0.0-beta.53。

关于 @g1cloud/entity-modeler-next 的常见问题

@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 和提交记录判断。