安装与前置条件
大多数用户只需下载安装包。只有在开发 Workrun、贡献代码或修改桌面端时,才需要从源码启动。
下载 Workrun
Section titled “下载 Workrun”前往 Workrun GitHub Releases 下载最新版本。
- 在最新 Release 的 Assets 中,选择与你的操作系统和芯片架构相符的安装包;
- 按系统安装流程完成安装;
- 启动 Workrun。
Release 页面会列出当前版本实际提供的安装包和说明。请始终从该页面下载,不要从第三方站点获取安装包。
首次启动时,按引导选择个人或团队工作区。个人模式填写个人资料即可使用,无需登录;团队模式需要 Workrun Server 地址并登录,详见团队工作区。随后配置模型访问:
- 打开 设置 → 模型;
- 为一个要使用的 Provider 填写 API 密钥;
- 设置会自动保存;
- 按5 分钟快速开始创建第一个工作流。
无需新建模型 Profile 或手动填写模型 ID。Workrun 提供内置模型目录;在 Agent 节点中选择与你已配置 Provider 对应的模型即可。使用 Ollama 时,填写本地或远程 Ollama 端点,而不是 API 密钥。
从源码运行(仅开发者)
Section titled “从源码运行(仅开发者)”如果你需要开发或修改 Workrun,请准备:
- Node.js 24 或更高版本;
- pnpm 12(精确版本以仓库根目录
package.json的packageManager为准); - Rust 工具链和当前平台所需的 Tauri 构建依赖;
- 网络连接:开发 Python App 时,
uv需要下载 Python 和依赖。
克隆仓库并启动桌面端:
git clone https://github.com/1111mp/workrun-app.gitcd workrun-apppnpm installpnpm app:dev常用开发命令
Section titled “常用开发命令”# 仅启动桌面端前端pnpm ui:dev
# 静态检查与测试pnpm typecheckpnpm oxlintpnpm test团队服务的本地开发还需要 MongoDB 和认证环境变量。以 apps/server/src/env.validation.ts 中的当前定义为准。