跳至主要內容

站点适配

xylplm2023/9/27大约 9 分钟

1、说明

media saber 不提供任何站点资源服务，但支持网友自行适配站点配置文件。 适配很简单，只需要一个文本编辑器+浏览器即可适配。 技术栈也仅仅只需要会 HTML+CSS 基础知识，理解 CSS 选择器即可。

2、配置文件说明

文件名必须为站点id保证在配置文件目录中唯一

目录

站点适配流程图

目录结构

/your_data_dir/site/configs
├── common/                     # 架构公共配置，一般定义公共请求
│   ├── NexusPhp.json           # NexusPhp 架构公共配置
│   ├── NexusRabbit.json        # NexusRabbit 架构公共配置
│   └── xxx.json                # 其他架构公共配置
├── sites/                      # 站点配置，可以复用对应架构的公共配置
│   ├── audiences.json          # 观众站点配置
│   ├── cyanbug.json            # 大青虫站点配置
│   └── xxx.json                # 其他站点配置

名词解释

parser

解析器，用于解析站点的配置文件，目前支持以下解析器

名称描述
CssSelectorcss 选择器。
XPathXPath 选择器。
JsonPathJsonPath，使用方法：https://github.com/tidwall/gjson。 注：这种方式可以不写 selector 表达式, 默认使用字段名
None不解析，特殊站点需要写代码解析。

filter

过滤器，用于对字段文本进行链式过滤转换，参数值部分支持 string、number、bool 类型，目前支持以下过滤器

名称描述
append_left左边添加字符串
append_right右边添加字符串
blank判断是否为空
byte_size体积转为字节数
case同 switch case
constant固定值
eq判断是否相等，自动转换为 bool 类型，或者转换任一指定的文本
not_blank判断是否不为空
querystring搜索指定字符串索引，截取从索引开始的字符串部分
regex正则匹配
replace字符串替换
re_search正则表达式搜索文本
split分割文本，获取第 n 段的子文本
strip去除字符串两端的空白字符（空格、制表符、换行符等）
timestamp日期转为 unix 时间戳
timezone时间戳时区转换，支持时区偏移加减

append_left

{
  "name": "append_left",
  "args": "str"
}

append_right

{
  "name": "append_right",
  "args": "str"
}

blank

三种方式
第一种自动转 bool 类型
第二种转换为指定的 string 类型，如果不匹配则返回原始文本
第三种转换为指定的 string、number、bool 类型

[
  {
    "name": "blank"
  },
  {
    "name": "blank",
    "args": "if True"
  },
  {
    "name": "blank",
    "args": [
      "if True",
      "if False"
    ]
  }
]

byte_size

{
  "name": "byte_size"
}

case

value 支持 string、number、bool 类型

{
  "name": "case",
  "args": {
    "k1": "v1",
    "k2": "v2",
    "*": "defaultValue"
  }
}

constant

{
  "name": "constant",
  "args": "str"
}

eq

两种方式，第一种自动转 bool 类型，第二种转换为指定的 string、number、bool 类型

[
  {
    "name": "eq",
    "args": "str"
  },
  {
    "name": "eq",
    "args": [
      "str",
      "if True",
      "if False"
    ]
  }
]

not_blank

用法同 blank

[
  {
    "name": "not_blank"
  },
  {
    "name": "not_blank",
    "args": "if True"
  },
  {
    "name": "not_blank",
    "args": [
      "if True",
      "if False"
    ]
  }
]

querystring

{
  "name": "querystring",
  "args": "str"
}

regex

两种方式，第一种自动转 bool 类型，第二种转换为指定的 string、number、bool 类型

[
  {
    "name": "regex",
    "args": "regex"
  },
  {
    "name": "regex",
    "args": [
      "regex",
      "if True",
      "if False"
    ]
  }
]

replace

{
  "name": "replace",
  "args": [
    "separator",
    "old",
    "new"
  ]
}

