Compare commits
2
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
3b9f3bbf5d | ||
|
|
5d58eee4c7 |
No files matched your search
@@ -2,6 +2,20 @@
|
||||
|
||||
本文档记录 KatelyaTV 项目的重要更新和功能变更。
|
||||
|
||||
## [fixed133] - 2026-11-16
|
||||
|
||||
### ⚡ 性能:最新港剧等聚合板块秒开(对齐热门电影的加载体验)
|
||||
- **接口层 stale-while-revalidate**:`/api/tvbox/all` 缓存过期后先立即返回旧数据(`X-Cache: STALE`,实测 0.02s),同时在后台重新聚合——多源聚合实测 8~22s,用户请求从此零等待;60s 内 `X-Cache: HIT`(0.03s)
|
||||
- **分类端点并发竞速**:`fetchClass` 三个候选端点由「串行逐试、每端点等满 8s」改为「并发竞速、首个成功即用」(半死源最坏 3×8s=24s → 8s);容器重启后的冷启动全量聚合从 **60s+ 降到 22.3s**(前端 25s 超时内可通过)
|
||||
- **失败分类表缓存 30s → 2min**:避免每分钟刷新反复踩满超时拖慢整体
|
||||
- **保活**:模块级预热定时器(edge 隔离下不保证存活)+ 宿主 crontab 每分钟保活请求——无用户流量时聚合结果也持续续期,数据最多旧约 2 分钟
|
||||
- **根因说明**:热门电影走豆瓣单接口(1~2s 即回),最新港剧走全片源站聚合(分类表映射 + 列表拉取 + 硬过滤去重),慢在聚合本身与 60s 缓存过期后的同步等待;本版以 SWR + 端点竞速消灭「等待」,数据源保持片源直达不降级(不换豆瓣源,避免点击后退化为标题搜索)
|
||||
- Dockerfile `ENV NEXT_PUBLIC_SITE_VERSION` 同步 fixed133(客户端编译期常量)
|
||||
|
||||
### 🧪 验证(2026-11-16 实测)
|
||||
- tsc / next build 通过;冷启动聚合 22.3s(list=70)、第 2 发 HIT 0.031s、过期后 STALE 0.024s(list=65)
|
||||
- 站点 307→login 200、Redis 67 键完好、容器 `SITE_VERSION=fixed133`
|
||||
|
||||
## [fixed132] - 2026-11-16
|
||||
|
||||
### ✨ 全新浏览器标签页图标(favicon)
|
||||
|
||||
+2
-2
@@ -35,7 +35,7 @@ RUN find ./src -type f -name "route.ts" -print0 \
|
||||
ENV DOCKER_ENV=true
|
||||
# 海报走站内 /api/image-proxy(浏览器直连豆瓣图被拦导致全裂)
|
||||
ENV NEXT_PUBLIC_IMAGE_PROXY=/api/image-proxy
|
||||
ENV NEXT_PUBLIC_SITE_VERSION=fixed131
|
||||
ENV NEXT_PUBLIC_SITE_VERSION=fixed133
|
||||
ENV NEXT_PUBLIC_ENABLE_REGISTER=true
|
||||
# 存储模式必须烤进镜像:丢失会导致服务端数据(观看记录/账号/收藏)全部不可读,
|
||||
# 且登录接口走 localstorage 分支无 AUTH_PASSWORD 直接放行(2026-11-15 事故)
|
||||
@@ -59,7 +59,7 @@ ENV HOSTNAME=0.0.0.0
|
||||
ENV PORT=3000
|
||||
ENV DOCKER_ENV=true
|
||||
ENV NEXT_PUBLIC_IMAGE_PROXY=/api/image-proxy
|
||||
ENV NEXT_PUBLIC_SITE_VERSION=fixed131
|
||||
ENV NEXT_PUBLIC_SITE_VERSION=fixed133
|
||||
ENV NEXT_PUBLIC_ENABLE_REGISTER=true
|
||||
# 存储模式必须烤进镜像:丢失会导致服务端数据(观看记录/账号/收藏)全部不可读,
|
||||
# 且登录接口走 localstorage 分支无 AUTH_PASSWORD 直接放行(2026-11-15 事故)
|
||||
|
||||
@@ -247,6 +247,8 @@ docker compose -f docker-compose.redis.yml down
|
||||
|
||||
## 📋 更新日志
|
||||
|
||||
- **v-fixed133**:**最新港剧加载提速(对齐热门电影)**——`/api/tvbox/all` 聚合接口改 stale-while-revalidate:过期先秒回旧数据(STALE 实测 0.02s)后台再刷新,60s 内 HIT 0.03s;分类端点由串行逐试改并发竞速,**冷启动聚合 60s+ → 22.3s**;失败分类缓存 30s→2min + 宿主 cron 每分钟保活;热门电影仍走豆瓣单接口(数据源不变,点击仍直达片源)
|
||||
- **v-fixed132**:全新浏览器标签页图标——替换旧「暗黑肖像缩略图」favicon(16px 下糊成黑团),新图标为**深蓝渐变圆角底 + 天蓝播放三角 + 右上角星光**,与暗色主题/天蓝主色一致;16px 用专用优化版(三角放大加粗),32/48/64 为标准版(4K 超采样抗锯齿);同步更新 PWA 图标 `icons/icon-{192,256,384,512}.png`
|
||||
- **v-fixed131**:相关推荐重做——数据改为**本站已有片源**,新增 `/api/related` 按 **主演/导演/语言/地区/类型** 五项元数据匹配打分(豆瓣推荐接口不再用于推荐);卡片点击带 `source+id` **直达实际片源开播**(播放页直达模式不再按标题搜索,杜绝片源对不上);「相关推荐」标题旁常驻显示匹配规则「按主演 / 导演 / 语言 / 地区 / 类型匹配 · 本站片源直达」,卡片下标注重合依据
|
||||
- **v-fixed130**:详情页「相关推荐」标题旁显示推荐规则说明「豆瓣相似影片推荐 · 取前10」(数据来自豆瓣官方推荐接口,取前 10 条相似影片)
|
||||
|
||||
@@ -270,13 +272,13 @@ docker compose -f docker-compose.redis.yml down
|
||||
```bash
|
||||
# 公网可拉(匿名)
|
||||
docker pull gitea.88531.cn/jinghui/katelyatv:latest # 固定版本
|
||||
docker pull gitea.88531.cn/jinghui/katelyatv:fixed96
|
||||
docker pull gitea.88531.cn/jinghui/katelyatv:fixed133
|
||||
|
||||
# 腾讯云 TCR(东京,公网匿名)
|
||||
docker pull jpccr.ccs.tencentyun.com/jinghui/katelyatv:latest
|
||||
```
|
||||
|
||||
当前版本:**v-fixed96**
|
||||
当前版本:**v-fixed133**
|
||||
|
||||
## 🔗 源码
|
||||
|
||||
|
||||
@@ -10,25 +10,81 @@ export const runtime = 'edge';
|
||||
// 聚合/class/9xx 映射逻辑已收拢到 @/lib/tvboxagg(旧补丁 ALL 逻辑的源码化实现),
|
||||
// 本文件只负责:进程内缓存 + 出口。
|
||||
|
||||
// 进程内响应缓存:相同查询 60s 内直接返回,避免每次刷新都重新聚合上游(最新港剧等栏目秒开)
|
||||
// 进程内响应缓存(stale-while-revalidate):
|
||||
// - HIT:有数据 60s 内直接返回(浏览器同样 max-age=60);
|
||||
// - STALE:过期后 10 分钟内先立刻返回旧数据,同时后台重新聚合——
|
||||
// 多源聚合实测 8~18s,用户请求永远零等待(最新港剧与热门电影一样秒开);
|
||||
// - 完全冷(容器刚重启、无任何旧数据)才同步等一次聚合。
|
||||
const respCache = new Map<string, [number, any]>();
|
||||
const refreshing = new Set<string>();
|
||||
const FRESH_MS = 60000; // 有数据的强新鲜窗口
|
||||
const FRESH_EMPTY_MS = 5000; // 空结果只短缓存 5s:上游偶发超时不能把空列表当正常数据缓存
|
||||
const STALE_MS = 10 * 60 * 1000; // stale 窗口:旧数据最多用 10 分钟,期间后台必然已刷新
|
||||
|
||||
async function aggregateNow(cacheKey: string, sp: URLSearchParams): Promise<any | null> {
|
||||
try {
|
||||
const config = await getConfig();
|
||||
const sourceConfigs: SrcCfg[] = (config.SourceConfig || []).filter((s: any) => !s.disabled);
|
||||
const r = await aggregateAll(sourceConfigs, sp);
|
||||
// 只缓存有数据的结果;空结果不驻留(下次请求立即重试)
|
||||
if (r && Array.isArray(r.list) && r.list.length) {
|
||||
respCache.set(cacheKey, [Date.now(), r]);
|
||||
if (respCache.size > 200) respCache.clear();
|
||||
return r;
|
||||
}
|
||||
} catch {
|
||||
// 聚合失败静默:stale 数据继续可用,下次请求/预热会再试
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 后台刷新(同一 key 并发去重,避免多个过期请求同时打上游)
|
||||
function refreshInBackground(cacheKey: string, sp: URLSearchParams) {
|
||||
if (refreshing.has(cacheKey)) return;
|
||||
refreshing.add(cacheKey);
|
||||
aggregateNow(cacheKey, sp).finally(() => refreshing.delete(cacheKey));
|
||||
}
|
||||
|
||||
export async function GET(request: NextRequest) {
|
||||
const { searchParams } = new URL(request.url);
|
||||
const cacheKey = searchParams.toString();
|
||||
const now = Date.now();
|
||||
const c = respCache.get(cacheKey);
|
||||
// 空结果只缓存 5s:上游偶发超时不能把空列表当 60s 正常数据缓存(最新港剧整栏消失的根因之一)
|
||||
const cTTL = c && c[1] && Array.isArray(c[1].list) && c[1].list.length ? 60000 : 5000;
|
||||
if (c && now - c[0] < cTTL) {
|
||||
const hasList = !!(c && c[1] && Array.isArray(c[1].list) && c[1].list.length);
|
||||
const freshTTL = hasList ? FRESH_MS : FRESH_EMPTY_MS;
|
||||
|
||||
if (c && now - c[0] < freshTTL) {
|
||||
return NextResponse.json(c[1], { headers: { 'Access-Control-Allow-Origin': '*', 'Cache-Control': 'public, max-age=60', 'X-Cache': 'HIT' } });
|
||||
}
|
||||
const config = await getConfig();
|
||||
const sourceConfigs: SrcCfg[] = (config.SourceConfig || []).filter((s: any) => !s.disabled);
|
||||
const r = await aggregateAll(sourceConfigs, searchParams);
|
||||
// 只缓存有数据的结果;空结果短缓存(上面 5s TTL)且不长期驻留
|
||||
if (r && Array.isArray(r.list) && r.list.length) respCache.set(cacheKey, [now, r]);
|
||||
// 防止缓存无限增长:超过 200 条清空
|
||||
if (respCache.size > 200) respCache.clear();
|
||||
return NextResponse.json(r, { headers: { 'Access-Control-Allow-Origin': '*', 'Cache-Control': 'public, max-age=60' } });
|
||||
// stale:先给旧数据、后台刷新——用户零等待
|
||||
if (hasList && now - c[0] < STALE_MS) {
|
||||
refreshInBackground(cacheKey, searchParams);
|
||||
return NextResponse.json(c[1], { headers: { 'Access-Control-Allow-Origin': '*', 'Cache-Control': 'public, max-age=60', 'X-Cache': 'STALE' } });
|
||||
}
|
||||
// 完全冷:没人有数据可给,只能同步聚合一等(配合下方启动预热 + 宿主保活 cron,正常用户几乎碰不到)
|
||||
const r = await aggregateNow(cacheKey, searchParams);
|
||||
return NextResponse.json(
|
||||
r || { code: 1, msg: '数据列表', page: 1, pagecount: 1, limit: 0, total: 0, list: [] },
|
||||
{ headers: { 'Access-Control-Allow-Origin': '*', 'Cache-Control': 'public, max-age=60' } },
|
||||
);
|
||||
}
|
||||
|
||||
// ---------- 启动预热 + 周期保活 ----------
|
||||
// 模块被首个请求加载后:3s 后预热首页聚合键(最新港剧),此后每 55s 续一次
|
||||
// (接在 60s fresh 窗口前),用户请求几乎永远命中 HIT/STALE。
|
||||
// edge isolate 若不保留定时器则自然退化为"过期请求触发后台刷新",无副作用。
|
||||
const WARM_KEYS = ['ac=videolist&t=902&pg=1&by=time'];
|
||||
function scheduleWarm() {
|
||||
const g = globalThis as any;
|
||||
if (g.__tvboxAllWarm) return;
|
||||
g.__tvboxAllWarm = true;
|
||||
const run = () => {
|
||||
for (const q of WARM_KEYS) {
|
||||
const ent = respCache.get(q);
|
||||
if (!ent || Date.now() - ent[0] > FRESH_MS - 5000) refreshInBackground(q, new URLSearchParams(q));
|
||||
}
|
||||
};
|
||||
setTimeout(run, 3000);
|
||||
setInterval(run, 55000);
|
||||
}
|
||||
scheduleWarm();
|
||||
+24
-14
@@ -36,28 +36,38 @@ export function ns(x: any, key: string) {
|
||||
return Object.assign({}, x, { vod_id: String(key) + ':' + String(x.vod_id) });
|
||||
}
|
||||
|
||||
// 源站分类表缓存:非空 10 分钟(分类表很稳定),空 30 秒(失败要尽快重试)
|
||||
// 源站分类表缓存:非空 10 分钟(分类表很稳定),空 2 分钟(失败过 2 分钟再试,
|
||||
// 30s 太短会让每分钟的刷新都重新踩满超时拖慢整体聚合)
|
||||
const classCache = new Map<string, [number, any[], boolean]>();
|
||||
export async function fetchClass(api: string): Promise<any[]> {
|
||||
const now = Date.now();
|
||||
const c = classCache.get(api);
|
||||
if (c && (c[2] ? now - c[0] < 30000 : now - c[0] < 600000)) return c[1];
|
||||
for (const ep of [api, api + (api.includes('?') ? '&' : '?') + 'ac=list', api + (api.includes('?') ? '&' : '?') + 'ac=class']) {
|
||||
if (c && (c[2] ? now - c[0] < 120000 : now - c[0] < 600000)) return c[1];
|
||||
// 三个候选端点并发竞速(旧行为是串行逐试:半死源每端点都等满 8s 超时,
|
||||
// 最坏 3×8s=24s 拖死整体聚合——冷启动 60s 的主要来源);首个返回非空分类的端点即胜,
|
||||
// 全部失败/超时(单端点 8s)才缓存空结果 → 冷启动最坏 8s 而非 24s
|
||||
const eps = [api, api + (api.includes('?') ? '&' : '?') + 'ac=list', api + (api.includes('?') ? '&' : '?') + 'ac=class'];
|
||||
const attempt = async (ep: string): Promise<any[]> => {
|
||||
const ctrl = new AbortController();
|
||||
const t = setTimeout(() => ctrl.abort(), 8000);
|
||||
try {
|
||||
const ctrl = new AbortController();
|
||||
const t = setTimeout(() => ctrl.abort(), 8000);
|
||||
const r = await fetch(ep, { headers: { 'User-Agent': UA, Accept: 'application/json' }, signal: ctrl.signal });
|
||||
clearTimeout(t);
|
||||
if (!r.ok) continue;
|
||||
if (!r.ok) throw new Error('http ' + r.status);
|
||||
const j = await r.json();
|
||||
if (Array.isArray(j?.class) && j.class.length) {
|
||||
classCache.set(api, [now, j.class, false]);
|
||||
return j.class;
|
||||
}
|
||||
} catch {}
|
||||
if (Array.isArray(j?.class) && j.class.length) return j.class;
|
||||
throw new Error('no class');
|
||||
} finally {
|
||||
clearTimeout(t);
|
||||
}
|
||||
};
|
||||
try {
|
||||
const classes = await Promise.any(eps.map(attempt));
|
||||
classCache.set(api, [now, classes, false]);
|
||||
return classes;
|
||||
} catch {
|
||||
classCache.set(api, [now, [], true]);
|
||||
return [];
|
||||
}
|
||||
classCache.set(api, [now, [], true]);
|
||||
return [];
|
||||
}
|
||||
|
||||
// 顶层 9xx 分类表 + 筛选器(旧补丁 MK):TVBox 端每个站点看到的就是这 7+1 个分类
|
||||
|
||||
Reference in new issue
Block a user