# @elaraai/e3 中文文档 规范地址：https://npmcn.com/package/%40elaraai/e3/ 版本：1\.0\.107 npm 元数据更新时间：2026-11-13T06:51:42.658Z 中文译文更新时间：2026-11-13T11:13:43.483Z 软件包许可：AGPL-3\.0-or-later 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40elaraai/e3 原文对照：https://npmcn.com/package/%40elaraai/e3/?lang=original 项目主页：https://github.com/elaraai/east-workspace#readme 源码仓库：https://github.com/elaraai/east-workspace ## 关键信息（来自 npm 元数据） - 包体积（解压后）：2.1 MB，231 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：3 个 - peer 依赖：@elaraai/east 1\.0\.107 - 首次发布：2025-12-11T23:51:02.240Z - 最新版本发布：2026-11-13T06:51:42.283Z - 近 30 天下载量：5594（2026-10-13 至 2026-11-11，npm 官方下载统计） - 已发布版本数：165（近 12 个月 165 个） ## 中文简介 编写 e3 软件包的脚本 SDK 类型 ## 安装 ```sh npm install @elaraai/e3 ``` 也可以使用：`pnpm add @elaraai/e3`、`yarn add @elaraai/e3`、`bun add @elaraai/e3` ## README # @elaraai/e3 请检查url=值 (帮助) SDK用于编写e3包. ## 安装 ```bash npm install @elaraai/e3 ``` ## 示例 ```typescript import e3 from '@elaraai/e3'; import { StringType, East, variant } from '@elaraai/east'; // Define input datasets with default values const input_name = e3.input('name', StringType, variant('value', 'World')); const input_prefix = e3.input('prefix', StringType, variant('value', 'Hello')); // Define a task that combines inputs const greet = e3.task( 'greet', [input_prefix, input_name], East.function( [StringType, StringType], StringType, ($, prefix, name) => East.str`${prefix}, ${name}!` ) ); // Chain tasks - output of one feeds into the next const shout = e3.task( 'shout', [greet.output], // reads from previous task's output East.function( [StringType], StringType, ($, greeting) => greeting.upperCase() ) ); // Create and export the package const pkg = e3.package('greeting-pkg', '1.0.0', shout); await e3.export(pkg, 'dist/greeting-pkg-1.0.0.zip'); ``` 创建软件包 : - `.inputs.name` - 字符串输入( 默认: "World" ) - `.inputs.prefix` - 字符串输入( 默认: "Hello" ) - `.tasks.greet` - 在问候中综合投入 - `.tasks.shout` - 变身问候大写 ## API 密码 - `e3.input(name, type, variant('value', default))` - 定义输入数据集 - `e3.task(name, inputs, fn)` - 定义有东方函数的任务 - `e3.streamTask(name, { inputs, output }, fn)` - 确定一项任务,使其输出而不是返回; `fn` 接收输入,然后 `emit` - `e3.output.array(T)`, (中文(简体) ), `set(T)`, (中文(简体) ), `dict(K, V, { merge? })`, (中文(简体) ), `fold(T, { zero, combine })` - 输出类型为: `emit` 使用,以及输出部分如何组合 - `e3.partition(dataset, { by? })` - 标出一个溪流任务的投入,作为它的工作可以分开,一次一个,平行 - `e3.record(name, type, { initial?, indexes?, mutations?, migrations? })` - 界定记录:只通过变异写成的状态,每个被审计的承诺。 一份记录被宣布为完整,其部分在其声明中指明: - `indexes: (index) => ({ by_site: index.on(["site"]), … })` - 第二次收集 在一个Dict记录, 另一种顺序: `index.on(fields)`, (中文(简体) ), `key(fn)` 或者说 `keys(fn)`,每个带有可选 `value` 投影,或 `interval`, (中文(简体) ), `area`, (中文(简体) ), `series`, (中文(简体) ), `nested` 财务报告和审定财务报表 `summary` 横跨行中的时间和框 - `mutations: (mutation) => ({ patch: mutation.patch(), … })` - 它的变异: `mutation.reduce(fn)`一种比全州都少的药; `edit(fn)`,通过一个 `edit` 能力;或 `patch()`,一个客户端发送的补丁 - `migrations: (migration) => [migration.value(name, fn), …]` - 当一个软件包改变记录类型时,部署的步骤会运行,顺序是: `value`, (中文(简体) ), `rows` 或者说 `rekey` - `e3.package(name, version, ...items)` - 创建软件包(自动收集的依赖性) - `e3.export(pkg, path)` - 导出包到zip文件 这个 [用户指南](https://github.com/elaraai/east-workspace/blob/main/libs/e3/USAGE.md) 覆盖了SDK的其余部分,CLI并建立了一个项目. ## 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 ``` ## 许可证 双AGPL-3.0 / 商业. 见 [利比里亚](https://npmcn.com/package/%40elaraai/e3/LICENSE.md)。 。 。 . ### 生态系统 - **[东](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. 通过npm(发射器+每个平面的可选依赖)进行分配,并在每个GitHub放出上作为tarball. - [@elaraai/东-克-克利](https://www.npmjs.com/package/@elaraai/east-c-cli): npm 发射器 – 安装匹配的本地二进制作为可选依赖 - `east-c`: Core 运行时间 – 类型系统,IR 解释器,内置,序列化(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 执行查询钩和预览组件 - **[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://github.com/elaraai/east-workspace/tree/main/libs/east) - [东 Python 运行时间](https://github.com/elaraai/east-workspace/tree/main/libs/east-py) - [Elara 大赦国际](https://elaraai.com/) - [问题](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/)。 。 。 ._ * * * _开发者 [Elara AI Pty有限公司](https://elaraai.com/)_ ## 常见问题 ### @elaraai/e3 是什么？ 编写 e3 软件包的脚本 SDK 类型 ### 如何安装 @elaraai/e3？ 在项目目录运行 npm install @elaraai/e3，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@elaraai/east（1\.0\.107）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @elaraai/e3 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @elaraai/e3 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @elaraai/e3 可以商用吗？ @elaraai/e3 使用 AGPL-3\.0-or-later 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。 ### @elaraai/e3 的下载量有多少？ 根据 npm 官方下载统计，@elaraai/e3 在 2026/10/13 – 2026/11/11 这 30 天内被下载 5,594 次，日均约 186 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @elaraai/e3 还在维护吗？ 最新版本 1\.0\.107 发布于 2026/11/13（今天）；至今共发布 165 个版本，其中过去 12 个月发布了 165 个；首次发布于 2025/12/12。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。