Files
Auto_Bangumi/docs/dev/plugins/points/search-site.md
Estrella Pan 3258fcca4b docs(4.0-P7): 插件开发文档拆分为总览加每个扩展点一页,补齐中英日三语
- docs/dev/plugins.md 改为总览与导航,旧内容拆入 docs/dev/plugins/
- 新增核心概念、配置表单、事件、前端挂载点、命令行、签名与分发、内置插件、示例页
- 每个扩展点一页,侧边栏由页面表生成
- 改正旧文档中下载器配置、hardlink path_map 与补链按钮的过时描述
2026-10-08 14:51:00 +02:00

970 B
Raw Permalink Blame History

搜索站点(search_site)

给搜索框增加一个站点。@provider(points.SEARCH_SITE, id=...) 返回 SearchSite,id 即站点名。

from ab_sdk.search import SearchSite

@provider(points.SEARCH_SITE, id="my-site")
def site(self):
    return SearchSite(url="https://example.com/rss?q=%s", parser="tmdb")
  • url 必须恰好含一个 %s,AB 把它替换为关键词(多个词用 + 连接)。
  • parser 指定用哪个元数据源补全搜索结果:mikan 或 tmdb。
  • 用户在搜索设置里配置的同名站点优先于插件提供的站点。
  • 站点需要登录时,配合 http.request 钩子 附加 Cookie。

测试

from ab_sdk.testing import SearchSiteContract, create_plugin

class TestSite(SearchSiteContract):
    def create(self):
        plugin, _ = create_plugin(MyPlugin)
        return plugin.site()

示例:examples/plugins/custom-rss-site。