OpenFlowKit icon

OpenFlowKit

OpenFlowKit 是面向开发者和技术团队的开源、本地优先架构图设计工作室,支持可视化绘图、Mermaid/D2/Structurizr、GitHub 仓库映射、C4 建模及 MCP 编程代理编辑。

OpenFlowKit

来自画布、代码或仓库的架构图

OpenFlowKit 是面向开发者和技术团队的开源架构图设计工作室。它将可视化画布与图表即代码工作流、仓库映射、C4 风格架构视图和代理辅助编辑结合起来,因此系统可以手动勾勒、根据文本生成,或从源代码推导。

该产品采用本地优先模式:托管应用无需账户,其静态自托管构建版本不包含产品后端或数据库。浏览器可以读取公开 GitHub 仓库,而私有仓库映射则可通过 CLI 从本地检出目录执行。图表始终可编辑,也可以通过文档所述的链接工作流导出或分享。

核心功能

GitHub 仓库映射

粘贴公开 GitHub 仓库地址或 owner/repo 路径,让浏览器识别其中的组件、文件和连接关系。箭头会链接回生成每个关系的源文件及对应行。

画布与图表即代码

手绘或绘制结构化图表,并导入或编写 Mermaid、D2 或 Structurizr。文本表示和画布表示仍属于同一个可编辑图表。

代理原生图表绘制

连接 Claude Code、Codex、Cursor、VS Code、Claude Desktop、Windsurf 或其他 MCP 客户端。本地服务器提供 29 个工具,用于绘图、读取、重新排列、设置样式、截图、导出和仓库操作。

架构建模

通过相互连接的架构视图对系统进行建模,包括 C4 风格的上下文、容器和组件视角。也可以将仓库作为 C4 模型打开,并将证据链接固定到所读取的提交。

技术感知型图表样式

只需输入 PostgreSQL、Redis 或 Kubernetes 等技术名称,即可使用自动图标匹配,为 2,000 多个 AWS、Azure、Google Cloud、CNCF 和开发者图标匹配样式。

自托管与本地存储

从文件托管服务提供静态构建版本,或在 Docker 中运行。图表保存在每位访问者的浏览器中;可选的仅查看分享功能使用单独部署的 Worker,并存储密文。

实际使用场景

  • 探索陌生代码库

    粘贴公开仓库以生成已发现服务、文件和连接关系的映射,然后选择箭头查看其背后的源文件和对应行。可以使用只读映射进行探索,也可以将其复制到画布中重新排列。

  • 记录系统架构

    从系统上下文、容器或组件视图开始,并保持相关架构层级相互连接。这有助于在 C4 风格模型中记录服务、数据存储、外部系统及其关系。

  • 在代码与可视化思维之间切换

    将 Mermaid、D2 或 Structurizr 描述转换为可编辑的可视化图表,或使用画布将结构化图形与手绘注释、图片、表情符号和图表结合起来。

  • 与编程代理协作

    请求 MCP 连接的代理绘制仓库架构、修改选定元素、添加缓存、重新设置图表样式,或将图表代码转换为可编辑文档。审查每项更改,并将其作为一个步骤撤销。

  • 托管私有图表工作区

    通过提供静态构建版本或使用 Docker,在内部域名或本地环境中运行 OpenFlowKit。将文档保存在浏览器中;如需仅查看链接,则可选择部署分享 Worker。

Pros and Cons

Pros

  • 在同一个画布中支持多种起始方式:手绘、图表代码、仓库映射和代理指令。
  • 仓库箭头提供文件和行号证据,便于将生成的架构图与源代码进行核查。
  • MCP 服务器允许受支持的代理通过 29 个工具编辑打开的图表,并且所做更改可以撤销。
  • 采用 MIT 许可证开源,静态构建版本可以自托管或在 Docker 中运行。
  • 支持 C4 风格的关联视图,并可自动匹配广泛的云技术和开发者技术图标。

Cons

  • 浏览器仓库映射仅限公开 GitHub 仓库;私有仓库需要使用本地 CLI 工作流。
  • 仓库映射根据导入和配置文件推断关系,而不是运行代码;大型仓库会在规定的读取限制内进行抽样。
  • 不内置团队同步功能:自托管文档保存在每位访问者的浏览器中,而仅查看分享需要单独部署 Worker。

FAQ

如何设置 OpenFlowKit?

OpenFlowKit 可直接在无需账户的托管版浏览器工作室中使用。自托管版本是一个静态 Web 应用,可以从文件夹提供服务或在 Docker 中运行;构建项目需要 Node 22.22 或更高版本。

OpenFlowKit 支持哪些工作流?

你可以在画布上绘图,粘贴或编写 Mermaid、D2 或 Structurizr,导入仓库映射,或连接 MCP 客户端。生成的图表仍是可编辑文档,代理所做的更改可以逐步撤销。

OpenFlowKit 可以映射私有 GitHub 仓库吗?

无需 API 密钥或安装,即可直接在浏览器中映射公开 GitHub 仓库。私有仓库必须通过本地检出目录进行映射,所需 CLI 已包含在 MCP 服务器软件包中。

仓库映射有哪些限制?

仓库映射器通过导入和配置文件推导连接关系,而不是执行应用程序。浏览器映射适用于公开 GitHub 仓库,并受 GitHub 未认证读取限制约束;大型仓库会根据文档所述的文件数量和总大小限制进行抽样。

支持哪些代理和 AI 工作流?

MCP 服务器支持 Claude Code、Codex、Cursor、VS Code、Claude Desktop、Windsurf 及其他 MCP 客户端。它在用户的计算机上运行,不需要单独的 API 密钥。通过云端模型发出的 AI 请求仍受相应提供商的数据处理政策和使用费用约束。

Quick Facts

类别
开发者工具;架构图设计
平台
可通过静态文件或 Docker 自托管的 Web 应用
许可证
MIT 许可协议开源
代理接口
包含 29 个图表和仓库工具的 MCP 服务器
图表输入
画布绘图、Mermaid、D2、Structurizr、GitHub 仓库
账户模式
托管工作室无需账户即可使用