一分钟搭建影视站,支持Docker等部署方式
// 采集站(Apple CMS 资源站)描述
export interface SourceConfig {
/** 唯一标识,如 "custom_0";内置源直接用短名 */
key: string;
name: string;
/** API 根地址,如 https://example.com/api.php/provide/vod */
url: string;
/** 可选:详情页根地址(部分源需要爬详情页提取 m3u8) */
detail?: string;
isAdult?: boolean;
}
export interface SearchResultItem {
sourceKey: string;
sourceName: string;
vodId: string;
name: string;
pic?: string;
typeName?: string;
year?: string;
area?: string;
remarks?: string;
/** 自定义源的 API 地址,详情请求需要 */
sourceUrl?: string;
isAdult?: boolean;
}
export interface VideoInfo {
title?: string;
cover?: string;
desc?: string;
typeName?: string;
year?: string;
area?: string;
director?: string;
actor?: string;
remarks?: string;
sourceKey: string;
sourceName: string;
sourceUrl?: string;
}
export interface VideoDetail {
episodes: string[];
videoInfo: VideoInfo;
}
export interface DoubanItem {
id: string;
title: string;
cover: string;
rating?: string;
isTv?: boolean;
}
export interface SourceSearchOutcome {
sourceKey: string;
ok: boolean;
list: SearchResultItem[];
error?: string;
/** 因超时失败:源可能只是慢,前端以琥珀色区分于真正的失败 */
timedOut?: boolean;
/** 该源搜索总耗时(ms),用于健康徽章 */
ms?: number;
}
// —— 画质(按「源 + 影片」记录) ——
/**
* 画质记录条目。
* `height` 为视频高度(像素),undefined 表示探测过但测不出(单码率 m3u8 / 直链)。
* `from` 区分来源:play 是播放器实测的真实分辨率(权威),probe 是解析 m3u8 推断值。
*/
export interface QualityEntry {
height?: number;
from: 'play' | 'probe';
/**
* 探测失败原因(如 `HTTP 403`、`请求超时`)。
* 有值 = 这次压根没探到;无值而 height 也缺失 = 探到了但源站没写画质信息。
* 两者在 UI 上都显示「未知」,靠这个字段区分出「源站不给」和「我们没够着」。
*/
error?: string;
/** 记录时间(epoch ms),用于 LRU 淘汰与失败重试 */
timestamp: number;
}
/** 画质探测请求条目:源配置 + 影片 ID */
export interface QualityProbeItem {
source: SourceConfig;
id: string;
}
/** 画质探测结果;height 缺失代表「测不出」而非失败失败(error 有值时才是失败) */
export interface QualityProbeResult {
sourceKey: string;
vodId: string;
height?: number;
error?: string;
}
// —— API 响应结构 ——
export interface SearchResponse {
list: SearchResultItem[];
failures: { sourceKey: string; error: string; timedOut?: boolean }[];
}
/** /api/search?stream=1 的 NDJSON 事件:逐源推送 + 最终聚合 */
export type SearchStreamEvent =
| ({ type: 'source' } & SourceSearchOutcome)
| { type: 'done'; list: SearchResultItem[]; failures: SearchResponse['failures'] };
export interface DoubanResponse {
items: DoubanItem[];
}
export interface BangumiCalendarDay {
/** 1=周一 … 7=周日 */
weekday: number;
items: DoubanItem[];
}
export interface BangumiCalendarResponse {
days: BangumiCalendarDay[];
}
export interface AuthStatusResponse {
/** 服务器是否配置了 PASSWORD */
passwordRequired: boolean;
/** 当前会话是否已验证 */
verified: boolean;
version: string;
/** 部署者通过 DEFAULT_SOURCES 环境变量预置的采集站(未配置时为空数组) */
defaultSources: SourceConfig[];
/** 部署者通过 DEFAULT_LIVE_SOURCES 环境变量预置的直播源(未配置时为空数组) */
defaultLiveSources: LiveSourceConfig[];
/** 部署者通过 DEFAULT_SUBSCRIPTIONS 环境变量预置的 SourceList 订阅链接(未配置时为空数组) */
defaultSubscriptions: { url: string; name?: string; refreshDays?: number }[];
/** 部署者通过 DEFAULT_RECOMMEND_SOURCE 环境变量指定的首页推荐数据源默认值(未配置时为 null) */
defaultRecommendSource: 'douban' | 'bangumi' | 'hot-list' | null;
/** 部署者通过 DEFAULT_IMAGE_MODE 环境变量指定的封面图加载方式默认值(未配置时为 null) */
defaultImageMode: 'direct' | 'proxy' | null;
}
// —— 直播 / IPTV ——
/** 直播源(M3U 订阅)配置 */
export interface LiveSourceConfig {
key: string;
name: string;
/** M3U 订阅地址 */
url: string;
/** 可选:XMLTV 节目单地址 */
epg?: string;
}
/** 单个直播频道(由 M3U 解析得到) */
export interface LiveChannel {
/** tvg-id 优先,缺失时由 URL 生成的稳定短 id */
id: string;
name: string;
url: string;
logo?: string;
group?: string;
tvgId?: string;
/** M3U 的 tvg-name 属性(原始台名) */
rawName?: string;
}
export interface LivePlaylistResponse {
/** 订阅名(M3U 无名时为空) */
name?: string;
channels: LiveChannel[];
groups: string[];
}
/** 单条节目单条目(XMLTV programme) */
export interface EpgProgram {
channelId: string;
/** epoch ms */
start: number;
/** epoch ms */
stop: number;
title: string;
desc?: string;
}
export interface LiveEpgResponse {
channelId: string;
current?: EpgProgram;
next?: EpgProgram;
programs: EpgProgram[];
}
// —— 数据源订阅 ——
/** 订阅条目未被导入(跳过)的原因分类 */
export type SubscriptionSkipReason =
/** Spider 类站点(csp_* / jar / js / py),需 TVBOX 引擎才能运行 */
| 'spider'
/** 仅提供 XML 接口或不支持的类型 */
| 'xml'
/** 站点自身标记为不可搜索(本站只有搜索入口,导入后无法使用) */
| 'unsearchable'
/** 直播源不是 M3U 播放列表(如 txt 频道列表、单仓 JSON) */
| 'nonM3uLive'
/** 接口目录条目自身标记 enabled: false(发布者主动停用,不是异常) */
| 'disabled'
/** 地址非法、非 http(s) 或未通过服务端公网校验 */
| 'invalidUrl';
/** 订阅解析统计:说明跳过与截断情况,用于导入结果提示 */
export interface SubscriptionParseStats {
/** 识别出的订阅格式 */
format: 'libretv' | 'tvbox' | 'source-catalog';
/** 被跳过的条目总数 */
skipped: number;
/** 跳过原因分类计数 */
skippedByReason: Partial<Record<SubscriptionSkipReason, number>>;
/** 被跳过条目的名称示例(最多 3 个),便于用户定位 */
skippedSamples?: string[];
/** 因超出数量上限被截断的条目数 */
truncated: number;
}
/**
* 远程订阅解析结果。
* `sources` 为点播源(Apple CMS 采集站),`liveSources` 为直播源(M3U + 可选 EPG)。
* 兼容三种订阅格式:LibreTV-SourceList JSON、TVBOX 配置 JSON(`sites` / `lives`)、
* 接口目录(裸数组 `{name, baseUrl, enabled}`,仅点播)。
* 老格式订阅只有 `sources`,此时 `liveSources` 为空数组。
*/
export interface SourceListPayload {
/** 订阅列表自带名称 */
name?: string;
sources: Omit<SourceConfig, 'key'>[];
liveSources: Omit<LiveSourceConfig, 'key'>[];
/** 解析统计(格式、跳过与截断),老数据可能缺失 */
stats?: SubscriptionParseStats;
}