# @alfe\.ai/gateway 中文文档

规范地址：https://npmcn.com/package/%40alfe.ai/gateway/

版本：0\.14\.5
npm 元数据更新时间：2026-11-05T01:43:51.579Z
中文译文更新时间：2026-11-06T20:42:37.338Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40alfe.ai/gateway
原文对照：https://npmcn.com/package/%40alfe.ai/gateway/?lang=original
项目主页：https://alfe.ai/

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

- 包体积（解压后）：1.2 MB，12 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：11 个
- 首次发布：2026-03-26T19:44:24.993Z
- 最新版本发布：2026-11-05T01:43:51.397Z
- 近 30 天下载量：2374（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：124（近 12 个月 124 个）

## 中文简介

Alfe 本地网关守护进程——用于代理集成的持久控制平面

## 安装

```sh
npm install @alfe.ai/gateway
```

也可以使用：`pnpm add @alfe.ai/gateway`、`yarn add @alfe.ai/gateway`、`bun add @alfe.ai/gateway`

## README

# @alfe.ai/门路

本地网关守护进程 Alfe —— 代理 VM 之间的常有控制平面, 它的运行时间,和阿尔费云.

## 概览

网关守护进程是一个独立的节点.js进程:

-   与 Alfe 云保持持久的 WebSocket 连接(`@alfe/gateway-service` (关于Fly.io)
-   显示 Unix 套接字 `~/.alfe/gateway.sock` 用于本地插件 IPC
-   从全云快照调试集成和状态化的运行时配置
-   监督所选运行时间( E)`openclaw`, (中文(简体) ), `hermes`,或 `claude-code`(中文(简体) )
-   托管本地 AI 代理和 MCP 捆绑器
-   幸存时间重新启动并报告生命周期/健康回云

## 建筑

```
Alfe Cloud ←—— control WS ——→ @alfe.ai/gateway (daemon)
                                     ├── runtime supervisor → OpenClaw/Hermes/Claude host
                                     ├── integration reconciliation
                                     ├── local AI proxy + MCP bundler
                                     └── IPC (~/.alfe/gateway.sock) ← runtime plugins/CLI
```

## 先决条件

1.  运行 `alfe setup` (或有管理地提供)配置代理身份
2.  节点.js 22+
3.  小时

## 使用量

### 通过 `alfe` CLI(建议)

```bash
# Start daemon (foreground)
alfe gateway start

# Check status
alfe gateway status

# Stop daemon
alfe gateway stop

# Install as system service (auto-start on boot)
alfe gateway install

# Remove system service
alfe gateway uninstall

# View logs
alfe gateway logs

# Full health check
alfe doctor
```

### 通过独立二进制

```bash
# Start daemon in foreground
alfe-gateway start

# Status
alfe-gateway status

# Stop
alfe-gateway stop
```

## IPC 议定书

插件连接到 `~/.alfe/gateway.sock` 并说新线限制 JSON:

### 请求( 插件 ) — 守护进程)

```json
{ "type": "req", "id": "uuid", "method": "register", "params": { "name": "my-plugin", "version": "1.0.0", "protocolVersion": 1, "capabilities": ["integrations"] } }
```

### 响应( 守护程序 ) – 插件

```json
{ "id": "uuid", "ok": true, "payload": { "status": "registered", "daemonVersion": "<current CLI version>", "protocolVersion": 1 } }
```

### 事件( 守护- 插件)

```json
{ "type": "event", "event": "cloud.status", "payload": { "connected": true } }
```

### 现行方法

| 方向 | 方法 | 说明 |
| --- | --- | --- |
| 守护进程- 缓冲 | `runtime.activity` | 测试在计划重启之前是否有聊天转机 |
| 插件 – 守护程序 | `register` | 用守护进程注册插件 |
| 插件 – 守护程序 | `status` | 获取守护进程健康状况 |
| 插件 – 守护程序 | `integration.list` | 列出已知的整合 |
| 插件 – 守护程序 | `integration.report` | 报告整合状况 |
| 插件 – 守护程序 | `mcp.list_tools` 编号 : `mcp.call_tool` | 检查或引用捆绑的MCP工具 |
| 插件 – 守护程序 | `mcp.list_servers` 编号 : `mcp.add_server` 编号 : `mcp.remove_server` | 管理本地 MCP 服务器 |

IPC是只拥有者,新线限定的JSON. 请求必须包含非空 `id`编号 :`method` 字段和对象 `params`; 单个信件封顶于 1个米B.

## 文件位置

| 文件 | 路径 |
| --- | --- |
| 配置 | `~/.alfe/config.toml` |
| 套接字 | `~/.alfe/gateway.sock` |
| PID 文件 | `~/.alfe/gateway.pid` |
| 日志 | `~/.alfe/logs/gateway.log` |
| 已启动列表 | `~/Library/LaunchAgents/ai.alfe.gateway.plist` |
| 系统化单元 | `~/.config/systemd/user/alfe-gateway.service` |
| 系统环境管理 | `~/.alfe/gateway.env` (或 `/etc/alfe/gateway.env` 用于根) |

## 警卫

-   套接字文件为 `chmod 0600` (仅限所有者使用)
-   PID 所有权在发送信号前与实时进程命令进行校验
-   管理下的系统化证书只保存在所有人(`0600`) 环境文件,而不是单位文本
-   证书碎片从未被记录
-   Auth 使用来自所管理环境的代理 API 密钥或 `~/.alfe/config.toml`

## 发展

```bash
# From monorepo root
pnpm install
pnpm --filter @alfe.ai/gateway build
pnpm --filter @alfe.ai/gateway test
pnpm --filter @alfe.ai/gateway lint
pnpm --filter @alfe.ai/gateway typecheck

# Dev mode (auto-restart on changes)
pnpm --filter @alfe.ai/gateway dev
```

## 云协议

守护进程使用云网关服务表达以下消息类型:

| 方向 | 消息 | 说明 |
| --- | --- | --- |
| 出境 | `SERVICE_REGISTER` | 用云注册守护进程 |
| 入境 | `SERVICE_ACK` | 云确认注册 |
| 入境 | `COMMAND` | 云发出命令执行 |
| 出境 | `COMMAND_ACK` | 守护进程报告命令结果 |
| 入境 | `DESIRED_STATE` | 云能推动理想的融合状态 |
| 出境 | `RECONCILIATION_REPORT` | 守护进程报告调节结果 |
| 出境 | `COMMANDS_AVAILABLE` | 守护进程发布整合命令 |
| 入境 | `PING` | 云心跳动 |
| 出境 | `PONG` | 守护进程心跳响应 |

`DESIRED_STATE` 是一个原子,可以删除的快照。 守护进程验证 当一行形状不正确时,每个嵌入的条目都会拒绝整个框架 已复制。 如果本地化状态无法实现, 它也会跳过所有突变 读取。 见 `src/protocol.ts`, (中文(简体) ), `src/reconciliation.ts`,以及 `DEVELOPING.md` 联 合 国 正式合同.

## 链接

-   网站: [https://alfe.ai (英语)](https://alfe.ai/)
-   医生: [https://docs.alfe.ai (英语)](https://docs.alfe.ai/)

## 常见问题

### @alfe\.ai/gateway 是什么？

Alfe 本地网关守护进程——用于代理集成的持久控制平面

### 如何安装 @alfe\.ai/gateway？

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

### @alfe\.ai/gateway 支持 TypeScript 吗？

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

### @alfe\.ai/gateway 支持 ESM 还是 CommonJS？

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

### @alfe\.ai/gateway 可以商用吗？

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

### @alfe\.ai/gateway 的下载量有多少？

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

### @alfe\.ai/gateway 还在维护吗？

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