openflowkit/openflowkit

解决的问题

OpenFlowKit 是一个以本地优先的开源工具，用于创建可作为代码管理、手绘或由 AI 代理生成的架构图。它消除了静态图表与不断演进的代码库之间的摩擦，允许用户将 GitHub 仓库直接映射到可视化地图中，并通过 CI/CD 流水线中的偏差检测确保图表与实际代码保持同步。

运作方式

该工具使用专有的 OpenFlow DSL (领域特定语言)，作为文本、可视化画布和 AI 代理之间的通用桥梁。无论用户粘贴 Mermaid、Structurizr 还是 D2 代码，编译器都会将其转换为 OpenFlow DSL。此 DSL 随后驱动可视化画布、CLI 和 MCP (Model Context Protocol) 服务器，允许 AI 代理 (如 Claude Code 或 Cursor) 在画布上或 .openflow.json 文件中实时读取、绘制和编辑图表。

目标对象

它专为需要维护准确系统文档的软件架构师、开发人员和团队而设计。对于那些使用 AI 编程助手来协助可视化复杂代码库，或希望将图表验证集成到 CI/CD 工作流程中的用户特别有用。

特色亮点

• 代理原生设计 (Agent-Native Design)：包含一个 MCP 服务器，让 AI 代理可以在画布上实时绘制、重新设计样式并截取图表屏幕截图。
• 自动化仓库映射：从公开的 GitHub 仓库生成架构图，并将箭头指向特定的代码行。
• 双向编辑：通过可视化画布所做的变更会反映在文本中，反之亦然。
• 偏差检测：一个可集成到 CI 中的 CLI 工具，用于标记实际代码库与记录的架构不一致的情况。
• 多格式导出：支持 PNG、SVG、PDF、JSON 以及用于逐步流程可视化的动画 SVG/GIF/MP4。