# @hatiolab/figure-model 中文文档

规范地址：https://npmcn.com/package/%40hatiolab/figure-model/

版本：0\.12\.15
npm 元数据更新时间：2026-11-16T08:55:35.587Z
中文译文更新时间：2026-11-17T11:51:56.170Z
软件包许可：UNLICENSED

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

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

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

- 包体积（解压后）：1.6 MB，166 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-09-04T14:41:41.790Z
- 最新版本发布：2026-11-16T08:55:35.377Z
- 近 30 天下载量：16758（2026-10-18 至 2026-11-16，npm 官方下载统计）
- 已发布版本数：164（近 12 个月 164 个）

## 中文简介

图文格式(图-资产-1):一个从所申报的关系来评价一个图的内核,作者命令一个建模者和一个AI共享,释放门和分数.

## 安装

```sh
npm install @hatiolab/figure-model
```

也可以使用：`pnpm add @hatiolab/figure-model`、`yarn add @hatiolab/figure-model`、`bun add @hatiolab/figure-model`

## README

# @hatiolab/图型

> 执行情况和核查情况: [文档/状态.md](https://npmcn.com/package/%40hatiolab/figure-model/docs/status.md)。 。 。 .

图格式, `figure-asset-1`:它的内核,编写命令,放出门,分数和AI建议 语法. 没有运行时间依赖 .

包裹内没有渲染器. 模特儿的作者 服务器的判断和存储 以及现场 取自其所编集.

运行时间 LOD : [ADR-0116 (英语)](https://npmcn.com/package/%40hatiolab/operato-application/adr/ADR-0116.md). 实施只显示视图的帮助器;相机选择和GPU资源属于事物-scene.

## 解决的是什么

它移动了添加组件 **从开发到编写**新型设备应为数据文件, 不是开发者写、构建和部署的类。 这需要三件事同时:

|  | 条件 |
| --- | --- |
| 1个 | **表达式** ——可以用代码书写的形状可以作为数据书写 |
| 2个 | **同等业绩** ——从数据中提取与绘制硬码几何一样快 |
| 3个 | **现场直播** - 事件、动画和数据绑定附件,而不仅仅是形状 |

一个图是 **大小、外观和状态为打字表达式的已命名部分的图表** 实例大小 国家投入。 名字是让装订者说"把灯彩绑到温度"或"开门"的.

## 使用

```sh
npm install @hatiolab/figure-model
```

所有东西都从包根导出.

```ts
import { parseFigureAsset, compileFigureAsset, inspectFigureAsset, figureScoreOf } from '@hatiolab/figure-model'
```

## 主要出口

| 区域 | 出口 |
| --- | --- |
| 资产文件 | `parseFigureAsset`, (中文(简体) ), `serializeFigureAsset`, (中文(简体) ), `compileFigureAsset`, (中文(简体) ), `captureFigureAuthoredInputs`; 从 `asset-types.ts`, (中文(简体) ), `FIGURE_PLACEMENTS` |
| 内核( 类型图) | `compileFigureGraph`, (中文(简体) ), `FIGURE_OPERATORS`, (中文(简体) ), `FIGURE_NON_AFFINE_OPERATORS`, (中文(简体) ), `FIGURE_STATE_NON_AFFINE_OPERATORS`, (中文(简体) ), `FIGURE_OPERATOR_STATE_POLICY`, (中文(简体) ), `figureShapeFaces`, (中文(简体) ), `FIGURE_KERNEL_VERSION`, (中文(简体) ), `FIGURE_FACE_NORMALS`; 图表类型 (`FigureGraph`, (中文(简体) ), `FigureCompiledGraph`, (...) (中文(简体) ) |
| 实例大小 | `FIGURE_INSTANCE_SIZE_INPUTS`, (中文(简体) ), `figureInstanceSizeRangeOf`, (中文(简体) ), `figureInstanceSizeLimitsOf`, (中文(简体) ), `recordFigureInstanceSize`, (中文(简体) ), `forgetRecordedInstanceSize`, (中文(简体) ), `fitNarrowedInstanceSize`, (中文(简体) ), `figureSizeRangeFitsOf` |
| 动议和状态 | `driverValue`, (中文(简体) ), `driverStates`, (中文(简体) ), `normalisePhase`, (中文(简体) ), `validateFigureDrivers`, (中文(简体) ), `validateFigureStateInputs`, (中文(简体) ), `advanceStateValue`, (中文(简体) ), `stateInputPolicy` |
| 写入命令 | `createFigureAsset`, (中文(简体) ), `addFigureBox`, (中文(简体) ), `addFigurePrimitive`, (中文(简体) ), `editFigurePart`, (中文(简体) ), `applyFigureAuthoring`, (中文(简体) ), `proposeFigureOccupancy`, (中文(简体) ), `proposeFigureProportion`, (中文(简体) ), `checkFigureJoints`, (中文(简体) ), `figureAttachmentsOf`, (中文(简体) ), `figureBindingsOf` |
| 编辑工作空间 | `createFigureEditorWorkspace` |
| 释放门 | `inspectFigureAsset`, (中文(简体) ), `FIGURE_INSPECT_LIMITS`, (中文(简体) ), `figureWorldBoxesOf`, (中文(简体) ), `figureOccupiedBoxesOf`, (中文(简体) ), `figureWritersOf`, (中文(简体) ), `figurePartsExtentOf`, (中文(简体) ), `figureContractChanges` |
| 得分和费用 | `figureScoreOf`, (中文(简体) ), `figureGradeOf`, (中文(简体) ), `figurePartCountOf`, (中文(简体) ), `figurePartBudgetOf`, (中文(简体) ), `figureCostOf`, (中文(简体) ), `figureTrianglesOf` |
| 运行时间切换 | `figureRenderViewOf`, (中文(简体) ), `figureRenderSegmentsOf`, (中文(简体) ), `FigureRenderLevel`;源评价、检查和分数仍为满分 |
| 大赦国际建议语法 | `applyFigureProposal`, (中文(简体) ), `FIGURE_PROPOSAL_GRAMMAR`, (中文(简体) ), `FIGURE_PROPOSAL_KINDS` |
| 能力和文件 | `compileFigureCapabilities`, (中文(简体) ), `compileFigureDocument`, (中文(简体) ), `parseFigureDocument`, (中文(简体) ), `serializeFigureDocument` |
| JSON 输入边界 | `parseFigureJson`, (中文(简体) ), `assertFigureJson`, (中文(简体) ), `FIGURE_JSON_MAX_BYTES`, (中文(简体) ), `FIGURE_JSON_MAX_DEPTH`, (中文(简体) ), `FigureContractError` |
| 共用词 | `AXES`, (中文(简体) ), `FIGURE_CAPABILITIES`, (中文(简体) ), `MATERIAL_PRESETS`, (中文(简体) ), `SEGMENT_PRESETS`, (中文(简体) ), `DETAIL_LEVELS`, (中文(简体) ), `PART_LIMIT`, (中文(简体) ), `LIMITS`, (.....`words.ts`(中文(简体) ) |
| 示例 | `robotArmFigure`, (中文(简体) ), `ROBOT_ARM_CHAIN` |

输入预览、修订检查和撤销/重做通过 `createFigureEditorWorkspace`。 。 。 . 独立 `createFigureAuthoringSession` API已删除; 输入编辑请求类型仍然从包根导出 .

## 评价结果:谁拥有什么

| 打电话 | 打电话的人得到什么 |
| --- | --- |
| `plan.evaluate(inputs)` - 整体评价`compileFigureGraph`, (中文(简体) ), `compileFigureDocument`, (中文(简体) ), `compileFigureAsset(...).evaluate`(中文(简体) ) | 什么都没有 里面的一切都是打电话者自己的,要保持或写入. 类型 `FigureGraphEvaluation`, (中文(简体) ), `FigureCapabilityEvaluation`。 。 。 . |
| `plan.evaluator().evaluate(inputs)`,则 `advance` 评估 | 一个快照。 这个 `values` 记录和记录 `geometry` (和 `bindings`清单是打电话者自己的;其中的所有价值和身体被冻结(`Object.freeze`),并作为同一项对象,在不改变的情况下,将后期结果上交. 一个写成一个扔 `TypeError` 却一无所获 类型 `FigureInstanceEvaluation`, (中文(简体) ), `FigureCapabilityInstanceEvaluation`,其内容为: `FigureFrozen<…>` (深处) `readonly`) (中文(简体) ). |
| `advance(inputs)` 采取姿势步骤(`kind: 'poses'`(中文(简体) ) | 没有快照. `bodies` 财务报告和审定财务报表 `poses` 是打电话者自己的副本. `read(ref)` 财务报告和审定财务报表 `changed(ref)` 调查评估人员,并只在下一次打电话之前作出答复(`evaluate` 或者说 `advance`或拒绝,或拒绝,然后他们抛出 `FigureContractError` `STEP_EXPIRED`。 何谓 `read` 返回被冻结. |

编译、序列化和剖析拒绝相同的资产: `compileFigureAsset` 对照节点检查联合记录 他们制造(`JOINT_SCHEMA`, (中文(简体) ), `JOINT_DRIFT`),作为 `parseFigureAsset` 已经. `compileFigureGraph` 保持其大小限制 本身;字节和节点限制属于文档和资产入口. `inspectFigureAsset` 拒绝设置 无法运行( n)`INSPECT_OPTION`),并运行的州比 `FIGURE_INSPECT_LIMITS.maxStates` (单位:千美元)`INSPECT_BUDGET`, (中文(简体) ), 在它评估任何东西之前.

## 图标

```
npm test               type check, source tests, then maintained prototype tests
npm run test:coverage  coverage (thresholds: lines 97% · branches 90% · functions 96%)
npm run test:prototypes  maintained prototype tests (30 tests in three files)
npm run check          type check (source tests included)
npm run build          build to dist (tests excluded)
npm run format         format sources and docs
```

## 所需资源

|  |  |
| --- | --- |
| 消费者 | 节点20或后. 只有无害环境管理;没有通用JS产出. |
| 发展 | 节点22.6或后- `npm test` 直接运行 TypeScript(类型剥离). |

没有 `enum`:节点类型条法不能运行需要代码生成的语法.

没有运行时间依赖性;它在浏览器中运行不变. 三大相互依存关系`typescript`, (中文(简体) ), `@types/node`, (中文(简体) ), `prettier`)不属于 `dist`。 。 。 .

## 文档

-   [设计.md](https://npmcn.com/package/%40hatiolab/figure-model/docs/design.md) 设计及其原因
-   [核心语义. md](https://npmcn.com/package/%40hatiolab/figure-model/docs/core-semantics.md) ——内核的核心语义
-   [形状-分配-合同.md](https://npmcn.com/package/%40hatiolab/figure-model/docs/shape-dimension-contract.md) - 形状维度及其如何应对大小
-   [空间合同](https://npmcn.com/package/%40hatiolab/figure-model/docs/spatial-contracts.md) ——空间合同
-   [动议合同](https://npmcn.com/package/%40hatiolab/figure-model/docs/motion-contract.md) 联合企业、国家投入和驱动因素
-   [资产-持久性.md](https://npmcn.com/package/%40hatiolab/figure-model/docs/asset-persistence.md) - 存储的资产文件
-   [作者- 交易](https://npmcn.com/package/%40hatiolab/figure-model/docs/authoring-transactions.md) ——编写命令
-   [能力约束](https://npmcn.com/package/%40hatiolab/figure-model/docs/capability-bindings.md) ——能力约束
-   [状态.md](https://npmcn.com/package/%40hatiolab/figure-model/docs/status.md) 执行和核查状况

## 常见问题

### @hatiolab/figure-model 是什么？

图文格式\(图-资产-1\):一个从所申报的关系来评价一个图的内核,作者命令一个建模者和一个AI共享,释放门和分数\.

### 如何安装 @hatiolab/figure-model？

在项目目录运行 npm install @hatiolab/figure-model，或使用 pnpm add / yarn add / bun add。

### @hatiolab/figure-model 支持 TypeScript 吗？

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

### @hatiolab/figure-model 支持 ESM 还是 CommonJS？

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

### @hatiolab/figure-model 需要什么版本的 Node\.js？

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

### @hatiolab/figure-model 可以商用吗？

@hatiolab/figure-model 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @hatiolab/figure-model 的下载量有多少？

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

### @hatiolab/figure-model 还在维护吗？

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

