Wegent

一套跨越本地桌面、云端智能体与远程工作机的开源 AI 工作系统。

English | 简体中文

Wegent 包含桌面工作台和可自托管的 Web 平台。Wegent Desktop 用于处理本地项目、文件、命令、测试和代码变更；Wegent Web 提供网页端智能体、知识库、自动化和管理功能；Wegent Backend 为这些应用提供共享项目空间、模型和执行设备。

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

Wegent Desktop

Wegent Desktop 按项目和任务组织本地编码工作。任务界面集中展示会话、工具活动、测试、变更文件和 Diff；项目空间界面提供任务看板、共享文件、自动化和执行状态。

_{在 Wegent Desktop 中执行并审查本地编码任务。}

_{Wegent Desktop 中的项目空间，包括任务看板、共享文件、自动化和执行状态。}

核心功能

• 桌面工作台：组织本地项目、任务、会话、文件、工具活动、测试和 Diff。
• 可复用智能体：组合模型、提示词、Skills、知识、工具和协作配置。
• 项目空间：共享任务看板、文件、讨论、自动化、执行记录和交付物。
• 多种执行位置：在本机、远程工作机或服务端执行器中运行任务。
• 自托管服务：部署 Wegent Web 和 Backend，管理团队访问、API、权限、调度和知识服务。

为什么选择 Wegent

**基于 Codex 的本地编码体验是 Wegent Desktop 的基础。**它直接在你的项目中使用本地代码、文件、命令和开发环境；当编码工作需要跨越一台电脑或一个人时，再连接 Wegent Backend。连接后，本地工作台和 Web 使用同一套项目、任务和设备资源。

• 让任务在合适的设备上运行：继续使用本地已有的代码、文件、命令和开发环境，也可以选择远程工作机或服务端执行器运行同一个项目的任务。
• 让团队围绕同一个项目推进：项目空间将任务看板、共享文件、讨论、执行状态和交付物关联起来，而不只是在各自的电脑上保存会话和代码变更。
• 把重复流程交给自动化：项目空间可配置自动化与执行队列，用于持续推进项目中的例行工作。
• 由团队掌握服务和数据：Web 和 Backend 可以自托管，用于共享访问、权限、模型配置、调度、知识服务和远程设备管理。

如果工作始终只在一台电脑上完成，Wegent Desktop 提供熟悉的 Codex 编码体验；当任务需要在多人、多设备或自托管环境之间流转时，连接 Wegent 可在此基础上继续扩展。

Wegent Web

Wegent Web 提供远程智能体的网页界面。智能体使用配置好的模型、知识、Skills 和工具，Wegent Backend 负责管理任务和执行。

_{Wegent 远程智能体调用工具生成甘特图。}

工作方式

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

flowchart LR
    Electron["Electron<br/>桌面宿主"]

    subgraph DSH["DSH Runtime"]
        direction TB
        Core["DSH Core<br/>插件发现、依赖注入与生命周期"]
        App["dsh-app-wework<br/>Wework 产品外壳与 UI 扩展点"]
        UI["dsh-ui-*<br/>任务、项目空间、设置、应用与自动化"]
        ElectronPlugin["dsh-electron-host<br/>Electron 能力桥接"]
        ExecutorPlugin["dsh-executor-runtime<br/>任务执行与事件适配"]
        TerminalPlugin["dsh-terminal-runtime<br/>本地交互式终端"]

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

    Executor["Executor<br/>任务与会话执行"]
    Codex["Codex<br/>编码 Agent"]
    Workspace["本地项目<br/>文件与命令"]

    Electron -->|"启动并托管"| Core
    Electron -->|"启动并监管"| Executor
    ElectronPlugin <-->|"受限桌面能力"| Electron
    UI <-->|"用户操作与界面更新"| ExecutorPlugin
    ExecutorPlugin -->|"创建、追问、审批、取消"| Executor
    Executor -->|"状态、消息、工具事件、结果"| ExecutorPlugin
    Executor <-->|"启动、控制与事件"| Codex
    Codex <-->|"读取、修改与执行"| Workspace
    TerminalPlugin <-->|"PTY"| Workspace

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

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，按页面引导设置管理员密码并配置模型。更多部署方式见 安装指南 和 Standalone 模式。

开发

需要 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 与桌面端共享的 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 快速开始
• 安装与部署
• 核心概念
• 开发者指南
• 故障排查

参与贡献

欢迎提交问题、改进文档、贡献代码或分享新的使用方式。

• 贡献指南
• 安全策略
• 问题反馈
• 钉钉社区群：“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