# @elaraai/east-c-cli 中文文档

规范地址：https://npmcn.com/package/%40elaraai/east-c-cli/

版本：1\.0\.107
npm 元数据更新时间：2026-11-13T06:49:08.018Z
中文译文更新时间：2026-11-13T12:16:58.718Z
软件包许可：BUSL-1\.1

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

原始 npm 页面：https://www.npmjs.com/package/%40elaraai/east-c-cli
原文对照：https://npmcn.com/package/%40elaraai/east-c-cli/?lang=original
项目主页：https://github.com/elaraai/east-workspace#readme
源码仓库：https://github.com/elaraai/east-workspace

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

- 包体积（解压后）：20.9 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：0 个
- 首次发布：2026-06-09T02:26:05.758Z
- 最新版本发布：2026-11-13T06:49:07.616Z
- 近 30 天下载量：4030（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：104（近 12 个月 104 个）

## 中文简介

规定 `east-c` 宾. 一个微小的启动器从每个平台的匹配软件包(@elaraai/east-c-cli-)中为您的平台解决了本地二进制,通过可选的依赖性拉入.

## 安装

```sh
npm install @elaraai/east-c-cli
```

也可以使用：`pnpm add @elaraai/east-c-cli`、`yarn add @elaraai/east-c-cli`、`bun add @elaraai/east-c-cli`

## README

# 东-克-克利

> 东- C 的命令行跑者——从终端原地执行编译的东 IR

