跳转到内容

团队发布与部署准备

Workrun 有两种彼此独立的工作区模式:个人模式用于在自己的电脑上构建与运行;团队模式通过 Workrun Server 让成员共享、审核和使用已发布的版本。选择团队模式并不意味着工作流会自动部署到服务器上:目前工作流仍由各成员的桌面端执行,团队服务负责身份、共享资产和发布版本。

自己保存的本地工作流在团队模式首页也能复用,不要求先发布;发布用于让其他成员使用共享版本。参见架构与部署边界。Server、LiteLLM 和 Langfuse 的独立部署与可选连接步骤见部署指南。

个人模式 团队模式
适合场景 个人探索、本地开发、独立运行 需要共享、审核和复现的协作流程
数据与资产 保存在当前设备的个人工作区 当前账号本地草稿;已发布版本和共享元数据保存在团队服务
登录与服务端 不需要登录或连接团队服务 需要连接团队服务并登录
运行方式 桌面端运行本地工作流和 App 桌面端运行自己的本地定义或共享发布版,并准备发布版的固定 App 依赖
版本发布 保存草稿即可继续修改和运行 发布语义版本,供其他成员浏览、运行和调度

首次启动时选择个人模式或团队模式。

选择个人模式后,填写个人资料即可开始在本机使用;无需部署或连接 Workrun Server。

个人模式:填写个人资料后在本机开始使用。

选择团队模式后,填写团队提供的 Workrun Server 地址并完成登录。请使用团队服务的公开 HTTPS 地址,不要填写容器内部地址或其他成员电脑上的 localhost。

团队模式:填写 Workrun Server 地址并继续。

连接服务后,使用团队账号登录,才能访问团队共享的 Workflow、App 与已发布版本。

团队模式:连接 Workrun Server 后登录团队工作区。

两种模式不是同一份资产的两个视图。个人模式中的本地 Workflow 或 App 不会因切换到团队模式而自动共享;需要协作的内容应在团队模式中创建或迁移,并按版本发布。之后可在 设置 → 工作区 查看或切换模式;切换前请确认当前未保存的草稿已经保存。

设置 → 工作区:在个人模式与团队模式之间切换。

团队模式需要一个可访问的 Workrun Server。它是团队协作的控制平面,不是用来代替成员电脑执行 Python App、模型调用或工作流运行的远程执行器。

运行历史、聊天会话和运行产生的 artifacts 始终保存在执行任务的本机,并按 Personal/Team 工作区隔离。团队发布共享的是工作流与 App 版本,不会同步这些运行记录或文件。换设备后不能自动查看此前的本地运行结果;参见 文件结果与本地存储。

连接团队服务并登录后,团队成员可以浏览和运行已发布的工作流。发布时,Workrun 使用语义版本管理 Workflow 与 App。

发布的 Workflow 会固定引用对应版本的 Team App。桌面端运行前会准备隔离的 App 副本,而不是读取后来被修改的开发版本。因此历史运行、评测结果和生产行为可以关联到当时实际使用的版本并被复现。

  1. 在 设置 → 工作区 连接团队服务并登录;
  2. 确认工作流引用的本地 App 已安装,需共享的 App 已先发布对应版本;
  3. 运行发布必检评测集;检查质量门、成本、耗时和失败 Case;
  4. 在工作流编辑器点击 发布,确认语义版本号和发布说明;
  5. 由另一位成员浏览或运行发布版本,验证团队端看到的是预期资产。

发布前建议完成三项检查:

  • 运行关键评估集,并确认质量门结果;
  • 检查引用的 App、模型和工具权限是否符合预期;
  • 写下这次版本改变了什么,以及不兼容变化如何迁移。
  • 团队成员从团队工作区选择已发布版本运行,而不是把发布后的草稿修改带入运行;
  • 团队定时任务使用发布定义,可按 recipe 跟随最新发布版或固定 release;
  • 修复问题或更新依赖时,发布新的版本。不要修改旧版本来“修复历史”,这样才能保留运行和评测的可追溯性;
  • 若某次运行发现 Team App 版本缺失或不匹配,应恢复该发布版本后再重试,而不是用当前开发副本替代。

团队模式依赖 Workrun Server 提供服务能力。服务端代码位于仓库的 apps/server,负责团队身份认证、共享 Workflow 与 App 的发布版本、相关资源存储,以及可选的 LiteLLM 模型访问;桌面编辑草稿保存在当前账号本地;它依赖 MongoDB 与 Better Auth。为团队启用该模式前,需要将 Workrun Server 部署到成员可访问的地址,并在桌面端的 设置 → 工作区 中连接该地址。

部署方案应按下面的边界设计:

成员的 Workrun 桌面端 ── HTTPS ──> 反向代理 / Workrun Server ──> MongoDB(持久化存储)
└──> OAuth 提供方(可选)
  1. 为团队服务准备稳定的 HTTPS 地址,例如 https://workrun.example.com;成员桌面端在 设置 → 工作区 中连接这个地址。
  2. 准备 MongoDB 的连接串和持久化存储。容器重建不应丢失团队用户、草稿、发布版本或文件资源。
  3. 生成并安全保存 BETTER_AUTH_SECRET;生产环境不得使用示例值。服务迁移或扩容时保持该值不变,避免现有登录会话失效。
  4. 将 SERVER_BASE_URL 与 BETTER_AUTH_URL 都设为对外可访问的 HTTPS 地址,而不是容器内地址或 localhost;如启用 GitHub 登录,也在 OAuth 提供方处登记相同的回调基地址。
  5. 将 MONGODB_URI、OAuth client secret 和认证密钥放入部署平台的密钥管理或未提交的环境文件,绝不写入镜像、部署配置文件或仓库。
  6. 在反向代理处终止 TLS,并只暴露服务所需端口;MongoDB 应留在私有网络,不直接暴露给互联网。

当前环境变量的权威定义在 apps/server/.env.example 和 apps/server/src/env.validation.ts。部署时应以它们为准配置运行环境。

  • 用团队的公开地址完成登录,并在另一台成员设备上确认会话可用;
  • 创建并发布一个测试 App 和 Workflow,确认第二位成员能够浏览和运行指定版本;
  • 验证 App 附带资源可以下载,且发布 Workflow 的固定依赖能被准备;
  • 重启 Server 容器后确认用户、已发布版本与资源仍存在;
  • 对 MongoDB 的数据与文件资源执行一次恢复演练,再将服务用于真实团队资产。

个人模式通过 ZIP/TAR 分享 App 和 Workflow。Workflow 包会包含本地 App 和子 Workflow 依赖,接收方需要在自己的设备上配置外部服务。操作步骤见 使用 Python App 和 构建第一个工作流。

压缩包分享不会把对象迁移到 Team 工作区,也不会创建 Team 发布版本。Team Workflow 仍通过 发布 分享,并固定依赖的 Team App 版本。作者可以在 Team Workflow 详情页的 更多(⋯) 菜单中删除 Workflow,其他成员不显示删除入口。