# @h2loop/autosar 中文文档

规范地址：https://npmcn.com/package/%40h2loop/autosar/

版本：1\.21\.0
npm 元数据更新时间：2026-11-17T05:58:03.330Z
中文译文更新时间：2026-11-17T05:01:36.272Z
软件包许可：UNLICENSED

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

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

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

- 包体积（解压后）：926 kB，74 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2026-11-06T07:12:31.693Z
- 最新版本发布：2026-11-17T05:58:03.129Z
- 近 30 天下载量：9065（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：60（近 12 个月 60 个）

## 中文简介

氢气的AUTOSAR Classic sack:ECUC在ARXML上读取/编辑到位置/验证/diff,配置到代码跟踪,生成器和建造跑道

## 安装

```sh
npm install @h2loop/autosar
```

也可以使用：`pnpm add @h2loop/autosar`、`yarn add @h2loop/autosar`、`bun add @h2loop/autosar`

## README

# @h2loop/autosar — AUTOSAR 氢气经典包

AUTOSAR Classic 集成工作的定型工具,因此代理从不手写ARXML:

| 工具 | 它会做什么 | 运行 |
| --- | --- | --- |
| `ecuc_read` | ECUC 配置为紧凑 ECUC JSON; def 摘要(`schema`(中文(简体) ) | 本地( Python 引擎) |
| `ecuc_edit` | 按 AUTOSAR 路径设置 / 添加/ 删除; 在位字节补丁; 全或全; 计划检查 | 当地 |
| `ecuc_validate` | 多重性、强制性、范围、enum、类型、字符串、Ref target/dest、 dragging、复制 → LSP 类诊断 | 当地 |
| `ecuc_find` | 关于欧洲教育委员会的结构化查询(条件、参考/出处) | 当地 |
| `ecuc_crosscheck` | 每个模块交叉检查表(摘录、网关、NvM尺寸、容量、包装、手柄) | 当地 |
| `arxml_edit` | sWC ARXML的结构化编辑,包含. `new_file` (DEST推断出,计划订购,创建了缺失的软件包) | 当地 |
| `autosar_add_like` | 添加新 X 如已存在的 Y (消息、 端口、 可运行+ 事件、 Dem 事件、 NvM 块,...): 复制整个命名链条, 跨越 ECUC + System ARXML, 重新命名; 链接、 处理 ID、 值; 验证或回滚 | 当地 |
| `autosar_add_signal` | 添加一个结束的信号端( ECUC + 提取链 + DBC), 验证或回滚 | 当地 |
| `arxml_diff` | 由 AUTOSAR 路径( ignores UUID、 顺序、 空白、 文件分拆) 编写的语义化 diff | 当地 |
| `autosar_trace` | 通过 H2Loop 代码图,配置 QQ 生成 C 符号 QQ 内部呼叫器 | H2Lop 后端 |
| `autosar_config_lookup` | 元素 + 儿童 + 校正 + 代码图的链接 | H2Lop 后端 |
| `autosar_spec_id_check` | 在您自己的光谱文本导出中检查要求的ID( SWS /TPS /ECUC .) : 定义 + 文本 / mentioned-ONLY / Not-FOUND | 当地(`specDocs`(中文(简体) ) |
| `autosar_audit` | c代码的集成审查: BSW API 手柄,方向,宽度,NvM NULL PTR vs ECUC | 当地 |
| `autosar_generate` 编号 : `autosar_build` | 运行工程配置的生成器/ 构建命令( 任务权限) | 当地 |

再加上 `autosar` 技能(ECUC模型、符号名称规则、配置类、项目布局、 编辑 – 验证 – 生成 → 构建 → 跟踪循环 `autosar-integrator` 子剂,以及 `/autosar-validate` 财务报告和审定财务报表 `/autosar-trace` 命令.

## 安装

```bash
hydron plugin add @h2loop/autosar          # or a local path / --project
```

所需经费: [页:1](https://docs.astral.sh/uv/) (首选;通过 `autosar-data`或 Python = 3.10 在路径上(`AUTOSAR_PYTHON` (原始内容存档于2017-03-25). overse. 后端工具使用 水文登录和选定的 H2Loop 项目(或 `workspace_id`(三); `KILO_API_URL` 覆盖后端.

## 项目配置

参数定义不捆绑 。 引擎按照这个顺序找到它们: `.hydron/autosar.json` `paramDefs` globs – 任何项目 `.arxml` 包含 `ECUC-MODULE-DEF` (醋饮出. ) `$AUTOSAR_PARAMDEFS` (路径列表). 没有数据,值是可以读取的,但不能验证.

```json
{
  "paramDefs": ["SIP/**/bswmd/*.arxml"],
  "config": ["Config/**/*.arxml"],
  "input": ["Input/**/*.arxml"],
  "generate": {"command": "<vendor-cli> --project Config/Ecu.dpa --generate {module}", "timeoutSec": 3600},
  "build": "make -C Build all",
  "specDocs": ["~/autosar/R25-11/txt/*.txt"]
}
```

`ecuc_read` 编号 : `ecuc_find` 给出每个值 `"@at:<Param>"` (文件:其 VALUE 元素的行)和整数 `"@hex:<Param>"`· ; `autosar_trace` 编号 : `autosar_config_lookup` 为本地元素添加相同值 结账. `specDocs` (或 `$AUTOSAR_SPEC_DOCS`)点 `autosar_spec_id_check` 在 AUTOSAR 文本导出时 规格; 包包没有光谱文本,也没有要求的ID索引.

## 引擎 CLI

```bash
cd python && uv run --no-project --with autosar-data==0.17.0 python -m ecuc_engine --root <project> \
  <info|read [path] [--depth N] [--schema]|edit --ops '<json>' [--dry-run]|validate [--module M] [--file F]|diff A B> --json
```

## 开发

```bash
bun install && bun run build && bun run typecheck
bun run test:py        # pytest; R25-11 integration tests run when AUTOSAR_R25_DEFS (or the eval_work copy) exists
hydron plugin validate .
```

## 常见问题

### @h2loop/autosar 是什么？

氢气的AUTOSAR Classic sack:ECUC在ARXML上读取/编辑到位置/验证/diff,配置到代码跟踪,生成器和建造跑道

### 如何安装 @h2loop/autosar？

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

### @h2loop/autosar 支持 TypeScript 吗？

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

### @h2loop/autosar 支持 ESM 还是 CommonJS？

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

### @h2loop/autosar 可以商用吗？

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

### @h2loop/autosar 的下载量有多少？

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

### @h2loop/autosar 还在维护吗？

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

