Agent 隐藏桌面工作区

为 AI agent 提供独立的 Linux 桌面与浏览器,完成 GUI 和网页任务时不占用你的屏幕。

Star 数
★ 228
最近更新
6 天前
License
MIT
主语言
Rust

30 秒速览

运行形态
命令行工具MCP 服务器Agent 插件 / 技能
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
免费,无需付费服务
上手难度
中 · 需要几步配置
开始前需要
LinuxXvfbOpenboxxdotoolxauthx11-utilsImageMagickxclipdbus-daemonpkg-configlibxkbcommon-x11-devShell / 命令行网络访问本地文件系统MCP Server
典型场景
需要在不抢占员工桌面或 Chrome 会话的情况下运行 GUI 与网站 QA 的开发团队。
不适合
  • 需要自动化真实桌面或宿主 Chrome 的用户
  • 需要跨用户隔离或安全沙箱的团队
  • 使用非 Linux 系统的团队
维护状态
近 30 天有提交最近提交 2026-11-15最新版本 v0.6.4(2026-11-06)近 7 天每天 +1.3 ★

这个 Agent 能做什么,适合哪些场景?

agent-workspace-linux 通过 X11 或原生 Wayland,为 agent 创建带独立窗口管理器或合成器、应用、剪贴板和浏览器的隐藏工作区。它提供 CLI 和通过 stdio 通信的 MCP server,可供 Codex、Claude Code 等 MCP host 使用。agent 可以启动应用、输入和点击、截取屏幕,并控制工作区自有的 Chrome 或 Chromium;用户可通过浮动 viewer 查看、暂停或停止工作区。项目支持 X11、i3、KWin、GNOME、Hyprland 和 COSMIC 六种后端,也提供可复用的 workspace profile。应用仍以当前用户身份运行并可访问其文件和网络,因此工作区不是安全沙箱。

先用 agent-workspace-linux doctor 检查依赖和可用后端,再通过 workspace start --ack-hidden-workspace 创建工作区。agent 可用 workspace launch 启动应用,用 workspace observe --screenshot 获取截图,并调用键盘、鼠标、窗口及剪贴板操作;浏览器流程通过 workspace open-browser 启动工作区自有 Chrome,再用 browser-navigate、browser-snapshot 等命令读取和操作页面。MCP host 可调用相应工具,浮动 viewer 提供实时查看、暂停、只读和停止控制。工作区停止后会清理其运行时临时文件。

  1. 需要在不抢占员工桌面或 Chrome 会话的情况下运行 GUI 与网站 QA 的开发团队。
  2. 希望让 agent 在可观察、可随时停止的独立浏览器中执行后台网页任务的用户。
  3. 需要创建干净 Linux 桌面来启动应用、截图检查并在完成后销毁的测试人员。
  4. 需要为长时间运行或无头 agent 提供独立桌面的运维人员。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • npm install -g @agent-sh/agent-workspace-linux
  • cargo install --git https://github.com/agent-sh/agent-workspace-linux
配置文件
.mcp.json
安装说明涉及
Linux

如何安装或部署这个 Agent?

默认 X11 后端需要安装系统依赖,然后选择从源码安装、npm 获取预编译二进制,或通过 Cargo 构建。MCP host 可使用 .mcp.json 注册 server。没有要求单独提供模型 API 密钥;agent 通过 MCP host 提供的工具调用工作区。

sudo apt install xvfb openbox xdotool xauth x11-utils imagemagick xclip \
    dbus-daemon pkg-config libxkbcommon-x11-dev
./install.sh

也可以安装预编译版本:

npm install -g @agent-sh/agent-workspace-linux

或从 Git 构建:

cargo install --git https://github.com/agent-sh/agent-workspace-linux

MCP host 配置示例:

{
  "mcpServers": {
    "agent-workspace-linux": {
      "command": "/home/YOU/.local/bin/agent-workspace-linux",
      "args": ["mcp"]
    }
  }
}

如何使用这个 Agent?

先检查环境并预览工作区,再显式确认创建。启动后可打开 viewer、运行应用、查看截图,最后停止工作区。

agent-workspace-linux doctor
agent-workspace-linux workspace start --dry-run
agent-workspace-linux workspace start --ack-hidden-workspace --purpose "QA run"
agent-workspace-linux viewer
agent-workspace-linux workspace launch --name editor -- xterm
agent-workspace-linux workspace observe --screenshot --output /tmp/ws.png
agent-workspace-linux workspace stop

MCP host 可由 agent 调用相应工具。浏览器操作示例:

