AI 协作工作台 wecode-ai/Wegent

Wegent

开源 AI 工作系统，覆盖本地桌面、云端智能体和远程机器。

Wegent 包含桌面工作台和可自托管的 Web 平台。Wegent Desktop 处理本地项目、文件、命令、测试和代码改动。Wegent Web 提供浏览器端智能体、知识、自动化和管理功能。Wegent Backend 把这些应用接到共享项目空间、模型和执行设备上。

下载最新版 Wegent Desktop · 文档 · 参与贡献

Wegent Desktop

Wegent Desktop 按项目和任务组织本地编码工作。任务视图把对话、工具活动、测试、改动文件和 diff 放在一起；项目空间视图提供看板、共享文件、自动化和执行状态。

在 Wegent Desktop 中运行并审查本地编码任务。

Wegent Desktop 里的项目空间，包含任务看板、共享文件、自动化和执行状态。

功能

- 桌面工作台 —— 整理本地项目、任务、会话、文件、工具活动、测试和差异。
- 可复用智能体 —— 组合模型、提示词、技能、知识、工具和协作设置。
- 项目空间 —— 共享任务看板、文件、讨论、自动化、执行历史和交付物。
- 多种执行目标 —— 在本地、远程工作机或服务端托管的执行器上运行任务。
- 自托管 —— 部署 Wegent Web 和 Backend，供团队访问，并提供 API、权限、调度和知识服务。

为什么选 Wegent

Wegent Desktop 的基础，是构建在 Codex 之上的本地编码体验。 它直接操作你项目里的代码、文件、命令和开发环境。当编码工作需要跨出一台电脑或一个人时，把它连到 Wegent Backend。连上之后，桌面工作台和 Web 共用同一批项目、任务和执行设备。

- 在合适的设备上运行任务 —— 继续使用本地机器上已有的代码、文件、命令和开发环境，也可以把同一项目的任务放到远程工作机或服务端托管的执行器上运行。
- 以团队方式推进项目 —— 项目空间把任务看板、共享文件、讨论、执行状态和交付物连在一起，不再让对话和代码改动散落在不同电脑上。
- 自动化重复的项目工作 —— 项目空间可以配置自动化和执行队列，让日常工作持续推进。
- 服务和数据由团队掌控 —— 自托管 Web 和 Backend，统一管理共享访问、权限、模型配置、调度、知识服务和远程设备。

如果工作始终留在一台电脑上，Wegent Desktop 提供熟悉的 Codex 编码体验。当任务需要跨人、跨设备或进入自托管环境时，连上 Wegent 就能扩展这套体验。

Wegent Web

Wegent Web 为远程智能体提供浏览器界面。智能体可以使用配置好的模型、知识、技能和工具，由 Wegent Backend 管理它们的任务和执行。

Wegent 远程智能体用工具生成并展示甘特图。

工作原理

Wework 是 Wegent 的桌面工作台。Electron 负责桌面窗口、系统能力和进程管理。DeepSeek Harness（DSH）是内嵌的应用与插件运行时，Wework 的产品界面由一组 DSH 插件组合而成。Executor 管理任务和会话，然后驱动 Codex 在本地项目里完成实际工作。

flowchart LR
Electron["ElectronDesktop host"]

subgraph DSH["DSH Runtime"]
direction TB
Core["DSH CorePlugin discovery, dependency injection, and lifecycle"]
App["dsh-app-weworkWework product shell and UI extension points"]
UI["dsh-ui-Tasks, project spaces, settings, apps, and automation"]
ElectronPlugin["dsh-electron-hostElectron capability bridge"]
ExecutorPlugin["dsh-executor-runtimeTask execution and event adapter"]
TerminalPlugin["dsh-terminal-runtimeLocal interactive terminals"]

Core --> App
Core --> UI
Core --> ElectronPlugin
Core --> ExecutorPlugin
Core --> TerminalPlugin
App --> UI
end

Executor["ExecutorTask and session execution"]
Codex["CodexCoding agent"]
Workspace["Local projectFiles and commands"]

Electron -->|"Starts and hosts"| Core
Electron -->|"Starts and supervises"| Executor
ElectronPlugin <-->|"Restricted desktop capabilities"| Electron
UI <-->|"User actions and UI updates"| ExecutorPlugin
ExecutorPlugin -->|"Create, follow up, approve, cancel"| Executor
Executor -->|"Status, messages, tool events, results"| ExecutorPlugin
Executor <-->|"Launch, control, and events"| Codex
Codex <-->|"Read, modify, and execute"| Workspace
TerminalPlugin <-->|"PTY"| Workspace

DSH 自己不执行编码任务。dsh-app-wework 定义产品外壳和扩展点，dsh-ui- 提供产品模块，dsh-electron-host 桥接受限的 Electron 能力，dsh-executor-runtime 在整个执行过程中与 Executor 双向通信，dsh-terminal-runtime 管理本地交互式终端。Executor 是任务执行层，Codex 是它驱动的具体编码智能体。

