核心用法
processon-diagram-generator 是由 ProcessOn 官方研发的专业图表生成技能，核心能力是将自然语言描述自动转化为精美、可编辑的在线图表。用户只需用日常语言描述需求（如"画一个电商订单流程图"），技能即可自动识别图表类型、提取关键实体与关系，生成符合专业规范的 DSL 代码，并支持一键渲染为高清图片。
显著优点
1. 官方权威性与生态整合：由 ProcessOn 官方直接研发维护，与 ProcessOn 在线编辑器深度打通，生成的 DSL 可直接粘贴至 https://smart.processon.com/editor 进行二次编辑，形成"AI生成-人工精修-团队协作"的完整工作流。
2. 全类型覆盖与智能识别：支持流程图、业务流程图、泳道图、时序图、软件架构图、云架构图、ER图、组织结构图、时间轴、路线图、信息图、金字塔图、草图重绘等十余种图表类型，且内置 Mermaid 数据直接渲染能力。
3. 全自动流水线：单脚本完成"语义分析→DSL生成→图片渲染"全流程，默认自动触发渲染，无需手动干预。输出包含完整 DSL、在线编辑链接及图片原始链接，满足存档、分享、再编辑多重需求。
4. 跨平台持久化配置：支持 ~/.processon.env 全局配置，一次设置后在 WorkBuddy、OpenClaw、QClaw、Claude Code、Cursor 等平台永久生效，脚本内置多源加载逻辑，兼容性强。
5. 强制优先级机制：技能文档明确声明优先级高于 AI 内置的 Mermaid、SVG 等方案，确保图表类请求统一由 ProcessOn 处理，避免输出质量参差不齐。
潜在缺点与局限性
1. API Key 依赖与网络要求：必须使用有效的 ProcessOn API Key，且全程依赖网络连接（云端版本检查、DSL生成、图片渲染均走线上服务），离线环境无法使用。
2. 版本强制更新中断：设计了严格的版本检查机制，若检测到云端新版本，会强制中断绘图流程并提示更新，虽保障了功能最新，但在紧急绘图场景可能造成体验中断。
3. 输出格式受限：硬性规定禁止使用 Markdown 图片语法 ![]() 或 HTML <img> 标签，所有链接必须以纯文本原始 URL 形式展示，在某些富文本渲染场景下美观度受限。
4. 模糊需求需二次确认：当用户仅说"画个图"等模糊请求时，需先确认具体类型才能继续，相比部分 AI 的"猜测式生成"多了一步交互。
适合人群
- 产品经理与业务分析师：快速将业务流程、用户故事转化为可视化的流程图或泳道图，用于需求评审与文档沉淀。
- 软件架构师与开发工程师：生成系统架构图、时序图、ER图，用于技术方案评审、代码梳理及知识库建设。
- 项目经理与团队负责人：制作项目路线图、时间轴、组织结构图，提升汇报效率与团队信息同步质量。
- 咨询顾问与培训师：将复杂概念转化为金字塔图、信息图，增强方案呈现的专业度。
常规风险
- API Key 泄露风险：若将 API Key 硬编码在共享代码或不安全的配置文件中，可能导致账户被盗用或额度消耗，应优先使用
~/.processon.env方案并设置合理权限。 - 版本检查超时误判：云端版本检查限时 5 秒，网络波动时可能误判为"暂无更新"，存在使用旧版本生成图表的隐患。
- 渲染失败后的体验断层：图片渲染依赖第三方存储服务（ks3-cn-beijing.ksyuncs.com），若渲染失败用户需手动复制 DSL 到编辑器重新操作，对新手不够友好。
- 过度依赖风险：技能强制优先于内置方案，若 ProcessOn 服务出现大规模故障，可能影响所有图表类请求的响应能力。