Nicotine+ 客户端搜索功能优化：实现"重新搜索"特性

背景与需求分析

在文件共享客户端Nicotine+的使用过程中，用户经常需要重复执行相同的搜索操作。当前版本中，用户只能通过历史记录重新选择关键词进行搜索，这种方式会导致界面中出现多个相同关键词的搜索标签页，不仅造成界面混乱，也增加了系统资源消耗。

技术实现挑战

实现"重新搜索"功能看似简单，实则涉及几个关键技术难点：

1. 搜索令牌机制：Nicotine+使用令牌(token)来标识每个搜索请求，直接刷新会导致节点不响应重复的令牌
2. 标签页管理：需要在不创建新标签页的情况下更新现有搜索内容
3. 状态同步：确保UI与后端搜索状态的正确同步

解决方案设计

核心思路

通过修改搜索模块，实现以下功能流程：

1. 保留原始搜索令牌
2. 重用现有搜索标签页
3. 重新发送搜索请求至服务器

具体实现方案

1. 后端修改(pynicotine/search.py)：

   • 新增resend_search_request方法，接收令牌参数
   • 从self.searches字典中检索历史搜索
   • 重用原始令牌重新发送搜索请求

2. 前端修改(gtkgui/search.py)：

   • 在右键菜单中添加"重新搜索"选项
   • 绑定到新的重搜方法而非创建新搜索

3. 错误处理增强：

   • 添加断网状态下的错误提示
   • 提供重试按钮功能

技术细节

令牌重用机制

def resend_search_request(self, token):
    """重新发送指定令牌的搜索请求"""
    if token in self.searches:
        search_data = self.searches[token]
        self.send_search_request(
            search_data["text"],
            token=token,
            wishlist=search_data["wishlist"]
        )

前端交互优化

右键菜单新增项目应直接调用重搜方法，而非创建新搜索标签。这需要确保：

• 正确传递当前搜索标签的令牌
• 保持UI响应性
• 处理可能的网络延迟

未来扩展

此功能为后续计划中的"搜索过滤器"重构奠定了基础，包括：

• 愿望清单搜索的保存与重用
• 自定义搜索过滤器的持久化
• 复杂搜索条件的快速重应用

用户价值

实现后，用户将获得：

1. 更简洁的界面体验
2. 更高的搜索效率
3. 降低系统资源占用
4. 更直观的错误恢复机制

这一改进虽然看似简单，但显著提升了Nicotine+的核心搜索功能的用户体验，体现了对用户日常操作痛点的深入理解和技术实现的精巧平衡。