跳到主要内容

使用 Server Web 管理项目

Server Web 是 Workflow Server 的浏览器管理端。Desktop 发布成功后,你可以在这里找到 Workflow、Conversation 和 Kanban 项目,运行可执行版本、预览 Kanban、管理权限和配置,并查看执行日志。

从登录到运行

打开 Server Web

打开你的 Workflow Server 地址。没有有效会话时,页面会进入登录页。

登录账号

使用邮箱密码登录。CLI 和 Desktop 的 device flow 也可以复用浏览器会话完成授权。

找到项目

在项目列表按项目 ID、名称、latest 版本、上传用户或类型搜索。只有你有权限访问的项目会出现在列表中。

进入项目详情

打开声明为 serverboth 的项目后,可以查看概览、设置、成员、知识库、执行日志、版本、定时任务、KV、环境变量和 Webhook;Workflow 还提供 MCP 连接页。项目至少发布过一个版本后才会出现 Embed。声明为 local 或缺少存储声明的项目只开放只读设置说明。

运行或排查 workflow

在项目详情中选择 latest 版本的 Workflow 入口并直接运行;Conversation 保持单一会话入口。执行完成后,从执行日志打开回放或详细日志查看结果和诊断信息。

项目列表可以做什么

项目列表用于快速找到已发布 workflow:

  • 按项目 ID、默认/中文/英文名称、latest 版本、上传用户和类型搜索。
  • 按全部、可运行、准备中、Webhook、Embed 等状态筛选。
  • 默认按更新时间从新到旧排列,最近更新的项目优先显示。
  • 查看当前语言名称、项目图标、手工声明、展示平台、latest 版本、更新时间和集成状态。
  • 进入详情或查看执行日志;至少发布过一个版本的项目还可以打开或配置 Embed。

仅创建并注册、尚未首次发布的项目仍保留在 Server Web 项目列表中,便于继续管理和完成发布,但项目表格、详情侧栏和设置页都不会显示 Embed 入口。直接访问这类项目的 Embed 管理地址会回到项目概览,也不会发起 Embed 配置读取。

上传包中的 package.json 通过根 nameworkflowCode.projectInfo 提供默认/本地化名称、手工声明、展示平台和数据存储声明,并可通过 workflowCode.projectCard 配置纯视觉卡片信息。名称、普通声明和 macOS/Windows/Web 平台只用于展示,不推断运行能力;dataStorage.mode 则是强制执行与数据访问门禁。Server Web 只支持 serverbothlocal 或缺声明时会阻断除只读设置说明外的项目详情。列表与版本页仍独立显示“Server 可运行”“仅本地”或“静态 Web”,运行入口只使用具备完整 Server runtime 且通过存储门禁的在线版本。Workflow/Conversation 类型从 executor 的 projectType 派生,Kanban 类型从 package.json.workflowCode.projectType 派生;中文界面的类型标签统一显示“工作流”“对话”“看板”。

项目详情常用操作

Workflow 项目详情中的 MCP 页面可选择 draft、latest 或精确版本,复制 Streamable HTTP URL、Bearer 模板和客户端 JSON,并查看固定的 entrypoint/tool 目录。连接和文件上传方式见 Server MCP 指南

登录页状态

登录提交中、失败或会话失效时,页面会显示明确状态。失败后请检查账号密码、服务器地址和网络连接。

管理端运行环境

Server 侧运行的 Workflow/Conversation 会把 workflow.getRuntimePlatform() 标记为 "web",包括管理端运行、external API、Embed 和 Webhook 触发的运行。普通、流式、调试、参数解析、恢复和定时任务都会在执行用户模块前检查 dataStorage.mode;只有 serverboth 继续执行。Kanban 是静态 HTML 项目,不启动 workflow runtime;它的静态预览、KV、知识库、PersistentValue、管理接口和 Bridge 同样经过服务器存储门禁。管理端先通过登录请求取得固定到项目、用户、目标版本和有效期的短期预览 capability;sandbox iframe 随后只用该 capability 加载静态资源,不继承管理端登录凭据。关联项目 KV 会按固定版本解析 alias,再读取双方当前声明和目标项目对当前项目的读写授权;调用方不能指定目标 UUID。

Workflow 的多入口属于同一项目的运行目录,权限、队列、成员、KV 和 PersistentValue 仍保持项目级。每次请求只选择一个入口并创建独立 run;业务流程需要调用其它 workflow 时由源码显式使用 workflow.runWorkflow()。Server 的外部 API 并发能力不受 Desktop/Embed 当前工作区只聚焦一条 live run 的界面限制。

Workflow 的定时任务固定到精确已发布版本和入口。Server 进程运行期间持续调度;停机时错过的触发不会补跑,同一计划的上一次 run 未结束时也不会排队。计划管理需要独立的 schedule.manage 权限和项目访问权,实际 fire 继续按创建者的运行权限与额度执行。

管理端、Embed 和 External 的流式运行会先完成鉴权、存储声明、请求字段、精确版本与入口校验,再发送 NDJSON 或 SSE 响应头。未知入口、禁止的服务器存储、缺声明、Conversation 携带入口或其它可预先识别的无效请求会直接返回 HTTP 4xx JSON,且不会创建 run;流已经开始后的执行错误仍通过对应的 NDJSON 或 SSE error event 返回。

Server Web 只连接服务器,不读取本地 workspace、Electron 项目或任意本地目录。它管理服务器项目、版本、运行记录、环境变量、计划任务、Webhook 和公开 Embed,并可查看已上传的 Workflow/Conversation 运行结果或已发布 Kanban 的固定版本预览。本地项目选择、.workflowignore 打包和上传由Desktop 或 CLI 完成;服务器接收归档后为 Workflow/Conversation 安装依赖并生成 runtime,对 Kanban 只校验并保留 HTML、JavaScript、图片、字体等静态产物。

日期与时间

Server Web 中需要定位具体时刻的运行、更新、登录、额度、计划和审计记录统一显示为 YYYY-MM-DD HH:mm:ss;账期、统计分组等只需要日历日的场景显示为 YYYY-MM-DD。定时任务按计划配置的时区显示,其它记录按浏览器当前时区显示。API 请求和响应中的 ISO 时间字段保持原协议,不受界面展示格式影响。

移动端与深色模式

Server Web 支持移动端布局、浅色、深色和跟随系统主题。移动端会保留关键状态、筛选和操作入口;深色模式使用与 Desktop 一致的黑灰中性色,成功、等待和错误仍保留各自的语义色,确保状态 badge、表格、抽屉和弹窗保持可读。操作结果通知会显示在弹窗和遮罩上方,弹窗打开期间也能直接读取反馈内容。