# @brrew/projectbridge 中文文档

规范地址：https://npmcn.com/package/%40brrew/projectbridge/

版本：0\.3\.29
npm 元数据更新时间：2026-10-26T06:34:40.074Z
中文译文更新时间：2026-11-10T00:33:07.783Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40brrew/projectbridge
原文对照：https://npmcn.com/package/%40brrew/projectbridge/?lang=original

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

- 包体积（解压后）：137 kB，8 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-10-12T07:31:53.247Z
- 最新版本发布：2026-10-26T06:34:39.746Z
- 近 30 天下载量：1692（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 26 个）

## 中文简介

项目Bridge远程托管代理CLI

## 安装

```sh
npm install @brrew/projectbridge
```

也可以使用：`pnpm add @brrew/projectbridge`、`yarn add @brrew/projectbridge`、`bun add @brrew/projectbridge`

## README

# Bridge 远程 CLI 项目

ProjectBridge是专有软件. 所有权利都保留;npm发布使得软件包可以安装,但不准许复制,修改,再发行,或创作衍生作品,除非是版权持有人单独授权.

## 安装和运行

```sh
npx --yes @brrew/projectbridge@latest remote --server https://YOUR-BRIDGE.example
```

要录取并让东道主坚持一步,运行:

```sh
npx --yes @brrew/projectbridge@latest remote --persistent --server https://YOUR-BRIDGE.example
```

在 Windows 上, 从高级管理员 PowerShell 上运行 。 它在 % ProgramData ProjectBridge 下安装了全机代理, 配置一个运行于 NT 的 AtStartup 任务为 NT 的 AUTHORITY\\ SYSTEM, 并且不依赖于登录用户 。 Windows为初始安装需要Node.js 20+和npm. 如果Node.js仅在安装账户中可用,安装者会在程序Data下分出可执行的节点和npm,因此背景代理不依赖于该用户配置文件. 尽可能将现有的每个用户入学人数迁移到方案数据库。 在 macOS 和 Linux 上,持续的启动仍然被范围化到安装用户. 对于已经注册的宿主,单独的安装服务命令仍然可用.

只删除持久启动项( 保留入学证书) :

```sh
npx --yes @brrew/projectbridge@latest uninstall-service
```

如果仪表板取消了这个主机,则本地证书是故意的,不会被再使用. 开始新的、经仪表板核准的入学,并恢复持续启动:

```sh
npx --yes @brrew/projectbridge@latest reenroll --persistent --server https://YOUR-BRIDGE.example
```

命令使用已保存的服务器时 `--server` 被省略,停止旧的背景代理,请求新的一次性配对代码,并等待您在仪表盘中再次批准主机. 审批期间保持航站楼开放. 使用 `reenroll` 无 `--persistent` 仅在您想要前景连接时; 使用 `reenroll --persistent` 用于通常的安装器流.

要完全卸载本地代理, 背景启动, 保存证书, 并安装运行时间, 运行 :

```sh
npx --yes @brrew/projectbridge@latest uninstall --yes
```

交互运行请求确认, 除非 `--yes` 提供。 这只删除本地文件;它不会改变主机在ProjectBridge仪表板中的记录. 必要时另取出记录.

检查并安装最新 npm 发布到管理的运行时间 :

```sh
npx --yes @brrew/projectbridge@latest update
```

