# @fluid-app/fluid-cli-portal 中文文档

规范地址：https://npmcn.com/package/%40fluid-app/fluid-cli-portal/

版本：0\.1\.1136
npm 元数据更新时间：2026-11-15T14:45:59.888Z
中文译文更新时间：2026-11-15T01:32:17.796Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40fluid-app/fluid-cli-portal
原文对照：https://npmcn.com/package/%40fluid-app/fluid-cli-portal/?lang=original

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

- 包体积（解压后）：3.1 MB，46 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：11 个
- 首次发布：2026-03-06T21:03:53.259Z
- 最新版本发布：2026-11-15T14:45:59.691Z
- 近 30 天下载量：187385（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：1137（近 12 个月 1137 个）

## 中文简介

用于构建门户应用程序的流体 CLI 插件

## 安装

```sh
npm install @fluid-app/fluid-cli-portal
```

也可以使用：`pnpm add @fluid-app/fluid-cli-portal`、`yarn add @fluid-app/fluid-cli-portal`、`bun add @fluid-app/fluid-cli-portal`

## README

# Fluid Portal CLI — Pull & Push App 公告

Fluid CLI允许您将一个Fluid OS定义(您的应用程序显示——屏幕,主题,导航,配置)拉入本地的JSON文件,进行编辑,并被推回生产.

## 创建门户项目

```bash
fluid portal create my-portal
```

创建默认使用捆绑的条形起动器. 过 `--remote-template` 只有在您有意想要 GitHub 镜像时,或者 `--skip-install` 当您想要只使用脚手架输出时。 当前脚手架的使用 `createPortal({ customPages })`软件包 `src/widgets.config.ts`,且不包含 iframe 预览条目.

## 一次性设置

-   **构建 CLI** (从回波根出):
    
    ```bash
    pnpm --filter @fluid-app/fluid-cli --filter @fluid-app/fluid-cli-portal build
    ```
    
-   这个 `fluid` 二进制是 `packages/cli/core/dist/bin/fluid.mjs`可选的别名:
    
    ```bash
    alias fluid="node /path/to/repo/packages/cli/core/dist/bin/fluid.mjs"
    ```
    
    (以下所有例子都假定这个别名。) 没有它,替换 `fluid` 与 `node packages/cli/core/dist/bin/fluid.mjs`. ) (中文(简体) )
    

## 认证

-   **电子邮件 + MFA 流量 :**
    
    ```bash
    fluid login
    ```
    
-   **或者用 API 符号跳过 MFA :**
    
    ```bash
    FLUID_TOKEN="<your-api-token>" fluid login
    ```
    

## 拉一个定义

```bash
fluid portal pull
```

-   交互式拾取器,或直接瞄准一个: `fluid portal pull --app "<definition name>"`
-   写作 `portal/` (单位:千美元)`screens/`, (中文(简体) ), `themes/`, (中文(简体) ), `navigations/`, (中文(简体) ), `profiles/`, (中文(简体) ), `definition.json`加上一个 `.portal-sync/` 跟踪同步状态的文件夹.
-   切换到另一个定义, 并附带未加压缩的本地更改 ? 添加 `--force` 要覆盖.

## 编辑预览( P)

-   编辑 JSON 下的文件 `portal/`。 。 。 .
    
-   本地预览( 保存本地文件中的列表) :
    
    ```bash
    fluid portal dev
    ```
    

## 将更改往后推

```bash
fluid portal push
```

-   显示 diff 并请求确认( 添加) `--yes` 跳过).
-   **Push 不发布** 它更新了定义的工作状态/草稿状态。 终端用户不断看到当前活跃的已发布版本.
-   对于经核实的非互动释放, `fluid portal push --yes --activate` 推动草稿,并创建/激活一个活版,只当每次推动时 阶段成功。 部分推出非零并从未被激活.

## 发布门户版本( 仅在您想要显示的更改为活时)

```bash
fluid portal version create --activate     # snapshot current state + make it live
fluid portal version list                  # see all versions
fluid portal version activate <version-id> # promote a specific version
```

## 发布部件运行时的文物

门户部件包与主机门户外壳分开发布. 创建远程 DOM 部件并在单一源包中注册 :

```bash
fluid portal widget create stock-ticker
```

脚手架将部件写在下面 `src/widgets/` 创建或更新 `src/widgets.config.ts` 使用 `defineWidget` 财务报告和审定财务报表 `defineWidgetPackage` 从 工人安全门户SDK入口. `portal.config.ts`, (中文(简体) ), `customWidgets`和遗产 显端不是部件发现的一部分 .

门户网站CLI发布公司拥有的门户网站部件包:

```bash
fluid portal deploy
```

-   构建 `defineWidgetPackage` 输入 `widget.js`,范围CSS, `manifest.json`, (中文(简体) ), 财务报告和审定财务报表 `publish-manifest.json` 下级 `.fluid/widget-dist` 默认.
-   `manifest.json` 使用 Canonical 远程 DOM 描述符。 内容 `workerEntryUrl` 和 CSS URL 是软件包本地化的工艺品路径; 目录 在主机使用描述符之前, 将它们确定为绝对的公开 URL . 公司和液滴包ID仍然完全合格(`company.*` 或者说 `droplet.*`) (中文(简体) ). 出版清单记录了文物清单和散列物.
-   发表a **公司拥有** fluid OS 使用的门户部件包 .
-   默认为 `--environment production` (产出/报告标签)和 `--out-dir .fluid/widget-dist`。 。 。 .
-   添加 `--dry-run` 来构建和打印上传的有效载荷,而不创建 上传会话 .
-   这只发布部件运行时的文物; 它确实 **没有** 部署 主机门户外壳 .

对于自有的滴滴市场部件包,请使用专用部件 CLI (单位:千美元)`@fluid-app/fluid-cli-widget`改为:

```bash
fluid widget create my-widget --droplet <uuid>
fluid widget link --droplet <uuid>
fluid widget publish
```

滴盘在部件 CLI 外管理, 在您之前必须已经存在 链接或发布 driplet 拥有的部件包.

## 手动命令

-   `fluid whoami` 显示活动配置
-   `fluid switch` - 在配置文件之间切换
-   `fluid logout` - 清空储存的证书
-   `fluid portal doctor` 诊断门户项目问题

## 常见问题

### @fluid-app/fluid-cli-portal 是什么？

用于构建门户应用程序的流体 CLI 插件

### 如何安装 @fluid-app/fluid-cli-portal？

在项目目录运行 npm install @fluid-app/fluid-cli-portal，或使用 pnpm add / yarn add / bun add。

### @fluid-app/fluid-cli-portal 支持 TypeScript 吗？

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

### @fluid-app/fluid-cli-portal 支持 ESM 还是 CommonJS？

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

### @fluid-app/fluid-cli-portal 需要什么版本的 Node\.js？

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

### @fluid-app/fluid-cli-portal 可以商用吗？

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

### @fluid-app/fluid-cli-portal 的下载量有多少？

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

### @fluid-app/fluid-cli-portal 还在维护吗？

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