# @agent-sh/agent-workspace-linux 中文文档

规范地址：https://npmcn.com/package/%40agent-sh/agent-workspace-linux/

版本：0\.6\.4
npm 元数据更新时间：2026-11-06T21:32:33.590Z
中文译文更新时间：2026-11-09T22:53:12.583Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agent-sh/agent-workspace-linux
原文对照：https://npmcn.com/package/%40agent-sh/agent-workspace-linux/?lang=original
项目主页：https://github.com/agent-sh/agent-workspace-linux#readme
源码仓库：https://github.com/agent-sh/agent-workspace-linux

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：22.3 kB，4 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-05-27T11:21:13.253Z
- 最新版本发布：2026-11-06T21:32:33.254Z
- 近 30 天下载量：1704（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

AI代理的背景 Linux 桌面: MCP 服务器二进制包.

## 安装

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

也可以使用：`pnpm add @agent-sh/agent-workspace-linux`、`yarn add @agent-sh/agent-workspace-linux`、`bun add @agent-sh/agent-workspace-linux`

## README

# @ agent-sh/ agent-workspace-linux (英语)

npm 分布包装 [`agent-workspace-linux`](https://github.com/agent-sh/agent-workspace-linux) MCP服务器:用于AI代理的背景Linux桌面.

## 安装

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

安装器自动下载您架构的预建二进制 从匹配中 [GitHub 发布](https://github.com/agent-sh/agent-workspace-linux/releases), (中文(简体) ), 然后核实所需 `<asset>.sha256` 安装前是侧车.

**仅限Linux.** `x64` (x86 64) (中文(简体) ) `arm64` (arch64)得到支持.

> **说明- `--ignore-scripts`数字 :** 跳过生命周期脚本(如:. `pnpm` 与 `ignore-scripts=true`,一些CI设置)不会自动下载二进制. 手动运行邮箱以恢复 :
> 
> ```sh
> node $(npm root -g)/@agent-sh/agent-workspace-linux/scripts/postinstall.js
> ```

发布下载接受绝对或相对的 HTTPS 重定向位置 最多5个重定向跳. 错误的 URL 和非 HTTPS 重定向目标 失败下载; 重定向不会绕过所需的校验和.

每个二进制或校验和下载在等待时有60秒的不活动超时 用于响应头或身体进展。 计时器每次字节到来都会重排 所以 仍在取得进展的缓慢转移可以继续下去。 分开30分钟 硬天花板只限制病理转移。 超时失败关闭活动 在重试开始前输出并删除其部分文件.

支票和副车厢必须包含有效的64-hex-digital SHA-256文摘并命名 预期释放资产。 接受空格和分页分隔符。 裸体文摘或 拒绝指定不同资产的项目.

邮购脚本对已验证的装配应用可执行权限 在替换已安装的二进制文件之前。 如果许可准备失败, 它 报告失败,并让先前安装的二进制未被更改.

每个安装在二进制旁使用自己独有的创建的中程目录 . 同时期安装不会去除或覆盖对方的下载. 常规 补全和错误清理尝试本身的中程目录; 强制 终止可以留下弃置 `.staging-*` 目录。 稍后安装 删除一个小时以上的运行目录并留下更新的目录 可能属于仍在运行的安装器.

## 使用量

安装后, 命令会位于您的 PATH( 它没有被扫描) 。 启动 MCP 服务器 :

```sh
agent-workspace-linux mcp
```

这是一个 [MCP 磁共振](https://modelcontextprotocol.io/) 服务器会说JSON -RPC 超过 stdio。 对于用于 Linux 的 Codex , 选择专用 **代理工作空间** 特性页这样命令路径,权限规则,以及重新连接/重启控制都不要出现在通用的MCP设置页面中. 如果旧的 Codex 安装在通用 MCP/配置页面中仍然显示此后端, 请移除 stale `agent-workspace-linux` MCP表在通过功能页重新连接之前. 对于其他MCP客户端,将其接入客户端配置,例如Claude Code:

```json
{
  "mcpServers": {
    "agent-workspace-linux": {
      "command": "agent-workspace-linux",
      "args": ["mcp"]
    }
  }
}
```

命令行包装器保留本地程序的退出代码并终止 信号 特别是,被SIGINT终止的儿童导致包装纸 由SIGINT也终止,而不是报告退出代码为0.

## 资料来源和完整文件

所有源代码、工具文档和问题跟踪都位于: **[https://github.com/agent-sh/agent-workspace-linux (中文(简体) )](https://github.com/agent-sh/agent-workspace-linux)**

## 许可证

麻省理工学院

## 常见问题

### @agent-sh/agent-workspace-linux 是什么？

AI代理的背景 Linux 桌面: MCP 服务器二进制包\.

### 如何安装 @agent-sh/agent-workspace-linux？

在项目目录运行 npm install @agent-sh/agent-workspace-linux，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agent-workspace-linux，可以用 npx agent-workspace-linux 直接运行。

### @agent-sh/agent-workspace-linux 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/agent-sh\_\_agent-workspace-linux 是否存在。

### @agent-sh/agent-workspace-linux 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @agent-sh/agent-workspace-linux 可以商用吗？

@agent-sh/agent-workspace-linux 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @agent-sh/agent-workspace-linux 的下载量有多少？

根据 npm 官方下载统计，@agent-sh/agent-workspace-linux 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,704 次，日均约 57 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agent-sh/agent-workspace-linux 还在维护吗？

最新版本 0\.6\.4 发布于 2026/11/07（3 天前）；至今共发布 21 个版本，其中过去 12 个月发布了 21 个；首次发布于 2026/05/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。