qBittorrent自定义搜索插件安装失败：提示不被支持，求协助

1. 检查插件核心结构与命名合规性 #

• 确认插件文件命名为zetorrents.py，必须和插件类名、注册名称完全一致，qBittorrent对命名匹配要求严格
• 核对是否包含强制核心组件：
  • 继承对应版本nova插件类的主类，注意新版本qBittorrent用nova3.plugin.Plugin，旧版本用nova2.plugin.Plugin
  • 类内必须实现search方法，同时定义name、url类属性
  • 必须存在register_plugin调用，正确注册你的插件类

2. 验证Python语法与版本兼容性 #

• 直接用Python解释器运行插件文件：python3 zetorrents.py，检查是否存在SyntaxError或ImportError
• 确保插件使用的Python语法与qBittorrent内置Python版本匹配，避免使用3.7+才支持的新语法，比如海象运算符:=

3. 排查nova API版本匹配问题 #

• 对比官方示例插件的导入逻辑，确认你使用的nova模块版本与qBittorrent版本对应
• 检查search方法的参数、返回结果格式是否符合官方要求，比如返回的种子字典必须包含link、name、size等必填字段

4. 测试插件基础输出 #

• 在插件末尾添加测试代码，手动调用search方法验证输出：

  if __name__ == "__main__":
      plugin = Zetorrents()  # 替换为你的插件类名
      try:
          results = plugin.search("test", "all")
          print(results)
      except Exception as e:
          print(f"Error: {str(e)}")
  

  运行脚本后，若无输出或报错，重点排查search方法内是否有静默捕获的异常，或网页请求是否被反爬拦截

5. 检查网页解析逻辑有效性 #

• 手动访问zetorrents网站，搜索关键词后查看页面源码，确认插件中使用的XPath/CSS选择器仍能匹配到种子信息
• 核对是否需要添加请求头（如User-Agent）、处理Cookie，部分网站会通过反爬机制拦截无标识请求

6. 查看qBittorrent详细日志 #

• 开启qBittorrent详细日志：设置→日志→启用详细日志
• 尝试安装插件后，查看日志文件获取具体报错信息，比如模块导入失败、方法缺失等
• 日志路径参考：Windows为%APPDATA%\qBittorrent\logs，Linux为~/.local/share/data/qBittorrent/logs

内容的提问来源于stack exchange，提问作者Alexandre ELIOT