Skip to main content
DiagramAI 可以创建新图，也可以修改编辑器中当前打开的图表。你可以提交提示词、上传支持的来源文件，或同时使用两者。

​
选择图表类型

当来源或提示词足以说明结构时，可以使用自动识别。需要特定表示法时，请手动选择类型。 自动识别不是第 14 类图表。手动选择后，Agent 会锁定该类型。

​
上传来源资料

图片

上传 PNG、JPEG 或 WebP。DiagramAI 会提取可见节点、标签、关系和布局。

接口与数据

使用 OpenAPI JSON 或 YAML、SQL Schema 生成接口架构图或 ER 图。

基础设施

使用 Docker Compose、Kubernetes 或 Terraform 文件展示服务、资源和依赖。

CI 与 ZIP

直接使用 CI 工作流文件，或把受支持的多文件来源打包为一个 ZIP。
附件按钮一次最多接受 10 个同一来源类型的非 ZIP 文件。上传附件后，提示词可以为空；如果需要限定范围或展示方式，请继续填写提示词。

​
文件限制

  • 每次请求最多 10 个附件
  • 单张图片最大 10 MB
  • 单个文本来源文件最大 5 MB
  • 非 ZIP 附件合计最大 10 MB
  • 每次最多一个 ZIP，并且 ZIP 必须是唯一附件
  • ZIP 最大 10 MB 压缩体积、50 MB 解压体积和 500 项
ZIP 安全解包会拒绝加密包、嵌套压缩包、绝对路径、路径穿越、符号链接、设备文件、异常压缩比和其他危险条目。DiagramAI 不会安装依赖、执行构建、运行基础设施工具、启动 CI 或执行附件中的用户代码。

​
组织提示词

有效提示词通常包括：
  1. 图表类型和用途
  2. 组件、参与者或来源范围
  3. 顺序、关系或边界
  4. 重要分支和异常
  5. 必须出现的标签
请统一使用产品名和领域名称。使用附件时，可以说明要重点展示的 Namespace、Tag、Module、 表分组或 Workflow。

​
DiagramAI 如何执行请求

DiagramAI 会先识别来源和修改意图：
  • 展示层修改保留语义、拓扑和坐标。
  • 局部修改只改变有限结构，并在需要时进行局部布局。
  • 完整生成用于新图、类型转换、主要结构变化或明确的重新设计。
文本来源中的实体和关系属于权威事实。DiagramAI 不会让两个模型候选分别发明不同的来源结构。 交付前，结果会经过文档结构和渲染检查。根据执行路径，还可以检查布局、重叠、标签、层级和连线可读性。

​
创建新图表

1

选择保存位置

打开目标文件夹，或停留在工作空间根目录。
2

打开 AI 生成

选择 AI 生成，按需指定图表类型，然后填写提示词或上传来源资料。
3

确认来源范围

如果 ZIP 中包含多个支持的来源类型，请选择本次主来源。大规模或含糊输入也可能需要选择范围。
4

提交并检查

根据界面显示的处理阶段等待完成。DiagramAI 会创建文件并打开可编辑结果。

​
修改当前图表

在编辑器中打开 AI 面板，并相对于现有图表描述变化：
如果当前图表非空，并且需求没有明确说明替换、合并还是创建新结果，DiagramAI 会在应用前询问你的选择。

​
credits 用量

  • 上传、哈希和确定性解析不消耗 credits。
  • DiagramAI 会检查可用余额是否足以覆盖 AI 请求。
  • 成功请求按照实际 Token 用量扣除 credits。
  • 失败或取消的请求不扣除 credits。
  • 个人工作空间请求使用个人余额。
  • 团队工作空间请求使用组织共享余额。
请参阅套餐、credits 与账单了解赠送额度和购买规则。
AI 输出可能不完整或不准确。在将图表用于实施、运维、安全或其他重要决策前，请进行人工检查。