Penstock

安装 Penstock

选择您使用的工具。它们是同一个编辑器、同一个许可证、同样的 30 天 Pro 试用,而且都无需注册。

Penstock 在 2026 年之前以 Camunda BPMN Editor 的名称发布。它是同一个插件,会原地更新,因此无需重新安装。

JetBrains | VS Code | 命令行

JetBrains IDE

2023.1 及以后带有 JCEF 的任意 JetBrains IDE,标准下载版本都已包含 JCEF:IntelliJ IDEA、WebStorm、PyCharm、GoLand、Rider 以及其他 IDE。

  1. 打开 Settings | Plugins | Marketplace。
  2. 搜索 Penstock,然后点击 Install。
  3. 打开任意 .bpmn 文件。它会在可视化编辑器中打开,XML 就在旁边的标签页里。
  4. 状态栏会显示试用状态和剩余天数。

Marketplace 会自动选择适合您 IDE 的构建版本。如果您以前搜索的是 Camunda BPMN Editor,这就是同一个插件。详见在 JetBrains 中安装和快速上手。

VS Code

VS Code 1.88 或更高版本。

code --install-extension penstock.penstock

Cursor、Windsurf、VSCodium 等分支版本,或无法访问 Marketplace

基于 VS Code 的编辑器从各自的扩展仓库(通常是 Open VSX)获取扩展,而不是从 Microsoft 的 Marketplace 获取。Penstock 已上架 Open VSX:在扩展视图中搜索 Penstock 即可。如果找不到该扩展,可以从 .vsix 文件安装:在扩展视图中使用 Install from VSIX...,或运行 code --install-extension penstock.vsix。参见从 VSIX 文件安装。

详见在 VS Code 中安装和快速上手。

命令行

Node.js 22(22.22.2 或更高)、24(24.15.0 或更高)或 26 及以上版本。

方式命令适用场景
不安装直接试用npx @kern0x1b/penstock-cli check .一次性检查
安装npm install -g @kern0x1b/penstock-cli您自己的电脑
由项目锁定版本npx @kern0x1b/penstock-cli init,然后运行 ./penstockw check .团队及其流水线,类似 gradlew

软件包发布在 npm 上。penstock doctor 会告诉您项目哪里有问题。命令行独立于编辑器,但与它们共用许可证:一个许可证同时适用于 JetBrains 插件、VS Code 扩展和命令行。详见命令行和快速上手。

其他编辑器

Zed、Helix、Neovim、Sublime Text、Emacs、Kate 和 Eclipse 无需插件,即可通过命令行自带的语言服务器显示 Penstock 的检查结果、悬停提示、定义、符号、快速修复和自动补全。它是免费的。先安装命令行,然后按照 penstock lsp 中针对您编辑器的说明操作。Eclipse 和 Zed 没有 Penstock 插件,OpenIDEA 插件尚未发布。

系统要求

JetBrains IDE2023.1 及以后带有 JCEF 的任意 JetBrains IDE。
VS CodeVS Code 1.88 或更高版本。
命令行Node.js 22(22.22.2 或更高)、24(24.15.0 或更高)或 26 及以上版本。
引擎Camunda 7、Camunda 8、Operaton、CIB seven、Flowable、Activiti 以及标准 BPMN 2.0。Flowable 和 Activiti 不支持部署。
操作系统Windows、macOS 和 Linux。
遇到问题?故障排除、许可证故障排除、hello@getpenstock.com或 GitHub issues。

最初的十分钟

  1. 把示例项目写入一个空文件夹。在终端中运行:penstock init --example camunda-8(或 camunda-7)。编辑器的 Penstock 视图中也提供了示例。
  2. 打开 order-process.bpmn,然后点击 Check。
  3. 点击 Deploy,将它部署到引擎。

入门指南带您从什么都没安装,到得到一个已检查、已部署的流程,大约只需十分钟。

哪些是免费的

编辑器、检查与 lint、部署、Monitor、令牌模拟、导出、分享和导入都是免费的,没有时间限制;元素模板编辑器、连接关系图、CMMN 查看器和语言服务器同样免费。每台新电脑还会先获得 30 天 Pro。参见价格。

卸载与您的数据

卸载会移除插件或扩展。您的流程图是您自己的文件,会保留在项目中。Penstock 把偏好设置和许可证保存在 ~/.penstock 中,把密钥保存在您所用工具的密钥存储中。参见 Penstock 写入的文件。