CLI 开始一个短寿命的入学请求,并要求您批准认证的ProjectBridge仪表板中的匹配主机. 在交互式安装期间,主机会显示一个 ASCII splash 屏幕并询问是否允许远程工具调用(`y/N`,默认编号。 柜台审批 单独核实和注册主机。 该代理人安全地存储了特定东道方的证书,发送经认证的最新健康信息,检查授权的任务,并报告限定的结果。 持续设置配置代理在背景中运行,并在中断后重新连接. 在运行期间,它定期检查更新情况,并利用包登记册的安全运输和完整性检查加以应用.

## 所需资源

-   节点.js 20+
-   HTTPS 访问ProjectBridge服务器
-   用户必须签入 ProjectBridge 仪表板批准匹配的入学申请

ProjectBridge不默认选择服务器. 设定 `--server https://YOUR-BRIDGE.example` 命令,或设置 `PROJECTBRIDGE_SERVER` 在运行它之前。 选中的服务器会随本地注册而保存 。 现有注册继续使用所保存的服务器; 传递不同的 `--server` 对于一个已经注册的宿主来说,是安全失败的,而不是默默地重定向它. 只为了地方发展, `http://localhost:8792` 已接受。 设定 `PROJECTBRIDGE_CONFIG` 以覆盖每个用户配置路径; Windows 全机模式总是使用 `%ProgramData%\ProjectBridge\remote.json`。关于配对、心跳、任务投票和任务结果的请求将发送给选定的服务器。 代理检查 npm 用于软件包更新; npm 注册访问与ProjectBridge服务器连接分离.

## MCP 工具名兼容性

MCP工具标识器由ProjectBridge MCP服务器提供,它与这个远程主机代理包是分开的. 当前服务器使用 `pb_` 前缀(例如, `pb_list_hosts`, (中文(简体) ), `pb_host_task`,以及 `pb_host_system_process_terminate`) 保留在 MCP 客户端的 40 个字符工具名限制内。 更新此 npm 主机代理包不会替换 MCP 服务器; 更新/ 重新启动服务器安装 .

## 远程主机控制

在新安装时, 远程工具呼叫默认禁用, 除非安装者明确回答 `y` 迅速获得当地同意。 现有注册主机在迁移期间保持目前的同意,经确认后可从仪表板上启用或禁用 `host.control.enable` 编号 : `host.control.disable` 任务 :

```sh
npx --yes @brrew/projectbridge@latest remote-control status
npx --yes @brrew/projectbridge@latest remote-control enable
npx --yes @brrew/projectbridge@latest remote-control disable
```

启用时,一个已注册的主机可以提供有界限的文件系统列表/stat/read/search,原子文件写作和独有的文本补丁,目录创建,文件移动/删除, shell命令,以及交互式进程会话(启动/读取/输入/终止). 进程细节和已编辑的ProjectBridge配置视图也可用. shell 命令作为运行代理机的操作系统账户执行,该账户拥有权限;启用主机控制不会提升权限. 需要变异 `confirm: true` 在任务。 外壳输出和文件读取被绑定,主机文件读取可以以字节抵消来恢复并准确的 Base64 块有效载荷(散列范围被标签为文件或块),目录列表/搜索结果会暴露续作光标. 文件删除拒绝目录, 文件补丁拒绝模糊匹配 。 交互进程会话仅活到代理进程,重启后不恢复.

授权状态存储于主机的入学配置 `remote_control_enabled` (Windows全机模式与系统/管理员ACL在程序数据下存储);证书从未由 `host.config.get`安装器的本地 `y` otop- in允许运行代理机的OS账户下列出的工具; 它不会提升权限 。 Dashboard 批准录用主机,但不能代替当地选入。 一旦设备投入使用并启用了本地遥控器,即不经每个任务仪表板批准而发出改变国家的行动。 如果主机停止接受维护请求,则从仪表板上禁用主机控制. 持续运作取决于东道主支持的背景服务设施和配置.

## 可选REA工具

REA是可选的,在普通的ProjectBridge入学期间没有安装. 在项目Bridge主机注册后,使用:

```sh
projectbridge rea status
projectbridge rea install
projectbridge rea remove
```

在交互式终端中安装并删除确认请求 。 使用 `--yes` 只当您明确希望批准非互动操作时。 要在初始主机设置中选择, 添加 `--with-rea` 页:1 `remote` 或者说 `install-service` 命令。 没有这面旗帜,标准安装仍然无REA.

主机从认证的ProjectBridge工艺品端点下载一个被绑定的版本捆绑;它不安装 `latest` 直接从npm。 服务器必须先安装一个经批准的平台捆绑。 见寄存器的 `docs/REA_DEPLOYMENT.md` 用于发布中转和平台要求。 REA的外部分析提供者(Hopper,Ghidra,IDA,JADX,浏览器和JDK)仍然分别安装了可选的依赖性.

## 常见问题

### @brrew/projectbridge 是什么？

项目Bridge远程托管代理CLI

### 如何安装 @brrew/projectbridge？

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

### @brrew/projectbridge 支持 TypeScript 吗？

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

### @brrew/projectbridge 需要什么版本的 Node\.js？

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

### @brrew/projectbridge 可以商用吗？

@brrew/projectbridge 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @brrew/projectbridge 的下载量有多少？

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

### @brrew/projectbridge 还在维护吗？

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