以下文本获取上传量字节数，上传量: 1 TB

[
  {
    "name": "re_search",
    "args": [
      "上传量: (.*)",
      1
    ]
  },
  {
    "name": "byte_size"
  }
]

split

分隔以下文本：hello world，结果为：world
-1 为最后一段

{
  "name": "split",
  "args": [
    " ",
    -1
  ]
}

strip

{
  "name": "strip"
}

timestamp

将时间格式： 2024-12-31 23:59:59，转为 unix 时间戳

[
  {
    "name": "timestamp"
  },
  {
    "name": "timestamp",
    "args": [
      "2006-01-02 15:04:05",
      "2006-01-0215:04:05"
    ]
  }
]

timezone

时间戳时区转换，将时间戳进行时区偏移加减，默认为 +8 时区。支持传入格式："+8"、"-5"、"8"、"-5" 等

[
  {
    "name": "timezone"
  },
  {
    "name": "timezone",
    "args": ["+8"]
  },
  {
    "name": "timezone",
    "args": ["-5"]
  }
]

配合 timestamp 使用示例：

[
  {
    "name": "timestamp",
    "args": [
      "2006-01-02 15:04:05"
    ]
  },
  {
    "name": "timezone",
    "args": ["+8"]
  }
]

selection

选择器文本类型

名称描述
text取匹配节点的文本
html取匹配节点的 html 源码

通用请求定义

字段的数据类型支持字段转换，目前支持 string 转 int、int64、bool、float64、string，如需更多类型请在 client.decodeHookFunc
代码里添加。

名称描述
favicon获取站点图标
user_basic_info获取用户基础信息
user_details获取用户详情
search搜索种子列表
seeding_statistics获取做种统计信息
my_hrHR 考核中列表
messages用户消息列表
message_detail消息详情，根据消息链接查询
notice公告
sign_in签到
details获取种子详情
download_file下载文件，种子、字幕等等都可以下载

user_basic_info 字段

名称描述
is_login是否登录
signed_in是否签到
id用户 id
name用户名称
ratio分享率
uploaded上传量
downloaded下载量
bonus魔力
gold金币，特殊站点用，最终转换为魔力
silver银币，同上
copper铜币，同上

user_details 字段

名称描述
level用户等级
level_icon用户等级 icon
join_at加入时间，时间戳
last_accessed最近动态，时间戳

search 字段

名称描述
id用户等级
category类别
title标题
description描述
details详情页地址，相对地址
download下载地址，相对地址
size体积
grabs完成数
seeders正在上传
leechers正在下载
downloadvolumefactor下载因子
uploadvolumefactor上传因子
date_added发布时间
date_elapsed存活时间
hr_dayshr 天数
labels标签

seeding_statistics 字段

名称描述
count数量
size体积

my_hr 字段

名称描述
idhr id
name标题
uploaded上传量
downloaded下载量
share_ratio分享率
download_time下载时间
need_seed_time需要做种时间
remaining_inspection_time考核剩余时间

messages 字段

名称描述
idid
title标题
date时间
content内容
link消息链接，相对地址

同 messages

message_detail 字段

名称描述
title标题
date时间
content内容

notice 字段

名称描述
title标题
date时间
content内容

details 字段

名称描述
absent种子已不存在
free是否免费
2x_free是否双免
hr是否是 HR 种子
peer_count做种人数

sign_in 字段

名称描述
signed_in是否签到

details 字段

名称描述
absent种子是否已不存在
free是否免费
2x_free是否双免
hr是否是 HR 种子
peer_count做种人数

JSON 数据结构

