# @camunda/linting-autofix 中文文档

规范地址：https://npmcn.com/package/%40camunda/linting-autofix/

版本：0\.3\.0
npm 元数据更新时间：2026-10-30T15:26:18.394Z
中文译文更新时间：2026-11-09T00:50:35.028Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：220 kB，6 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：bpmn-js \>= 18\.0\.0，diagram-js \>= 15\.0\.0，@camunda/linting \>= 4\.1\.0，bpmn-js-properties-panel \>= 5\.63\.0，@bpmn-io/properties-panel \>= 3\.57\.1，bpmn-js-element-templates \>= 2\.38\.0
- 首次发布：2026-08-19T15:33:09.102Z
- 最新版本发布：2026-10-21T05:40:03.386Z
- 近 30 天下载量：13283（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

由 Camunda 桌面和 Web 建模器共享的 Camunda linting 自动修补和自动填充费用

## 安装

```sh
npm install @camunda/linting-autofix
```

也可以使用：`pnpm add @camunda/linting-autofix`、`yarn add @camunda/linting-autofix`、`bun add @camunda/linting-autofix`

## README

# @camunda/ linting- autofix (英语)

自动修补和自动填充 [线性](https://github.com/camunda/linting),由 Camunda 桌面和Web Modeler 共享.

模块装饰一个代理化的 Agent 子进程内部的元素属性面板, 并带有一击将 AI Agent 工具合同的两侧连接的平价: `fromAi()` 输入代理用品,以及 `toolCallResult` 输出它读回。 每项报酬都适用一条规则: **种子空白字段,绝不覆盖一个值.**

两位建模师都登记同一模块,因此两人通过施工而不是建筑师记忆中要改变两者而保持锁定.

## 使用量

注册模块 :

```javascript
import { agentConfigAutofillModule } from '@camunda/linting-autofix';

const modeler = new BpmnModeler({
  additionalModules: [
    agentConfigAutofillModule
  ]
});
```

模块是只编辑器(它会改变模型),需要属性面板也要注册. 主机集成为一行.

> **中断更改 :** `@camunda/linting-autofix/assets/linting-autofix.css` 已不存在 `import '@camunda/linting-autofix/assets/linting-autofix.css';` 线条。 该模块现在通过属性面板发布简单的诊断 `propertiesPanel.setDiagnostics` API,它使所有的东西(文字颜色,动作按钮,组点,列表徽章)在本土化和样式化;没有这个包的自己所剩有的外形来发运.

### 同伴依赖关系

`bpmn-js`, (中文(简体) ), `diagram-js`, (中文(简体) ), `bpmn-js-properties-panel` 财务报告和审定财务报表 `@bpmn-io/properties-panel` (qq 3. 57.1) 是同伴的依赖关系,因此模块总是与主机自己的实例配合,保持与面板的同步,但面板样式是诊断.

`bpmn-js-element-templates` (+++ 2.38.0)和 (++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ `@camunda/linting` (QQ 4.1.0)是可选的同龄人. 该单元将它的行动纳入通过下列途径出版的诊断材料中: `propertiesPanel.setDiagnostics`在林丁标出一个字段的地方,动作会传递诊断结果;在其他地方,动作都是赤裸裸的,在工具提示中加以解释.

## 支付费用

1.  **输入自动填充( E)`fromAi()`(中文(简体) )**在工具流上 _只输入元素_ - 空白的io-映射输入和空白的可感知元素模板字段 `zeebe:input` 得到一个 `Input from agent` 行动、播种 `=fromAi(toolCall.<key>, "<description>", "<type>")`。当生成的密钥与 a 相撞时,没有报价 `fromAi()` 键已在此元素上声明.
    
2.  **自动填充( E)`toolCallResult`(中文(简体) )**,一个 `Output to agent` 操作任何工具流程元素,如果尚未在自身执行路径上游产生可读合同结果,则写入该元素的 _本地语言_ 结果字段——一个被模板化的连接器的结果表达式,一个感觉脚本任务的结果变量,一个多进取输出集合,或者一个输出参数在一个平原任务上的过程变量名称.
    
    在输出映射行上,此动作坐落在进程变量名上,然后写出其它的,所以该行的 _可变派值_ 永远不会影响它.
    
    在无法单击时撤回: 已瞄准的输出行 `toolCallResult`中,单击将写入已经存在的值;在一行中,针对一个子路径,例如 `toolCallResult.statusCode`它会破坏 深思熟虑的部分贡献.
    
3.  **自动修正动作**,在人口密集地区提供: `fromAi()` 键(错误的前缀、括号表示、引用、路径过长、外壳错误、完全缺失)和近误结果通道名称通过重新分解元素本身的字段来检测。 身材不错 `fromAi()` 以不入境为理由的电话 `Move to "<entry element>"`,它只重写 `fromAi(...)` 留下其余的字段 完好无损.
    
    每一个动作都是现场自身诊断的一部分:一个校正会从它所解决的验证信息中走过,一个场上给出的没有旗帜是赤裸裸的动作并在工具提示中解释. 其可见的标签独立描述构建者的目标,而不管执行是否将突变归类为固定或自動填充:
    
    | 球场持有的 | 接受什么给你 | 标签 |
    | --- | --- | --- |
    | 您所写的描述或类型 | 您的文本保存得准确; 只有密钥被更正, 你留下的任何东西都被填入 | `Fix` |
    | 除了破碎的钥匙`fromAi()`, (中文(简体) ), `fromAi(42)`(中文(简体) ) | 完整的呼叫: 密钥、 描述、 类型 | `Input from agent` |
    | 一个根本无法解释的电话 | 重置到工作默认值; 您所写的被替换, 相邻的验证文本和可访问的工具提示都这样写 | `Input from agent` |
    
    3条规则对此作出了规定 `agent-tool-corrections.ts`: 保留你所做的仍然可以读取的每个决定; 只有在无物可救时才会重置; 并说这两个决定中哪一个刚刚发生, 因为按钮预览什么也没有. 类型来自模板已声明的属性, 但从未从关键词猜到您已经打过电话 .
    

修补是横跨范围,从不进行全场替换,所以是一种表达方式,比如 `=concat("prefix-", fromAi(), "-suffix")` 永远不会丢弃。 每个被应用的固定装置,包括多元素移动,都是一个单一的撤消单元.

### 种子的种子 `fromAi()` 类型是猜测,不是事实

每一个种子呼唤都带有 `type` 参数计算 `inferFromAiType` 内 `from-ai-autofill.ts`。仅限 `propertyType === 'Boolean'` 在一个元素模板字段上是一个自信的事实; 其它一切都是一个关键词, 相对于字段本身的描述/标签文本, 默认为 `'string'`。 。 。 .

如果您在工具呼叫中碰到了运行时类型不匹配的情况, 请在假设连接器或模型有错之前先检查一下: 种子呼叫的第三个参数是 `inferFromAiType` 返回,从未手写。 修补是种子的一字编辑 `"<type>"` 参数本身,而不是对该函数的更改.

## 资格

带有此特性的相接子进程算作代理 `io.camunda.agenticai.toolContainer` `zeebe:Properties` 布尔,或 `io.camunda.connectors.agenticai.aiagent.jobworker.v1` 元素模板 id- 匹配 `isAgenticAdHocSubProcess` 内 `bpmnlint-plugin-camunda-compat`。一个赤裸的 `zeebe:AdHoc` 扩展被故意不作为倒置处理: 使用输出收集的平版加热子进程也携带它.

共享的前提`isAgenticAdHocSubProcess`, (中文(简体) ), `isToolFlowElement`, (中文(简体) ), `isToolEntryElement`)是输出的,因此每个主机表面都同意付费的归属.

## 构建和运行

```sh
# install/setup
npm install

## spin up visual playground
npm start

# lint + build + test, the same as CI
npm run all
```

### 地方发展与东道建模

构建库并将其链接到主机中 :

```sh
npm run build && npm link
cd ../camunda-modeler/client && npm link @camunda/linting-autofix
```

重新运行 `npm run build` 每次更改后; 主机拾取 `dist/` 直接说.

## 许可证

麻省理工学院

## 常见问题

### @camunda/linting-autofix 是什么？

由 Camunda 桌面和 Web 建模器共享的 Camunda linting 自动修补和自动填充费用

### 如何安装 @camunda/linting-autofix？

在项目目录运行 npm install @camunda/linting-autofix，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：bpmn-js（\>= 18\.0\.0）、diagram-js（\>= 15\.0\.0）、bpmn-js-properties-panel（\>= 5\.63\.0）、@bpmn-io/properties-panel（\>= 3\.57\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @camunda/linting-autofix 支持 TypeScript 吗？

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

### @camunda/linting-autofix 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @camunda/linting-autofix 可以商用吗？

@camunda/linting-autofix 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @camunda/linting-autofix 的下载量有多少？

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

### @camunda/linting-autofix 还在维护吗？

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