安装 Penstock
选择您使用的工具。它们是同一个编辑器、同一个许可证、同样的 30 天 Pro 试用,而且都无需注册。
Penstock 在 2026 年之前以 Camunda BPMN Editor 的名称发布。它是同一个插件,会原地更新,因此无需重新安装。
JetBrains IDE
2023.1 及以后带有 JCEF 的任意 JetBrains IDE,标准下载版本都已包含 JCEF:IntelliJ IDEA、WebStorm、PyCharm、GoLand、Rider 以及其他 IDE。
- 打开 Settings | Plugins | Marketplace。
- 搜索
Penstock,然后点击 Install。 - 打开任意
.bpmn文件。它会在可视化编辑器中打开,XML 就在旁边的标签页里。 - 状态栏会显示试用状态和剩余天数。
Marketplace 会自动选择适合您 IDE 的构建版本。如果您以前搜索的是 Camunda BPMN Editor,这就是同一个插件。详见在 JetBrains 中安装和快速上手。
VS Code
VS Code 1.88 或更高版本。
code --install-extension penstock.penstock
- 打开一个
.bpmn文件。它会在 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 文件安装。
命令行
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 IDE | 2023.1 及以后带有 JCEF 的任意 JetBrains IDE。 |
| VS Code | VS 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。 |
最初的十分钟
- 把示例项目写入一个空文件夹。在终端中运行:
penstock init --example camunda-8(或camunda-7)。编辑器的 Penstock 视图中也提供了示例。 - 打开
order-process.bpmn,然后点击 Check。 - 点击 Deploy,将它部署到引擎。
入门指南带您从什么都没安装,到得到一个已检查、已部署的流程,大约只需十分钟。
哪些是免费的
编辑器、检查与 lint、部署、Monitor、令牌模拟、导出、分享和导入都是免费的,没有时间限制;元素模板编辑器、连接关系图、CMMN 查看器和语言服务器同样免费。每台新电脑还会先获得 30 天 Pro。参见价格。
卸载与您的数据
卸载会移除插件或扩展。您的流程图是您自己的文件,会保留在项目中。Penstock 把偏好设置和许可证保存在 ~/.penstock 中,把密钥保存在您所用工具的密钥存储中。参见 Penstock 写入的文件。