【免费下载链接】WegentPlan, build, and deliver with an open-source, self-hostable AI workspace for coding, collaboration, and automation.项目地址https://gitcode.com/gh_mirrors/we/Wegent点击查看免费下载Wegent 是一个开源、可自托管的 AI 工作区AI workspace用于编码、协作与自动化。它的任务执行层wegent-executor是一个用 Rust 编写的执行器既支持Docker 沙箱隔离运行也支持本地设备运行时直接跑在你的 Mac/Linux/Windows 上并通过持久化的Codex app-server完成 AI 编码集成。本文带你快速看懂这三大核心机制的设计原理无需深入代码也能理解它的架构脉络。一、先认识 wegent-executor一个二进制两种形态整个执行器由 Rust 编译为单一二进制wegent-executor构建说明见 executor/BUILD.mdDocker 模式在容器内启动 HTTP 执行服务由 Executor Manager 统一调度天然获得容器级隔离本地模式作为桌面应用Wework的 sidecar 运行通过 Socket.IO 与 Backend 通信无需 Docker 环境。两种模式共用同一套任务执行核心Agent 引擎、协议层、事件流因此云端沙箱与本地设备在能力上保持对齐。二、Docker 模式容器 bubblewrap 的沙箱隔离在 docker/executor/Dockerfile 中可以看到生产环境的隔离设计容器隔离Rust 二进制被复制到镜像的/app/executor稳定路径配合EXECUTOR_MODEdocker、端口10001运行每个任务运行在独立容器中进程级沙箱镜像中额外安装了bubblewrap这是 Codex 在 Linux 上的沙箱 helper让 AI 生成的 shell 命令、文件改动被限制在沙箱边界内能力预装Claude Code、OpenAI Codex CLI、浏览器自动化Playwright/Chromium、文档生成依赖LibreOffice、pandoc 等都在镜像层固化保证任务环境可复现。容器之外还有一个 Python 写的Executor Manager见 executor_manager/services/sandbox/负责沙箱的创建、调度scheduler.py、健康检查health_checker.py、Skills 同步skill_sync.py与运行时绑定runtime_binding.py并维护sandboxes/{id}/heartbeat这类心跳链路对应执行器侧 executor/src/heartbeat.rs。 一句话总结Docker 管环境边界bubblewrap 管进程边界两层防线保护宿主机。三、本地模式你的电脑就是执行沙箱本地模式的核心文档是 executor/docs/LOCAL_MODE.md。它在用户目录下建立独立主目录实现逻辑隔离~/.wegent-executor/ ├── workspace/ # 代码仓库克隆位置{task_id}/{repo_name} ├── logs/ # 轮转日志 └── cache/skills/# Skills 缓存关键组件均在 executor/src/local/ 下组件文件职责LocalBackendRunnerexecutor/src/local/backend.rsSocket.IO 连接、设备注册、心跳、任务事件分发AppIpcServerexecutor/src/local/app_ipc.rs通过 stdin/stdout 向桌面 App 提供 JSONL IPCAgentProcessEngineexecutor/src/agents/mod.rsClaude Code / Codex / Dify 等 Agent 统一执行入口连接配置优先级为环境变量 ~/.wegent-executor/device-config.json 默认值。当 Wework 桌面端启动执行器并设置WEGENT_APP_IPC_DEVICE_ID时本地控制面走 stdio IPC而独立启动的本地执行器则沿用 Socket.IO 远端链路两条链路可并存。值得一提的是这条本地设备链路是从 Python 版迁移到 Rust 的executor/docs/LOCAL_DEVICE_PYTHON_MIGRATION_TESTS.md 逐条列出了迁移状态与测试覆盖包括设备身份持久化、能力同步、终端会话PTY、取消任务等全部行为——这是 Rust 执行器本地即生产级的证据。开发者的日常循环由 executor/local.sh 一条命令搞定./local.sh all完成构建、停止、启动./local.sh logs查看日志。四、Codex 集成持久化 app-server JSON-RPC 权限画像Codex 集成是执行器中最精巧的部分实现集中在 executor/src/agents/codex.rs。它不是每次任务起一个 CLI 进程而是维护一个持久化的codex app-server进程通过 stdio 上的 JSON-RPC见 executor/src/agents/codex/json_rpc.rs进行对话进程复用与自愈app-server 按二进制 专属 Home维度共享运行时代理变更、轮次卡死默认 180 秒无进展时会自动重启Executor 关闭时会终止所有派生的 Agent 进程三级权限画像任务请求中可指定:read-only只读、:workspace工作区内可写、:danger-full-access完全访问默认策略由 Backend 下发AI 的能力边界因此是可审计、可配置的命名 Agent Homeexecutor/src/agents/instance_home.rs 为不同 Bot 分配独立的 Agent Home 目录会话、Skills、插件状态互不干扰并带文件锁防止并发写入Skills 部署executor/src/agents/runtime_capabilities.rs 负责从 Backend 拉取受管 Skills 包先解包到暂存目录再原子替换支持 ETag 增量同步。五、凭证安全本地模型代理Codex 进程本身不接触任何模型供应商密钥。executor/src/server/local_model_proxy/ 在本地起了一个模型代理Codex 只请求127.0.0.1上的固定路由由代理负责注入凭证、附加自定义 Header、走出站代理、归一化 Responses 流并把 Chat Completions 供应商翻译成对应协议。附带限流重试1s/5s/10s/30s/60s 退避与图片预算控制。这意味着即使某个 Skill 行为异常它拿到的也只是本地回环地址真实 API Key 始终留在执行器内存中。六、上手路径从零跑通本地执行器克隆仓库后进入executor目录执行cargo build --release --locked产物在target/release/wegent-executor设置连接信息后直接运行WEGENT_BACKEND_URLhttp://localhost:8000 \ WEGENT_AUTH_TOKENyour-auth-token \ ./dist/wegent-executor或者用一键脚本./local.sh all完成构建与后台启动观察~/.wegent-executor/logs/executor.log确认设备已注册、心跳正常生产部署则使用 Dockerdocker build -f docker/executor/Dockerfile -t executor:latest .交给 Executor Manager 统一编排。七、小结Wegent 的 Rust 执行器用一套代码同时解决了三个难题关注点方案安全边界Docker 容器 bubblewrap 沙箱 权限画像本地运行单一 Rust 二进制 Socket.IO/stdio 双链路 独立主目录AI 集成持久化 Codex app-server JSON-RPC 本地模型代理核心关键词回顾Wegent Rust 执行器、沙箱隔离、本地设备运行时、Codex 集成、wegent-executor。如果你想进一步研究建议从 executor/docs/LOCAL_MODE.md 的架构图与 executor/tests/ 下上百个 contract 测试入手——它们比任何文档都更准确地描述了这个执行器的行为契约。赞分享【免费下载链接】WegentPlan, build, and deliver with an open-source, self-hostable AI workspace for coding, collaboration, and automation.项目地址https://gitcode.com/gh_mirrors/we/Wegent点击查看免费下载相关推荐dolphin-code 沙箱运行时如何隔离运行 AI 编码agent-runtime 架构深度解析dolphin code 沙箱运行时如何隔离运行 AI 编码agent runtime 架构深度解析 dolphin code 的 agent runtimeDB-GPT Sandbox 沙箱执行环境深度解析从分层架构到多运行时隔离实践DB GPT Sandbox 沙箱执行环境深度解析从分层架构到多运行时隔离实践 导读 本文以 docs/docs/sandbox/index.md https人工智能大模型AI AgentRAG模型推理服务本地部署后端前端DeepAudit安全沙箱技术深度解析Docker隔离与执行DeepAudit作为国内首个开源代码安全分析多智能体系统其核心的安全沙箱技术为用户提供了高度隔离的执行环境。在安全测试过程中安全沙箱通过Docker容器技人工智能AI Agent大模型代码智能体应用安全后端前端RAG创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考