合集

合集（系列）的创建、管理和剧集排序接口。合集支持 type（类型） 与 brand（品牌/工作室） 两个分类字段，参考 hanime1.me 的「影片系列」设计。

type 存储类型 code（如 hentai_series_compilation、ova、movie），完整可选项由站点配置 siteConfig.seriesTypes 维护。
brand 为自由字符串，用于标注制作方（如 T-Rex / Pink Pineapple）。
选集器（视频详情页）可在后台配置「默认类型过滤」，仅展示对应类型的合集。

合集类型可选项

POST/api/trpc/series.listTypes公开

返回站点配置的合集类型列表，以及选集器默认过滤类型（null 表示不过滤）。

type Response = {
  types: Array<{ code: string; label: string; color?: string; description?: string }>;
  defaultFilter: string | null;
};

合集列表

POST/api/trpc/series.list公开

参数	类型	必填	说明
`limit`	number	是	每页数量
`page`	number	是	页码
`sortBy`	string	否	排序方式：`latest` / `videoCount` / `views`
`type`	string	否	按类型 code 过滤，`all` 或省略表示不过滤
`brand`	string	否	按品牌精确过滤

返回 items 中每条包含 type 与 brand 字段。

合集详情

POST/api/trpc/series.getById公开

返回合集信息及所含剧集列表，包含 type 与 brand。

参数	类型	必填	说明
`id`	string	是	合集 ID

根据视频 ID 查询所属合集

POST/api/trpc/series.getByVideoId公开

视频详情页选集器使用。返回视频所属合集与当前集数；指定 typeFilter 时仅在合集类型匹配时返回，否则返回 null。

参数	类型	必填	说明
`videoId`	string	是	视频 ID
`typeFilter`	string	否	仅返回该类型合集；`all` 或省略表示不过滤

创建合集

POST/api/trpc/series.create需登录content:write

参数	类型	必填	说明
`title`	string	是	合集标题
`description`	string	否	描述
`coverUrl`	string	否	封面 URL
`downloadUrl`	string	否	下载链接
`downloadNote`	string	否	下载说明
`type`	string	否	类型 code，必须在 `siteConfig.seriesTypes` 中存在
`brand`	string	否	品牌 / 工作室

更新合集

POST/api/trpc/series.update需登录content:write

参数	类型	必填	说明
`id`	string	是	合集 ID
`title`	string	否	新标题
`description`	string	否	新描述
`coverUrl`	string	否	新封面
`downloadUrl`	string	否	下载链接
`downloadNote`	string	否	下载说明
`type`	string	否	类型 code（传空字符串或 `null` 表示清空为未分类）
`brand`	string	否	品牌 / 工作室（传空清空）

删除合集

POST/api/trpc/series.delete需登录content:write

参数	类型	必填	说明
`id`	string	是	合集 ID

管理剧集

添加视频到合集

POST/api/trpc/series.addVideo需登录content:write

参数	类型	必填	说明
`seriesId`	string	是	合集 ID
`videoId`	string	是	视频 ID
`episodeNum`	number	否	集数编号
`episodeTitle`	string	否	集数标题

从合集移除视频

POST/api/trpc/series.removeVideo需登录content:write

参数	类型	必填	说明
`seriesId`	string	是	合集 ID
`videoId`	string	是	视频 ID

重新排序剧集

POST/api/trpc/series.reorderEpisodes需登录content:write

参数	类型	必填	说明
`seriesId`	string	是	合集 ID
`episodes`	object[]	是	剧集排序 `[{videoId, episodeNum}]`

合集