@fluid-app/fluid-cli-mist

中文文档
0.1.743发布于 2026/11/15TypeScriptES Module近 30 天下载 13.8万

用于管理雾宿主扩展的流体 CLI 插件

中文使用文档
文档目录7 节
  1. 图标
  2. 推动核定承诺
  3. 生成一个秘密
  4. 通过Egress代理到达Exigo
  5. 修复所附的滴盘
  6. 重新列出所附的滴盘( 不可逆)
  7. 发展

@fluid-app/fluid-cli-miist (英语)

Mist 主机扩展名的流体 CLI 插件 。 这个 fluid CLI发现它通过 fluid-cli-* 命名公约并添加 fluid mist 命令。 完整命令表面在 features/mist/cli-spec.md。 。 。 .

每个命令都使用可选的雾弹. 没有它,它读到 .mist 当前目录中的文件,哪个 fluid mist clone 写作.

图标

命令目的
list, (中文(简体) ), show, (中文(简体) ), create, (中文(简体) ), update, (中文(简体) ), delete, (中文(简体) ), restore管理雾
clone, (中文(简体) ), push, (中文(简体) ), pull, (中文(简体) ), open使用密码和已部署的应用程序
attach, (中文(简体) ), attach-droplet将表面( 如 Droplet) 线接入雾中
deployments, (中文(简体) ), logs参见构建和运行时间输出
env list|set|unset|pull管理生产环境 vars
droplet repair|reinstall|egress-proxy修复、重新安装或为附着的 Droplet 请求进取

推动核定承诺

fluid mist push --expect-commit <full-sha> [--watch]

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}就是推动承诺 refs/heads/<branch>。它拒绝在任何网络呼叫之前使用出站码5,除非sha是一个完整的40个特征的六分位码(64对sha256重置;在sha1重置中的一个64个重置值被拒绝) head_mismatch),等于 HEAD,该分支是一个普通名称(否) refs/ 前缀或 :),而工作树没有变化,没有跟踪文件或肮脏的子模块. 它从不自动承诺,拉出,或藏出, 它不能结合 -m。 。 。 . --watch 和sha的部署吻合.

生成一个秘密

fluid mist env set WEBHOOK_AUTH_TOKEN --generate             # 32 bytes
fluid mist env set my-mist SESSION_SECRET --generate --bytes 64

--generate 薄荷是密码学上坚固的碱基64url密语(16到128字节,默认为32),将密语写到密钥上,再打印一次. 流体存储嵌入值加密和 env list 永远不要让他们看到,所以复制 秘密立即,如果你还需要它 .env.local它使用与"雾"相同的生成器 set_mist_env_var 工具。 它在生成任何东西之前拒绝使用雾管理键. 调动 fluid mist push 以便改变生效.

通过Egress代理到达Exigo

fluid mist create --droplet --egress-proxy    # new mist + droplet, asking for egress
fluid mist attach-droplet --egress-proxy      # attach (or reuse) a droplet, asking for egress
fluid mist droplet egress-proxy on            # ask for egress for the attached Droplet
fluid mist droplet egress-proxy off           # withdraw the request (and any grant)

Fluid的"Egress"代理让一个Droplet的装置到达了外部系统,例如从Fluid的固定外出IP中达到Exigo. 这些命令设置 Droplet 的 egress_proxy_requested,而代理则在未经进一步认可的情况下承认了"滴滴",无论代理尊重了Fluid的回答. 撤回申请还清理了记录的流利管理者(egress_proxy_enabled) (中文(简体) ).

--egress-proxy 工作内容 create --droplet, (中文(简体) ), create --kind droplet, (中文(简体) ), create --hostable, (中文(简体) ), attach --kind droplet 财务报告和审定财务报表 attach-droplet。在一个已经存在的 Droplet 上,它更新了请求,而不是忽略了旗帜。 Fluid只接受公司管理员提出的Egress请求,为自己的公司服务。 否则,它拒绝这一要求: --egress-proxy 然后,在无水的地方安置水,并加以警告 droplet egress-proxy 没有写 Fluid 的理由失败 。 一种早于田地的流体会忽略了它们,而命令会发出警告或者以同样的方式失败. droplet egress-proxy off 此外,还批准了未申请的流体管理员的补助金。 雾桌面的安全模式处理 droplet egress-proxy 作为写作.

修复所附的滴盘

fluid mist droplet repair --dry-run   # show the planned change
fluid mist droplet repair             # prompt, then apply
fluid mist droplet repair --yes       # apply without a prompt

