@freightos/freightwind

中文文档
2.4.0发布于 2026/11/09MITTypeScriptESM + CJS近 30 天下载 2775

FlordWind设计系统——Flordos应用程序的图标、常数和公用事业

中文使用文档
文档目录6 节
  1. 安装
  2. 使用量
  3. 主机隔离( WebCargo)
  4. MCP Apps (英语: @freightos/freightwind/mcp-app (中文(简体) )
  5. 同伴依赖关系
  6. 许可证

@freightos/freightwind (英语)

FredWind Design System — React UI组件用于Fredos应用.

安装

npm install @freightos/freightwind @freightos/freightwind/icons

使用量

import { Button, Alert, Badge } from '@freightos/freightwind';
import '@freightos/freightwind/tokens.css';

组件需要用 FDS 设计符号装入 Tailwind CSS v4 tokens.css。 。 。 .

主机隔离( WebCargo)

在 WebCargo 主机内安装货运窗口时, 也会导入 WebCargo 将您的 App 包装到 .fw-root 元素 :

import '@freightos/freightwind/tokens.css';
import '@freightos/freightwind/host-isolation/webcargo.css';

<div className="fw-root">
  <App />
</div>

图纸端口 Tailwind的标准飞行前范围 .fw-root 通过 :where() (0个添加的特异性),加上有焦点的取消键 编辑 .fw-base 每个元素标记,所以它覆盖了所提供的FW组件 在 Radix 门户内部(Dialog / Popover / Tooltip / Dropdown Menu / 选择). 它的存在完全是为了中和WebCargo的"靴子"式主机CSS 目标赤元素选择器( e)h1-h6 { margin-bottom: .5rem }, (中文(简体) ), button { border-radius: 0 }, (中文(简体) ), button:focus { outline: 5px auto … },(.)—— 它不强制FW特定型号, 所以它从来不从FW设计中漂移 标志.

在干净的主机中消耗货运窗口时跳过此文件( Vite player, greenfield Next.js apps,合作伙伴站点没有"靴子")——没有主机 CSS在那里战斗.

MCP Apps (英语:@freightos/freightwind/mcp-app(中文(简体) )

将货运窗口表面作为AI聊天内的互动卡(Claude, ChatGPT)通过MCP Apps标准. useMcpApp 连接到主机、 镜像 会议主题.dark)和语言(dir编号 :lang把工具结果交给你, 并停止旧卡发送 一旦更新它.

import { useMcpApp } from '@freightos/freightwind/mcp-app';

function Card() {
  const { data, isSuperseded, updateModelContext, sendMessage } = useMcpApp<MyData>({
    appInfo: { name: 'my-card', version: '1.0.0' },
    supersessionChannel: 'my-app:show_thing',
    instanceKeyOf: (d) => ({ issuedAt: d.issuedAt, seq: d.seq }),
  });
  // updateModelContext(text) informs the model quietly; sendMessage(text) posts to the chat.
}

安装可选的同位素以使用 : @modelcontextprotocol/ext-apps (>= 1.7.5 < 2) 财务报告和审定财务报表 @modelcontextprotocol/sdk (^ 1.29) (中文(简体) ). 副路径是仅限无害环境管理,例如: ext-apps本身。 超级会话使用 a BroadcastChannel,所以一个新的卡在 又一次公开聊天也标志着年长者已经过时。 全向导:货运窗口 文件 – AI – MCP Apps.

同伴依赖关系

  • react 第18条
  • react-dom 第18条
  • @freightos/freightwind/icons >= 1.0.0
  • @modelcontextprotocol/ext-apps >= 1.7.5 < 2和 @modelcontextprotocol/sdk ^1.29(可选,用于 /mcp-app 仅限)

许可证

麻省理工学院

版本与发布记录

@freightos/freightwind 共发布 26 个版本,首次发布于 2026/01/15;过去 12 个月发布了 26 个版本。

版本发布日期距今
2.4.0latest2026/11/096 天前
2.3.22026/11/0312 天前
2.3.12026/10/2917 天前
2.3.02026/09/281 个月前
2.2.52026/08/162 个月前
2.2.42026/07/124 个月前

其他发布通道:host-isolation → 2.1.3-host-isolation.3。

关于 @freightos/freightwind 的常见问题

@freightos/freightwind 是什么?

FlordWind设计系统——Flordos应用程序的图标、常数和公用事业

如何安装 @freightos/freightwind?

在项目目录运行 npm install @freightos/freightwind,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=18)、react-dom(>=18)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@freightos/freightwind 支持 TypeScript 吗?

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

@freightos/freightwind 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@freightos/freightwind 可以商用吗?

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

@freightos/freightwind 的下载量有多少?

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

@freightos/freightwind 还在维护吗?

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