EventCatalog版本管理优化：解决搜索中多版本显示问题

EventCatalog作为一款事件驱动架构文档工具，在版本管理方面存在一个影响用户体验的问题：当用户搜索服务、命令、查询或事件时，搜索结果会显示所有版本而非仅显示最新版本。这不仅导致搜索结果冗长，还增加了用户查找最新文档的难度。

问题本质分析

EventCatalog当前版本管理机制存在两个核心问题：

1. 搜索结果显示冗余：全局搜索和探索页面的自动补全功能会列出所有历史版本，而非智能展示最新版本
2. 版本计数不一致：首页显示的计数与发现页面显示的计数标准不统一，前者统计唯一消息数量，后者则包含所有版本

技术实现原理

EventCatalog底层使用PageFind实现搜索功能。PageFind提供了从索引中排除特定页面的能力，这为解决版本冗余显示问题提供了技术基础。通过合理配置，可以仅索引最新版本文档，而将历史版本从搜索索引中排除。

优化方案建议

基于社区讨论和技术分析，推荐采用以下优化策略：

1. 搜索结果优化：

   • 默认只显示最新版本
   • 通过文档页面内的版本侧边栏访问历史版本
   • 按版本号降序排列结果（最新优先）

2. 界面显示优化：

   • 表格视图默认仅展示最新版本
   • 文档/可视化侧边栏仅显示最新版本
   • 统一各页面计数标准，采用唯一消息计数

3. 技术实现路径：

   • 利用PageFind的索引排除功能过滤历史版本
   • 实现版本排序算法确保最新版本优先
   • 重构计数逻辑保持一致性

用户体验提升

优化后的系统将显著改善用户体验：

• 搜索结果更加简洁，直接命中用户最可能需要的最新文档
• 保持历史版本可访问性，通过文档内导航访问旧版本
• 界面计数统一，避免用户混淆
• 降低认知负荷，提高文档查找效率

这一改进将特别有利于大型项目，随着版本数量增加，搜索效率提升效果将更加明显。EventCatalog作为架构文档工具，通过这样的优化能更好地服务于事件驱动系统的文档管理需求。