# @freecallai/ui 中文文档

规范地址：https://npmcn.com/package/%40freecallai/ui/

版本：0\.0\.11
npm 元数据更新时间：2026-11-13T10:29:25.701Z
中文译文更新时间：2026-11-15T16:47:43.205Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40freecallai/ui
原文对照：https://npmcn.com/package/%40freecallai/ui/?lang=original
项目主页：https://gitee.com/chengduzhihuige/fuker-ui
源码仓库：https://gitee.com/chengduzhihuige/fuker-ui

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

- 包体积（解压后）：30.4 MB，4378 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：8 个
- peer 依赖：vue ^3\.5\.13
- 首次发布：2026-10-15T12:49:32.402Z
- 最新版本发布：2026-11-13T10:29:25.369Z
- 近 30 天下载量：2226（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

福客AI基础组件库，基于 Arco Design Vue 二次开发

## 安装

```sh
npm install @freecallai/ui
```

也可以使用：`pnpm add @freecallai/ui`、`yarn add @freecallai/ui`、`bun add @freecallai/ui`

## README

# Fuker UI · 福客AI基础组件库

`@freecallai/ui` 是福客AI基于 Arco Design Vue 维护的基础组件库，采用 MIT 许可证，保留 ArcoDesign Team 原作者署名。公司版本与上游版本独立。

通过 npmjs.com 公开安装，无需认证或 SSH 隧道：

```bash
npm install @freecallai/ui@0.0.11
```

```ts
import { createApp } from 'vue';
import FukerUI from '@freecallai/ui';
import FukerIcons from '@freecallai/ui/es/icon';
import '@freecallai/ui/dist/arco.css';
import App from './App.vue';

createApp(App).use(FukerUI).use(FukerIcons).mount('#app');
```

```vue
<template>
  <fku-button type="primary">确定</fku-button>
</template>
```

命名导出保留 `Button`、`Input`、`IconPlus` 等名称；全局注册使用 `FkuXxx`，模板标签为 `fku-xxx`，CSS 类使用 `fku-`。产物文件名 `dist/arco.css` 保留，不影响类名前缀。

不直接使用 Arco 自动导入解析器。当前支持全量插件或显式局部导入。内置图标属于当前 UI 包，独立字体图标包 `@freecallai/icons` 位于同仓库的 `packages/web-vue-icons`，通过独立版本分发。

-   [公司源码与开发指南](https://gitee.com/chengduzhihuige/fuker-ui)
-   [上游源码](https://github.com/arco-design/arco-design-vue)
-   [上游 API 文档](https://arco.design/vue)（示例中旧包名和 a- 标签需迁移）

## 常见问题

### @freecallai/ui 是什么？

福客AI基础组件库，基于 Arco Design Vue 二次开发

### 如何安装 @freecallai/ui？

在项目目录运行 npm install @freecallai/ui，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vue（^3\.5\.13）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @freecallai/ui 支持 TypeScript 吗？

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

### @freecallai/ui 支持 ESM 还是 CommonJS？

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

### @freecallai/ui 可以商用吗？

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

### @freecallai/ui 的下载量有多少？

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

### @freecallai/ui 还在维护吗？

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