开发环境快速开始

这份文档只做一件事：帮你用最短路径把 Workova 在本地跑起来。

前置环境

本仓库默认按开发模式运行，常见依赖有：

• Node.js 18 及以上
• Go 1.24.x
• Rust stable
• make
• macOS 或 Linux 常见终端环境

如果你不想自己逐个排查，最省事的方式就是直接使用根目录统一脚本。

第一步：安装依赖

在仓库根目录执行：

make install

这个命令会帮你做几件事：

• 安装或检查 Go、Node.js、Rust
• 安装 admin-web、desktop、website 的 npm 依赖
• 下载 backend 的 Go 依赖
• 安装后端热重载工具 air

第二步：启动项目

如果你想一次启动主要模块：

make start

如果你只想启动某一个模块，也可以用这些命令：

make start-backend
make start-admin-web
make start-desktop
make start-website

第三步：看日志和端口

默认端口如下：

• backend：8080
• admin-web：5173
• website：3000
• desktop：开发态会启动 Tauri + 本地前端服务

统一日志会落到仓库根目录的 logs/。

常用验证命令

按模块分别验证时，可以直接用这些命令：

# website
cd website && npm run lint && npm run typecheck

# desktop
cd desktop && npm run test

# backend
cd backend && make test

新人最容易踩的坑

1. 直接改旧目录

当前真正继续演进的是 desktop/，不是 archive/desktop-legacy/。

2. 把执行逻辑往后端塞

Agent Loop、工具调用、MCP 生命周期这些执行逻辑，都应该在桌面端 runtime 里。

3. 看到旧文档就照着做

仓库里还保留了一批历史资料，不是每篇都适合直接照做。

不确定时先看这两页：

• 文档盘点
• 待完善清单