跳到主要内容
harness harnesses runtime runtimes 底座
开源 · MIT

企业级 AI 原生引擎

把团队的做法教给 AI 一次,之后由人和 Agent 一起按这个做法执行。

SoduWork 由三部分组成:桌面客户端、Hub 和 Runner。Hub 由你自己部署。团队的做法打包成插件,每一步用哪个 Agent 底座和模型,由你来选。

Client 1.13.13 · Windows · macOS · Linux

start.py
$ git clone https://github.com/mdiri-ai/SoduWork
$ cd SoduWork
$ python start.py --desktop
SoduWork is ready: http://127.0.0.1:18989
Administrator: admin

为什么选择 SoduWork

多底座协同

9 个内置底座,按任务选择,同一对话里随时切换。

Agent 底座 »

多 Agent 协同

同一条工作流里,每一步交给不同底座上的 Agent,人在关键处确认。

交接与路由 »

研发闭环

定标准、实现、审查、测试、合并、发布,在一条流程里完成。

工作流节点 »

即做即用

描述需要的工具,SoduWork 当场做好并打开,边用边改。

即用 »

AI 资产沉淀到组织

做完的工作沉淀为插件,团队审核后人人可用。

发布到组织 »

需要运行哪些部分

Client(客户端)

桌面工作台,用于对话、需求、插件和即用。它在用户电脑上启动 Agent 底座。

  • 与任意已安装的 Agent 底座对话
  • 插件工坊与本机逐节点调试
  • 带 AI 侧栏的即用窗口
  • 每个对话可选本机执行或云端执行
  • Skill 与 MCP 服务
Electron · Windows、macOS、Linux了解更多 »

Hub(服务端)

所有客户端连接的服务。用户、任务和插件目录都由它管理。

  • 身份、组织与权限
  • 任务、需求及其历史
  • 插件导入、审查、绑定与审计
  • 模型目录、额度与用量
  • Runner 登记与云端环境
  • 管理端
FastAPI · PostgreSQL 或 SQLite了解更多 »

Runner(执行机)

实际执行工作的进程,可以运行在用户电脑上,也可以运行在共享服务器上。

  • 接收 Hub 派发的工作
  • 启动选定的 Agent 底座
  • 只为本次执行注入模型配置
  • 把输出和文件回传给 Hub
  • 重启后恢复已排队的工作

你可以做什么

自己部署

用一个启动文件,在一台电脑上同时运行 Hub、管理端和桌面客户端;团队使用时,用 Docker 和 PostgreSQL 部署 Hub。

快速开始 »

编写插件和即用

把工作讲给内置的插件开发助手,需要独立界面时用快速创建即用,SoduWork 会替你编写、检查并安装。也可以自己写文件。

插件指南 »

接入 Agent 底座

在底座目录里写一条声明,就能接入支持 Agent Client Protocol(ACP)的程序。

Agent 底座 »

接入业务系统

通过 OAuth 连接器、基于 OpenAPI 的 REST API 和 MCP 接入业务系统。

集成 »

各部分如何协作

SoduWork 架构

各端都连接同一个 Hub。Hub 把工作派发给本机或云端的 Runner,Runner 再启动 Agent 底座。

阅读架构总览 »

把团队的做法,变成可以重复执行的插件

插件写明一项工作的输入、步骤、每一步由哪个底座和模型执行,以及怎样才算完成。在对话里输入 / 就能使用,也可以从需求或定时任务启动。下面这个插件里,Pi 起草周报,Qwen Code 逐条核对来源,核对不通过时流程停下。

插件不用手写:把工作讲给插件开发助手,它会生成同样的文件。

在对话中创建插件 »
plugin.json
{
  "schemaVersion": 1,
  "key": "weekly-brief",
  "version": "1.0.0",
  "name": "团队周报",
  "description": "对照原始资料核对过的团队周报。",
  "instructions": "把本周工作整理成成果、风险和下周计划,不得虚构。",
  "entrypoints": { "conversation": true, "task": true, "automation": true },
  "workflow": {
    "nodes": [
      {
        "key": "draft", "type": "ai", "name": "起草周报",
        "config": { "prompt": "根据本周任务写出 deliverables/brief.md。", "agentKind": "local:pi" },
        "outputs": [{ "key": "brief", "kind": "file", "path": "deliverables/brief.md", "required": true }]
      },
      {
        "key": "check", "type": "ai_review", "name": "对照原始资料核对", "dependsOn": ["draft"],
        "inputs": [{ "key": "brief", "fromNode": "draft", "outputKey": "brief", "required": true }],
        "config": { "prompt": "逐条对照原始资料核对,结论写入 review.json;有任何一条找不到来源就阻断。", "agentKind": "local:qwen" },
        "outputs": [{ "key": "verdict", "kind": "decision", "path": "review.json", "required": true }]
      },
      { "key": "done", "type": "publish", "name": "办结", "dependsOn": ["check"] }
    ]
  }
}

开源

SoduWork 自有源码的版权属于 MDiRi,按 MIT 许可发布。依赖和随包工具保留各自的许可。欢迎提交 Issue、PR、翻译和插件。

在你的电脑上运行 SoduWork

首次启动需要 Python 3.12、Node.js 22.19 和网络连接。

快速开始 »