此设定 Droplet 的 embed_url, (中文(简体) ), install_webhook_url 财务报告和审定财务报表 uninstall_webhook_url 从雾中 public_url 正如流体报告的那样。 当地 .mist 文件的 URL 副本从未使用。 网路来自 dropletLifecycle 内 fluid.capabilities.json 当你在项目里运行的时候 否则就用它 /api/webhooks/installed 财务报告和审定财务报表 /api/webhooks/uninstalled。只有这三个字段会改变,命令会重新读取 Dropplet 来验证它们。 没有终端可以启动,它需要 --yes。 。 。 .

修理可以修复未来的生命周期交付。 它不会重播 droplet.installed 用于现有安装 reinstall。 。 。 .

重新列出所附的滴盘( 不可逆)

fluid mist droplet reinstall --dry-run    # 1. show the exact plan
fluid mist droplet reinstall --confirm    # 2. execute it

reinstall 修复生命周期 URL , 并要求 Fluid 在一次持久操作中替换雾层自己的 Droplet 安装。 在那次行动中,Fluid撤销了安装,交付了未安装,被终结并创建了替换. CLI从不删除并重新创建安装本身. 规则与雾相匹配 repair_and_reinstall_droplet 工具:

  • 先计划. --dry-run 改变什么。 它会打印出"雾","滴",安装和替换的终点.

  • 明确批准. --confirm 仅在一个 --dry-run 在过去15分钟里运行了相同的 Droplet,安装和生命周期 URL. --yes 永远不要批准重新安装. --confirm 不管计划是否继续 都用上计划 --confirm 运行不能共享一个计划,所以重试需要一个新的 --dry-run。 。 。 .

  • 只拥有滴滴. Droplet总是附着在雾中,而Fluid拒绝任何其他Droplet的装置.

  • 复有观想. 默认情况下, CLI 监视 120 秒 (--watch-timeout <seconds>) (中文(简体) ). 较慢的替换返回 "status": "still_running" 与继续观看它的命令:

    fluid mist droplet reinstall --resume <operationId> --installation <installationUuid>
    

    简历没有开始,不需要新的计划,但需要 --installation 却不接受 --dry-run。只有在 status 实值 "succeeded"。 。 。 .

  • 复苏. 一次失败的尝试可能已经终结了源安装,因此它不再出现在列表中. 在这种情况下,计划和确认 --installation <uuid>,使用早期计划中的uuid. 命名的装置总是优先于活动装置.

reinstall 总是印出JSON。 拒绝打印 {"status": "refused", "code": …} 和出站 1. 一个失败的替换出站 1, API出站错误使用 CLI 的常用代码: 2 a 4xx, 3 a 5xx, 4 a 网络出站错误. 计划收据只持有ID,计划URL和一个时间戳. 它们被储存在 ~/.fluid/mist/reinstall-plans/。 。 。 .

发展

pnpm nx run-many -t test,typecheck,lint,build -p @fluid-app/fluid-cli-mist

共享的雾逻辑(生命周期 URL, Dropplet 修复规划, 替换规则, 投票, 秘密生成) 生活于私人 @fluid-app/mist-core 软件包。 构建将其捆绑到此插件中 .

版本与发布记录

@fluid-app/fluid-cli-mist 共发布 744 个版本,首次发布于 2026/07/03;过去 12 个月发布了 744 个版本。

版本发布日期距今
0.1.743latest2026/11/15今天
0.1.7422026/11/15今天
0.1.7412026/11/15今天
0.1.7402026/11/141 天前
0.1.7392026/11/141 天前
0.1.7382026/11/141 天前

关于 @fluid-app/fluid-cli-mist 的常见问题

@fluid-app/fluid-cli-mist 是什么?

用于管理雾宿主扩展的流体 CLI 插件

如何安装 @fluid-app/fluid-cli-mist?

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

@fluid-app/fluid-cli-mist 支持 TypeScript 吗?

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

@fluid-app/fluid-cli-mist 支持 ESM 还是 CommonJS?

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

@fluid-app/fluid-cli-mist 需要什么版本的 Node.js?

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

@fluid-app/fluid-cli-mist 可以商用吗?

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

@fluid-app/fluid-cli-mist 的下载量有多少?

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

@fluid-app/fluid-cli-mist 还在维护吗?

最新版本 0.1.743 发布于 2026/11/15(今天);至今共发布 744 个版本,其中过去 12 个月发布了 744 个;首次发布于 2026/07/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。