# @alienplatform/commands 中文文档

规范地址：https://npmcn.com/package/%40alienplatform/commands/

版本：3\.3\.54
npm 元数据更新时间：2026-11-05T10:26:35.260Z
中文译文更新时间：2026-11-06T07:01:33.026Z
软件包许可：FSL-1\.1-Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40alienplatform/commands
原文对照：https://npmcn.com/package/%40alienplatform/commands/?lang=original
项目主页：https://alien.dev/
源码仓库：https://github.com/alienplatform/alien

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

- 包体积（解压后）：285 kB，22 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：1 个
- 首次发布：2026-07-20T10:34:04.944Z
- 最新版本发布：2026-11-05T10:26:35.016Z
- 近 30 天下载量：4234（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：71（近 12 个月 71 个）

## 中文简介

纯TypeScript 命令发送器和为外星平台拖取接收器, 获取

## 安装

```sh
npm install @alienplatform/commands
```

也可以使用：`pnpm add @alienplatform/commands`、`yarn add @alienplatform/commands`、`bun add @alienplatform/commands`

## README

# `@alienplatform/commands`

向异形部署发送命令或从任何节点或Bun接收命令 进程。 对于主机外星,普通应用程序不需要 `alien.ts`,管理器 URL,或 手工铸造的代币. 软件包为纯类型脚本 `fetch`。 。 。 .

## 安装

```sh
npm install @alienplatform/commands
```

需要节点18+或Bun 1.0.23+.

## 从外部应用程序发送

连接部署 ID 和服务器侧外星 API 密钥 :

```ts
import { CommandsClient } from "@alienplatform/commands"

const commands = await CommandsClient.forDeployment({
  deploymentId: "dep_123",
  apiKey: process.env.ALIEN_API_KEY!,
})

const result = await commands
  .target("image-processor")
  .invoke<{ ok: boolean }>("health-check", {})
```

外星人发现部署的现任经理 和薄荷薄荷短命, 仅命令访问。 API 密钥只发送到外星 API; 客户端使用 与经理的短暂的证书, 并在内部刷新.

## 在外部应用程序中接收

指定命令启动的容器或守护进程

```ts
import { createCommandReceiver } from "@alienplatform/commands"

const receiver = createCommandReceiver({
  deploymentId: "dep_123",
  apiKey: process.env.ALIEN_API_KEY!,
  target: "image-processor",
})

receiver.command("health-check", async () => ({ ok: true }))

process.on("SIGTERM", () => receiver.stop())
await receiver.run()
```

目标明确,因为一项部署可包含若干项 指挥能力资源。 发现开始于 `run()` 开始; 异形决定 目标是否是集装箱或守护进程,并发布短时间访问权限 仅限于部署和目标.

外星人部署的应用程序仍然是零配置,因为外星人注射了接收器 身份和全权证书:

```ts
const receiver = createCommandReceiver()
receiver.command("health-check", async () => ({ ok: true }))
await receiver.run()
```

## 自管经理

明确建造器仍可供自宿和当地使用 发展:

```ts
const commands = new CommandsClient({
  managerUrl: "http://localhost:8080",
  deploymentId: "dep_123",
  token: process.env.ALIEN_COMMANDS_TOKEN!,
})
```

对于明确的接收器,配置现有的 `ALIEN_COMMANDS_*` 环境变量和呼叫 `createCommandReceiver()`。 。 。 .

两者都接受 `platformUrl` 当异形平台 API 不在时 `https://api.alien.dev`。 。 。 .

断开的安装集 `ALIEN_COMMANDS_DISABLED=true` 用于具有指挥能力 工作量。 接收器接受处理器注册并等待到 `stop()` 无 进行网络请求。 没有这个明确的设置, 缺少接收器配置 启动时仍然失败 .

## 常见问题

### @alienplatform/commands 是什么？

纯TypeScript 命令发送器和为外星平台拖取接收器, 获取

### 如何安装 @alienplatform/commands？

在项目目录运行 npm install @alienplatform/commands，或使用 pnpm add / yarn add / bun add。

### @alienplatform/commands 支持 TypeScript 吗？

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

### @alienplatform/commands 支持 ESM 还是 CommonJS？

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

### @alienplatform/commands 需要什么版本的 Node\.js？

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

### @alienplatform/commands 可以商用吗？

@alienplatform/commands 使用 FSL-1\.1-Apache-2\.0 许可。声明的许可为 FSL-1\.1-Apache-2\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @alienplatform/commands 的下载量有多少？

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

### @alienplatform/commands 还在维护吗？

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