# @empathyco/x-components 中文文档

规范地址：https://npmcn.com/package/%40empathyco/x-components/

版本：10\.9\.0
npm 元数据更新时间：2026-11-13T09:45:24.028Z
中文译文更新时间：2026-11-13T15:44:03.476Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40empathyco/x-components
原文对照：https://npmcn.com/package/%40empathyco/x-components/?lang=original
项目主页：https://github.com/empathyco/x/tree/main/packages/x-components#readme
源码仓库：https://github.com/empathyco/x

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

- 包体积（解压后）：13.2 MB，5425 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：12 个
- peer 依赖：vue ^3\.5\.45，vuex 4\.0\.2
- 首次发布：2021-07-14T07:29:38.719Z
- 最新版本发布：2026-11-13T09:45:23.637Z
- 近 30 天下载量：32528（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：896（近 12 个月 150 个）

## 中文简介

冷漠X组件

## 安装

```sh
npm install @empathyco/x-components
```

也可以使用：`pnpm add @empathyco/x-components`、`yarn add @empathyco/x-components`、`bun add @empathyco/x-components`

## README

# X 组件

这是一个基于组件的图书馆, 它为您提供了将它们结合到不同的 创建自己的搜索体验的方法。 这些组件可以使用,即使你不想 创建搜索体验,可以用于构建常规应用程序,但利用 他们的灵活性.

## 建立发展环境

### 本地设置

要开始为这个项目做出贡献,你需要了解如何看到 X 组件上升和 运行中.

1.  运行 `pnpm i --frozen-lockfile` 项目根
2.  设定 `packages/x-components` 作为终端的工作目录
3.  运行 `pnpm run serve`

该应用程序将在本地主机发布. 顶端标签上可用的每个视图都设置在 `packages/x-components/src/router.ts`。 。 。 .

主标签为 `Home`,按下开始,您将看到内容 `packages/x-components/src/views/home/Home.vue` 与大多数 X 组件呈现在视图.

### 在您的工程中使用 X 组件

可以找到关于如何安装和使用 X 组件的文件 [这里](https://docs.empathy.co/develop-empathy-platform/build-search-ui/web-x-components-development-guide.html)。 。 。 .

## 捐款

要开始为项目捐款 请看看我们 [贡献准则](https://npmcn.com/package/%40empathyco/x-components/CONTRIBUTING.md) 用于接口 X 组件.

## 常见问题

### @empathyco/x-components 是什么？

冷漠X组件

### 如何安装 @empathyco/x-components？

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

### @empathyco/x-components 支持 TypeScript 吗？

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

### @empathyco/x-components 支持 ESM 还是 CommonJS？

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

### @empathyco/x-components 需要什么版本的 Node\.js？

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

### @empathyco/x-components 可以商用吗？

@empathyco/x-components 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @empathyco/x-components 的下载量有多少？

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

### @empathyco/x-components 还在维护吗？

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