---
slug: "anygen-diagram-generator-free"
name: "anygen-diagram-generator-free"
version: "1.0.0"
displayName: "AnyGen图表生成器免费版"
summary: "使用AnyGen CLI生成基础流程图与架构图，支持文本到图表的智能转换，适合快速可视化需求。。基于AnyGen CLI的图表生成技能免费版，通过www.anygen.io服务端 将文本描述"
summary_zh: "使用AnyGen CLI生成基础流程图与架构图，支持文本到图表的智能转换，适合快速可视化需求。。基于AnyGen CLI的图表生成技能免费版，通过www.anygen.io服务端 将文本描述"
license: "MIT"
description: |-
  基于AnyGen CLI的图表生成技能免费版，通过www.anygen.io服务端
  将文本描述转换为流程图、架构图等基础可视化图表。采用smart_draw
  操作类型驱动智能绘图引擎，支持API Key认证。适用于技术文档配图、
  流程梳理等基础场景。需要AnyGen CLI与anygen-workflow-generate
  依赖技能配合运行。本免费版支持基础图表类型与默认配置.
tags:
  - 研发工具
  - Diagram
  - Visualization
  - 工具
  - 效率
  - anygen
  - api
  - smart_draw
  - key
tools:
  - read
  - exec
  - write
homepage: ""
category: "Automation"
---
# AnyGen 图表生成器（免费版）

通过 AnyGen CLI 调用 `www.anygen.io` 服务端绘图引擎，将文本描述转换为流程图、架构图等基础可视化图表。核心操作类型为 `smart_draw`，由 `anygen-workflow-generate` 依赖技能编排生成流程。本免费版支持基础图表类型与默认渲染配置.
## 输入格式

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | AnyGen图表生成器免费版处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |

## 认证配置

AnyGen CLI 提供 API Key 认证方式：

```bash
anygen auth login --api-key sk-your-api-keyxxxxxxxxxxxx
```

也可通过环境变量持久化配置：

```bash
export ANYGEN_API_KEY=sk-your-api-keyxxxxxxxxxxxx
```

当命令返回认证错误时，检查 API Key 是否正确设置，或重新执行登录命令后重试.
## 依赖技能安装

本技能依赖 `anygen-workflow-generate` 技能来编排 `smart_draw` 操作。首次使用前需安装：

```bash
anygen skill install --platform claude-code -y
```

`--platform` 参数根据当前 Agent 运行平台选择，常见值包括 `claude-code`、`cursor`、`codex`、`gemini-cli`.
## 依赖说明

### 运行环境
- **Agent平台**: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
- **操作系统**: Windows / macOS / Linux

### 依赖项
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:-----|:-----|:-----|:-----|
| LLM API | API | 必需 | 由Agent内置LLM提供 |

### API Key 配置
需要配置对应API Key，详见上文环境配置章节

### 可用性分类
- **分类**: MD+EXEC（）

**API Key配置方式**:
```bash
export API_KEY="your_api_key_here"
```
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
## 核心能力

- **文本到图表转换**：将自然语言描述的流程、结构转换为标准可视化图表，无需手动编写图表语法
- **基础图表类型支持**：流程图、系统架构图、时序图等常见图表类型
- **服务端渲染**：图表在 `www.anygen.io` 服务端生成，输出可直接嵌入文档的图片
- **smart_draw 智能绘图**：由智能引擎根据文本描述自动识别图表类型并选择布局算法
### 文本到图表转换

针对文本到图表,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应.
**输入**: 用户提供文本到图表转换相关的配置参数、输入数据和处理选项.
**输出**: 返回文本到图表转换的处理结果。- 验证返回数据的完整性和格式正确性
- 参考`文本到图表转换`的配置文档进行参数调优
### 基础图表类型支持

针对基础图表类型支持,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应.
**输入**: 用户提供基础图表类型支持相关的配置参数、输入数据和处理选项.
**输出**: 返回基础图表类型支持的处理结果。- 验证返回数据的完整性和格式正确性
- 参考`基础图表类型支持`的配置文档进行参数调优
### 服务端渲染

针对服务端,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应.
**输入**: 用户提供服务端渲染相关的配置参数、输入数据和处理选项.
**输出**: 返回服务端渲染的处理结果。- 验证返回数据的完整性和格式正确性
- 参考`服务端渲染`的配置文档进行参数调优
#
## 快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

## 使用流程

1. **环境确认**: 确认Agent平台已加载本skill，检查依赖说明中的环境要求
2. **指令输入**: 向Agent描述需要执行的任务，引用`anygen-diagram-generator-free`的相关能力
3. **执行处理**: Agent按照核心能力章节的指令执行任务
4. **结果验证**: 检查输出结果是否符合预期，参考错误处理章节处理异常

#
## 适用场景

### 场景一：技术文档流程图配图

编写技术文档时，需要将业务流程或算法流程可视化为标准流程图。用户提供流程步骤的文字描述，本技能通过 smart_draw 操作生成包含判断分支、起止节点的流程图，直接嵌入文档.
### 场景二：系统架构图生成

设计系统或梳理现有架构时，需要将模块组成与依赖关系可视化为架构图。用户提供系统组成部分与调用关系的文字描述，本技能生成包含组件节点与连线的架构图，辅助团队理解系统结构.
### 场景三：业务流程梳理

