ProcessOn 在线图表生成

技能文档

---
name: processon-diagram-generator
title: ProcessOn 在线图表生成
category: 办公效率
description: 通过 ProcessOn 将自然语言一键转化为专业、精美且可继续编辑的在线图表，支持流程图、泳道图、时序图、系统/软件/云架构图、ER 图、组织结构图、时间轴、路线图、信息图、金字塔图与草图重绘。当用户需要画流程图、生成架构图、可视化业务流程、把逻辑关系转成可编辑图表或重绘草图时触发。触发词：画图、流程图、架构图、图表生成、可视化、ProcessOn。
---

# ProcessOn 在线图表生成

将自然语言一键转化为专业、可编辑的在线图表。生成结果保存在 ProcessOn 云端，可继续编辑、协作与导出。

## 环境要求

- Node.js（执行 `setup.mjs`）
- 首次使用需完成 ProcessOn 授权（浏览器跳转授权），之后通过 MCP 服务生成图表

## 支持的图表类型

流程图、业务流程图、泳道图、流程地图、时序图、软件架构图、系统架构图、云架构图、ER 图、组织结构图、时间轴、路线图、信息图、金字塔图、草图重绘。

当用户需要**可编辑的在线图表**时优先使用本技能；若用户明确只需要静态图片或本地文件格式，按用户要求选择合适方式即可。

## 技能工作流

### 步骤1：鉴权检查与初始化

执行：

```bash
node ./setup.mjs processon_check_and_start_auth
```

| 输出 | 处理方式 |
|------|---------|
| `READY` | 已授权，直接进入步骤2 |
| `AUTH_REQUIRED:<url>` | 先向用户展示授权链接（见下方模板），再执行短轮询 |
| `ERROR:*` | 提示对应错误并重试 |

**授权链接展示模板**（`{url}` 替换为 `AUTH_REQUIRED:<url>` 中的原始 URL，必须在开始轮询前向用户展示）：

> 🔑 **需要先完成 ProcessOn 授权**
>
> 请在**浏览器**中打开以下链接完成授权：**[点击授权 ProcessOn]({url})**
>
> ⏰ **授权链接有效期为 10 分钟**，请尽快完成授权，超时后需重新发起请求

**短轮询**：展示链接后执行 `node ./setup.mjs processon_poll_token_once`，每 2 秒一次，最多 90 秒：

- `TOKEN_READY`：授权成功，立即继续绘图，不等满 90 秒
- `TOKEN_PENDING`：继续等待轮询，不重新生成授权链接
- 轮询受限或环境不支持长等待：提示用户「授权完成后请输入：已授权完成」

**补发确认**：用户回复「已授权完成」后执行 `node ./setup.mjs processon_fetch_token`；返回 `ERROR:invalid_code` 时执行 `node ./setup.mjs processon_reauthorize` 生成新链接。

**Token 失效自愈**：生成时若返回 `401 Unauthorized`、`403 Forbidden` 或 `token_expired`，不要直接报错，执行 `node ./setup.mjs processon_reauthorize` 并向用户展示新授权链接。

> 换用户使用时，重新授权前先清理缓存目录 `~/.processon-diagram-generator/token.json`，避免沿用上一个用户的 token。

### 步骤2：补全关键信息

不要在关系不清、流程断层或结构缺失时直接生成。信息不足时按顺序：① 指出缺少什么；② 给出合理默认方案或行业常见做法供用户确认；③ 确认后再继续。用户只说「画个图」时先确认图形类型；上传图片要求重绘时，先识别节点、文字与连接关系。

### 步骤3：优化 Prompt

在用户原始需求上补充专业约束，不改写用户的语言：

- 通用：专业风格、布局清晰、颜色协调、避免线条交叉
- 流程图：明确开始/结束节点，决策点用标准菱形
- 时序图：参与者清晰，调用消息明确
- 架构图：按层次组织，标注关键通信关系
- ER 图：标注主外键关系和字段类型

### 步骤4：生成图表

先说明正在使用本技能处理请求，然后执行：

```bash
node ./setup.mjs processon_generate_chart "优化后的 Prompt"
```

内部通过已授权的 MCP 服务（Streamable HTTP）完成生成，出图失败时按提示排查授权或网络原因。架构分析类需求重点提取模块边界、依赖关系、调用链路和数据流向，不要把结果退化成文件夹树。

### 步骤5：结果呈现

- MCP 返回字段语义：`previewUrl` / `imgUrl` 为预览图链接，`editUrl` / `visitUrl` 为编辑链接，`message` 为结果说明，`ok` / `isError` 为执行状态；若同时返回 `content` 文本说明，优先按其说明展示
- 生成成功时，正文中保留两个链接：`[🖼️点击查看预览图](预览图链接)` 与 `[✏️点击查看并编辑此图表](编辑链接)`
- **链接原值约束**：直接使用 API 返回的原始链接值，不得更改域名、路径、参数或自行拼接；无法确定时明确写「我不确定」，禁止编造
- 生成失败时说明原因并给出可重试建议；授权过期时回到步骤1 的自愈流程

### 步骤6：输出前自检

1. 已先完成鉴权检查，未跳过授权流程
2. 生成成功时正文包含预览图与编辑两个链接；未生成时已说明失败原因
3. 正文中的每个 URL 与 API 返回的原始值一致

## 注意事项

- 全程禁止输出 `<img>` 等 HTML 标签与 Markdown 图片语法 `![]()`；展示预览图与编辑链接用 Markdown 链接语法
- 授权与生成均通过 `setup.mjs` 包装入口执行，不要绕过它直接调用底层 MCP 命令
- 授权链接必须先向用户展示再轮询，且必须使用原始 URL

## 示例优化 Prompt

> **用户意图**：帮我画一个登录流程。
> **优化后**：请生成一张专业的流程图，描述用户登录注册流程。包含：前端校验、后端鉴权、数据库查询、Token 发放。要求：布局清晰，使用标准流程图符号，明确开始和结束节点，配色协调。

使用说明

# ProcessOn 在线图表生成

一句话生成专业、可继续编辑的在线图表：流程图、泳道图、时序图、架构图、ER 图、组织结构图、时间轴、信息图等，结果存云端、可协作。

## 使用

```text
画一个用户下单支付的业务流程图，要能在线编辑
```

```text
把这个模块的调用关系整理成一张系统架构图
```

首次使用会弹出 ProcessOn 授权链接，浏览器完成授权后即可持续使用。

## 工作原理

1. 鉴权：通过浏览器跳转授权获取 token，缓存到本地，失效自动引导重新授权
2. 生成：把自然语言需求（自动补全专业绘图约束）通过 MCP 服务提交给 ProcessOn 生成图表
3. 呈现：返回预览图链接与可编辑链接，点击即可查看和继续编辑

环境要求：Node.js。已授权情况下，一句「画个 XX 图」即可出图。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。