[![License](https://img.shields.io/badge/license-BUSL--1.1-orange.svg)](https://npmcn.com/package/%40elaraai/east-c-cli/LICENSE.md)

**东-克-克利** 是 C 运行时间的命令行切入点。 它与 [`east-c`](https://npmcn.com/package/%40elaraai/east-c) (核心)和 [`east-c-std`](https://npmcn.com/package/%40elaraai/east-c-std) (标准平台)用于执行东方IR程序.

## 构建

需要 CMake 3.16+ 和一个 C11 编译器.

```bash
make build    # From libs/east-c/
make test
make clean
```

见 [`docs/conventions/MAKEFILE_TARGETS.md`](https://npmcn.com/docs/conventions/MAKEFILE_TARGETS.md)。 。 。 .

## 使用量

```bash
# Run a Beast2-encoded IR file
./build/packages/east-c-cli/east-c run program.beast2

# Run a JSON-encoded IR file
./build/packages/east-c-cli/east-c run program.json

# With arguments
./build/packages/east-c-cli/east-c run program.beast2 --input '"hello"'
```

CLI 装入标准平台 `east-c-std` 默认。 自定义平台功能可以在构建时链接.

### 运行一个单元( E)`exec`(中文(简体) )

`east-c exec <unit.beast2>` 是命令 e3 运行: 机器显示双胞胎 联 合 国 `run`。单位文件名为工作——一个运行于其输入的程序,或 要合并的输出部分—— 与平台, 线程运行 可能使用,输出的种类(程序返回的值,或数组,设置, 拼接或折叠输出到何处, 并写入输出和输入 成果:结果`ok`,或 `failed` 与消息及其来源 ),峰值内存,以及所花费的加载,编译,执行的时间 写作 单元中的路径可能与其文件相对,所以一个单元和 文件名在移动时重放。 一个跑步的单位说它如何 输入读取(`decode`页:1 当结果为 0 时退出 `ok` 和1个 当结果记录为失败时; `-v` 显示时间和高峰 记忆.

### 如何阅读投入

收藏输入会懒散地打开, 不管它重多重: 索引化的野兽2文件是 和一个读取的解码器,只有它到达的片段——大小,一个按键 读取和 `$.for` 循环一次解码一段,操作 寻呼器不能服务解码整个输入,一次,当它首先需要的时候. A 类 循环只保留它行走的部分。 Keyed 读取保留它们的片段 解码,每次输入可被解码的重量可达256米B(`EAST_PAGED_CACHE_BYTES`· ; `1` 保留一个段),并按键顺序读取,保存大约两个. `--decode whole` 在程序运行之前解码每个输入, 哪个 适合随机阅读多于此内容的程序,或绕过一个 多次输入:懒散地,在寻呼器所保存的分段之外读取 重新解码它的片段. `exec` 从它的单位读取相同的选择 `decode`。非收藏的价值观及其要素 保存一个参考文献或一个函数, 以两种方式全部解码.

```bash
east-c run task.beast2 -i rows.beast2 --decode whole -o out.beast2
```

与 `-v` 跑者说每个输入是如何打开的 读到的: 或一个输入解码器整体所持有的内容 记忆——除其规模外,整个解码系统内存的增长 重量在磁盘上,因为一个嵌入式收藏在如此大小的很多时候解码. 读取再次解码段, 输入的解码 整个会做代替.

收集输入也可能是显示目录,形式 e3 阶段 a 存储在: 输入文件包含一个表单, 并且每个段 名称是一个独立blob在 `<file>.segments/<sha256>.beast2`打开 轻而易举地,只读打开它到达的部分,或 ——并量其部分 `-v` 账户.

### 与父关系退出

与 `--exit-with-parent` 命令行(任何命令,在 赛跑者在自己的线上看着自己的出道 状态 1 。 一个父母 给跑跑者产出一个它从不写给的活管 就像e3那样 即使身体在计算时 死亡时 跑者会带着它下去. 没有了旗帜,斯丁独自一人.

```bash
east-c run task.beast2 --exit-with-parent -o out.beast2
```

在Windows上,监视器读取了同步管或重叠管. 拿来 相重叠的管子—— `FILE_FLAG_OVERLAPPED`或节点的节点 `'overlapped'`, (中文(简体) ), 如 e3 一样: 同步管上待读的读取符持有管的文件对象 锁定,所以任何其它使用 stdin 在跑道上会等待到父母是 不见了.

### 剖析

```bash
east-c run task.beast2 -i rows.beast2 --profile
east-c exec unit.beast2 --profile
EAST_PROFILE=1 EAST_PROFILE_INTERVAL=300 east-c exec unit.beast2
```

打印,在工作后(以及失败出错后),每个东方函数 和平台的功能, 以自己的时间, 它的呼叫计数 总时间, 以及它在哪里: " 自由者 " 的名称, 当它与 IR有一个,它的定义站点,当这不同时,它的位置是: 第一个呼叫它,它告诉帮助者一个建造者 在他们的呼叫站点打电话。 平台功能是 它自己的,以它命名 并被接到的电话,所以时间 里面花的不是打电话者的自我时间 懒惰读取的输入也是 解码:每段读取解码,整段读取解码 操作调用器不能为需要服务, 是名为一个条目的调用 输入后为 `-v` 说吧`input 1`),第一句话改为: 解码 按键在寻呼器所保存的片段之外随机读取 (单位:千美元)`EAST_PAGED_CACHE_BYTES`),或重复扫描,显示于此;读取 函数的总时间保存这些解码,而其自我时间没有.

`EAST_PROFILE` 设置到任何东西,但 `0` 没有旗帜的配置文件, 即 如何描述 e3 运行的任务: e3 将环境交给跑者, 报告登入任务日志. `EAST_PROFILE_INTERVAL=N` (单位:秒) 在工作进行期间, 还会打印目前为止的配置文件每 N 秒, 一个呼叫 迄今仍在计算;间隔时间不是 秒数表示并被忽略。 east -py的跑道印的一样 报告(描述器为libeast-c's). 外,剖析成本,每个分支 电话.

这个 `ir` 工具箱( 问题 # 627) 在不运行它们的情况下在 IR 文件上工作 :

```bash
# The canonical form of an IR file: loc_ids stripped, variables/labels renamed in
# the TypeScript lowering's order, captures recomputed, recursive type ids renumbered
east-c ir normalize program.json -o canonical.json

# Normalize two IR files and report the first structural difference (exit 1) or
# "identical" (exit 0); --raw compares as-is
east-c ir diff program.json rebuilt.beast2

# json <-> beast2 with the source map intact
east-c ir convert program.json -o program.beast2
```

## Claude 代码插件

东方生态系统也运载a [克劳德代码](https://claude.com/claude-code) 插件 — East 语言技能, 实例搜索, 以及 East 代码的先发制人诊断 `elaraai` 市场:

```text
# Inside Claude Code
/plugin marketplace add elaraai/east-workspace
/plugin install east@elaraai
```

```bash
# From a terminal
claude plugin marketplace add elaraai/east-workspace
claude plugin install east@elaraai
```

## 许可证

业务来源许可证1.1——见 [利比里亚](https://npmcn.com/package/%40elaraai/east-c-cli/LICENSE.md)。与 `east-c` 核心键.

### 生态系统

-   **[东](https://github.com/elaraai/east-workspace/tree/main/libs/east)**: statical地打出,以表达为主的语言有可序列的IR. 运行跨 TypeScript, Python, C 等运行时间的可移植逻辑.
    
    -   [@elaraai/东边](https://www.npmjs.com/package/@elaraai/east): 有类型系统、表达式和参考JS编译器的核心语言SDK
-   **[东节点](https://github.com/elaraai/east-workspace/tree/main/libs/east-node)**: Node.js 平台用于I/O,数据库和系统操作的功能.
    
    -   [@elaraai/东节点-std](https://www.npmjs.com/package/@elaraai/east-node-std): 控制台、 文件系统、 获取、 加密、 时间、 路径、 随机
    -   [@elaraai/东-北-欧](https://www.npmjs.com/package/@elaraai/east-node-io): SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, 压缩
    -   [@elaraai/东-节点-cli](https://www.npmjs.com/package/@elaraai/east-node-cli): 用于在 Node.js 运行 East IR 程序的 CLI
-   **[东 C](https://github.com/elaraai/east-workspace/tree/main/libs/east-c)**: C11本土运行时间用于执行东IR. 被压死 `linux-x64` 财务报告和审定财务报表 `linux-arm64`,附于每个 GitHub 发布.
    
    -   `east-c`: Core 运行时间 — 类型系统, IR 解释器, 200+内置, 序列化( Beast2, JSON, CSV, East text)
    -   `east-c-std`: 控制台、 文件系统、 获取、 加密、 时间、 路径、 随机
    -   `east-c-cli`: 用于在本地运行 East IR 程序的 CLI
-   **[东 Py](https://github.com/elaraai/east-workspace/tree/main/libs/east-py)**: Python 运行时间,标准平台,I/O,以及数据科学平台功能. 发布至PyPI.
    
    -   [东平](https://pypi.org/project/east-py/): Core Python 运行时间——类型系统,IR编译器,212+内建,Cython加速热路
    -   [东平-上](https://pypi.org/project/east-py-std/): 控制台、 文件系统、 获取、 加密、 时间、 路径、 随机
    -   [东比欧](https://pypi.org/project/east-py-io/): SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, 压缩
    -   [东-平-克利](https://pypi.org/project/east-py-cli/): 用于在 Python 运行 East IR 程序的 CLI
    -   [东平数据科学](https://pypi.org/project/east-py-datascience/) (平价)+ [@elaraai/东平数据科学](https://www.npmjs.com/package/@elaraai/east-py-datascience) (npm):优化(MADS, Optuna, ALNS, GoogleOR),ML(XGBoost, LightGBM, NGBoost, PyTorch, Lightning, GP), 贝叶斯推论(PyMC),可解释性(SHAP),相通性预测(MAPIE)
-   **[东方大学](https://github.com/elaraai/east-workspace/tree/main/libs/east-ui)**:已打入UI组件定义和React渲染器,外加VS代码预览.
    
    -   [@elaraai/东-伊](https://www.npmjs.com/package/@elaraai/east-ui): 50+ 键入的UI 组件用于布局,窗体,图表,表格,对话框
    -   [@elaraai/ 东- ui- 组件](https://www.npmjs.com/package/@elaraai/east-ui-components): 带有 Chakra UI v3 样式的反相渲染器
    -   [@elaraai/e3-ui (英语)](https://www.npmjs.com/package/@elaraai/e3-ui):e3 + UI桥-数据绑定, `e3.ui()` 任务,显示
    -   [@elaai/e3-ui-组件](https://www.npmjs.com/package/@elaraai/e3-ui-components): 为 e3 API 执行查询钩和预览组件
    -   [@elaraai/e3-ui-cli (英语)](https://www.npmjs.com/package/@elaraai/e3-ui-cli): 在终端浏览一个 e3 寄存器(`e3-ui [repo]`),并将East-ui / e3-ui组件制入PNG(`e3-ui shot`(中文(简体) )
-   **[e3——东行发动机](https://github.com/elaraai/east-workspace/tree/main/libs/e3)**: 大规模运行东方管线的持久执行引擎。 类似Git的内容可处理存储,自动记忆,反应数据流,实时监测.
    
    -   [@elaraai/e3 请检查url=值 (帮助)](https://www.npmjs.com/package/@elaraai/e3): SDK 用于编写带有打字任务和管道的 E3 包
    -   [@elaraai/e3-core (英语)](https://www.npmjs.com/package/@elaraai/e3-core): 对象存储、数据流管弦器、执行状态
    -   [@elaai/e3型](https://www.npmjs.com/package/@elaraai/e3-types): e3 包的共享类型定义
    -   [@elaraai/e3-cli (英语)](https://www.npmjs.com/package/@elaraai/e3-cli)数字 : `e3 repo`, (中文(简体) ), `e3 package`, (中文(简体) ), `e3 workspace`, (中文(简体) ), `e3 dataflow run`, (中文(简体) ), `e3 watch`, (中文(简体) ), `e3 task logs` 命令
    -   [@elaraai/e3-api-客户端](https://www.npmjs.com/package/@elaraai/e3-api-client)远程 e3 寄存器的 HTTP 客户端
    -   [@elaraai/e3-api-服务器](https://www.npmjs.com/package/@elaraai/e3-api-server): 用于 e3 寄存器的 REST API 服务器
    -   [@elaraai/e3-api测试](https://www.npmjs.com/package/@elaraai/e3-api-tests): 共享 API 合规测试套件

## 链接

-   **网站**数字 : [https://elaai.com/ (中文(简体) )](https://elaraai.com/)
-   **仓库**数字 : [https://github.com/elaai/东-工作空间](https://github.com/elaraai/east-workspace)
-   **问题**数字 : [https://github.com/elaraai/east-workspace/issues (中文(简体) )](https://github.com/elaraai/east-workspace/issues)
-   **电子邮件**数字 : [支助@elara.ai](mailto:support@elara.ai)

## 关于埃拉拉

东方由 [Elara AI Pty有限公司](https://elaraai.com/)一个由AI驱动的平台 创造经济数字双胞胎 企业优化业绩。 Elara将业务目标、决定和数据结合起来,以帮助各组织在业务、采购、销售和客户参与以及项目和投资规划方面作出由数据驱动的决定。 东能给以埃拉拉解决方案的计算层,使得复杂的商业逻辑和数据能够以简单,类型安全和可移植的语言来表达.

* * *

_开发者 [Elara AI Pty有限公司](https://elaraai.com/)。 。 。 ._

## 常见问题

### @elaraai/east-c-cli 是什么？

规定 east-c 宾\. 一个微小的启动器从每个平台的匹配软件包\(@elaraai/east-c-cli-\)中为您的平台解决了本地二进制,通过可选的依赖性拉入\.

### 如何安装 @elaraai/east-c-cli？

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

### @elaraai/east-c-cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/elaraai\_\_east-c-cli 是否存在。

### @elaraai/east-c-cli 支持 ESM 还是 CommonJS？

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

### @elaraai/east-c-cli 需要什么版本的 Node\.js？

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

### @elaraai/east-c-cli 可以商用吗？

@elaraai/east-c-cli 使用 BUSL-1\.1 许可。声明的许可为 BUSL-1\.1，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @elaraai/east-c-cli 的下载量有多少？

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

### @elaraai/east-c-cli 还在维护吗？

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