先说个判断:2027 年大概率会火的是 AI 工作台。不是那种陪你聊两句的对话框,是能把一件事从接单做到验收、还得有人签收的工具。正好这两天我把 SoduWork 拉到本地跑了一遍------国内网络三道坎都趟了,装得起来,跑得通,也确实有东西。就拿它当例子,说说这类工具现在能做到哪一步。
实测环境:Windows 11 · PowerShell 实测对象:mdiri-ai/SoduWork,MIT 协议
下面按我操作的顺序写:先弄明白它是干嘛的,再拉代码、备环境、启动,最后说它跑起来到底什么样、值不值得装。
一、先弄明白这是个什么东西
官方给自己的说法是"企业级 AI 原生引擎""数字 AI 员工,先有数字方法论"。说直白点,它是一套 AI 工单系统:你提一张需求单,写清楚要什么、验收标准是什么,交给 AI 去执行,做完人来签收。聊天框聊完就散,它得签收才算完。
README 第一行那句话把它的脾气说透了:
"A chat ends with an answer. A SoduWork request ends when the person who asked signs off." (聊天以一个回答结束,而 SoduWork 的需求以"提需求的人签收"才算结束。)
几个词后面反复出现,先过一下:
| 概念 | 官方叫法 | 我的理解 |
|---|---|---|
| Harness | 执行底座 | 真正干活的那双手。Pi、Codex、OpenCode、Qwen Code 这些都是 Agent 运行时,不是模型,可以随时换,聊天记录和工作目录都留着 |
| 模型 | Model | 大脑,接你自己的 API Key。手和脑是分开的 |
| 需求 | Request | 一张工单,不是对话:目标、材料、验收标准,开工前写清楚 |
| 插件 | Plugin | 跑通过一次的做法固化成带版本的能力包,审核后全组能用 |
| Runner | 执行机 | 干活的工位,本机或你自己的云服务器,通过 WebSocket 连 Hub |
它把「需求 → 交办 → AI 执行 → AI 初审 → 人验收 → 沉淀插件」整成了一条闭环;管理端那套审计日志、角色权限、执行网络、用量成本,在开源 AI 工具里确实少见。
背景数据(截至 2026-11-17,我用 GitHub API 核过):仓库 10 月底开源,三周 1299 star、182 fork,README 明确标着 public beta。技术栈是 Electron + React 客户端、FastAPI + SQLAlchemy 后端、React/Vite 管理端;数据库单机用 SQLite,团队部署用 PostgreSQL 16。
有个小地方能看出它在飞奔:README 表格标题写着"已支持的 9 种 Harness",实际只列了 7 种。文档跑得比表格快。这点瑕疵先记着,后面"不足"那节还会提到。
二、跑起来:从拉代码到出登录页
先说选哪条路。它给了三种装法:
- 源码启动:
.\start.cmd --desktop,快速体验、单机用,只要 Python 3.12+ 和 Node 22.19+,不需要 Docker、Git 或手写.env; - Docker 自托管:
py ops/self-host/deploy.py up,给团队搭服务器用,会起 PostgreSQL 16; - 直接下安装包连官方云,注册
service.soduwork.ai账号就能试。
我走的是第一条。它最省事,一条命令把 Hub(后台服务)、浏览器管理端(127.0.0.1:18989)和 Electron 桌面客户端全起来,数据都在本地 SQLite,不碰机器上已有的环境。第二条路我也把文档读了,写得很细------自动生成数据库密码、管理员密码、签名密钥,健康检查通过才吐地址------但我这台机器的 Docker 引擎起不来(Docker Desktop 报 launcher lock,是我本机的问题,不是项目的),所以 Docker 路线只做了文档核对,没实测。这里先说清楚,免得你以为我验过。
开始拉代码。第一把就撞墙:
vbnet
fatal: unable to access 'https://github.com/mdiri-ai/SoduWork.git/':
Recv failure: Connection was reset
意料之中。仓库差不多 4900 个文件,换加速前缀,30 秒搞定:
powershell
git clone --depth 1 https://gh-proxy.com/https://github.com/mdiri-ai/SoduWork.git
(ghfast.top 当时超时,gh-proxy.com 能用。这类镜像站的可用性会漂,哪个通用哪个。)
start.cmd 看着是一条命令,背后要下三样大东西。国内网络不提前处理,基本会卡在第三步然后一脸懵。
Python 包(Hub 和 Runner 两套依赖):
powershell
$env:PIP_INDEX_URL = 'https://pypi.tuna.tsinghua.edu.cn/simple'
Electron 二进制(100 MB 级,桌面客户端要用,默认从 GitHub 下):
powershell
$env:ELECTRON_MIRROR = 'https://npmmirror.com/mirrors/electron/'
这个镜像实测很给力,67.6 秒下完。
PortableGit(约 58 MB)。Windows 桌面启动会给 Agent 备一套内置命令行环境(Bash + Git),项目给了固定版本。我最稳的做法是先从 npmmirror 下到本地、核对官方 SHA-256,再把路径喂给启动器:
powershell
curl.exe -sSL -o PortableGit-2.55.0.4-64-bit.7z.exe `
https://registry.npmmirror.com/-/binary/git-for-windows/v2.55.0.windows.4/PortableGit-2.55.0.4-64-bit.7z.exe
# 校验:应为 016e84230a3767f0c6b3788e79ba0c58a17377086801719d46700fca4f7b36b5
Get-FileHash .\PortableGit-2.55.0.4-64-bit.7z.exe -Algorithm SHA256
$env:SODUWORK_PORTABLE_GIT_ARCHIVE = 'C:\完整路径\PortableGit-2.55.0.4-64-bit.7z.exe'
启动器对下载件做固定摘要校验,镜像内容和官方字节一致才放行------这点我给好评,镜像站被污染也骗不过它。实测解压准备 41.1 秒。
三项环境变量加一个本地归档,就是国内部署 SoduWork 要提前知道的全部东西。然后启动:
powershell
.\start.cmd --desktop --no-browser --password-stdin # 自动化用法
.\start.cmd --desktop # 正常用法,会弹浏览器+客户端
首次运行会让你给 admin 设密码,12--128 位,输入不回显------没有星号,输完直接回车,别以为卡住了。这个密码只存在本地实例,不是任何线上账号。
启动器把过程拆成 4 步,实测耗时:
| 阶段 | 内容 | 实测耗时 |
|---|---|---|
| 1/4 | 创建独立 Python 环境(venv) | 12.7 s |
| 2/4 | 安装服务端依赖(FastAPI 等) | 约 2 min |
| 3/4 | 安装管理端依赖 + 构建(Vite) | 约 1.5 min |
| 4/4 | 桌面客户端准备:Electron 下载 | 67.6 s |
| 4/4 | 桌面客户端准备:命令行环境(PortableGit) | 41.1 s |
| --- | 起服务 + 数据库迁移 | 约 10 s |
加起来 5 分半。(第二次启动会复用依赖,几十秒。)就绪时终端打印:
arduino
SoduWork is ready: http://127.0.0.1:18989
Administrator: admin
浏览器打开先是介绍首页,点"进入管理后台"才是登录页;桌面客户端会自己弹出来,登录页右下角明明白白写着连的是 127.0.0.1:18989:

数据全在这个目录,删库就是删它,备份也是备份它:
| 内容 | 位置(Windows) |
|---|---|
| 源码模式数据目录 | %LOCALAPPDATA%\SoduWork\source-service |
| 业务数据库 | 同上 soduwork.db(SQLite) |
| 启动日志 | 同上 startup.log(排障全靠它) |
| 实例密钥 | 同上 local-service.json(别外传) |
三、启动时卡了我一下的地方
不过第一次启动没这么顺。第 2 步直接挂,日志就一行:
kotlin
ERROR: Can not perform a '--user' install.
User site-packages are not visible in this virtualenv.
原因不在 SoduWork,在环境里预设了 PIP_USER=1(有些 Python 发行版或工具链会设)。虚拟环境里再叠 --user,必然失败:
powershell
Remove-Item Env:PIP_USER -ErrorAction SilentlyContinue
# 或者启动前 $env:PIP_USER = '0'
这条我记下来了:以后碰到任何国产 AI 项目"在 venv 里 pip 安装却报 --user 错",八成都是这个。
四、跑起来之后,它长什么样
管理端不像个开源 demo,倒像是做过企业软件的人做的。登录后左边一整列导航,治理、运营、监控、权限、审计这些板块都在。

首页四张卡给的是管理视角:需求池、需求交付率、待处理风险、在线率(1/1 台在线)。往下是"部门需求态势"和"现在先处理什么(逾期需求 / 执行异常)",全是给主管看的指标,不是给工程师看的日志。
模型目录这一页设计得最好。内置 10 个服务商,主流的通义、Claude、DeepSeek 都在,每张卡上直接标着"缺密钥/缺地址/已配置",还带实时负载:正在生成、排队等待、并发上限、平均排队时间、HTTP 429 次数。

审计日志更有意思,它把我刚才改配置的每一步都记下来了,时间、操作者、操作类型、对象、详情,一项不缺:

谁在什么时候动了哪个模型服务,这种记录是它跟"个人 AI 工具"拉开距离的地方。
桌面端很克制。登录后左边是新对话/项目/最近聊天,中间一句话提示加一个输入框:

输入框下面那排小东西信息量挺大:权限范围(默认"完全访问",可改)、工作目录(默认工作区)、会话 ID、模型选择器、Harness 选择器(Pi)。也就是说,同一个会话里模型和 Harness 都能换,记录和目录留着------这就是它说的"手脑分离"。
真干活怎么样?我用官方文档里那道测试题试的,这题最能看出 AI 听不听话:
把下面的模拟会议记录整理成待办表,列出负责人和截止时间;没有给出的信息写待确认:小王负责整理需求,周五完成;小李核对报价。
3 到 6 秒出结果,而且严格照做:
| 序号 | 待办事项 | 负责人 | 截止时间 | 备注 |
|---|---|---|---|---|
| 1 | 整理需求 | 小王 | 周五(具体日期待确认) | --- |
| 2 | 核对报价 | 小李 | 待确认 | --- |
下面还补了一句说明:只提到"周五"没给具体日期,标了待确认;小李这条没截止时间,写待确认;如果要补优先级或交付物,也可以列成待确认项。

这一步其实是关键。很多模型会自作主张把"周五"编成一个具体日期,或者干脆把"待确认"漏掉。它没有。听不听指令、会不会标注自己不确定的地方,这是"能拿来干活"和"只能玩玩"的分界线。
顺带问了它一句"你是什么模型",答得也实在:底层 GLM-5.3-Flash,通过 pi 编码代理框架工作,能读写文件、执行命令、操作浏览器。

用下来有几个细节让我舒服。"恢复这一轮"------模型调用失败时,上下文和工具结果都留着,修好配置点一下接着跑,不用把需求重讲一遍,这个设计很懂真实工作。过程可见,回复上方写着"用时 12s / 深度思考 / 运行了命令",不是个黑箱。权限也可见,输入框旁边常驻"完全访问"提示,点开能改,不偷偷拿全盘权限。
不足也得说。模型能力默认"未确认",图片输入、工具调用、流式输出这三项要自己勾或者点"检测能力",第一次接模型容易漏,表现就是"看着配好了,用起来不对"。必须自带 API Key,没 Key 连第一句话都不回------这是它的定位(不卖模型),但对纯小白不友好,官方给了在线体验环境 service.soduwork.ai 当折中。
还有几条跟成熟度有关。文档和实现有点小错位,就是前面说的 9 种 Harness 标题配 7 行表格。Docker 这条我这次没实测(本机 Docker 引擎故障),文档写了自动生成密码、健康检查、备份回退,看着完整,但没验证不等于能用。它还在 beta,README 自己写着"用于生产环境前请先充分评估",重要业务别裸上。
最后一个跟安全有关:组织级 Key 是明文落库的。管理端说"密钥只保存在后台数据库,任何接口都不会返回明文",这话没错------接口确实不回显------但我在本地 SQLite 的 model_provider.api_key 里看到的就是明文。自托管时得靠磁盘加密加目录权限兜底,别把数据目录扔共享盘上。
五、到底值不值得上
分人群说:
| 你是谁 | 结论 | 理由 |
|---|---|---|
| 有 API Key 的个人开发者 | 值得装,半天能跑通 | 一条命令起全套,需求池加插件沉淀对独立开发、接私活很实用,模型还能换便宜的 |
| 3--20 人小团队 | 值得评估 | 审计日志、角色权限、执行网络、用量成本是真做了,不是摆设;插件审核分发能把某个人的绝活变成团队资产 |
| 企业/要私有化 | 先 POC,别急着上生产 | 定位对了(自托管、治理、审计),但还在 public beta,移动端/Web 端还在路线图上 |
| 只想找个免费 ChatGPT 壳 | 别装 | 它默认没模型,必须自带 Key;价值在流程,不在聊天 |
一句话:SoduWork 的价值在流程------让 AI 的产出能被验收、被复用、被追责。对个人是效率,对团队是秩序。如果你正卡在"AI 用得挺爽,团队却用不起来",花半天试试它。
附录 A:命令速查
powershell
# 1. 克隆(国内镜像)
git clone --depth 1 https://gh-proxy.com/https://github.com/mdiri-ai/SoduWork.git
cd SoduWork
# 2. 网络加速(PowerShell,当前会话生效)
Remove-Item Env:PIP_USER -ErrorAction SilentlyContinue # 防 venv 安装失败
$env:PIP_INDEX_URL = 'https://pypi.tuna.tsinghua.edu.cn/simple'
$env:ELECTRON_MIRROR = 'https://npmmirror.com/mirrors/electron/'
$env:npm_config_registry = 'https://registry.npmmirror.com'
# PortableGit 二选一:镜像根 或 本地归档
$env:SODUWORK_PORTABLE_GIT_MIRROR = 'https://registry.npmmirror.com/-/binary/git-for-windows'
$env:SODUWORK_PORTABLE_GIT_ARCHIVE = 'C:\...\PortableGit-2.55.0.4-64-bit.7z.exe'
# 3. 启动
.\start.cmd --desktop # Hub + 管理端 + 桌面客户端
.\start.cmd # 只起浏览器管理端
.\start.cmd --check --desktop # 只体检,不装依赖
.\start.cmd --desktop --port 18990 # 端口被占时换端口
# 4. 团队 Docker 自托管(本次未实测)
py ops/self-host/deploy.py up
py ops/self-host/deploy.py credentials # 查看初始管理员密码
附录 B:参考资料
- 仓库:github.com/mdiri-ai/So...
- 安装与启动:github.com/mdiri-ai/So...
- Docker 自托管:github.com/mdiri-ai/So...
- 官网:soduwork.ai · 在线文档:dev.soduwork.ai/zh-CN/
所有截图均来自本机真实运行。项目处于公开测试阶段,界面与步骤可能随版本变化,以官方文档为准。