Wework 也能连接 Wegent Backend，共享项目空间、模型和远程执行设备。Wegent Web 是独立的浏览器界面，构建在同一个 Backend 之上。

快速开始

Wegent Desktop

1. 下载最新的 Wegent Desktop 安装包并安装。
2. 打开应用，添加或选择一个本地项目。
3. 创建任务，描述要做的工作。
4. 查看智能体活动、命令输出和文件变更。

Wegent Web 与 Backend

用 Docker 以 standalone 模式启动自托管 Web 应用和 Backend：

curl -fsSL https://raw.githubusercontent.com/wecode-ai/Wegent/main/install.sh | bash -s -- --standalone
打开 http://localhost:3000，按安装流程创建管理员密码并配置模型。其他部署方式见安装指南和单机模式。

开发

需要 Node.js 22.15+（22.x）或 23.8+（推荐 Node.js 24），以及 pnpm：

pnpm install
pnpm --filter wework dev

运行 macOS 桌面应用：

pnpm --filter wework dev:mac

桌面端的开发、构建与发布说明见 wework/README.md。wework/ 是当前桌面应用的源码目录。

仓库结构

产品与服务

| 目录 | 职责 |
| wework/ | Wegent Desktop（Electron、Vite、React） |
| wework-mobile/ | 独立的 Expo 应用，面向 iOS 和 Android |
| frontend/ | Wegent Web（Next.js、React） |
| backend/ | 默认公共 API、业务逻辑与数据模型 |
| backend-rs/ | Rust 混合网关，以及已完成迁移的 API |
| executor/ | Rust 任务执行器、本地设备运行时与 Codex 集成 |
| executor_manager/ | 服务端执行器调度、沙箱与编排 |
| chat_shell/ | 轻量聊天与智能体运行时 |
| knowledge_runtime/ | 知识索引与检索 API |
| knowledge_doc_converter/ | 文档解析与异步转换服务 |

共享代码与开发者工具

| 目录 | 职责 |
| knowledge_engine/ | 可复用的 Python 内核，负责解析、索引、向量存储与检索 |
| shared/ | 各服务共用的 Python 模型、协议、工具与遥测 |
| packages/ | Web 与 Desktop 共用的 TypeScript 聊天与协作模块 |
| sdk/ | 插件认证、构建、创建，以及钉钉工作区 SDK |
| wegent-cli/ | 管理 Wegent CRD 资源的 Python 命令行 |

基础设施、测试与文档

| 目录 | 职责 |
| docker/ | 服务镜像、单机资源，以及 docker/telemetry/ 可观测性栈 |
| scripts/ | 安装、发布、验收、仓库策略与开发自动化 |
| tests/ | 跨服务 Playwright 集成测试与安装测试 |
| docs/ | 中英文用户文档、开发者文档、架构与历史设计 |
| patches/ | pnpm patchedDependencies 使用的第三方依赖补丁 |
| LICENSES/ | 仓库分发所需的第三方许可证文本 |
| .github/ | CI、发布工作流、复合 action 与仓库自动化 |

根目录入口

| 文件 | 职责 |
| start.sh, install.sh | 本地启动与自托管安装 |
| build_image.sh, build_image_mac.sh | 多架构与宿主机 Docker 镜像构建 |
| docker-compose*.yml | 默认、构建与 E2E Compose 编排 |
| package.json, pnpm-workspace.yaml | JavaScript/TypeScript 工作区定义 |
| pyproject.toml, uv.lock | 仓库级 Python 工具与锁文件元数据 |
| AGENTS.md, CLAUDE.md | 贡献者规则与兼容性符号链接 |

文档

- Wegent Desktop 文档
- 桌面端开发与发布
- Wegent 快速开始
- 安装与部署
- 核心概念
- 开发者指南
- 故障排查

贡献

欢迎提交 bug 报告、改进文档、贡献代码，也欢迎分享 Wegent 的新用法。

- 贡献指南
- 安全策略
- GitHub Issues
- 钉钉社区：「wework社区交流」，群号 190890002451
- Discord 社区
- 许可证

贡献者

感谢每一位帮助 Wegent 成长的人。

Axb

Feifei

MicroLee

FicoHu

Icycrystal4

Yanhe

YaFei Liu

junlong chen

+7

Moqimoqidea

Jake Zhang

fishermen

Johnny0120

Parabala

Joyway78

Yi Xiang

Birch

lvmowei

Xuemin

sleetdrop

Fengkuizhi

Jm.hu

Kva

Twelveeee

xiaoqiang

Just Quan

Kerwin Bryant

RockysGit

Erdawang

Junbaor

Fingki

李枨煊

friendfei

qinxll

Li Daiyan

Sense_wang

Code-wangdi

Jolestar

Jasper Zhong

Ray

RichardoMu

alexcastgonz

Andrewzq777

Ch15084

Gdouyang

Graindt

haohaitao

Qingcheng

Salt-hai

wang zhuo

Wxcfox

Made with ❤️ by WeCode-AI Team