PT 助手 Plus 搜索功能揭秘：Searcher 类实现多站点种子检索

2026-02-05 04:23:26作者：尤峻淳Whitney

你是否曾为寻找优质种子而在多个PT站点间反复切换？PT 助手 Plus（PT-Plugin-Plus）的多站点搜索功能彻底解决了这一痛点。本文将深入解析核心搜索模块的实现原理，带你了解如何通过Searcher类实现跨站点的种子检索与聚合。

搜索功能核心架构

PT 助手 Plus 的搜索系统采用模块化设计，主要由Searcher类（src/background/searcher.ts）和SiteService类（src/background/site.ts）构成。前者负责搜索任务的调度与结果处理，后者管理站点配置与 schema 解析，两者协同实现多站点并行检索。

核心工作流程如下：

用户输入搜索关键词并选择目标站点
Searcher初始化搜索任务队列
SiteService提供站点配置与解析规则
并行发送搜索请求至各站点
解析返回结果并标准化数据格式
聚合展示搜索结果

Searcher 类核心实现

类结构与关键属性

Searcher类通过 TypeScript 实现，定义于src/background/searcher.ts文件中，核心属性包括：

export class Searcher {
  // 搜索入口定义缓存
  private searchConfigs: any = {};
  // 解析文件内容缓存
  private parseScriptCache: any = {};
  public options: Options = { sites: [], clients: [] };
  private searchRequestQueue: Dictionary<JQueryXHR> = {};
  
  // 构造函数与核心方法...
}

其中searchRequestQueue用于管理并发请求，避免重复请求同一资源；parseScriptCache缓存站点解析脚本，提升重复搜索效率。

搜索方法实现

searchTorrent方法是搜索功能的入口点，负责构建搜索请求并处理结果：

public searchTorrent(
  site: Site,
  key: string = "",
  payload?: ISearchPayload
): Promise<any> {
  // 1. 初始化搜索配置
  // 2. 处理搜索关键词（如提取IMDb编号）
  // 3. 构建搜索URL与请求参数
  // 4. 遍历搜索入口并发送请求
  // 5. 聚合处理搜索结果
}

关键处理逻辑包括：

关键词预处理（支持IMDb编号自动识别）
站点搜索规则匹配
URL构建与参数替换
请求队列管理与并发控制

多站点并行搜索

Searcher通过searchRequestQueue管理多个站点的并行搜索请求：

this.searchRequestQueue[url] = $.ajax({
  url: url,
  cache: true,
  dataType: "text",
  contentType,
  timeout: this.options.connectClientTimeout || 30000,
  headers: entry.headers,
  method: entry.requestMethod || ERequestMethod.GET,
  data
})
.done((result: any) => {
  // 处理搜索结果
})
.fail((jqXHR, textStatus, errorThrown) => {
  // 错误处理
});

这种设计既保证了搜索效率，又能通过abortSearch方法随时取消请求：

public abortSearch(site: Site, key: string = ""): Promise<any> {
  // 遍历请求队列并取消指定站点的搜索请求
}

站点配置与解析规则

SiteService 类的作用

SiteService类负责管理站点配置与 schema 解析，为搜索功能提供站点特定规则：

export class SiteService {
  public isLogin: boolean = false;
  private _schema: SiteSchema = {};
  
  constructor(public options: Site, public systemOptions: Options) {
    this.mergeOptions();
  }
  
  // 合并站点默认配置与用户自定义配置
}

通过schema属性，SiteService能够为不同站点提供特定的解析规则，包括搜索URL格式、请求参数、结果解析脚本等。

搜索结果解析流程

搜索结果解析是实现多站点兼容的关键环节。Searcher类通过以下步骤标准化不同站点的搜索结果：

根据站点类型选择解析器（HTML或JSON）
加载站点特定的解析脚本
执行解析逻辑提取种子信息
标准化数据格式

解析脚本通常位于站点配置目录，通过缓存机制提高重复搜索效率：

// 解析脚本缓存逻辑
if (!entry.parseScript) {
  APP.getScriptContent(scriptPath)
    .done((script: string) => {
      this.parseScriptCache[scriptPath] = script;
      entry.parseScript = script;
      // 执行搜索请求...
    });
}

实战案例：完整搜索流程

以下是一个完整的搜索请求生命周期：

用户输入：用户在插件界面输入"星际穿越"并选择3个目标站点
参数处理：searchTorrent方法对关键词进行编码处理
URL构建：根据站点配置生成搜索URL，如https://example.com/search?q=星际穿越
请求发送：通过addSearchRequestQueue方法并行发送请求
结果解析：执行站点特定解析脚本提取种子信息
数据聚合：标准化不同站点的结果格式并去重
结果展示：返回统一格式的搜索结果到前端界面

错误处理与优化策略

完善的错误处理机制

Searcher类定义了多种错误状态（src/background/searcher.ts#L38-L44），确保在各种异常情况下给予用户明确反馈：

export enum ESearchResultParseStatus {
  success = "success",
  needLogin = "needLogin",
  noTorrents = "noTorrents",
  torrentTableIsEmpty = "torrentTableIsEmpty",
  parseError = "parseError"
}

针对不同错误类型，系统会执行相应的恢复策略，如自动登录、重试请求或切换备用解析规则。