agent-workspace-linux workspace open-browser "http://127.0.0.1:8111"
agent-workspace-linux workspace browser-navigate "http://127.0.0.1:8111/page" --wait-ms 1500
agent-workspace-linux workspace browser-snapshot --max-text-chars 2000

这个 Agent 有哪些优点和局限?

优点
  • 工作区拥有独立显示、窗口管理器或合成器、剪贴板和浏览器,避免输入落到用户桌面。
  • 支持六种 X11 和原生 Wayland 后端,可按主机环境选择。
  • MCP 工具带有只读、写入、破坏性或开放世界标记,并支持 daemon 强制执行应用白名单。
  • 浮动 viewer 可实时查看并暂停、设为只读或停止工作区。
局限
  • 仅支持 Linux;默认 X11 安装需准备多项系统包,原生后端还有各自依赖。
  • 项目明确说明它不是沙箱;应用以当前用户身份运行,可访问用户文件和网络。
  • 版本处于 1.0 之前,接口和工具 schema 可能变化。
  • viewer 在原生 Wayland 上的支持仍在成熟中,控制 socket 按同一用户信任模型设计。

这个 Agent 与同类方案有什么区别?

若要操作用户正在使用的真实 Linux 桌面,可考虑项目说明中的 sibling computer-use-linux;本项目面向 agent 的独立后台工作区,两者用途互补。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Agent 隐藏桌面工作区 当前 80 · 表现良好 命令行工具免费 ★ 228 6 天前 Rust Codex · Claude Code
OpenBot:可托付真实工作的 AI 同事 87 · 表现良好 自托管服务免费 + 模型费 ★ 13k 今天 TypeScript —
Open Computer Use(MCP 桌面服务) 79 · 表现良好 命令行工具免费 + 模型费 ★ 3k 1 天前 Swift Codex · Claude Code
Auto Browser 76 · 存在缺口 自托管服务免费 + 模型费 ★ 929 5 天前 Python OpenAI API · Claude API

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
表现良好
80/ 100 五分制 4.0 / 5
信任安全 19/29
可靠稳定 11/14
适用触发 18/18
规范维护 15/18
有效结果 10/13
证据核验 7/8
查看各维度的扣分理由
信任安全19 / 29 · 3.3/5

文档明确说明工作区不是沙箱,宿主运行时会共享用户文件、网络、密钥环和 SSH agent;权限上限、工具风险标记、只读/暂停控制及隐藏工作区显式确认提供了实际约束,因此最小权限与确认得分为 2。README、技能和安全策略都披露数据边界及浏览器配置文件风险,数据流透明度充分;但默认无应用白名单,实时控制也只是尽力而为,敏感数据保护不完整。对外部操作要求批准,且清理会在无法验证进程归属时停止并报告错误;仍未充分说明所有外部副作用的恢复流程。依赖审计有明确例外和解释,但 Git 依赖跟踪 main 分支,安全策略仅支持 latest。许可证和维护者身份有文件依据,但发布者未经验证,且未给出清晰的替代维护或更新责任链,因此来源归属仅部分充分。

可靠稳定11 / 14 · 3.9/5

README、SKILL、权限模型、安全策略与代码入口对产品边界和主要操作流程基本一致,并以 doctor、dry-run、状态查询和错误检查降低误操作风险。CI 配置覆盖构建、静态检查、测试及依赖审计,但这些只是配置证据而非本次执行结果。依赖包括跟踪 main 的 GPUI Git 分支,可能改变且不如固定修订可复现;可见错误路径有上下文和失败关闭行为,但样本不足以证明所有故障消息都清楚,故未给满分。

适用触发18 / 18 · 5.0/5

项目明确面向后台 GUI/Web QA、浏览和无人值守桌面任务,并清楚排除宿主桌面控制和纯代码编辑。技能提供按阶段渐进加载工具的路由,权限边界、支持后端、运行时版本、缩放差异及 Linux 限制均有具体说明。多后端和按需准备的 GNOME 运行时支持多种 Linux 环境,证据充分,故这些项目得高分。

规范维护15 / 18 · 4.2/5

README 按安装、快速开始、后端、安全、限制和文档组织,安装步骤覆盖系统包、二进制、MCP 注册及多个安装方式。命名和版本信息整体可辨认,但预 1.0 明确可能变动,样本未包含变更日志;示例丰富但未见常见问题索引,故相关项目为部分充分。限制说明详细,MIT 许可证清楚。安全策略说明 latest 支持和私密漏洞报告渠道,但维护责任主要落在单一署名者,未见更完整的团队维护或继任安排。

有效结果10 / 13 · 3.8/5

