> 功能说明: 本技能涵盖 配图生产 等核心能力。
AnyGen图表生成工具 - 专业版
概述
AnyGen图表生成专业版是一款面向企业团队与专业用户的高级图表与可视化结构生成工具。在免费版自然语言生成图表能力之上,扩展了批量图表生成、自定义模板库、团队协作、API 集成与多格式输出等高级功能,可融入商业文档内容生产流水线.
本版本完全兼容免费版所有命令与认证方式,企业用户可直接迁移既有工作流并获得更强大的批量处理与团队协作能力.
核心能力
| 能力项 | 免费版 | 专业版 | 说明 |
|---|---|---|---|
| 自然语言生成图表 | 是 | 是 | 描述即出图 |
| 流程图/架构图/组织图 | 是 | 是 | 多类型支持 |
| 服务端渲染 | 是 | 是 | 高质量输出 |
| 简单认证 | 是 | 是 | 浏览器/Key |
| 批量生成 | 否 | 是 | 多描述队列 |
| 自定义模板 | 否 | 是 | 统一团队风格 |
| 团队协作 | 否 | 是 | 资产共享 |
| API 集成 | 否 | 是 | 程序化调用 |
| 多格式输出 | 限制 | 是 | PNG/SVG/PDF/MD |
| 渲染优先级 | 普通 | 高优先 | 企业级保障 |
| 技术支持 | 社区 | 专属 | 工单响应 |
核心功能执行
用input_params参数进行配置.
处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.
- 执行此能力时使用input_params参数,支持创建/查询/导出操作
参数配置与调用
用config_options参数进行配置.
处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志.
- 执行此能力时使用config_options参数,支持修改/重置/导入操作
结果处理与输出
用output_format参数进行配置.
处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志.
- 执行此能力时使用output_format参数,支持导出/保存/转换操作
能力覆盖范围:本skill的核心能力覆盖以下场景关键词:企业级图表生成工、支持批量生成、团队协作与、适配商业文档生产、AnyGen、图表生成专业版、面向企业团队与专、业用户的高级图表、与可视化结构生成、核心能力、批量图表生成、支持多描述队列处、自定义图表模板库、团队协作与图表资、产管理、可嵌入文档生成系、Markdown、优先渲染队列与企、业级技术支持等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.
使用场景
场景一:技术文档批量配图
技术写作团队需为一批文档批量生成架构图与流程图.
# 批量生成图表
python3 (请参考skill目录中的脚本文件) \
--input ./diagram_specs/ \
--output ./diagrams/ \
--format svg \
--parallel 5
# ...
# diagram_specs/ 目录下放置多个描述文件(JSON)
# 示例
# {
# "name": "microservice_arch",
# "description": "微服务架构图:前端→API网关→[用户/订单/支付]服务→数据库",
# "template": "enterprise_arch",
# "format": "svg"
# }
场景二:企业架构图标准化
企业需统一各部门架构图的视觉风格,使用自定义模板库.
# 创建自定义模板
python3 (请参考skill目录中的脚本文件) \
--name "enterprise_arch" \
--style "企业标准风格" \
--colors "#1a365d,#2b6cb0,#63b3ed" \
--fonts "Noto Sans CJK SC" \
--output ./templates/
# ...
# 应用模板生成图表
anygen smart_draw "企业IT架构图" \
--template enterprise_arch \
--output ./diagrams/it_arch.svg
场景三:产品文档图表自动生成
产品团队需将 PRD 中的流程描述自动转化为图表.
# 从 PRD 文档提取描述并生成图表
python3 (请参考skill目录中的脚本文件) \
--input ./prd/user_flow.md \
--extract "流程图描述" \
--template product_flow \
--output ./diagrams/user_flow.svg
# ...
# API 集成到文档系统
curl -X POST https://api.anygen.io/v1/diagrams \
-H "Authorization: Bearer $ANYGEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"description": "用户注册流程:填写信息→验证邮箱→完善资料→完成注册",
"template": "product_flow",
"format": "svg"
}'
场景四:团队图表资产管理
团队需将优质图表沉淀为可复用资产,使用团队协作功能.
# 提交图表到团队资产库
python3 (请参考skill目录中的脚本文件) \
--file ./diagrams/microservice_arch.svg \
--description "微服务标准架构图" \
--tags "架构,微服务,标准" \
--category "reference"
# ...
# 团队成员搜索与复用
python3 (请参考skill目录中的脚本文件) \
--query "微服务架构" \
--category "reference"
# ...
# 拉取团队最新模板
python3 (请参考skill目录中的脚本文件) \
--remote team-repo \
--branch main
不适用场景
以下场景AnyGen图表生成-专业版不适合处理:
- 逆向工程闭源API
- API安全安全评估
- 非标准协议集成
触发条件
需要API集成、接口对接、Webhook配置、系统连接时使用。不适用于非本工具能力范围的需求.
快速开始
领先步:配置企业 API Key
# 企业版认证
anygen auth login --api-key sk-pro-未指定
export ANYGEN_API_KEY=sk-pro-未指定
export ANYGEN_EDITION=pro
第二步:执行批量生成
python3 (请参考skill目录中的脚本文件) \
--input ./specs/ \
--output ./diagrams/ \
--format svg \
--parallel 5
第三步:归档与分发
# 归档到团队资产库
python3 (请参考skill目录中的脚本文件) \
--input ./diagrams/ \
--message "批量生成技术文档配图"
配置示例
专业版完整配置:
# 环境变量
ANYGEN_API_KEY=sk-pro-未指定
ANYGEN_EDITION=pro
ANYGEN_MAX_BATCH=50
ANYGEN_DEFAULT_FORMAT=svg
ANYGEN_DEFAULT_TEMPLATE=enterprise_arch
ANYGEN_TEAM_REPO=git@team:diagrams-repo
# ...
# 批量生成参数
--input <dir> # 输入目录(描述文件)
--output <dir> # 输出目录
--format png|svg|pdf|md # 输出格式
--parallel <n> # 并发数(1-10)
--template <name> # 自定义模板
# ...
# 团队协作参数
--team-project <name> # 团队项目名
--category <category> # 资产分类
--tags <tag1,tag2> # 标签
输出格式对照
| 格式 | 适用场景 | 特点 |
|---|---|---|
| PNG | 文档嵌入、演示 | 位图,通用性强 |
| SVG | 网页展示、可缩放 | 矢量,无损缩放 |
| 印刷、归档 | 适合正式文档 | |
| Markdown | 文档源码、Git | 文本格式,可版本控制 |
优选实践
- 模板先行:建立团队统一的图表模板(颜色/字体/风格),确保视觉一致性
- 描述规范化:图表描述使用规范结构(节点+关系+层级),提升生成准确度
- 批量分批处理:大批量任务建议分批(每批 20-30 个),避免队列拥堵
- SVG 优先:技术文档优先用 SVG(可缩放可编辑),演示用 PNG,归档用 PDF
- 资产标签管理:图表入库时打标签(架构/流程/组织),便于检索复用
- 版本控制:图表描述文件纳入 Git 管理,变更可追溯
- API 集成自动化:通过 API 集成到文档生成流水线,实现 PRD→图表自动化
常见问题
Q1:专业版与免费版是否兼容?
A:完全兼容。专业版支持免费版所有命令与认证方式,迁移时仅需更换 API Key 并设置 ANYGEN_EDITION=pro.
Q2:批量生成支持多少图表?
A:单批最多 50 个图表,并发数 1-10 可调。大批量建议分批处理.
Q3:自定义模板如何创建?
A:通过 create_template 脚本定义模板名称、风格、颜色、字体等,保存到团队模板库。生成图表时通过 --template 参数应用.
Q4:多格式输出如何选择?
A:网页展示用 SVG(可缩放),文档嵌入用 PNG(通用),印刷归档用 PDF(正式),文档源码用 Markdown(可版本控制).
Q5:团队协作支持多少人?
A:License 绑定团队席位,支持 5-50 人团队(视授权规模)。支持资产共享、模板管理与权限控制.
Q6:能否集成到 CI/CD 流水线?
A:可以。通过 API 可集成到文档构建流水线,实现 PRD/Markdown 文档变更→图表自动重新生成→文档发布的自动化流程.
依赖说明
运行环境
- Agent平台: 支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
- 操作系统: Windows / macOS / Linux
- 运行时: AnyGen CLI + Python 3.9+
依赖详情
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| AnyGen Pro API | 外部 API | 必需 | 企业服务渠道申请 |
| AnyGen CLI | 命令行工具 | 必需 | 官方安装 |
| Python 3.9+ | 脚本运行 | 必需 | 官方安装 |
| Git | 版本控制 | 必需 | 系统自带 |
| anygen-workflow-generate | 工作流技能 | 必需 | anygen skill install |
API Key 配置
- 环境变量名:
ANYGEN_API_KEY(企业版 Key) - 附加变量:
ANYGEN_EDITION=pro - 获取方式: 通过企业服务渠道申请,享有高优先级渲染队列
- 安全建议: 使用密钥管理服务存储 Key,团队仓库使用 SSH 密钥认证
- 认证方式: 支持 API Key、浏览器授权两种方式
可用性分类
- 分类: MD+execute(纯 Markdown 指令,核心功能需要 exec 命令行执行能力)
- 说明: 基于Markdown的AI Skill,支持批量生成、自定义模板、团队协作等企业级图表生产场景
错误处理
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |
已知限制
- 需要API Key,无Key环境无法使用
示例
基本用法
输出:返回执行结果,包含操作状态和输出数据
用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功
安全注意事项
| 风险类型 | 防范措施 |
|---|---|
| API密钥泄露 | 通过环境变量配置,禁止硬编码到代码或配置文件中 |
| 命令执行风险 | 仅执行白名单命令,避免拼接用户输入到命令行参数中 |
| 网络通信安全 | 使用HTTPS协议,验证SSL证书有效性 |
| 敏感数据暴露 | 输出结果中不包含密钥、令牌等敏感信息 |
使用前请确认已阅读依赖说明章节,确保运行环境满足安全要求。