name: flow-to-markdown
description: "将 .flow 工作流文件转换为 Markdown 文档。当用户需要解析 .flow 文件、识别工作流结构或生成工作流文档时调用。包含变量 ID 映射、参数来源和输出目标。"

Flow文件转Markdown技能（增强版）

功能概述

将 .flow 格式的工作流文件转换为结构清晰的 Markdown 文档，必须包含每个节点的详细输入输出变量配置信息。

核心要求

⚠️ 关键要求：必须解析详细输入输出配置

解析工作流时，必须包含以下信息：

1. 变量 ID 映射表：每个变量的 ID、名称、类型、必填性
2. 节点输入参数详情：
3. 参数名
4. 参数值（变量引用需显示来源变量名称）
5. 来源变量（从哪个变量获取）
6. 节点输出参数详情：
7. 参数名
8. 变量ID
9. 输出到哪个变量
10. 变量传递关系：完整的数据流向图
11. 子工作流调用信息：输入参数、版本ID、输出参数

输出目录

所有转换后的 Markdown 文件默认保存在 hy-skill/hy-custom-workflow/ 目录下：

hy-skill/hy-custom-workflow/
├── 【H.】文档知识更新与版本同步.md
├── 其他工作流.md
└── ...

使用方法

与 hy-skill 集成使用

当使用 hy-skill 进行工作流识别时：
1. 用户发出"识别这个工作流"指令
2. 选择".flow文件识别"方式
3. 上传或选择本地 .flow 文件
4. 系统自动调用此技能进行处理
5. 输出 Markdown 格式的完整工作流文档到 hy-custom-workflow/ 目录

解析规范

变量映射表格式

节点输入参数格式

**输入参数**:
| 参数名 | 值 | 来源变量 |
|--------|-----|----------|
| document_name | 知识名称(3506a7cac2) | 变量：知识名称 |
| versionId | null | 随版本启用（使用最新激活版本） |

节点输出参数格式（标准节点）

**输出参数**:
| 参数名 | 说明 |
|--------|------|
| message | 输出到：关键词结果 |

节点输出参数格式（子工作流节点）

子工作流节点的输出参数存储在 outputParametersByNode 字段中，格式如下：

**输出参数**:
| 参数名 | 变量ID | 说明 | 输出到变量 |
|--------|--------|------|-----------|
| fill | 37dee9afb4 | 待填写字段 | 待填写字段 |
| knowledge_result | 5f90c85875 | 模板正文内容 | 模板正文内容 |

变量引用解析规则

当参数值包含 {{变量ID}} 时，必须：

1. 提取变量 ID
2. 查找变量名称
3. 显示为：变量名称(变量ID)

例如：{{3506a7cac2}} → 知识名称(3506a7cac2)

完整输出结构

生成的 Markdown 文档必须包含以下章节：

1. 基本信息：流程ID、名称、状态、创建时间等
2. 输入变量：完整的变量列表（含ID）
3. 输出变量：输出变量列表（含ID）
4. 执行路径：简化的流程说明
5. 详细节点配置：每个节点的完整输入输出
6. 节点基本信息
7. 输入参数表（含来源变量）
8. 输出参数表（含输出目标）
9. 条件分支（如果有）
10. 子工作流调用详情（如果有）
11. 变量传递关系图：展示数据流向
12. Mermaid 流程图：可视化流程
13. 子工作流依赖表：列出所有调用的子工作流
14. 潜在问题：标记 versionId 为 null 等问题

依赖

• Python 3.x
• 无需额外依赖（使用标准库）

核心脚本

convert_flow.py

主转换脚本，实现以下功能：

1. Base64 + URL 解码 .flow 文件
2. 解析嵌套 JSON 结构
3. 提取变量 ID 到名称的映射
4. 翻译组件类型为中文
5. 解析每个节点的详细输入输出配置
6. 解析子工作流的 outputParametersByNode
7. 生成完整的 Markdown 文档

参考文档

• references/component-types.md - 组件类型中英文对照表