# Workflow 编排模块需求

## 1. 模块目标

Workflow 编排模块负责把知识检索、模型调用、MCP 工具、Skill 和回答输出组织成可保存、可测试、可发布、可追踪的图形化流程。

## 2. 功能需求

- 支持项目空间管理，区分环境和发布状态。
- 支持 Workflow 草稿编辑、保存和发布版本。
- 支持节点库：Start、LLM、Knowledge Retrieval、MCP Tool、Skill、Condition、Answer。
- 支持 JSON Graph 保存画布结构。
- 支持运行测试并生成运行记录和步骤日志。
- 支持绑定默认 Agent，供对话调试和发布使用。

## 3. 发布要求

- 草稿可以保存但不能直接作为生产版本。
- 发布时必须生成不可变版本快照。
- 发布前必须检查模型路由、知识库索引、MCP 授权和 Skill 发布状态。

## 4. 关联资料

- 表：`studio_project`、`workflow_definition`、`workflow_version`、`workflow_run`、`workflow_run_step`
- 枚举：`studio/environment`、`studio/publish_status`、`workflow/status`、`workflow/run_status`、`workflow/node_type`
- 脚本：`script/sql/studio_project.sql`、`script/sql/workflow.sql`
- 前端原型：`StudioDashboardPage.vue`、`WorkflowBuilderPage.vue`