# @aifabrix/builder 中文文档

规范地址：https://npmcn.com/package/%40aifabrix/builder/

版本：2\.67\.1
npm 元数据更新时间：2026-10-29T12:53:20.690Z
中文译文更新时间：2026-11-06T16:59:25.929Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：10.5 MB，1811 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.0\.0
- 运行依赖：15 个
- 首次发布：2025-10-26T17:20:40.744Z
- 最新版本发布：2026-10-29T12:53:20.451Z
- 近 30 天下载量：2672（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：118（近 12 个月 103 个）

## 中文简介

AI Fabrix 构建器 — CLI和开发者脚本(pnpm + af)

## 安装

```sh
npm install @aifabrix/builder
```

也可以使用：`pnpm add @aifabrix/builder`、`yarn add @aifabrix/builder`、`bun add @aifabrix/builder`

## README

# AI Fabrix - 构建器

[![npm version](https://img.shields.io/npm/v/@aifabrix/builder.svg)](https://www.npmjs.com/package/@aifabrix/builder) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

AI Fabrix生态系统开放开发者运行时间. 安装 AI Fabrix 平台并在本地测试. 然后加入外部集成或构建自己的应用程序.

← **完整文档:** [文档/README.md](https://npmcn.com/package/%40aifabrix/builder/docs/README.md) (所有指南的目录)

**贡献者快速启动(miso QQ 数据平面 QQ 构建器):** [QUICK-START.md (中文(简体) )](https://npmcn.com/package/%40aifabrix/builder/QUICK-START.md)

* * *

## 为什么是AI Fabrix Builder?

-   **构建视角 :** JSON schemas-没有隐藏的逻辑.
-   **工业标准和安全:** 遵循行业标准和高安全性(如ISO 27k);版本控制中没有秘密.
-   **您的版本控制中的全部生命周期 :** 配置,app,和集成在自己的VCS(GitHub,GitLab,Azure DevOps)中.
-   **从第一天开始的一个工具:** 单一的CLI,用于本地基础、应用和集成创建、构建、运行和部署同样的应用和集成工作流程.
-   **一致性和生产准备:** Schema驱动; 在同一控制器/数据飞机上部署应用软件和集成设备; 与生产准备的秘密 `kv://` 和Azure键瓦特.
-   **应用程序开发:** 使用 **[错误客户](https://github.com/esystemsdev/aifabrix-miso-client)** (TypeScript和Python)与数据平面和控制器交谈. repo 包括 TypeScript 和 Python SDK; 参见 [模板/应用程序/数据平面/README.md](https://npmcn.com/package/%40aifabrix/builder/templates/applications/dataplane/README.md) 和用来偿还的.

* * *

## 先决条件

-   **节点.js 22+** - 支持CLI地板;Node.js 24.22.1是目前推荐的运行时间.
-   **嵌入桌面** ——全面接入多克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克.
-   **平台前的秘密 :** 在设置中或与之一起添加一个 AI 工具密钥( OpenAI 或 Azure OpenAI) `aifabrix secret set` **在此之前** 平台需要它们。 见 [基础设施](https://npmcn.com/package/%40aifabrix/builder/docs/infrastructure.md)。 。 。 .

* * *

## 安装 CLI

```bash
npm install -g @aifabrix/builder
```

**别名:** 你用得着 `af` 改为 `aifabrix` 在任何命令.

客户集成寄存器可以安装代理 Kit(Cursor, Codex, and Claude Code),其中:

```bash
aifabrix agent-kit install
```

见 [代理 Kit 命令](https://npmcn.com/package/%40aifabrix/builder/docs/commands/agent-kit.md)。 。 。 .

* * *

## 目标1:安装平台(一个命令)

让Postgres, Redis, Keycloak, Miso Control, 和Dataplane在你的机器上运行.

```bash
aifabrix setup
```

这是大多数开发者的全部故事。 此命令检测到下面是否已经运行 :

| 情况 | 发生什么事 |
| --- | --- |
| **新鲜机器** | 短向导 · 拉出图像 · `up-infra` → `up-platform` |
| **已安装** | 模式菜单( 3个选项 ) : **重新安装** (销毁数卷), **擦除数据** (只有数据库),或 **更新图像** (保存数据) – 每个路径在重启前会拉出新鲜的多克图像 |

**拿杯咖啡来** ——设置牵引基础设施和站台图像(先运行几分钟后或在图像更新后). 设置完成后, CLI 将存储 **`platform-controller`** 内 `config.yaml` (绝对的Miso URL 对于你的机器). 用用户名签名 **`admin`** 和您的管理员密码。 如果您已经登录到控制器 URL, 设置会话会保留; 否则它会像新安装一样提示设备登录 .

**控制器 URL :** 不使用Traefik 的本地多克 `http://localhost:` + 端口 `3000 + developerId×100`与特拉菲克和 `remote-server`中,使用显示在 **平台准备** 页脚( 路径) `/miso/*`) (中文(简体) ). 见 [基础设施指南](https://npmcn.com/package/%40aifabrix/builder/docs/infrastructure.md#install-the-platform-one-command)。 。 。 .

——分步骤详细情况、港口和 **dev / 亲** 安装配置 : **[基础设施指南](https://npmcn.com/package/%40aifabrix/builder/docs/infrastructure.md#install-the-platform-one-command)**

### Dev vs pro 安装( 设置配置)

这些名字和我们谈论的吻合 **环境** 其他地方(**备忘**, (中文(简体) ), **点**, (中文(简体) ), **专业**) (中文(简体) ). 在这里,他们的意思 **如何在本地安装**,而不是你部署到哪个云层环境.

| 简介 | 最好还是 | 管理电子邮件 | 管理密码 |
| --- | --- | --- | --- |
| **备忘** (默认) | 地方发展、培训、实验室 | 您输入一次 | **一个密码** 用于 Postgres, pgAdmin, Keycloak 和平台登录 |
| **专业** | 生产型或硬化装置 | 一样 | **自动生成** 强口令( 击出一次) **或者说** 手动输入 |

**默认 :** **备忘** (一个电子邮件,一个密码). **赞成** 在设置向导中或非交互作用中可用 :

```bash
aifabrix setup --installation pro --pro-password-mode autogen
```

使用 `--pro-password-mode manual` 输入密码(所有角色都有一个密码,或将以下 / Keycloak / 平台密码通过 `up-infra` 旗帜).

管理证书存储于 **`~/.aifabrix/admin-secrets.env`** (在配置密钥时加密). 应用和集成秘密留在里面 **`~/.aifabrix/secrets.local.yaml`**。 。 。 .

### 配置 LLM 提供者

`aifabrix setup` 不收集 LLM 证书。 存储选中的提供者值 在您的本地或共享秘密商店中

```bash
aifabrix secret set openai/apiKey <your-openai-secret-key> --shared
```

同样的模式适用于 `azure-openai/apiKey`, (中文(简体) ), `azure-openai/endpoint`,以及 `anthropic/apiKey`。当集成表提及匹配时 `kv://` 地址:, `aifabrix upload` 解析本地或共享存储的值并按下 放在Dataplane上而不把值放在清单中。 米苏上船 还直接配置这些标准地址.

完全删除平台 : `aifabrix teardown`。命令细节 : [基础设施命令](https://npmcn.com/package/%40aifabrix/builder/docs/commands/infrastructure.md#aifabrix-setup)。 。 。 .

* * *

## 目标2:外部系统一体化

创建并部署外部系统(如HubSpot):向导或手动设置,再验证并部署.

**示例: 枢纽点:**

-   创建 : `aifabrix create hubspot-test` (外部是默认;或 `aifabrix wizard` 以便他们遵循正道。 用于网络应用 `aifabrix create my-app --type webapp`。 。 。 .
-   配置认证和数据源 `integration/hubspot-test/`。 。 。 .
-   验证 : `aifabrix validate hubspot-test`
-   部署: `aifabrix deploy hubspot-test`

→ [外部系统指南](https://npmcn.com/package/%40aifabrix/builder/docs/external-systems.md) • 妇女 [向导](https://npmcn.com/package/%40aifabrix/builder/docs/wizard.md)

* * *

## 目标3:建立自己的应用程序

本地创建、配置和运行您的 AI Fabrix 应用程序或部署它( 创建 app 配置 构建 运行/ 部署) .

→ [您的应用程序](https://npmcn.com/package/%40aifabrix/builder/docs/your-own-applications.md)

* * *

## 文档

所有指南和参考文献均列于 **[文档/README.md](https://npmcn.com/package/%40aifabrix/builder/docs/README.md)** (目录).

-   [CLI 命令参考](https://npmcn.com/package/%40aifabrix/builder/docs/commands/README.md) - 所有命令
-   [基础设施](https://npmcn.com/package/%40aifabrix/builder/docs/infrastructure.md) - 安装平台、服务、dev/pro设置
-   [配置参考](https://npmcn.com/package/%40aifabrix/builder/docs/configuration/README.md) - 配置文件(部署密钥、应用程序)。 (Yaml, env.template, 秘密)

* * *

## 所需资源

-   **嵌入桌面** - 用于运行容器
-   **节点.js 22+** - 支助的CLI楼层;建议采用节点24.22.1
-   **阿苏尔CLI** - 部署到Azure(可选)

* * *

## 许可证

北欧电子系统有限公司2026年----所有权利保留地

`@aifabrix/builder` 是AI Fabrix平台的一部分.

## 常见问题

### @aifabrix/builder 是什么？

AI Fabrix 构建器 — CLI和开发者脚本\(pnpm \+ af\)

### 如何安装 @aifabrix/builder？

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

### @aifabrix/builder 支持 TypeScript 吗？

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

### @aifabrix/builder 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @aifabrix/builder 需要什么版本的 Node\.js？

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

### @aifabrix/builder 可以商用吗？

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

### @aifabrix/builder 的下载量有多少？

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

### @aifabrix/builder 还在维护吗？

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