WorkflowSummaryResponse

errCodeintegerrequired

Constant value: 0

errMessagestringrequired

Constant value:

data objectrequired

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]

WorkflowSummaryResponse

{
  "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"
    }
  }
}