产品提供独立桌面、专属浏览器、观察与控制界面,以及可由 MCP 调用的 GUI 自动化能力,能解决不占用用户桌面的明确任务,边际价值较高。工具结果和计划包含状态、预览、告警及审批检查点,但样本未完整呈现工具输出模式,因此输出可直接用于后续流程的程度仅部分得到支持。系统依赖和多后端安装成本较高,收益与成本说明有限。

证据核验7 / 8 · 4.4/5

README 的关键安全与能力主张能在权限模型、安全策略、SKILL、Cargo 配置及代码片段中找到对应依据;CI 文件列出可复核的构建、检查和审计步骤。不同来源存在较好的交叉印证,但本次只提供部分技能和源文件样本,交叉核对范围有限。文档区分已实现机制、运行限制和测试/探针说明;本评估将其视为静态主张,不将 CI 配置当作已执行结果,因此事实与推断边界清楚。

风险与缓解建议
  • 工作区不是沙箱:宿主运行时中的应用以当前用户身份运行,可访问用户文件、网络、密钥环和 SSH agent;默认没有应用白名单。
  • 启用真实账户或浏览器配置文件可能触及真实登录状态和外部操作;应使用经明确批准的配置文件副本,并对发送、购买或账户变更单独确认。
  • 项目处于预 1.0 阶段,且 GPUI 依赖跟踪 Git main;接口及构建依赖可能变化。
证据充分度:低 评估于 2026年11月11日 审查版本 3bb1e46250e0 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/agent-workspace-linux.svg?lang=zh)](https://followagents.com/zh/agents/agent-workspace-linux)
<a href="https://followagents.com/zh/agents/agent-workspace-linux"><img src="https://followagents.com/badge/agent-workspace-linux.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.6.4
    发布说明摘录
    KWin 6.8.2 workspaces now start when screenshots use RGBX8888. X11 display selection now skips stale artifacts owned by another user instead of aborting. - Accept KWin QImage::Format_RGBX8888 screenshots and force the unused alpha byte to opaque (#194). - Skip unremovable stale X11 sockets and locks, then continue with the next display (#195). - Keep prepared-runtime cache hashes stable with explicit lowercase SHA-256 encoding (#185). - Fix permission tests on NixOS and cover symlinked absolute allow entries (#196). …
    在 GitHub 查看 ↗
  2. v0.6.3
    发布说明摘录
    GNOME 46 is available as a prepared workspace runtime. Use --session gnome --session-version 46, or session: {"backend":"gnome","version":"46"} through MCP and saved profiles. GNOME 46 is the only prepared version. Host packages remain the default. - Fix KWin clicks that dropped the button press. Motion and following input now share one connection and allow pointer focus to settle. Drag start and scrolling use the same path. …
    在 GitHub 查看 ↗
  3. v0.6.2
    发布说明摘录
    The native viewer now uses bundled Inter and supports saved Light, Dark and System themes. The header wraps in narrow windows, secondary controls scroll, and status labels are easier to read. - Viewer typography, colors, spacing and empty states refreshed in #173. - Faster local builds and nextest-based test runs in #172. - Focus smoke now waits for its test window to finish input setup before typing. - Updated rmcp, libc and wayland-protocols dependencies. Install or update: ```sh npm install -g @agent-sh/[email protected] ``` …
    在 GitHub 查看 ↗

常见问题

创建工作区会自动开始吗?
不会。创建时必须传入 --ack-hidden-workspace,MCP 工具也要求显式确认。
这是安全沙箱吗?
不是。工作区应用以当前用户身份运行,可访问文件和网络;宿主运行时还会转发 SSH/GPG agent 和部分会话服务。
它能控制我正在使用的 Chrome 或真实桌面吗?
项目将输入和浏览器控制限定在工作区;浏览器命令要求工作区自有 Chrome/Chromium,不用于驱动宿主桌面或宿主 Chrome。
使用是否需要付费模型或 API 密钥?
仓库记录的软件采用 MIT 许可,安装和示例没有要求付费模型或 API 密钥;agent 由 MCP host 提供。
停止后临时工作区文件会怎样?
工作区停止后,其可写运行时层和临时文件会被移除;已准备的 GNOME 46 镜像会保留供复用。
Agent 隐藏桌面工作区 开源吗?
开源。源码在 GitHub(agent-sh/agent-workspace-linux),许可证是 MIT。
Agent 隐藏桌面工作区 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-15,在最近 30 天内。最新版本是 v0.6.4(2026-11-06)。
Agent 隐藏桌面工作区 是谁开发的?
Agent 隐藏桌面工作区 由 GitHub 账号 agent-sh 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念