# @graview/core 中文文档

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

版本：0\.2\.5
npm 元数据更新时间：2026-11-16T13:19:11.719Z
中文译文更新时间：2026-11-17T00:56:23.363Z
软件包许可：Elastic-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40graview/core
原文对照：https://npmcn.com/package/%40graview/core/?lang=original
项目主页：https://graview.dev/docs/packages/core.html
源码仓库：https://github.com/en-dash-consulting/graview

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

- 包体积（解压后）：9.4 MB，1752 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.22\.0
- 运行依赖：1 个
- peer 依赖：better-sqlite3 \*
- 首次发布：2026-10-02T04:43:02.644Z
- 最新版本发布：2026-11-16T13:19:11.300Z
- 近 30 天下载量：14188（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：77（近 12 个月 77 个）

## 中文简介

图經所出,木通所出,通取所出之计与验. 所有Graview的应用软件都宣布了 并且CLI验证了它.

## 安装

```sh
npm install @graview/core
```

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

## README

# @ graview/ 核心

所有Graview的应用程序都宣布了 以及核实它的验收员.

-   **司马** —— 说 `defineNode` 财务报告和审定财务报表 `createSchema`. Zod 是唯一一个来源 运行时间验证, TypeScript 类型和 JSON Schema.
-   **图** ——节点和边缘,有跟踪读取器,故有突变记录 读的和写的一样.
-   **变异** —— 说 `defineMutation`。每个变化都是打字,命名, 可贬低的行为;没有东西直接写出图表。 每一种都有一个 来源 `edit-<kind>` 提供土地,没有其他行为。 每个行为 拒绝它不需要的论据, 命名它做的, 和行为 按要求拒绝 `ActRefusal` 谁 `reason` 财务报告和审定财务报表 `sentence` 主机可以显示( o)`refusalOf` 读为一: `refused` 当行为本身的规则说不, `invalid` 以发送的呼叫.
-   **变化因素** 用来判断图 并命名突变的规则 会修复它们。 这个名字是接缝 得到的付得起.
-   **运行日志** - 图表是折叠的 作者、意图、阅读和 写在每个操作上, 这使得选择取消依赖性 问题而不是堆叠.
-   **权限** a 包括: `Principal` 是一个 `Author` 有角色,所以什么日志 责任是政策判断的.
-   **文件** - 记录有照片、录像或主持人的文件 储存(`imageField`, (中文(简体) ), `videoField`, (中文(简体) ), `fileField`· ; `"image"`, (中文(简体) ), `"video"` 财务报告和审定财务报表 `"file"` 文件和任何清单:a `FileValue`页:1 `href` (单位:千美元) 在主机上的路径,通过页面上传 `HostFiles` 并绘制在 服务于它的主机`fileSrc`) (中文(简体) ). 一个视频的价值可以说是它的 `poster`页:1 `duration` 以秒计及其 `captions` (主机上的WebVTT文件),以及 被说成"45秒的视频"(a 45-second video)`videoWords`) (中文(简体) ).
-   **主题** ——代币合同,两个发运的调色板,以及对比 测试器,测量一个品牌的调色板 之前它飞来。 其余部分 看看旁边的数据.. `SHAPE`, (中文(简体) ), `TYPOGRAPHY` 财务报告和审定财务报表 `isoShade(scheme)`, (中文(简体) ), 解决品牌问题 `shapeOf` 财务报告和审定财务报表 `typographyOf` - 外面的一页 应用程序可以在不导入样式表的情况下装扮成一个。 一个文件 品牌也持有其余部分(FR-124): 以 `svgProblem` 财务报告和审定财务报表 `markProblem` 和Graview Cloud一样 图像; 取自 `SYSTEM_STACKS`,系统本身和 `DOCUMENT_FONTS`,由 `fontProblem`; 和不会 按给定读取被拒绝 `accentProblem` 与对子,其比例和 a 阴影会过去(FR-126)。 Graview自己的身份(设计包, 修订 03 也是数据, 并且只能通过这些默认 : `GRAVIEW_COLORS` (En Dash海军和绿地,纸张,读取墨水,哑音) 文本中, `GRAVIEW_FACE` 财务报告和审定财务报表 `WEIGHTS` (蒙特塞拉特550、450和600号,命名为 先进 `TYPOGRAPHY` 而不曾获得, `LOGO_RULES`,则 共享平面符号作为内含当前Color SVG(`graviewSymbol`, (中文(简体) ), 28 px 下的微切数 `symbolCut`) (中文(简体) ). 已运出调色板已建 上面写着:绿松石既不是圆的,也不是圆的.
-   **`graview check`** - 阅读一份宣言并报告其问题, 说到代理人可以采取行动 密码是 `@graview/core/check`数字 : `checkApp`, (中文(简体) ), `describeApp`,代理文件(`generateLlmsTxt`),以及 `compileDocument`,编辑并检查文档.
-   **文档** —— 说 `@graview/core/document`整个应用作为一个JSON对象, 汇编者 `compileDocumentWithoutCheck` 输入同一个应用程序 `defineApp` 声明并永远不要以代码运行( q)`compileDocument` 从 `@graview/core/check` 并询问检查器; `toDocument` 写入应用程序 回来。 规则说必须用小的 预算语言 (单位:千美元)`expressionRule`) (中文(简体) ). 每一个进入命令都会有 `--document <file>`视图的块 `@graview/core/blocks`。 。 。 . 一个数字字段可能表示其范围(`min`, (中文(简体) ), `max`, (中文(简体) ), `step`——这是每种形式的, 工具并应用荣誉 `connects` 链接 它的主体是, `replaces` 断开它所取代的链接,并将记录设置在 其它端(它的"setsOther"密钥),它的"setsLinked"密钥带有更改 记录其主体已经通过关系链接,由 每个远处的记录都是自己编辑的. `editDocument`, (中文(简体) ), `diffDocuments` 财务报告和审定财务报表 `planMigration` 更改文档, 并说更改要存储什么 数据. 在服务器上编译文档的主机 `serializeCompiled(compiled)`,该页面用 `appFrom` 或者说 `appFromOrCompile` 从 `@graview/core/compiled`,哪个 包含没有编译器(格式为 `graview-compiled@1`) (中文(简体) ).
-   **用于编辑器和编译器的文档形状** - 每个版本 船舶 `@graview/core/document.schema.json`,文档格式为 JSON Schema,由编译器读取的形状所写的构造. A 类 显示的文档 `"$schema": "./node_modules/@graview/core/dist/document.schema.json"` (或该版本自己的地址,其 `$id`)在输入时被选中:a 在编辑器中下划线为未知密钥,运行时不会拒绝. `@graview/core/typed` typeScript 中的文档为: `defineDocument` 返回 JSON 文档,格式没有的密钥, 一种的边缘,没有人 宣布,一目了然 或生命周期野外这种 缺少,关系 某行为连接 或某类规则是没有 已声明为类型错误. `graview types <document> --out document.d.ts` 写文档的种类、字段(一个enum作为工会的选择)和 关系作为类型, `TypesOf<typeof document>` 来源于 `defineDocument`,以及 `typedReader<Types>(store)` 读取商店通过 (单位:千美元)`reader.fieldOf(node, "status")`, (中文(简体) ), `reader.edgesOf(node, "under")` 因此,重新命名的字段或关系失败 `tsc` 在产品中 读它.
-   **再次尝试的部分** —— 说 `@graview/core/retry`,仅限一页: `retryingImport(() => import("./part.js"))` 是一个装填器,再次询问 导入失败后, 使用自己的 URL ()`?retry=<n>`在其中 引擎为页面保留一个失败的模块, 如 Chromium 和 Firefox 来 从未从服务器的代码中找到 : 以计算方式拒绝脚本 `import()` 进去.
-   **一个快照文件** —— 说 `@graview/core/snapshot`数字 : `writeSnapshot(graph)` 写一行标题( 当它被制作时, 记录和各种链接, 其中 每个种类的行是),然后每行记录; `readSnapshot(text, { kinds })` 只描述所要求的各种事物, `fetchSnapshot(url, { kinds })` 只取他们的字节和一个旧的 `{ nodes, edges }` 文件仍然读取.
-   **双向同步** —— 说 `@graview/core/sync`数字 : `SyncEngine` 在行动日志上 冲突政策`report`, (中文(简体) ), `theirs`, (中文(简体) ), `ours`),资源自有 (单位:千美元)`readonly`拒绝在这里与他们的 `because`),链接的种子来自 a 版本字段,以及 Google 日历和工具服务器的传输 超过 MCP(`mcpClient`, (中文(简体) ), `mcpDoor`, (中文(简体) ), `doorClient`, (中文(简体) ), `mcpRemote`) (中文(简体) ). 谷歌主题 传送跟随每个页面, 当 Google 拒绝时启动完整的再同步 同步符号,并询问 `token({ refresh: true })` 谷歌时一次 拒绝访问符; `scripts/verify-google-calendar.mjs` 证明一下 对照真实测试日历(证书来自 `~/.graview-google-test.env`,一次由 `scripts/google-calendar-once.mjs`· ; `scripts/calendar-sync-demo.mjs` 实值 也一样。 名称数据库也是一种传送(`notion`: 一个 数据库,一种类型,按名称或已申报,由 `last_edited_time` 在查询、制作、设置和 已存档,Notion的利率限制 等待了出来, 一个被拒绝的秘密或一个 未共享数据库作为句子表示; `scriptedNotion()` 是逗号在 用于测试的内存 `scripts/verify-notion.mjs` 证明 实际工作空间的运输(`~/.graview-notion-test.env`· ; `--stub` 以文稿为一). 文档宣布为 `connections.<name>` 日历、其字段和颜色或标记过滤器, 或数据库及其属性; `read` 或者说 `both`冲突政策 - 由 `graview check` 运行于 `graview serve` 财务报告和审定财务报表 `graview preview`· ; `connection(…)` 为任何主机构建引擎.
-   **带入的电子表格** —— 说 `@graview/core/import`数字 : `importRows(store, kind, rows, mapping, { by })` 按字段类型读取每个单元格,链接 a 单元格到其名称的记录中,将每一行保留为可撤销的行 批次 `via: "import"`说每个字都拒绝排行; `previewImport` 什么都没有, `proposeMapping` 提供来自 标题行,以及 `parseCsv` 读取 CSV 或粘贴 (`docs/import.md`) (中文(简体) ).
-   **这个城市** —— 说 `@graview/core/scene`数字 : `sceneThumbnail` 绘制文档 (或一个应用) 当场景从海拔高度引出时—— 相同的区域在 同样的地图,在它们的花色中——作为一个SVG字符串,没有DOM,为主机 列出应用程序; `sceneDistricts` 是和数据相同的答案。 在一张牌上 尺寸, `fit: "content"` 符合现状:每个地区作为一个整体 从同一角划入地块 有几个街区没有 窄于 `minBuilding` 像素( 默认为 16) 而不是每平方厘米 记录。 没有计数——一个没有快照的活应用程序——每个区站 三个街区的设置和 升起的同类的名字, 所以每个应用程序仍然看起来 喜欢自己. `size: "icon"` 绘制为标签图标: 32 乘 32 位于其地块内,有一个地块,可读于16分 像素和大约一千字节——一个独立的SVG作为favicon. 一种类型的 数字是 `@graview/core/figures`。 。 。 .
-   **所描述的、 匹配的和在页后列出的** (FR-179) - (法语) `@graview/core/search`:唯一匹配者(`search`, (中文(简体) ), `actsOn`, (中文(简体) ), `touchWeights`, (中文(简体) ), `parseQuery`, (中文(简体) ), `matchNode`),在先有人时获取 搜索 . `@graview/core/words`:记录读为个人阅读 (单位:千美元)`readableFields`, (中文(简体) ), `pageSections`, (中文(简体) ), `isLongText`, (中文(简体) ), `describeNode`, (中文(简体) ), `tellApart`),一个论点要求什么(`argShape`, (中文(简体) ), `describeArg`页:1 辩词和记录中的拒绝`argumentWords`, (中文(简体) ), `failureWords`和 `viaSaid`。 。 。 . `@graview/core/seat`:一个行为的答案是: 它的座位可能看见它`answerSeenBy`),撤销地平线后的归档 因为它是一个席位可能看到它(`archivedSeenBy`,一个宿主的 `HistoryHost.archived` 回答,应用程序的每一个地方(`placesOf`, (中文(简体) ), `placesFrom`)和顺序 东西是制作在(`beginning`) (中文(简体) ). 判断 安排`arrangementFindings`)为 `@graview/core/check`对.
-   **何等一页装入第一** —— 说 `@graview/core` 财务报告和审定财务报表 `@graview/core/document` 只保留一个页面的画。 检查者,城市,数字和 块解析器位于上面的子路径上,因为一个捆绑器放置了一个 每一个块中的全部模块可以到达它: 主机页面导入两者 在取出面孔之前.
-   **一个视图的CSS,作为浏览器读取** —— 说 `@graview/core/css`,没有 页面: CSS 标语和解析器, 以及消毒器 (单位:千美元)`sanitizeStylesheet`, (中文(简体) ), `sanitizeStylesheets`, (中文(简体) ), `sanitizeDeclarations`, (中文(简体) ), `sanitizeValue`),只保留样式表,只保留打开工具包允许的样式表 ——表单 `CSS_PROPERTIES`, (中文(简体) ), `CSS_FUNCTIONS`, (中文(简体) ), `CSS_AT_RULES` 编辑 休养, `url(#id)` 单靠一幅画,没什么能取到的 `OPEN_MAX_STYLESHEET` 字符键。 它是框架的一位CSS法官: `@graview/guest` 画一个工人的视图的样式表 通过它,和 检查器为每个视图持有文档自己的样式表 (单位:千美元)`brand.views.css`)到它,所以什么通过是一个页画.
-   **一个地方的地址** —— 说 `addressOf(place, { basePath })` 拼写一个地方 从 `placesOf` 作为路由面链接 它在一个主机的基础路径, `pathWithin` 读回一个地址,和 `basePathOf` 使基地正常化. A 类 `search` 击打说它自己:记录, 同类的列表或地方携带 `address`,用同样的方式拼出 `basePath` 它被赋予,和a 座位只找到记录 它的视线打开.
-   **显示一个设备的屏幕** —— 说 `@graview/core/devices`,无页 一条固定的屏幕沿着它的脚画出条纹(`deviceScreensOf`页:1 声明 `devices.screens`还有家和应用程序的工作 它的栏杆,一个屏幕名称(`screenPlaceOf`),和检查器的 以它不能提供的言语发誓`deviceFindings`页:1 `MOST_DEVICE_SCREENS` 财务报告和审定财务报表 `LONGEST_SCREEN_LABEL`。 。 。 . `@graview/pages/device` 画出它.
-   **遵约** —— 说 `@graview/core/conformance`: 主机运行对齐的固定装置 a 版本 (`conformance()`)证明它读取,编译和得出相同内容.
-   **状态板的动作** —— 说 `@graview/core/describe`数字 : `columnReach` 说 将牌移动到哪个一栏——设置 字段为该列的值,否则一个行为告诉了值——和 `columnMoves` 其中一个席位可能有一个记录,它的条件 判断.
-   **什么声明** —— 说 `@graview/core/compose`,无页 `traitsOf(document | app)` 读取一个声明的特征 在关闭 词汇 `TRAITS` (拥有东西的人, 地位移动,金钱) (......),包括各种类型、领域、规则、镜头和行为 带着它和一句话, 从来没有关闭手写标签; `startingDocument({ base?, drop?, add?, name, purpose? })` 构成a 文档从模板的部件和特性模块,每个模块都加入到 善良的人看到最多, 编集无警告,并说它是什么 从何处取出 `inferJobs` 财务报告和审定财务报表 `composeDesign`,建议 声明的工作和整个设计.

```sh
npx graview create my-app          # a product on Graview, started (also: npm create graview)
npx graview check ./dist/domain/app.js
npx graview docs ./dist/domain/app.js
```

`create` 写入声明分为域和UI,一个外壳,一个无头 测试和一个 CI 工作流程,初始化一个寄存器,安装,并说些什么 接下来做. `--link <path>` 将框架从兄弟会的取出中消耗 路径,而不是一个注册 - 唯一的有效方式,直到软件包 ——并拒绝未构建的框架. 背后的发电机是 `@graview/core/scaffold`,纯函数从一个 名称和文件列表的第一种,用于提供应用程序的主机.

## 常见问题

### @graview/core 是什么？

图經所出,木通所出,通取所出之计与验\. 所有Graview的应用软件都宣布了 并且CLI验证了它\.

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

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

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

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

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

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

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

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

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

@graview/core 使用 Elastic-2\.0 许可。声明的许可为 Elastic-2\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

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

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

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

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