站点配置 JSON 说明：

  • id: 唯一标识
  • name: 名称
  • domain: 域名地址
  • api: api 地址
  • public: 是否为公开站点
  • schema: 系统架构，见名词解释
  • reuse_schema: 复用系统架构
  • required: 是否必须
    • user_id: 是否需要手动填写用户的 id
    • sign_in: 是否需要签到
    • cookie: 是否需要手动填写 cookie
  • category: 分类，此处省略
  • price: 价格
    • has_free: 是否免费
    • has_2x_free: 是否双免
    • has_hr: 是否有 HR 种子
  • common_fields: 公共字段定义
  • requests: 请求定义，支持继承 schema 的配置，若 schema 无配置，则尝试使用 reuse_schema 的配置
    • parser: 解析器，见名词解释
    • method: 请求方法，GET、POST
    • path: 请求地址，非 http、https 开头则拼接 domain 或 api
    • use_api: 是否使用 api 地址
    • chrome: 使用 chrome
    • headers: 请求头
    • required_headers: 必填请求头，可以在站点管理自定义请求头里面配
    • params: url 请求参数，值必须为字符串类型
    • form_data: 表单数据，值必须为字符串类型
    • body: 请求体
    • success_status_codes: 成功状态码
    • list: 列表请求，用于获取列表数据
      • selector: 列表项选择器
      • next_page: 分页参数, 同 field
    • fields: 字段定义
      • selector: 选择器
      • selection: 选择器文本类型，见名词解释
      • attribute: css 选择器属性
      • filters: 过滤器，链式处理，见名词解释
      • parent: 是否选择父元素
      • remove: css 选择器移除子元素，多个用英文逗号分隔
      • any: 按顺序匹配，直到匹配成功，同 fields
      • array: 是否为数组
      • fields: 字段嵌套
      • fields_ref: 字段嵌套引用
      • list: 字段嵌套列表参数
      • trim_chars: 是否去除特殊字符
    • fields_ref: 引用当前文件指定 rd 的 fields
    • disabled_extends: 禁用继承，指定不需要继承的字段
      • path
      • headers
      • required_headers
      • params
      • form_data
      • body
      • success_status_codes
      • list
      • fields
      • field

站点公共配置 JSON 说明：

  • id: 架构
  • requests: 同上

注意事项

  • 增加 sign_in_required 配置
  • 馒头部分接口没有权限，可以通过自定义 authorization 来获取全权限
  • 影分类太细，暂不适配分类
  • appendleft 过滤器名称改为 append_left
  • case 去掉，改为 any + not_blank filter
  • index 去掉，自己想办法

搜索接口事项

  • search td.rowfollow 统一去掉 rowfollow，提高 NexusPHP.json 重复利用率
  • table.torrents > tr:has("table.torrentname") 统一改为 table.torrents tr:has(table.torrentname)
  • 去除 date、free_deadline，貌似没有用到
  • 去掉 tags、subject，以前用于渲染 description 的
  • title_optional title_default 合并为 title，使用 any 即可，但要确保 title_optional 在 title_default 前面，否则可能拿到
    description 的文本
  • contents 使用 filter split
  • default_value 改为 constant filter

字段继承

  • 基本上一致，建议确认后直接继承：id、category、title、details、download、downloadvolumefactor、uploadvolumefactor、size、
    grabs、seeders、leechers、date_elapsed、date_added
  • 重复率较低，请仔细确认：description、labels、hr_days、imdbid

MyHr 接口事项

  • 增加 id 字段
  • downloaded_time 改为 download_time
  • renaming_inspect_time 改为 renaming_time

details 接口事项

  • 以前的 price xpath 表达式迁移过来
  • 修改 price free、2xFree、hr 相关配置

seeding_statistic 接口事项

  • 重写了接口，如果不需要分页，请禁用 list 的继承，headers 视情况禁用

常见问题

  • css selector 要注意，使用 > 时必须保证为直接下级，否则会失败。应该有很多地方需要修改。例如：table.torrentname >
    tr，这种情况应该修改为 table.torrentname tr，因为中间还有一层 tbody，一般搜索接口拿不到值大概率是这个原因导致。
MIT License | Copyright © 2023-present xylplm
Copyright © 2026 xylplm