Yomitan与Anki Connect性能优化：解决词典查询延迟问题

问题背景

在日语学习工具Yomitan与Anki Connect的集成使用过程中，用户报告了显著的性能延迟现象。当启用"检查卡片重复项"功能时，查询"なければならない"这类复杂词汇的总耗时达到8秒，其中与Anki Connect的通信就占用了约5秒。这严重影响了用户体验，特别是在高频查询场景下。

技术分析

通过详细的性能剖析，我们发现延迟主要来自以下几个关键环节：

1. Anki Connect请求结构问题

   • 系统会发起4次API调用：版本检查、两次canAddNotes调用（分别允许和不允许重复项）、以及一个multi组合查询
   • canAddNotes请求携带了过多冗余数据，包括完整的词典定义内容（ExtraDefinitions等字段）

2. Anki Connect内部处理瓶颈

   • createNote方法的算法复杂度达到O(n²)，其中n是请求包含的字段数量
   • 实际重复检查仅需要第一个字段的值，但当前实现会处理所有传入字段

3. 网络传输开销

   • 大尺寸的请求体（特别是包含完整词典数据的请求）导致显著的序列化/反序列化开销
   • Windows平台下可能存在localhost解析延迟问题

优化方案

基于上述分析，我们提出以下优化措施：

1. 精简请求负载

   • 修改canAddNotes调用，仅保留必要的字段（如key字段）
   • 移除ExtraDefinitions等非必要词典数据
   • 实现请求体压缩传输

2. 优化Anki Connect处理逻辑

   • 改进createNote方法，提前终止非必要字段处理
   • 实现字段级缓存机制，避免重复计算

3. 客户端优化

   • 实现请求批处理机制，减少网络往返次数
   • 添加本地结果缓存，减少重复查询

实施效果

经过上述优化后，预期可获得以下改进：

• 总查询时间从8秒降至3秒以内
• Anki Connect通信时间从5秒降至500毫秒以内
• 系统资源消耗降低30%以上

技术启示

这一案例展示了几个重要的技术原则：

1. 网络通信中，请求体的精简往往比想象中更重要
2. 即使是简单的API调用，不当的实现也可能导致显著的性能问题
3. 端到端的性能分析是解决复杂系统问题的关键

对于开发者而言，这一优化过程也提醒我们：在开发类似集成系统时，应该从一开始就考虑性能因素，特别是在处理可能包含大量数据的教育类应用场景中。