# @freecallai/pro 中文文档

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

版本：0\.0\.28
npm 元数据更新时间：2026-11-13T17:19:06.895Z
中文译文更新时间：2026-11-15T13:09:49.782Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.3 MB，223 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：6 个
- peer 依赖：vue ^3\.5\.13，@freecallai/ui ^0\.0\.11
- 首次发布：2026-10-15T12:49:49.774Z
- 最新版本发布：2026-11-13T17:19:06.284Z
- 近 30 天下载量：4719（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：29（近 12 个月 29 个）

## 中文简介

福客AI业务组件库

## 安装

```sh
npm install @freecallai/pro
```

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

## README

# Fuker UI 业务组件

`packages/web-vue-pro` 是与 `packages/web-vue` 平级的独立 workspace 包，包名为 `@freecallai/pro`。业务组件直接按名称放在 `components/` 下，各自维护源码、类型、样式、`TEMPLATE.md`、演示和测试。基础包 `@freecallai/ui` 不依赖此包。

使用 pnpm 9.5.0 开发：

```bash
pnpm --filter @freecallai/pro docgen
pnpm --filter @freecallai/pro build
pnpm --filter @freecallai/pro test
```

第一个组件 `FkpRichText` 同时提供整包注册和 `@freecallai/pro/rich-text` 按需入口。组件使用 Tiptap 和独立的 `@freecallai/icons`；宿主需先加载 `@freecallai/ui/dist/arco.css`，再加载 `@freecallai/pro/style.css`。上传、鉴权、保存和 AI 操作仍由宿主注入或响应事件。当前源码版本为 0.0.28，要求 UI ^0.0.11、Vue ^3.5.13，Icons 使用 0.0.6，发布状态见[发布指南](https://npmcn.com/package/docs/fuker/RELEASE.md)。

SVG 图标由独立的 [`@freecallai/icons`](https://npmcn.com/package/%40freecallai/web-vue-icons/README.md) 包维护。富文本组件直接引用该包，图标布局样式包含在 `@freecallai/pro/style.css` 中。业务包目前不另设 Icon 导出或注册入口；其他场景可直接使用 `@freecallai/icons`。

文档站从[快速上手](https://npmcn.com/ui/pro/start)进入；[组件开发](https://npmcn.com/ui/pro/development)放在“开发指南”，演示和公开 API 放在[知识富文本组件页](https://npmcn.com/ui/pro/rich-text)。知识富文本的转换协议、扩展说明及历史设计记录从[知识富文本文档索引](https://npmcn.com/package/%40freecallai/pro/components/rich-text/docs/README.md)进入。

## 组件与场景

组件和转换器可从以下公开子路径按需导入（路径均以 `@freecallai/pro` 开头）：

| 子路径 | 主要导出 |
| --- | --- |
| `/filters` | `FkpFilter`、`FkpSearchableMultiSelect`、`FkpFilterPeriod`、`FkpFilterDateRange` |
| `/switcher` | `FkpSwitcher` |
| `/edition-info` | `FkpEditionInfo` |
| `/navigation` | `FkpNavigation` |
| `/knowledge-type-picker` | `FkpKnowledgeTypePicker` |
| `/rich-text` | `FkpRichText`、场景类型及工具函数 |
| `/rich-text/legacy-converter` | 知识场景旧数据转换函数 |
| `/agent-prompt-editor` | `FkpAgentPromptEditor`、提示词类型及工具函数 |
| `/agent-prompt-editor/legacy-converter` | Agent 提示词旧数据转换函数 |

```ts
import { FkpSwitcher } from '@freecallai/pro/switcher';
import { FkpAgentPromptEditor } from '@freecallai/pro/agent-prompt-editor';
import '@freecallai/ui/dist/arco.css';
import '@freecallai/pro/style.css';
```

样式目前是整个 Pro 包共用的 CSS，按需子路径只拆分 JavaScript 和类型入口。根入口的默认插件会注册其中一组组件；Agent 提示词编辑器通过自己的子路径导入。

Header、Sidebar、PageLayout 仅为使用业务组件和 UI 组合的文档场景，不导出独立组件或 `/layout` 入口。Navigation 的排序复用 `@freecallai/ui` 的 SortableList；宿主负责账号保存和页面跳转。未发布的旧 ProjectSwitcher / FilterSearch / FilterSelect 名称不保留兼容入口。

## 常见问题

### @freecallai/pro 是什么？

福客AI业务组件库

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

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

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

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

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

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

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

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

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

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

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

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