# @domscribe/relay 中文文档

规范地址：https://npmcn.com/package/%40domscribe/relay/

版本：0\.7\.0
npm 元数据更新时间：2026-10-27T19:41:45.206Z
中文译文更新时间：2026-11-12T15:49:45.850Z
软件包许可：未声明

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

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

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

- 包体积（解压后）：724 kB，277 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：16 个
- 首次发布：2026-03-18T01:16:49.627Z
- 最新版本发布：2026-10-27T19:41:44.587Z
- 近 30 天下载量：141201（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：16（近 12 个月 16 个）

## 中文简介

DOMLATS 本地继电器服务器和 MCP 适配器

## 安装

```sh
npm install @domscribe/relay
```

也可以使用：`pnpm add @domscribe/relay`、`yarn add @domscribe/relay`、`bun add @domscribe/relay`

## README

# @ dominis/ 转发

Domlis的本地中继服务器和MCP适配器.

`@domscribe/relay` 运行在开发者的机器上,并用编码代理连接到浏览器上方. 它提供了用于注释管理的HTTP API,用于实时重叠更新的WebSocket服务器,以及用于代理工具访问的MCP服务器.

## 安装

```bash
npm install @domscribe/relay
```

## CLI 命令

具有CLI的中继舰管理服务器过程和工作空间初始化.

```bash
domscribe serve     # Start relay server (foreground or --daemon)
domscribe status    # Check relay daemon status
domscribe stop      # Stop relay daemon
domscribe init      # Setup wizard (agent + framework configuration)
domscribe mcp       # Run as MCP server via stdio
```

用于代理 MCP 配置, 独立 `domscribe-mcp` 二进制直接在stdio上运行MCP服务器,而无需HTTP/WebSocket中继.

**Monorepo 支持 :** 所有命令自动从 a 解析程序根 `domscribe.config.json` 从单列波根运行时的文件。 运行 `domscribe init --app-root <path>` 生成配置,或让交互式向导检测它.

## 寿命周期

开发者点击运行中的应用程序中的元素,键入一个指令并提交. 注释通过下列状态:

| 从 | 改为: | 触发 |
| --- | --- | --- |
| `QUEUED` | `PROCESSING` | 代理电话 `domscribe.annotation.process` |
| `PROCESSING` | `PROCESSED` | 代理电话 `domscribe.annotation.respond` |
| `PROCESSING` | `FAILED` | 代理错误或超时 |
| `PROCESSED` | `ARCHIVED` | 通过覆盖开发者存档 |

代理人声称在解剖学上(防止双重处理)进行注解,编辑相关的源文件,再以摘要回复. 封面通过WebSocket接收状态更改并实时更新.

## WebSocket 事件

中继在 WebSocket 上播放事件, 以保持连接到的覆盖实例同步 .

| 活动 | 说明 |
| --- | --- |
| `CONNECT` 编号 : `CONNECTED` 编号 : `DISCONNECTED` | 连接生命周期 |
| `ERROR` | 连接出错 |
| `ANNOTATION_CREATED` 编号 : `ANNOTATION_UPDATED` | 注释变化 |
| `MANIFEST_UPDATED` | 显示文件更改 |
| `CONTEXT_REQUEST` 编号 : `CONTEXT_RESPONSE` | 双向运行时上下文查询 |

`CONTEXT_REQUEST` 编号 : `CONTEXT_RESPONSE` 当代理从浏览器中请求活组件道具或状态时使用 – 中继器将请求转发到覆盘中,覆盘中查询运行时间并通过相同的WebSocket连接发送回回复.

## 链接

部分 [多写](https://github.com/patchorbit/domscribe)。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @domscribe/relay 是什么？

DOMLATS 本地继电器服务器和 MCP 适配器

### 如何安装 @domscribe/relay？

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

### @domscribe/relay 支持 TypeScript 吗？

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

### @domscribe/relay 支持 ESM 还是 CommonJS？

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

### @domscribe/relay 需要什么版本的 Node\.js？

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

### @domscribe/relay 可以商用吗？

@domscribe/relay 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @domscribe/relay 的下载量有多少？

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

### @domscribe/relay 还在维护吗？

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