Anygen Diagram Generator Free

SKILL.md

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

# AnyGen 图表生成器（免费版）

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

## 认证配置

AnyGen CLI 提供 API Key 认证方式：

```bash
anygen auth login --api-key sk-xxxxxxxxxxxxxxxx
```

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

```bash
export ANYGEN_API_KEY=sk-xxxxxxxxxxxxxxxx
```

当命令返回认证错误时，检查 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 智能绘图**：由智能引擎根据文本描述自动识别图表类型并选择布局算法
### 文本到图表转换

执行文本到图表转换操作,处理用户输入并返回结果。

**输入**: 用户提供文本到图表转换所需的参数和指令。

**输出**: 返回文本到图表转换的处理结果。

- 执行`文本到图表转换`操作，处理输入数据并返回结果
- 验证执行结果，确认输出符合预期格式
- 参考`文本到图表转换`相关配置参数进行设置
### 基础图表类型支持

执行基础图表类型支持操作,处理用户输入并返回结果。

**输入**: 用户提供基础图表类型支持所需的参数和指令。

**输出**: 返回基础图表类型支持的处理结果。

- 执行`基础图表类型支持`操作，处理输入数据并返回结果
- 验证执行结果，确认输出符合预期格式
- 参考`基础图表类型支持`相关配置参数进行设置
### 服务端渲染

执行服务端渲染操作,处理用户输入并返回结果。

**输入**: 用户提供服务端渲染所需的参数和指令。

**输出**: 返回服务端渲染的处理结果。

- 执行`服务端渲染`操作，处理输入数据并返回结果
- 验证执行结果，确认输出符合预期格式
- 参考`服务端渲染`相关配置参数进行设置
### 能力覆盖范围

本skill还覆盖以下能力场景: CLI、生成基础流程图与、支持文本到图表的、智能转换、适合快速可视化需、的图表生成技能免、将文本描述转换为、架构图等基础可视、操作类型驱动智能、绘图引擎、API、Key、适用于技术文档配、流程梳理等基础场、workflow、generate、依赖技能配合运行、本免费版支持基础、图表类型与默认配。这些能力在上述核心功能中均有对应处理逻辑。
## 使用流程

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

### 命令参数说明

- `-xxxxxxxxxxxxxxxx`: 命令参数,用于指定操作选项

## 适用场景

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

编写技术文档时，需要将业务流程或算法流程可视化为标准流程图。用户提供流程步骤的文字描述，本技能通过 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` 完成安装，安装完成后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令图表生成请求。

### 网络连接超时

调用 `www.anygen.io` 服务端时出现连接超时或不可达。处理方式：检查本机网络连接与代理配置，确认能正常访问外网。受限网络环境下配置 HTTP 代理后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令。

### 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响应超时或无响应 | 网络延迟或模型负载过高 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接，执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令请求；确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |

## 已知限制

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

## 升级提示

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

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

如需以上能力，请升级至付费版 anygen-diagram-generator。