产品或运营团队梳理业务流程时，需要将业务步骤可视化。用户提供业务环节描述，本技能生成标准流程图，便于团队评审与讨论流程合理性.
## 使用案例

### 案例一：用户注册流程图生成

用户描述用户注册流程包含填写信息、邮箱验证、手机号验证、创建账户四个步骤，其中邮箱验证与手机号验证失败需返回填写信息步骤重新提交。本技能调用 smart_draw 操作，生成包含起止节点、判断菱形、回退连线的标准流程图，每个节点附带简短说明，便于产品团队评审注册流程.
### 案例二：Web 应用架构图生成

用户描述一个 Web 应用由前端、Nginx 反向代理、后端 API 服务、数据库、缓存组成，前端通过 Nginx 访问后端 API，后端 API 读写数据库并查询缓存。本技能生成包含五个组件节点与调用关系连线的系统架构图，清晰展示各层调用方向，作为架构设计文档的配图.
## 命令执行规范

1. 检查 AnyGen CLI 认证状态，未认证则执行 `anygen auth login --api-key` 命令
2. 确认 `anygen-workflow-generate` 依赖技能已安装，缺失则执行 install 命令
3. 按 `anygen-workflow-generate` 技能指引，以 `smart_draw` 操作类型发起图表生成请求
4. 等待服务端渲染完成，获取生成结果
5. 将结果返回用户

## 异常处理

### 认证失败（auth error）

命令返回认证错误时，说明 API Key 未设置或失效。处理方式：检查 `ANYGEN_API_KEY` 环境变量是否正确设置，或重新执行 `anygen auth login --api-key sk-xxx` 命令，认证成功后重新执行原命令.
### 依赖技能未安装

执行 smart_draw 操作时报错提示 `anygen-workflow-generate` 技能不存在。处理方式：根据当前 Agent 平台执行 `anygen skill install --platform <平台标识> -y` 完成安装，安装完成后检查网络连接和配置后重试图表生成请求.
### 网络连接超时

调用 `www.anygen.io` 服务端时出现连接超时或不可达。处理方式：检查本机网络连接与代理配置，确认能正常访问外网。受限网络环境下配置 HTTP 代理后检查网络连接和配置后重试.
### smart_draw 操作参数缺失

发起 smart_draw 请求时未提供足够的图表描述信息，导致服务端无法识别目标图表类型。处理方式：补充图表类型、参与方、关系描述等关键信息后重新发起请求。描述越具体，生成质量越高.
### 图表生成结果与预期不符

生成的图表与用户描述存在偏差。处理方式：在原描述基础上补充约束条件（如节点数量、布局方向），或明确指定图表类型后重新生成。复杂图表建议拆分为多个简单子图分别生成.
## 常见问题

### Q1：AnyGen CLI 支持哪些操作系统？

AnyGen CLI 支持 Windows、macOS、Linux 三大主流操作系统。安装方式参考 AnyGen 官方文档对应平台的说明。CLI 运行依赖 Node.js 运行时环境，安装前请确认 Node.js 版本满足要求.
### Q2：API Key 如何获取？

API Key 通过 AnyGen 官方平台注册账号后获取。登录后在账户设置或 API 管理页面创建 API Key，复制后通过 `anygen auth login --api-key` 命令或 `ANYGEN_API_KEY` 环境变量配置。注意保管 API Key，避免泄露.
### Q3：免费版支持哪些图表类型？

免费版支持流程图、系统架构图、时序图等基础图表类型。通过 smart_draw 操作由智能引擎自动识别图表类型并渲染。对于复杂的图表需求（如多层级嵌套、大量节点），建议简化描述或拆分生成.
### Q4：生成的图表可以编辑吗？

生成的图表以图片形式输出，不能直接在 AnyGen CLI 中编辑。若需调整，修改原始文本描述后重新执行 smart_draw 操作重新生成。建议保留原始描述文本便于后续迭代.
## 错误处理

| 错误场景 | 原因 | 处理方式 |
|---:|---:|---:|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | 检查网络连接和配置后重试；确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |

## 已知限制

- 需要联网访问 `www.anygen.io` 服务端，纯离线环境无法使用
- 依赖 AnyGen CLI 与 `anygen-workflow-generate` 技能，两者缺一不可
- 图表生成质量取决于文本描述的清晰度，模糊描述会导致生成结果偏差
- 单次生成的图表节点数量存在上限，复杂图表需拆分生成
- 生成的图表为图片输出，不支持生成后直接编辑
- 服务端渲染耗时随图表复杂度增加

## 升级提示

本免费版支持基础图表类型与默认渲染配置。升级付费版可解锁以下能力：

- 完整图表类型支持（思维导图、组织结构图、状态机图、ER 图等）
- 自定义渲染配置（输出格式、布局算法、主题样式）
- 多层级复杂图表生成与分层渲染
- 图表描述编写规范指导与生成质量优化
- 完整异常处理与高级认证方式（浏览器交互认证）
- 支持的图表类型参考与编码参数精细控制

如需以上能力，请升级至付费版 anygen-diagram-generator.
## 输出格式

```json
{
  "success": true,
  "data": {
    "result": "AnyGen图表生成器免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "anygen-diagram-generator"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}
```