Mihon项目中的Bangumi漫画搜索功能优化解析

背景概述

Mihon作为一款开源的漫画阅读追踪应用，在集成Bangumi平台数据时遇到了搜索结果展示的优化问题。核心问题集中在两个方面：一是无法有效区分漫画与小说类作品，二是日期显示存在语义混淆。本文将深入分析问题成因及解决方案。

技术问题分析

1. 作品类型识别问题

Bangumi平台的书籍类目包含多种类型，其中漫画与小说经常出现同名作品。通过API获取的搜索结果中虽然包含作品类型信息，但前端界面未做有效展示。经查证，API返回的platform字段明确包含中文类型标识（如"小说"表示小说类，"漫画"表示漫画类），这为类型区分提供了技术基础。

2. 日期显示问题

当前界面将作品发布日期显示为"阅读过"，这存在两个技术误区：

• 日期数据实际对应作品的首次出版时间，而非用户阅读记录
• 中文翻译直接套用了图书馆过滤功能的字符串资源，导致语义错位

解决方案实现

类型过滤机制优化

开发团队采用platform字段作为过滤依据：

1. 当字段值为空时默认展示
2. 仅当字段值明确为"漫画"时才显示结果
3. 完全排除小说类条目（platform="小说"）

这种处理方式既保证了结果准确性，又避免了因API字段缺失导致的数据丢失。

多语言显示优化

针对日期显示问题，技术方案需要处理两个层面：

1. 数据层面：明确区分三种日期类型

   • 作品首次连载日期（可能不完整）
   • 单行本出版日期（当前使用的字段）
   • 用户阅读日期（需调用独立接口）

2. 展示层面：

   • 为搜索结果单独创建字符串资源
   • 与图书馆过滤功能解耦
   • 采用更中性的表述如"首发日期"

技术启示

1. API集成规范：第三方平台集成时需完整理解各字段语义，避免想当然的映射
2. 多语言支持：相同字符串在不同上下文可能需要差异化翻译
3. 用户体验：技术实现应服务于最终用户的信息获取效率

后续优化方向

1. 增加作品类型的可视化标识（如图标区分）
2. 考虑展示更多元数据（作者、出版社等）
3. 实现用户阅读记录的同步显示

该案例展示了开源项目如何通过社区反馈不断完善产品体验，也体现了技术方案需要兼顾数据准确性与界面友好性的平衡。