Kazumi项目搜索模块重构的技术实践与思考

背景与需求分析

在Kazumi这个动漫信息应用项目中，搜索功能一直是用户体验的核心环节。随着用户需求的不断增长，原有的搜索模块逐渐暴露出一些局限性，特别是在多条件组合搜索方面。项目团队决定对搜索模块进行全面重构，以支持更灵活、更强大的搜索能力。

原有架构的问题

原搜索模块存在几个关键问题：

1. 搜索语法单一，仅支持简单的关键词匹配
2. 标签搜索与关键词搜索耦合度过高
3. 点击标签自动填充搜索框的交互方式不够优雅
4. 页面导航栈管理存在缺陷

技术方案设计

团队决定实现一套自定义搜索语法系统，支持类似tag:恋爱 夏日口袋这样的结构化查询。这种语法设计允许用户在特定分类下检索关键词，大大提升了搜索的精准度。

核心实现要点

1. 语法解析器：开发了一个轻量级的查询解析器，能够识别和处理key:value形式的搜索条件
2. 搜索条件组合：支持多个条件的AND逻辑组合
3. 向后兼容：确保原有简单关键词搜索仍能正常工作

路由管理的挑战与解决方案

在实现过程中，团队发现了一个棘手的架构问题：路由栈中可能出现多个infoPage和searchPage实例，这与原有的单例控制器设计产生了冲突。

问题分析

1. 单例控制器的局限性：当用户在标签页进入搜索，再从搜索结果进入详情页时，会产生页面嵌套
2. 状态共享问题：多个页面实例共享同一个控制器会导致状态管理混乱
3. 现有代码的隐式依赖：许多功能模块假设只有一个详情页控制器

分阶段解决方案

团队采取了渐进式的重构策略：

1. 第一阶段：将searchPage的控制器改为与页面绑定的非单例模式
2. 第二阶段：暂时限制路由栈中infoPage的数量，作为临时解决方案
3. 最终目标：计划将infoController拆分为infoController和infoPageController，彻底解决架构问题

技术决策的思考

这种重构体现了几个重要的软件工程原则：

1. 单一职责原则：通过拆分控制器，使每个模块职责更加清晰
2. 渐进式重构：在保证现有功能的前提下逐步改进架构
3. 用户体验优先：即使技术实现尚未完美，也要确保用户界面流畅

经验总结

这次重构给项目带来了几个重要启示：

1. 早期设计的前瞻性：核心架构应该为未来的扩展预留空间
2. 技术债务管理：及时识别和解决架构问题，避免积累
3. 平衡的艺术：在完美解决方案和实际开发成本之间找到平衡点

该重构已在Kazumi 1.6.6版本中完成，显著提升了应用的搜索能力和用户体验，同时也为未来的功能扩展奠定了更坚实的基础。