快速开始
SoduWork 由三部分组成，三者都在，才能跑 AI 工作。
| 部分 | 作用 | 运行在哪里 |
|---|---|---|
| Hub | 账号、任务、插件、模型和管理端 | 你自己控制的电脑或服务器 |
| 客户端 | 用户使用的桌面工作台 | 每位用户的 Windows、macOS 或 Linux 电脑 |
| Runner | 启动 Agent 底座、执行工作 | 在客户端内运行；云端执行时运行在共享服务器上 |
客户端连接一个 Hub。客户端本身不会替你启动 Hub。
选择一条路径
| 路径 | 适合 | 数据库 | 谁能访问 |
|---|---|---|---|
| 从源码启动 | 在一台电脑上试用 | SQLite | 只有本机 |
| 用 Docker 自部署 | 小团队的单机部署 | PostgreSQL 16 | 本机；或通过你自己的 HTTPS 反向代理给团队访问 |
| 团队部署 | 需要自己的域名、备份和生产配置 | PostgreSQL | 你的团队 |
前两种是两套独立的安装，数据各自保存，从一种换到另一种不会自动迁移数据。
本组页面的顺序
- 要求与限制：先检查你的电脑。
- 从源码启动：启动 Hub，打开管理端。
- 连接桌面客户端：安装客户端并登录。
- 配置模型和 Agent 底座：给 SoduWork 配一个可用的 AI 模型。
- 跑通第一个任务：发起一次对话，再运行一个插件。
之后按需阅读：
SoduWork 不包含什么
- 模型密钥。 你需要配置自己有权使用的模型服务。
- 大部分 Agent 底座。 Pi 随客户端内置，其他底座在需要时安装。
没有配置模型时，管理端和协作功能可以正常使用，但 AI 工作不会运行。
harness harnesses runtime runtimes 底座