# ZCLAW Pipelines

Pipeline 是 ZCLAW 中声明式的自动化工作流定义。每个 Pipeline 描述了完成特定任务所需的一系列步骤。

## 目录结构

```
pipelines/
├── education/           # 教育类 Pipeline
│   └── classroom.yaml   # 互动课堂生成器
├── marketing/           # 营销类 Pipeline
│   └── (待添加)
├── legal/               # 法律类 Pipeline
│   └── (待添加)
└── _templates/          # Pipeline 模板
    └── base.yaml        # 基础模板
```

## Pipeline DSL

### 基本结构

```yaml
apiVersion: zclaw/v1
kind: Pipeline
metadata:
  name: my-pipeline
  displayName: 我的 Pipeline
  category: education
  description: Pipeline 功能描述
spec:
  inputs:
    - name: param1
      type: string
      required: true
  steps:
    - id: step1
      action:
        type: llm_generate
        template: "处理 {{param1}}"
  outputs:
    result: ${steps.step1.output}
```

### 输入类型

- `string` - 文本输入
- `number` - 数字输入
- `boolean` - 布尔值
- `select` - 单选下拉
- `multi-select` - 多选
- `file` - 文件上传
- `text` - 多行文本

### 动作类型

| 动作 | 说明 |
|------|------|
| `llm_generate` | LLM 生成 |
| `parallel` | 并行执行 |
| `sequential` | 顺序执行 |
| `condition` | 条件分支 |
| `skill` | 调用 Skill |
| `hand` | 调用 Hand |
| `classroom_render` | 渲染课堂数据 |
| `file_export` | 导出文件 |
| `http_request` | HTTP 请求 |
| `set_var` | 设置变量 |
| `delay` | 延时 |

### 表达式语法

Pipeline 支持表达式来引用上下文数据：

- `${inputs.xxx}` - 输入参数
- `${steps.xxx.output}` - 步骤输出
- `${item}` - 循环当前项 (parallel 内)
- `${index}` - 循环索引 (parallel 内)
- `${vars.xxx}` - 自定义变量

## 创建新 Pipeline

1. 在对应分类目录下创建 `.yaml` 文件
2. 按照 DSL 规范定义 Pipeline
3. 在前端 Pipeline 页面测试运行

## 用户界面

Pipeline 在用户界面中表现为功能卡片：
- 用户看到的是 Pipeline 的 `displayName` 和 `description`
- Hands 和 Skills 作为内部实现被隐藏
- 用户只需填写输入参数，Pipeline 自动执行

## Agent 集成

Agent 可以识别用户意图并推荐合适的 Pipeline：

```
用户: "帮我做一个关于光合作用的课件"
Agent: "我可以使用【互动课堂生成器】为你自动生成完整课件..."
```