---
name: pipeline-sage-bridge
version: 1.0.0
description: "Sage产线前端桥接模块 — 通过HTTP调用pipeline-app后端API。"
trigger_conditions:
  - 修改Sage中产线前端展示
  - 调整pipeline-app API调用方式
  - 添加新的产线前端功能
tags: [pipeline, sage, bridge, frontend]
---

# Pipeline Sage 前端桥接模块

## 仓库
- 路径：`~/repos/pipeline/`
- 远端：`git@git.opencomputing.cn:yumoqing/pipeline.git`

## 架构

本模块是纯前端桥接层，无数据库表。通过 aiohttp 异步 HTTP 调用 pipeline-app（端口9090）的 API。

```
Sage UI → pipeline/*.dspy → HTTP → pipeline-app:9090
```

## API 配置

`pipeline/init.py` 中的 `PIPELINE_API_BASE`：
```python
PIPELINE_API_BASE = "https://token.opencomputing.cn/pipeline/v1"
```

## 注册的函数

| 函数 | HTTP方法 | 端点 | 说明 |
|------|----------|------|------|
| hermes_pipeline_list | GET | /tasks?user_id= | 用户产线列表 |
| hermes_pipeline_detail | GET | /task/{id} | 产线详情+节点树 |
| hermes_pipeline_submit | POST | /task/submit | 提交新产线 |
| hermes_pipeline_node | GET | /task/{id}/node/{step} | 节点输入输出 |

## dspy 端点

| 文件 | 功能 |
|------|------|
| pipeline_list.dspy | 调用 hermes_pipeline_list |
| pipeline_detail.dspy | 调用 hermes_pipeline_detail |
| pipeline_submit.dspy | 调用 hermes_pipeline_submit |
| pipeline_node.dspy | 调用 hermes_pipeline_node |

## 部署

1. pip install pipeline
2. sage.py 添加 load_pipeline()
3. wwwroot 软链接
4. scripts/load_path.py 执行

## 注意事项

- 请求超时：普通120秒，提交30秒
- 错误处理：HTTP 非200返回 {"status":"error","message":...}
- 无数据库操作，所有数据来自 pipeline-app