# useSearchHistory.ts

**路径**：`src/composables/useSearchHistory.ts`

## 功能用途

搜索历史组合式函数，将关键词持久化到 localStorage（键 `polyclient_search_history`），最多保留 10 条，去重且新词置顶。

## 核心能力

- `list`：只读的搜索历史数组
- `add(keyword)`：添加关键词，去重并限制数量
- `remove(index)`：删除指定索引
- `clearAll`：清空全部

## 使用方式

```typescript
import { useSearchHistory } from '@/composables/useSearchHistory'

const searchHistory = useSearchHistory()

// 提交搜索时
searchHistory.add(searchKeyword)

// 展示历史
const searchHistoryList = searchHistory.list.value

// 清空
searchHistory.clearAll()
```

## 扩展方式

1. **分类历史**：扩展为 `useSearchHistory(category)`，按分类存储
2. **同步服务端**：在 `add` 时调用接口同步到后端
3. **最大条数**：修改 `MAX_HISTORY` 常量