---
title: 概览
description: 了解 Search 包的数据边界、交互能力和适用场景。
order: 1
toc:
  - id: package-role
    title: 包的职责
  - id: capabilities
    title: 主要能力
  - id: design-boundary
    title: 设计边界
---

## 包的职责 {#package-role}

`@workspace/search` 提供应用级搜索界面与状态管理。宿主应用通过 `SearchAdapter` 提供数据，Search 负责查询生命周期、分页、结果展示、选择交互和搜索历史。

## 主要能力 {#capabilities}

- 使用 Adapter 连接任意 HTTP API、数据库、命令注册表或本地索引。
- 按业务来源分组展示结果，并合并分页数据。
- 使用 `AbortSignal` 取消已经过期的查询。
- 提供最近搜索记录和可配置的本地持久化。
- 内置 `Mod+K` 快捷键、无结果、加载与错误状态。
- 提供 `en-US` 和 `zh-Hans` 消息目录。

## 设计边界 {#design-boundary}

Search 不决定数据从哪里获取，也不负责路由跳转。应用实现 Adapter，并在 `onSelect` 中解释结果的 `payload`。