DiamondMemory | Neural Network Visualization

Bug 修复说明

已修复导出 JSON/YAML 返回 500 错误

已修复导入格式不匹配（支持 workflow 格式）

已修复版本自动创建（PUT 更新时自动创建版本记录）

API 端点

工作流导出

GET/api/hermes/workflow/:id/export导出 JSON 格式

GET/api/hermes/workflow/:id/export?format=yaml导出 YAML 格式

工作流导入

POST/api/hermes/workflow/import导入工作流（自动生成新ID）

POST/api/hermes/workflow/import?overwrite=true覆盖已存在工作流

POST/api/hermes/workflow/import?validate_only=true仅验证导入数据

版本管理

PUT/api/hermes/workflow/:id更新并自动创建版本

GET/api/hermes/workflow/:id/versions获取版本列表

GET/api/hermes/workflow/:id/versions/:v获取指定版本详情

PUT/api/hermes/workflow/:id/versions/:v更新版本状态

DELETE/api/hermes/workflow/:id/versions/:v删除版本

使用示例

导出 JSON

# 导出 JSON 格式
curl -X GET https://chat.herllamo.com/api/hermes/workflow/{workflow_id}/export \
  -H "Accept: application/json"

# 响应
{
  "format": "json",
  "version": "1.0",
  "workflow": {
    "workflow_id": "xxx",
    "name": "工作流名称",
    "nodes": [...],
    "connections": [...]
  }
}

导出 YAML

# 导出 YAML 格式
curl -X GET https://chat.herllamo.com/api/hermes/workflow/{workflow_id}/export?format=yaml

# 响应
version: "1.0"
workflow:
  name: 工作流名称
  nodes: []
  connections: []

导入工作流

# 导入工作流（支持两种节点格式）

# 格式1：标准格式（node_id/node_type）
curl -X POST https://chat.herllamo.com/api/hermes/workflow/import \
  -H "Content-Type: application/json" \
  -d '{
    "format": "json",
    "version": "1.0",
    "workflow": {
      "name": "新工作流",
      "nodes": [
        {"node_id": "node1", "node_type": "start", "name": "开始"},
        {"node_id": "node2", "node_type": "end", "name": "结束"}
      ],
      "connections": [
        {"source": "node1", "target": "node2"}
      ]
    }
  }'

# 格式2：兼容格式（id/type/from/to）
curl -X POST https://chat.herllamo.com/api/hermes/workflow/import \
  -H "Content-Type: application/json" \
  -d '{
    "format": "json",
    "version": "1.0",
    "workflow": {
      "name": "新工作流",
      "nodes": [
        {"id": "node1", "type": "start", "name": "开始"},
        {"id": "node2", "type": "end", "name": "结束"}
      ],
      "connections": [
        {"from": "node1", "to": "node2"}
      ]
    }
  }'

# 响应
{
  "success": true,
  "data": {
    "workflow_id": "xxx",
    "name": "新工作流"
  }
}

更新并自动创建版本

# 更新工作流（自动创建版本）
curl -X PUT https://chat.herllamo.com/api/hermes/workflow/{workflow_id} \
  -H "Content-Type: application/json" \
  -d '{
    "name": "更新后的名称",
    "description": "新的描述"
  }'

# 响应
{
  "success": true,
  "data": {...},
  "version": 2,
  "version_created": true
}

获取版本列表

# 获取版本列表
curl -X GET https://chat.herllamo.com/api/hermes/workflow/{workflow_id}/versions

# 响应
{
  "success": true,
  "data": [
    {
      "version": 2,
      "name": "更新后的名称",
      "changelog": "自动保存版本",
      "created_at": "2026-05-11T..."
    }
  ],
  "stats": {
    "total_versions": 2,
    "latest_version": 2
  }
}

DiamondMemory API 说明文档