# @bridge4dev/runner 中文文档

规范地址：https://npmcn.com/package/%40bridge4dev/runner/

版本：0\.82\.0
npm 元数据更新时间：2026-10-17T01:45:06.245Z
中文译文更新时间：2026-11-08T15:46:54.994Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40bridge4dev/runner
原文对照：https://npmcn.com/package/%40bridge4dev/runner/?lang=original
项目主页：https://bridge4.dev/

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

- 包体积（解压后）：5.6 MB，330 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：5 个
- 首次发布：2026-07-26T14:52:40.198Z
- 最新版本发布：2026-10-17T01:45:06.074Z
- 近 30 天下载量：1887（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：75（近 12 个月 75 个）

## 中文简介

DevBridge dev serfer — 连接一个 Dev 服务器到 DevBridge并运行代理会话( Claude Code / Codex)

## 安装

```sh
npm install @bridge4dev/runner
```

也可以使用：`pnpm add @bridge4dev/runner`、`yarn add @bridge4dev/runner`、`bun add @bridge4dev/runner`

## README

# @ bridge4dev/ runner (英语)

DevBridge Dev跑车 它连接其中之一 **你们自己** 机器改为 [DevBridge 软件](https://bridge4.dev/) 并运行其中的编码代理会话 — Claude Code, Codex 或OpenCode——与从未离开那台机器的退票相对.

DevBridge 无法获得 SSH 访问权限和您的服务器的证书: 运行者连接 **向外** 在WSS之上,并持有它自己的唯一一个代号的副本.

## 所需资源

-   节点.js 20
-   gi
-   代理人 CLI : [克劳德代码](https://claude.com/claude-code) 或者说 [代码](https://developers.openai.com/codex/cli),从服务器卡上安装并签名 在DevBridge(或已经在机器上),或 [打开代码](https://opencode.ai/) - 仅限Linux, 由运行器安装到自己的文件夹( 见 _代理 clis_(中文(简体) )
-   用于打开代码 : `bubblewrap` – 每个 OpenCode 会话都在其中运行. DevBridge 安装器 给跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑跑 用户名空间(在 Ubuntu 24.04 上的 AppArmor 配置文件) `bwrap`(中文(简体) )
-   a DevBridge 账户,配对代码(盘-) **发展** → _连接服务器_(中文(简体) )

## 安装

```bash
npm install -g @bridge4dev/runner
```

然后将机器与仪表板上的代码配对并安装为服务:

```bash
devbridge-runner pair DBR-XXXXXXXX
devbridge-runner install-service
devbridge-runner status          # exit code 0 = connected
```

`install-service` 写入 **系统化用户单元** (单位:千美元)`CPUQuota=80%`, (中文(简体) ), `MemoryMax=2G`开始 这个 如果你宁愿在前台运行, 或者在你自己的主管之下,使用 `devbridge-runner daemon`。 。 。 .

> 全球安装可能打印 `ERESOLVE` 关于警告 `zod`克劳德探员SDK问 用于Zod 4作为同位素,而跑取者使用Zod 3. 安装成功—— npm 自己筑巢 - 复制 - 而且没有损坏。 添加 `--loglevel=error` 如果噪音打扰你的话.

## 图标

| 命令 | 它会做什么 |
| --- | --- |
| `pair <DBR-code> [--api <url>] [--name <name>]` | 申请配对代码,并保存跑道符号 |
| `install-service` | 安装 + 启动系统化用户服务 |
| `daemon` | 在前景中运行 |
| `status` | 连接状态; 连接时退出代码 0 |
| `set-token <dbr_token>` | 从仪表盘上旋转一个符号存储 |

## 机器上的东西

-   运行会话或 **项目文件夹本身中** ——默认:是分行 之后将不再适用,或 **git 工作树上的会话分支 其本身**,DevBridge要求当文件夹忙碌或树枝被命名时。 哪个 每场比赛都要在仪表板上决定.
-   执行地方政策。 一部分是仪表板 **无法** 提高:秘密文件 密钥永远不会被读取, 任何寄存器都不会被写入 `.git`,以及 `sudo`,服务 每个信任级别都拒绝控制、插头和防火墙。 一部分是束缚 由 DevBridge 的一位管理者选择的项目自己的设置: 代理商是否可以 `git push` 以及是否读取和更改文件 **项目之外 文件夹** ——包含同一机上的其他项目. 特工从盒子里推出 没什么 留在它的文件夹里 再加上隐藏在它流出的一切 和它自己的 最多可一次性开多少会.
-   将会话日记流出序列号和确认,从而重新启动 双方恢复工作而不是失去工作.
-   永不上传您的来源 。 每个文件和文件都请求 Diff 和文件视图 无法匹配密件拒绝列表 .

## 它拥有的文件

| 路径 | 目录 |
| --- | --- |
| `~/.config/devbridge-runner/config.toml` | API URL,服务器 ID, **运行符号** (mode 0600——此文件) _实值_ 那个秘密店) |
| `~/.local/state/devbridge-runner/` | 会议期刊和 `status.json` |
| `…/devbridge-runner/opencode-home/` | OpenCode:它自己的npm前缀,它的家,每个订阅一个数据文件夹(它) |
|  | 键和对话,模式0700 – 从未在机器上 `PATH` |

两个荣誉 `XDG_CONFIG_HOME` 编号 : `XDG_STATE_HOME`。 。 。 .

## 机器的主人可以关掉什么

`config.toml` 由跑者阅读,不能从仪表板上更改——这些是 拥有者的否决, 他们活下来的再补偿。 这里关闭的能力不是 完全向服务器宣布,所以仪表板没有绘制控制而非控制 回答“被否决”了.

```toml
[verify]
enabled = true          # running the project's own build/test recipe

[checkpoints]
enabled = true          # restore points (copies of the working tree, on this disk)

[agents]
install_enabled = true  # installing and updating the agent CLIs (0.47.0)
```

`[agents] install_enabled = false` 即时覆盖两条路线: **安装** 编号 : **更新** 服务器卡上的按钮和自动更新会话的启动否则 触发。 无论是哪种方式,下载到同一个磁盘上都是一样的.

## 代理 clis

由于0.47.0 跑者不携带克洛德二进制,安装者不安装 探员. `claude` 财务报告和审定财务报表 `codex` 普通系统安装,服务器卡显示 每个版本:

-   **安装/ 更新** 运行该代理商自己的安装器, 在一个版本 从注册处摘取的卡片。 先检查空闲空间, 测试新二进制 通过运行它,一个不会运行的建筑被卷回. **守护进程没有 重新启动** ——已运行的会话保留所打开的文件,新版本需要 下一张的效果.
-   **自动更新代理** (默认情况下)在会话中单独做同样的事情 开始,只为那个会话的代理人,最多每个代理人每天一次.

```bash
claude --version
codex --version
```

**打开代码** (2.x,只有Linux)是例外,目的. 跑者用npm安装它 进入它自己的状态文件夹中的前缀,并且只从那里开始,通过绝对路径—— a 一个 `opencode` 你装上 `PATH` 自己从来没有被使用, 和DevBridge不拿一个 签到的在里面。 它跟随销售商的最新2.x发布;每次安装和更新之后 跑者检查版本和包的签名 并运行一个短的探针转弯,然后放 如果一个版本失败,则返回上一版本。 每个会话都在内部运行 `bubblewrap`: 它看见了 系统只读、其项目文件夹和自订阅的密钥 订阅费。 何处 `bubblewrap` 不启动,则根本不提供OpenCode。 钥匙和 在DevBridge服务器的OpenCode页面上添加订阅; `devbridge-runner doctor` 显示隔离是否从这里开始(`opencode isolation`) (中文(简体) ).

## 更新

从仪表板:服务器卡提供 **更新运行器** 一旦更新版本为 正在使用中,跑者代替自己——在新建筑之前进行烟雾测试 重启,如果测试失败,则返回到先前的焦油球. **更新 运行此机的每次会话都断开**; 更新代理不存在.

手执:

```bash
npm install -g --omit=optional @bridge4dev/runner && systemctl --user restart devbridge-runner
```

## 许可证

麻省理工学院——见 [自由主义](https://npmcn.com/package/%40bridge4dev/runner/LICENSE)。 。 。 .

## 常见问题

### @bridge4dev/runner 是什么？

DevBridge dev serfer — 连接一个 Dev 服务器到 DevBridge并运行代理会话\( Claude Code / Codex\)

### 如何安装 @bridge4dev/runner？

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

### @bridge4dev/runner 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @bridge4dev/runner 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @bridge4dev/runner 需要什么版本的 Node\.js？

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

### @bridge4dev/runner 可以商用吗？

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

### @bridge4dev/runner 的下载量有多少？

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

### @bridge4dev/runner 还在维护吗？

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