xtraderClient/docs/composables/useSearchHistory.md

useSearchHistory.ts

路径：src/composables/useSearchHistory.ts

功能用途

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

核心能力

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

使用方式

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 常量