# @atoms-studio/nuxt-swiftsearch 中文文档

规范地址：https://npmcn.com/package/%40atoms-studio/nuxt-swiftsearch/

版本：1\.5\.0
npm 元数据更新时间：2026-11-03T22:05:08.608Z
中文译文更新时间：2026-11-07T03:44:18.193Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40atoms-studio/nuxt-swiftsearch
原文对照：https://npmcn.com/package/%40atoms-studio/nuxt-swiftsearch/?lang=original
项目主页：https://github.com/atoms-studio/nuxt-swiftsearch#readme
源码仓库：https://github.com/atoms-studio/nuxt-swiftsearch

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

- 包体积（解压后）：2.5 MB，196 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：9 个
- 首次发布：2024-02-15T17:01:35.446Z
- 最新版本发布：2026-11-03T22:05:08.274Z
- 近 30 天下载量：3899（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：75（近 12 个月 12 个）

## 中文简介

一名裁缝对nuxt 4进行了algolia即时搜索

## 安装

```sh
npm install @atoms-studio/nuxt-swiftsearch
```

也可以使用：`pnpm add @atoms-studio/nuxt-swiftsearch`、`yarn add @atoms-studio/nuxt-swiftsearch`、`bun add @atoms-studio/nuxt-swiftsearch`

## README

# Nuxt 斯威夫特搜索

[![npm version](https://img.shields.io/npm/v/@atoms-studio/nuxt-swiftsearch/latest.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://npmjs.com/package/@atoms-studio/nuxt-swiftsearch) [![npm downloads](https://img.shields.io/npm/dm/@atoms-studio/nuxt-swiftsearch.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://npmjs.com/package/@atoms-studio/nuxt-swiftsearch) [![License](https://img.shields.io/npm/l/@atoms-studio/nuxt-swiftsearch.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://npmjs.com/package/@atoms-studio/nuxt-swiftsearch) [![Nuxt](https://img.shields.io/badge/Nuxt-18181B?logo=nuxt.js)](https://nuxt.com/)

为Algolia InstantSearch定制的Nuxt 4模块,具有很强的Vue InstantSearch对等性.

-   [QQ 发布注释](https://npmcn.com/CHANGELOG.md)
-   [页:1](https://nuxt-swiftsearch.netlify.app/)

## 特征

-   QQ SSR 首先,客户端只按需,其他正反部分也是如此
-   中央集权状态,你可以从应用程序的任何地方挖掘出来
-   与 vue-instantry 部件 API 几乎完全对等
-   \* 已输入组件

## v1 发布

`@atoms-studio/nuxt-swiftsearch@1.x` 现在直播在 `latest` npm dist-tag. (英语).

-   安装稳定 :

```bash
bun add @atoms-studio/nuxt-swiftsearch
```

-   音轨预发:

```bash
bun add @atoms-studio/nuxt-swiftsearch@beta
```

## V1里装的是什么

-   具有决定性部件树主的 Nuxt 4- first SSR 架构
-   编译时间 : `:widgets`
-   带有明确范围部件ID `indexId` 隔离规则
-   Nuxt- 第一台路由器状态同步通过 `useAisRouter()`
-   对Vue InstantSearch固定装置的扩大对等/e2e的覆盖率

## Vue 即时搜索兼容性

搜索 v1 轨迹 `vue-instantsearch@4.24.3` 平价:

-   实施36/37个上游部件,其行为相同
-   `AisInstantSearchSsr` 由于安保部门改革被纳入 `AisInstantSearch`
-   `AisConfigureRelatedItems` 作为兼容性别名可供使用 `AisExperimentalConfigureRelatedItems`

见完整汇总表和审计详情 `docs/content/1.getting-started/6.widget-coverage-upstream-audit.md`。 。 。 .

## 快速设置

1.  添加 `@atoms-studio/nuxt-swiftsearch` 对您的项目的依赖性

```bash
bun add @atoms-studio/nuxt-swiftsearch
```

或使用 Nuxt 的模块命令 :

```bash
npx nuxi@latest module add swiftsearch
```

2.  添加 `@atoms-studio/nuxt-swiftsearch` 页:1 `modules` 节 `nuxt.config.ts`

```js
export default defineNuxtConfig({
  modules: ["@atoms-studio/nuxt-swiftsearch"],
});
```

就这样! 您现在可以在您的 Nuxt app 中使用 Nuxt Swiftsearch

## 发展

```bash
# Install dependencies
bun install

# Generate type stubs
bun run dev:prepare

# Develop with the playground
bun run dev

# Build the playground
bun run dev:build

# Run Oxlint and Oxfmt check
bun run lint
bun run format:check

# Run Vitest
bun run test
bun run test:watch

# Release new version
bun run release

# Start next premajor beta channel (ex: 2.0.0-beta.0)
bun run release:beta

# Publish next beta iteration (ex: 2.0.0-beta.1)
bun run release:beta:next
```

## GitHub 发布工作流程

此回波还包括一个手动 GitHub 动作工作流程 `.github/workflows/release.yml`。 。 。 .

-   选择一个 `stable-*` 选项 `latest`。 。 。 .
-   选择 `beta-start-v1` 开始下一行 `beta` dis.
-   选择 `beta-next` 在 `beta`。 。 。 .

## 常见问题

### @atoms-studio/nuxt-swiftsearch 是什么？

一名裁缝对nuxt 4进行了algolia即时搜索

### 如何安装 @atoms-studio/nuxt-swiftsearch？

在项目目录运行 npm install @atoms-studio/nuxt-swiftsearch，或使用 pnpm add / yarn add / bun add。

### @atoms-studio/nuxt-swiftsearch 支持 TypeScript 吗？

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

### @atoms-studio/nuxt-swiftsearch 支持 ESM 还是 CommonJS？

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

### @atoms-studio/nuxt-swiftsearch 可以商用吗？

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

### @atoms-studio/nuxt-swiftsearch 的下载量有多少？

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

### @atoms-studio/nuxt-swiftsearch 还在维护吗？

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