WorkflowSummaryListResponse

errCodeintegerrequired

Constant value: 0

errMessagestringrequired

Constant value:

data object[]required

Array [

idstringrequired

项目 UUID，同时也是 server 权限与上传校验边界。

namestringrequired

projectTypeWorkflowProjectTyperequired

Workflow/Conversation 由 executor.projectType 声明；Kanban 由 package.json.workflowCode.projectType 声明。宿主据此选择运行或静态预览界面。

Possible values: [workflow, conversation, kanban]

projectCard objectrequired

iconstringrequired

Possible values: [workflow, message-circle, bot, sparkles, code, git-branch, boxes, zap, database, file-text, cpu, brain]

iconUrlstring<uri>

Optional image URL used instead of the icon token. New Desktop uploads use the Server-generated /project-card-images/... WebP URL; existing external http(s) values remain readable for backward compatibility.

iconColorstring

Optional built-in icon foreground color. Defaults to white for older metadata.

Possible values: Value must match regular expression ^#[0-9a-fA-F]{6}$

iconBackgroundColorstringrequired

Possible values: Value must match regular expression ^#[0-9a-fA-F]{6}$

projectInfo objectrequired

项目元数据权威模型。读取旧项目时 dataStorage 可能为 null，其它创建或保存请求必须使用 DeclaredWorkflowProjectInfo 并提供有效 mode。当前界面识别 zh-CN、en、 multilingual、multiplatform、macos、windows 和 web；符合格式的未来 locale 或 ID 原样保留。

Authoritative project metadata model. Legacy read responses may carry null dataStorage; create and save requests use DeclaredWorkflowProjectInfo with an explicit valid mode.

localizedNames objectrequired

property name*string

declarationsstring[]required

Possible values: Value must match regular expression ^[a-z][a-z0-9-]*$

platformSupport objectrequired

oneOf

object

modestringrequired

Constant value: agnostic

dataStorage objectrequired

严格限定项目可访问的数据位置；null 只表示尚未迁移的旧项目。 / Strictly limits accessible data locations; null represents an undeclared legacy project only.

oneOf

WorkflowProjectDataStorage

modestringrequired

local 仅本地，server 仅服务器，both 允许显式选择两端。 / local permits local storage only, server permits server storage only, and both permits an explicit choice.

Possible values: [local, server, both]

relatedProjects object[]required

Possible values: <= 32

Array [

aliasstringrequired

Possible values: Value must match regular expression ^[a-z][a-z0-9_-]{0,63}$

projectIdstring<uuid>required

grantToRelatedProject objectrequired

允许关联项目访问当前项目 KV 的规则；不是当前项目访问对方的权限。

read objectrequired

oneOf

object

modestringrequired

Constant value: none

write objectrequired

oneOf

object

modestringrequired

Constant value: none

]

ownerUserIdstring

visibilityWorkflowVisibilityrequired

Possible values: [private, public]

createdByUserIdstring

createdByProfile object

userIdstringrequired

displayNamestringrequired

emailstring

Optional email address for the profile summary.

avatarUrlstring

Optional avatar image URL or data URL for the uploader profile.

createdAtstring<date-time>

updatedAtstring<date-time>

hasDraftbooleanrequired

lateststring | nullnullablerequired

最新在线发行版，不保证可在 Server 执行或兼容当前 Desktop 平台。

versionsstring[]required

onlineVersionsstring[]required

serverRunnableVersionsstring[]required

已在线、启用 Server、存在 runtime artifact 且 Core 兼容的版本。

latestServerRunnablestring | nullnullablerequired

最新 Server 可运行版本；没有兼容版本时为 null。

nextVersionstringrequired

runQueue object

acceptsNewRunsbooleanrequired

concurrencyintegerrequired

Possible values: >= 1

Default value: 3

updatedAtstring<date-time>required

draftBuild object

statusstringrequired

Possible values: [success, failed]

startedAtstring<date-time>required

endedAtstring<date-time>required

durationMsnumberrequired

stdoutstringrequired

stderrstringrequired

errorstring

sourceDownload object

allowedbooleanrequired

当前身份是否具备下载项目源码的权限。

availablebooleanrequired

latest 版本是否保留原始源码。

targetstring | nullnullablerequired

sourceMode objectrequired

oneOf

WorkflowVersionSourceMode

bundled 只保留 bundle/minify 产物；source 保留原始源码快照。

WorkflowVersionSourceMode

bundled 只保留 bundle/minify 产物；source 保留原始源码快照。

Possible values: [bundled, source]

]

WorkflowSummaryListResponse

{
  "errCode": 0,
  "errMessage": "string",
  "data": [
    {
      "id": "string",
      "name": "string",
      "projectType": "workflow",
      "projectCard": {
        "icon": "workflow",
        "iconUrl": "string",
        "iconColor": "string",
        "iconBackgroundColor": "string"
      },
      "projectInfo": {
        "localizedNames": {},
        "declarations": [
          "string"
        ],
        "platformSupport": {
          "mode": "agnostic"
        },
        "dataStorage": {
          "mode": "local"
        },
        "relatedProjects": [
          {
            "alias": "string",
            "projectId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "grantToRelatedProject": {
              "read": {
                "mode": "none"
              },
              "write": {
                "mode": "none"
              }
            }
          }
        ]
      },
      "ownerUserId": "string",
      "visibility": "private",
      "createdByUserId": "string",
      "createdByProfile": {
        "userId": "string",
        "displayName": "string",
        "email": "string",
        "avatarUrl": "string"
      },
      "createdAt": "2024-07-29T15:51:28.071Z",
      "updatedAt": "2024-07-29T15:51:28.071Z",
      "hasDraft": true,
      "latest": "string",
      "versions": [
        "string"
      ],
      "onlineVersions": [
        "string"
      ],
      "serverRunnableVersions": [
        "string"
      ],
      "latestServerRunnable": "string",
      "nextVersion": "string",
      "runQueue": {
        "acceptsNewRuns": true,
        "concurrency": 3,
        "updatedAt": "2024-07-29T15:51:28.071Z"
      },
      "draftBuild": {
        "status": "success",
        "startedAt": "2024-07-29T15:51:28.071Z",
        "endedAt": "2024-07-29T15:51:28.071Z",
        "durationMs": 0,
        "stdout": "string",
        "stderr": "string",
        "error": "string"
      },
      "sourceDownload": {
        "allowed": true,
        "available": true,
        "target": "string",
        "sourceMode": "bundled"
      }
    }
  ]
}