SuperAPI AI 工具集

processon-diagram-generator

设计与创作

查看项目

更新于 10-15 21:48

技能介绍

用途:将带有依据的图表规格转换为可编辑的 ProcessOn DSL,并在需要时渲染为图片。仅在用户明确要求 ProcessOn 或托管可编辑输出时使用;普通 Markdown 原生图表用 mermaid 技能,严格 UML、C4 或 .puml 输出用 plantuml 技能,仅需 ProcessOn 思维导图大纲时用 processon-mindmap 技能。

配置:必须设置环境变量 export PROCESSON_API_KEY="<your-processon-api-key>",密钥可在 https://smart.processon.com/user 获取,切勿打印、持久化或写入提示与输出。可选变量包括 PROCESSON_DSL_API_URL、PROCESSON_RENDER_API_URL、PROCESSON_MODEL、PROCESSON_UID、PROCESSON_CONNECT_TIMEOUT、PROCESSON_MAX_RETRIES。不要每次调用都做远程更新检查,仅在用户询问更新或维护时查看内置版本文件;显式更新检查命令为 python3 scripts/check_update.py。

工作流:从请求或已检查的源中提取节点、关系、决策、参与者、状态与标签;通过源检查补全缺失关系,仅在歧义会实质改变图表时提问;构建保留用户语言、要求布局可读且交叉最少的简洁提示;运行内置客户端,例如 python3 scripts/processon_api_client.py --title "登录流程" "生成登录、鉴权、数据查询和令牌签发流程图";仅需可编辑 DSL 时加 --no-render。即使图片渲染失败,也要交付完整 DSL 与编辑链接。

输出约定:最终回复须包含未截断的完整 DSL、编辑链接 https://smart.processon.com/editor、渲染成功时的图片 URL 或保存路径、渲染失败时的明确原因,以及重建图表时所做的假设。宿主支持时使用普通 Markdown 链接或本地图片预览。

可靠性:仅对超时、连接失败、HTTP 429 和 HTTP 5xx 重试,使用有界指数退避;不重试认证等确定性 4xx 失败;DSL 交付独立于图片渲染成功;图片保存到请求的项目或明确输出目录,不使用机器特定硬编码路径;对空或畸形 API 响应给出不泄露凭据的诊断。

验证:完成前确认 DSL 非空、图表类型已知或明确为通用、编辑链接存在、本地输出路径存在。修改客户端后运行离线单元测试:python3 -m unittest discover -s tests -p 'test_*.py'。