工具生态收录（PT-Plugin-Plus / Jackett / cross-seed）
站点的真实「日常界面」往往是浏览器插件与自动化工具，而非网页本身。本系统已内置三条兼容通道，本文说明如何让工具生态认得你的站。
已内置的通道
| 通道 | 端点 | 适配对象 |
|---|---|---|
| PTPP 用户信息 | GET /api/v1/plugins/ptppUserInfo（API Token 鉴权） | PT-Plugin-Plus / PT-depiler 的用户信息卡 |
| NP 兼容形状 | GET /compat/nexusphp/*（user.json / torrents.json / download.php） | 按 NexusPHP 字段口径工作的旧工具 |
| NP 别名路径 | getrss.php / takelogin.php / userdetails.php / details.php | 硬编码 NexusPHP 路径的老脚本 |
| Torznab 出口 | GET /api/v1/torznab + /torznab/search | Prowlarr / Jackett / Sonarr / Radarr / cross-seed |
| RSS | GET /api/v1/rss/{passkey}（item 带 enclosure 直链） | qBittorrent RSS / autobrr feed / Flexget / 阅读器 |
| 开放 API + 增量流 | /openapi.json、/open/recent、/open/announces、/open/torrents | 自写脚本 / 推送器 / 自动发种工具 |
详细字段与用法：_doc/开放API接入指南.md。 给工具维护者的对接页（三行命令起测试实例 + 逐工具对接要点 + 已备好的收录材料）： _doc/工具维护者对接页.md —— 用户来提收录请求时，把这一页甩过去即可。
提交收录（站长可选的对外动作）
- PT-depiler（PT-Plugin-Plus 的 MV3 继任者，明确兼容 NexusPHP/UNIT3D/Gazelle 三系）：
- 到其仓库
pt-plugins/PT-depiler提交站点定义（site config JSON）； - 我们走自研站通道：用户信息卡用
ptppUserInfo端点（朱雀口径，已验证的最短路径）， 搜索/推送走开放 API； - 提交前自测：插件「用户信息」能拉到等级/上传量、且下载链能真的拉到 .torrent 即通 （模板里的
passkey字段必须有值，见.research/ptpp-config-template/config.json）。
- 到其仓库
- Jackett：基于 UNIT3D/NexusPHP 通用定义改 FluxTorrent 定义——由于
/compat/nexusphp/torrents.json提供同形状输出，通用定义通常直接可用； 更省事的是直接走 Torznab（caps 已合规，Prowlarr/Jackett 可直接添加索引器）。 提 PR 到Jackett/Jackett/definitions。 - cross-seed：优先走 Torznab（
t=search已支持，item 的torznab:attr含infohash/seeders）；RSS 模式自 0267 起也可用（item 带<enclosure>直链）。 注意其对 tracker 负载的影响（建议 RSS 低频）。 - autobrr：本站不提供 IRC announce，实时抓新种请用
GET /api/v1/open/announces?since_id=轮询（增量、只返新种）。
对站长的意义
收录后用户可以用熟悉的插件聚合搜索、一键推送到下载器、跨站辅种——显著提升留存与保种率。收录动作只需一次，之后随版本保持 /compat 端点稳定即可（这属于公开 API 承诺的一部分）。