本地模糊检索

问题背景

当你需要在前端快速检索本地的客户或联系人列表时，后端搜索接口并非总是可用。用户输入时也常伴有拼写错误、拼音片段或只记得部分字段。此时，一个轻量、离线可用的本地模糊匹配方案可以避免等待网络请求，并直接在内存中完成容错检索。

实现方式

该技能基于 Fuse.js 构建纯前端检索逻辑。Agent 会先将数据源字段映射为检索键，并按照默认权重排序：公司名与姓名最高，手机号与联系方式次之，备注最低。随后生成一个 localFuzzySearch 函数，支持自定义阈值，建议在 0.3 到 0.45 之间，以平衡噪声与漏召回。

在 UI 交互中，建议加入 200 到 300 毫秒的防抖，避免频繁计算。当关键词为空时，函数会返回空列表或前 N 条数据，而不是抛出异常，确保界面稳定。最终交付物是可直接放入 templates/ 目录的可运行 JS/TS 代码片段。

适用边界

该方案仅适用于内存中的数据检索，不能替代服务端全文搜索。对于超过 5000 条的列表，建议先分片或建立索引，否则性能会受影响。依赖库 fuse.js 的体积与许可需由项目自行评估引入。