Maofeng
30 lines
1.1 KiB
Plaintext
30 lines
1.1 KiB
Plaintext
---
|
|
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`。
|