mirror of
https://github.com/EstrellaXD/Auto_Bangumi.git
synced 2026-10-31 12:45:41 +08:00
3258fcca4b
- docs/dev/plugins.md 改为总览与导航，旧内容拆入 docs/dev/plugins/ - 新增核心概念、配置表单、事件、前端挂载点、命令行、签名与分发、内置插件、示例页 - 每个扩展点一页，侧边栏由页面表生成 - 改正旧文档中下载器配置、hardlink path_map 与补链按钮的过时描述
30 lines
970 B
Markdown
30 lines
970 B
Markdown
# 搜索站点（search_site）
|
||
|
||
给搜索框增加一个站点。`@provider(points.SEARCH_SITE, id=...)` 返回 `SearchSite`，`id` 即站点名。
|
||
|
||
```python
|
||
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` 钩子](/dev/plugins/points/http-request) 附加 Cookie。
|
||
|
||
## 测试
|
||
|
||
```python
|
||
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`。
|