新上线1个月前56 投票
Zindex：为AI Agent打造的图基础设施——让图表成为持久化状态而非一次性输出
Zindex 是一个面向AI Agent的图表基础设施，它将图表视为可持久化的状态，而非一次性生成结果。其核心是 Diagram Scene Protocol (DSP)，一种机器可读的图表描述协议，Agent 通过它声明节点、边和关系，而布局、渲染等几何计算则由引擎自动完成。
核心能力
- 语义化而非几何化：Agent 只需描述图表内容（如“API网关”连接“任务队列”），引擎自动计算布局，无需手动指定坐标。
- 增量编辑：通过稳定ID支持局部更新，添加或移动节点时无需重新生成整个图表。
- 确定性执行：相同的输入总是产生相同的输出，每个步骤（验证→标准化→布局→渲染）均可审查。
- 多格式渲染：支持 SVG 和 PNG 输出，并提供四种主题（干净、暗色、蓝图、手绘）。
- 领域专用：专为架构图、BPMN工作流、ER图、序列图、组织架构图和网络拓扑图设计，而非通用矢量图形。
- 生产级验证：内置 40+ 验证规则，确保图表符合领域规范。
架构与工作流
Zindex 的流水线分为四步：
- Validate：检查图表结构是否符合 DSP 规范。
- Normalize：将输入转换为标准内部表示。
- Layout：使用 Sugiyama 风格的分层布局算法自动计算节点位置和连线路径。
- Render：输出为 SVG 或 PNG 格式。
为什么需要 Zindex？
传统上，AI 生成图表往往是一次性的：输出一张图片后便失去上下文。Zindex 将图表视为 版本化工件，支持修订历史、差异对比和稳定ID，使得多个 Agent 可以协作编辑同一个图表，并追踪变更。这对于需要持续维护和演进的系统架构图、业务流程图等场景尤为重要。
适用场景
- 多Agent协作：多个 Agent 共同编辑同一张图表，各自负责不同模块。
- 持续更新：系统架构随代码演进，图表需要频繁增量修改。
- 可追溯性：需要审计图表变更历史，例如合规性文档。
- 自动化文档：CI/CD 流水线中自动生成并更新图表。
总结
Zindex 填补了 AI 生成图表领域的一个空白：从“生成图片”升级为“管理图表状态”。对于需要持久化、协作和版本控制的开发团队来说，它是一个值得关注的基础设施工具。目前项目已开源，可以在 GitHub 上找到，并提供了在线 Playground 供试用。