# @delurio/cli 中文文档

规范地址：https://npmcn.com/package/%40delurio/cli/

版本：0\.6\.1
npm 元数据更新时间：2026-11-11T09:46:35.676Z
中文译文更新时间：2026-11-11T22:00:31.358Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40delurio/cli
原文对照：https://npmcn.com/package/%40delurio/cli/?lang=original
项目主页：https://delur.io/
源码仓库：https://github.com/delurio-labs/delurio

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

- 包体积（解压后）：497 kB，63 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.18
- 运行依赖：4 个
- 首次发布：2026-10-25T01:05:09.658Z
- 最新版本发布：2026-11-11T09:46:35.274Z
- 近 30 天下载量：4220（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

Delurio-graph/0的开页检查器和页面:检查一个工程自己的CI中的每个图,离线,带有GNU出错行和SARIF.

## 安装

```sh
npm install @delurio/cli
```

也可以使用：`pnpm add @delurio/cli`、`yarn add @delurio/cli`、`bun add @delurio/cli`

## README

# 德卢里奥

打开的检查器和页面 **三角图/0**,一种将产品流,屏幕和API写成一个图表的格式,人们用文字来审查,这个图表对照代码来检查,在真实的应用上重放,变成教程. 格式为 [SPEC.md 高频](https://npmcn.com/package/%40delurio/cli/SPEC.md)。 。 。 .

这个软件包是一个项目自己的CI运行的部分:它读取了图表文件,而别无其他内容. 没有网络,没有帐户和模型.

## 安装

运行一次, 不安装 :

```sh
npx @delurio/cli@0.1.1 check graphs --strict
```

或在工程中刻入精确的版本,然后命令是 `delurio`数字 :

```sh
npm install --save-dev --save-exact @delurio/cli
npx delurio check graphs --strict
```

或容器图像,以其文摘为后缀:

```sh
docker run --rm -v "$PWD:/work" -w /work ghcr.io/delurio-labs/delurio@sha256:<digest> check graphs --strict
```

节点22.18或后.

## 检查每个图表

```sh
npx @delurio/cli check graphs --strict
```

-   **调查结果:** 在GNU错误格式中,编译器、编辑器和CI日志各一行读取:
    
    ```
    graphs/billing/billing.payment/flow.yaml:176:7: error: restricted-only-when-retries-ran-out is broken: … [assertion-violated]
    graphs/billing/billing.payment/flow.yaml:176:7: note: start: role = manager, paid = false
    graphs/billing/billing.payment/flow.yaml:176:7: note: step 1: RETRIES_RAN_OUT
    ```
    
-   **萨里夫:** `--format sarif --output delurio.sarif` 写 SARIF 2.1.0 代码扫描。 相同的输入给出了相同的字节.
    
-   **基线:** `--baseline <sarif>` 仅失败自早先运行以来的新错误 .
    

| 退出 | 含义 |
| --- | --- |
| 0 个 | 每个图载, 和下 `--strict` 没事 |
| 1个 | 无法加载图表, 或为比此版本更新的格式撰写 |
| 2个 | 下级 `--strict`:一个保证被打破,目录密钥或样本被丢失,主故事无法行走,写出流没有变化注释. |

## 图一页

```sh
npx @delurio/cli page examples/qauth-authorize --out viz/qauth-authorize
```

页面以文字显示流量:它的主要故事,它的每一道结束,它的保证以及它们是否持有,它的屏幕作为线框,以及它的图表,它打开与窗口相适应并像设计工具的画布一样移动(被拖去移动, Ctrl 或 QQ + 卷轴或被捏去缩放,被Shift+1相适应). `examples/qauth-authorize` 是一个小图来尝试它.

以一个图表的文件夹来代替,它写下每个图表的一页, 每一个在自己的路径,和 `index.html` 列出他们的支票:

```sh
npx @delurio/cli page graphs --out viz
```

## 在编辑器中写入图表

包装了 JSON Schema (2020- 12) 每种图形文件 `schemas/`数字 : `flow`, (中文(简体) ), `ui`, (中文(简体) ), `nav` (另见: `nav.extracted.yaml`, (中文(简体) ), `domain` 财务报告和审定财务报表 `catalog`。用一个编辑器来完成密钥,在悬浮时解释 SPEC.md 的每个密钥,并标出一个打字符,一个错误的值,或者一个标题被内部一个逗号剪接 `{ }`在 VS 代码中,加上YAML 扩展,将此内容插入 `.vscode/settings.json`数字 :

```json
{
  "yaml.schemas": {
    "https://unpkg.com/@delurio/cli@0.2.0/schemas/flow.schema.json": "**/flow.yaml",
    "https://unpkg.com/@delurio/cli@0.2.0/schemas/ui.schema.json": "**/ui.yaml",
    "https://unpkg.com/@delurio/cli@0.2.0/schemas/nav.schema.json": ["**/nav.yaml", "**/nav.extracted.yaml"],
    "https://unpkg.com/@delurio/cli@0.2.0/schemas/domain.schema.json": ["**/domain.yaml", "**/domain/*.yaml"]
  },
  "json.schemas": [
    { "fileMatch": ["**/catalog/*.json"], "url": "https://unpkg.com/@delurio/cli@0.2.0/schemas/catalog.schema.json" }
  ]
}
```

一个域可能会被分割到其目录(SPEC.md §5)的文件; `**/domain/*.yaml` 在命名的目录中覆盖 `domain`,其它文件则在第一行列出其计划: `# yaml-language-server: $schema=<the domain schema's URL>`包装好了, `./node_modules/@delurio/cli/schemas/<kind>.schema.json` 同样的工作,离线. `check` 报告与编辑相同,作为规则错误 `schema` 失败 `--strict`,并找到一个计划无法看到的东西,例如不存在的状态或缺失的目录密钥.

在编辑器旁边,保持页面的开放和当前:

```sh
npx @delurio/cli page graphs --serve      # http://127.0.0.1:4600/, written again and reloaded on every save
```

`--watch` 在每一处更改上重新写出页面而不为它们服务. `--serve` 仅收听 127. 0.0.1 , 并服务于已写入的页面和其它任何内容; 当保存留下无法加载的图表时, 打开的页面会说明为什么直到下一次好保存为止 .

## 修改的文字变化

```sh
npx @delurio/cli diff examples/qauth-authorize --base origin/main
```

这个打印出Markdown的拉动请求 。 它涵盖了流量的不同作用(通过运行两次修订而发现)和图中的变化.

## 作为图书馆

在格式上构建的工具可以使用CLI使用的同一种加载和检查器:

```ts
import { load } from '@delurio/cli/graph';
import { explore, Model } from '@delurio/cli/model';

const g = load('graphs/billing/billing.payment');
const configurations = explore(new Model(g.flow)).configs.length;
```

切入点是 `graph`, (中文(简体) ), `model`, (中文(简体) ), `story`, (中文(简体) ), `wireframe`, (中文(简体) ), `kit`, (中文(简体) ), `edges`, (中文(简体) ), `html`, (中文(简体) ), `nav`, (中文(简体) ), `expr` 财务报告和审定财务报表 `yaml`,每个类型. `yaml` 读取一个图文件的文本, 如 CLI 一样( Name`readYaml`),拒绝文本解决前SPEC.md §1排除的;读出其发送的图表的服务器应当随其阅读. 虽然版本为0.x,但他们的API可能会在任何小版本中有所改变:给精确的版本打针.

## 许可证

阿帕奇2.0 (英语). 见 [自由主义](https://npmcn.com/package/%40delurio/cli/LICENSE) 财务报告和审定财务报表 [通知](https://npmcn.com/package/%40delurio/cli/NOTICE)。“delurio”这个名字没有代码许可.

## 常见问题

### @delurio/cli 是什么？

Delurio-graph/0的开页检查器和页面:检查一个工程自己的CI中的每个图,离线,带有GNU出错行和SARIF\.

### 如何安装 @delurio/cli？

在项目目录运行 npm install @delurio/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 delurio，可以用 npx delurio 直接运行。

### @delurio/cli 支持 TypeScript 吗？

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

### @delurio/cli 支持 ESM 还是 CommonJS？

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

### @delurio/cli 需要什么版本的 Node\.js？

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

### @delurio/cli 可以商用吗？

@delurio/cli 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @delurio/cli 的下载量有多少？

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

### @delurio/cli 还在维护吗？

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