Files
2026-10-24 10:54:52 +08:00

620 lines
20 KiB
JavaScript

'use strict';
const express = require('express');
const path = require('path');
const http = require('http');
const WebSocket = require('ws');
const { createStores } = require('./lib/store');
const { loadSeed } = require('./lib/seed');
const lrcLib = require('./lib/lrc');
const models = require('./lib/models');
const DATA_DIR = process.env.DATA_DIR || path.join(__dirname, 'data');
const PORT = Number(process.env.PORT) || 30001;
const seed = loadSeed();
const stores = createStores(DATA_DIR, {
appearancePresets: seed.appearancePresets,
contentPresets: seed.contentPresets,
lrcPresets: seed.lrcPresets,
settings: seed.settings,
normalizeAppearancePreset: models.normalizeAppearancePreset,
normalizeContentPreset: models.normalizeContentPreset,
normalizeLrcPreset: lrcLib.normalizeLrcPreset,
});
const app = express();
const server = http.createServer(app);
const wss = new WebSocket.Server({ server });
app.disable('x-powered-by');
app.use(express.json({ limit: '8mb' }));
// ── 运行状态(不持久化:重启后默认全部隐藏) ──────────────────────────────────
let activePresetId = null;
let activeContentPresetId = null;
let activeFieldOverrides = {};
/** @type {null | {
* presetId: string, presetName: string, cues: any[], style: any,
* anchor: number, paused: boolean, pausedElapsed: number,
* totalMs: number, endMs: number, tailMs: number, offsetMs: number,
* startedAt: number, leadInMs: number
* }} */
let lrcPlayback = null;
let lrcEndTimer = null;
const MAX_TIMER_DELAY = 2_147_483_647;
// ── 静态资源 ──────────────────────────────────────────────────────────────────
app.use(express.static(path.join(__dirname, 'public'), {
etag: true,
maxAge: 0,
setHeaders(res, filePath) {
if (filePath.endsWith('.html')) res.setHeader('Cache-Control', 'no-cache');
},
}));
// ── 工具函数 ──────────────────────────────────────────────────────────────────
function fail(res, status, message) {
return res.status(status).json({ error: message });
}
function settingsValue() {
return stores.settings.value;
}
function sanitizeFieldOverrides(input) {
if (!input || typeof input !== 'object' || Array.isArray(input)) return {};
const result = {};
for (const [key, value] of Object.entries(input)) {
if (!/^[\w-]+$/.test(key)) continue;
result[key] = String(value == null ? '' : value).slice(0, 20_000);
if (Object.keys(result).length >= 80) break;
}
return result;
}
/** 只保留请求里显式提供的字段,避免 PUT 局部更新把未传字段清空 */
function pickDefined(source, keys) {
const result = {};
if (!source || typeof source !== 'object') return result;
for (const key of keys) {
if (source[key] !== undefined) result[key] = source[key];
}
return result;
}
function getActiveAppearancePreset() {
if (!activePresetId) return null;
return stores.appearancePresets.find(activePresetId);
}
function getContentData() {
const fields = {};
const appearance = getActiveAppearancePreset();
if (appearance && appearance.fieldDefs) {
for (const field of appearance.fieldDefs) {
fields[field.key] = field.defaultValue || '';
}
}
if (activeContentPresetId) {
const content = stores.contentPresets.find(activeContentPresetId);
if (content) Object.assign(fields, content.fields);
}
Object.assign(fields, activeFieldOverrides);
return fields;
}
function getActivePayload() {
return {
type: 'activePreset',
preset: getActiveAppearancePreset(),
contentData: getContentData(),
autoHideDuration: settingsValue().autoHideDuration,
activePresetId,
activeContentPresetId,
};
}
function broadcastRaw(message) {
const text = JSON.stringify(message);
wss.clients.forEach((client) => {
if (client.readyState === WebSocket.OPEN) client.send(text);
});
}
function broadcastActive(autoHideDuration) {
const payload = getActivePayload();
if (typeof autoHideDuration === 'number') payload.autoHideDuration = autoHideDuration;
broadcastRaw(payload);
}
// ── LRC 播放状态 ─────────────────────────────────────────────────────────────
function getLrcStatePayload() {
if (!lrcPlayback) return { type: 'lrcState', state: { playing: false } };
return {
type: 'lrcState',
state: {
playing: true,
paused: lrcPlayback.paused,
presetId: lrcPlayback.presetId,
presetName: lrcPlayback.presetName,
cues: lrcPlayback.cues,
style: lrcPlayback.style,
anchor: lrcPlayback.anchor,
pausedElapsed: lrcPlayback.pausedElapsed,
totalMs: lrcPlayback.totalMs,
endMs: lrcPlayback.endMs,
tailMs: lrcPlayback.tailMs,
offsetMs: lrcPlayback.offsetMs,
leadInMs: lrcPlayback.leadInMs,
startedAt: lrcPlayback.startedAt,
},
};
}
function broadcastLrc() {
broadcastRaw(getLrcStatePayload());
}
function clearLrcEndTimer() {
if (lrcEndTimer) {
clearTimeout(lrcEndTimer);
lrcEndTimer = null;
}
}
function scheduleLrcEnd() {
clearLrcEndTimer();
if (!lrcPlayback || lrcPlayback.paused) return;
const delay = lrcPlayback.endMs - Date.now();
if (delay <= 0) {
stopLrc('ended');
return;
}
lrcEndTimer = setTimeout(() => {
lrcEndTimer = null;
stopLrc('ended');
}, Math.min(delay, MAX_TIMER_DELAY));
}
function stopLrc(reason) {
if (!lrcPlayback) return false;
clearLrcEndTimer();
lrcPlayback = null;
broadcastRaw({ type: 'lrcState', state: { playing: false, reason: reason || 'stopped' } });
return true;
}
function buildTimelineForConfig(preset, overrides = {}) {
const source = typeof overrides.source === 'string' ? overrides.source : preset.source;
const filters = lrcLib.normalizeFilters({
...(preset.filters || {}),
...(overrides.filters && typeof overrides.filters === 'object' ? overrides.filters : {}),
});
const range = lrcLib.normalizeRange(overrides.range !== undefined ? overrides.range : preset.range);
const offsetMs = lrcLib.clampNumber(overrides.offsetMs, -60000, 60000, preset.offsetMs);
const tailMs = lrcLib.clampNumber(overrides.tailMs, 0, 60000, preset.tailMs);
const style = lrcLib.normalizeStyle({
...(preset.style || {}),
...(overrides.style && typeof overrides.style === 'object' ? overrides.style : {}),
});
const parsed = lrcLib.parseLrc(source);
const timeline = lrcLib.buildTimeline(parsed, { filters, range, offsetMs, tailMs });
return { parsed, timeline, filters, range, offsetMs, tailMs, style, source };
}
// ── 设置 API ─────────────────────────────────────────────────────────────────
app.get('/api/settings', (req, res) => {
res.json(settingsValue());
});
app.put('/api/settings', (req, res) => {
const next = { ...settingsValue() };
if (req.body && req.body.autoHideDuration !== undefined) {
const duration = Number(req.body.autoHideDuration);
if (!Number.isFinite(duration) || duration < 0) {
return fail(res, 400, 'autoHideDuration 必须是非负数字');
}
next.autoHideDuration = Math.min(Math.round(duration), 600_000);
}
stores.settings.update(next);
res.json(settingsValue());
});
// ── 外观预设 API ──────────────────────────────────────────────────────────────
app.get('/api/presets', (req, res) => {
res.json({
presets: stores.appearancePresets.list(),
contentPresets: stores.contentPresets.list(),
lrcPresets: stores.lrcPresets.list(),
lrcDefaults: {
filters: { ...lrcLib.DEFAULT_LRC_FILTERS },
style: { ...lrcLib.DEFAULT_LRC_STYLE },
timing: { ...lrcLib.DEFAULT_LRC_TIMING },
creditKeywords: lrcLib.DEFAULT_CREDIT_KEYWORDS,
},
activePresetId,
activeContentPresetId,
settings: settingsValue(),
lrcState: getLrcStatePayload().state,
});
});
app.get('/api/lrc/defaults', (req, res) => {
res.json({
filters: { ...lrcLib.DEFAULT_LRC_FILTERS },
style: { ...lrcLib.DEFAULT_LRC_STYLE },
timing: { ...lrcLib.DEFAULT_LRC_TIMING },
creditKeywords: lrcLib.DEFAULT_CREDIT_KEYWORDS,
});
});
app.post('/api/presets', (req, res) => {
try {
const body = req.body || {};
const preset = stores.appearancePresets.insert({
name: body.name,
kind: body.kind,
html: body.html,
themeColor: body.themeColor,
align: body.align,
extraCss: body.extraCss,
fieldDefs: body.fieldDefs,
});
res.json(preset);
} catch (err) {
fail(res, 400, err.message);
}
});
app.put('/api/presets/:id', (req, res) => {
const body = req.body || {};
try {
const updated = stores.appearancePresets.update(req.params.id,
pickDefined(body, ['name', 'kind', 'html', 'themeColor', 'align', 'extraCss', 'fieldDefs']));
if (!updated) return fail(res, 404, '预设不存在');
if (activePresetId === updated.id) broadcastActive();
res.json(updated);
} catch (err) {
fail(res, 400, err.message);
}
});
app.delete('/api/presets/:id', (req, res) => {
const removed = stores.appearancePresets.remove(req.params.id);
if (!removed) return fail(res, 404, '预设不存在');
if (activePresetId === req.params.id) {
activePresetId = null;
activeContentPresetId = null;
activeFieldOverrides = {};
broadcastActive(0);
}
res.json({ ok: true });
});
// ── 内容预设 API ──────────────────────────────────────────────────────────────
app.get('/api/content-presets', (req, res) => {
res.json(stores.contentPresets.list());
});
app.post('/api/content-presets', (req, res) => {
try {
const body = req.body || {};
const preset = stores.contentPresets.insert({
name: body.name,
appearancePresetId: body.appearancePresetId,
fields: body.fields,
});
res.json(preset);
} catch (err) {
fail(res, 400, err.message);
}
});
app.put('/api/content-presets/:id', (req, res) => {
const body = req.body || {};
try {
const updated = stores.contentPresets.update(req.params.id,
pickDefined(body, ['name', 'appearancePresetId', 'fields']));
if (!updated) return fail(res, 404, '内容预设不存在');
if (activeContentPresetId === updated.id) broadcastActive();
res.json(updated);
} catch (err) {
fail(res, 400, err.message);
}
});
app.delete('/api/content-presets/:id', (req, res) => {
const removed = stores.contentPresets.remove(req.params.id);
if (!removed) return fail(res, 404, '内容预设不存在');
if (activeContentPresetId === req.params.id) {
activeContentPresetId = null;
activeFieldOverrides = {};
broadcastActive(0);
}
res.json({ ok: true });
});
// ── 激活 API ──────────────────────────────────────────────────────────────────
app.post('/api/content-presets/:id/activate', (req, res) => {
const content = stores.contentPresets.find(req.params.id);
if (!content) return fail(res, 404, '内容预设不存在');
activeContentPresetId = content.id;
activePresetId = content.appearancePresetId || null;
activeFieldOverrides = sanitizeFieldOverrides(req.body && req.body.fieldOverrides);
const overrideDuration = req.body && typeof req.body.autoHideDuration === 'number'
? req.body.autoHideDuration
: null;
broadcastActive(overrideDuration !== null ? overrideDuration : settingsValue().autoHideDuration);
res.json({ ok: true });
});
app.post('/api/presets/:id/activate', (req, res) => {
const preset = stores.appearancePresets.find(req.params.id);
if (!preset) return fail(res, 404, '预设不存在');
activePresetId = preset.id;
activeContentPresetId = null;
activeFieldOverrides = sanitizeFieldOverrides(req.body && req.body.fieldOverrides);
const overrideDuration = req.body && typeof req.body.autoHideDuration === 'number'
? req.body.autoHideDuration
: null;
broadcastActive(overrideDuration !== null ? overrideDuration : settingsValue().autoHideDuration);
res.json({ ok: true });
});
app.post('/api/clear', (req, res) => {
activePresetId = null;
activeContentPresetId = null;
activeFieldOverrides = {};
broadcastActive(0);
stopLrc('cleared');
res.json({ ok: true });
});
// ── LRC 预设 API ──────────────────────────────────────────────────────────────
app.get('/api/lrc-presets', (req, res) => {
res.json(stores.lrcPresets.list());
});
app.get('/api/lrc-presets/:id', (req, res) => {
const preset = stores.lrcPresets.find(req.params.id);
if (!preset) return fail(res, 404, 'LRC 预设不存在');
res.json(preset);
});
app.post('/api/lrc-presets', (req, res) => {
try {
const body = req.body || {};
const preset = stores.lrcPresets.insert({
name: body.name,
source: body.source,
filters: body.filters,
range: body.range,
offsetMs: body.offsetMs,
tailMs: body.tailMs,
style: body.style,
});
res.json(preset);
} catch (err) {
fail(res, 400, err.message);
}
});
app.put('/api/lrc-presets/:id', (req, res) => {
const body = req.body || {};
try {
const updated = stores.lrcPresets.update(req.params.id,
pickDefined(body, ['name', 'source', 'filters', 'range', 'offsetMs', 'tailMs', 'style']));
if (!updated) return fail(res, 404, 'LRC 预设不存在');
res.json(updated);
} catch (err) {
fail(res, 400, err.message);
}
});
app.delete('/api/lrc-presets/:id', (req, res) => {
const removed = stores.lrcPresets.remove(req.params.id);
if (!removed) return fail(res, 404, 'LRC 预设不存在');
if (lrcPlayback && lrcPlayback.presetId === req.params.id) stopLrc('preset-deleted');
res.json({ ok: true });
});
/** 仅解析 / 预览,不保存 */
app.post('/api/lrc/parse', (req, res) => {
const body = req.body || {};
try {
const source = typeof body.source === 'string' ? body.source : '';
const filters = lrcLib.normalizeFilters(body.filters);
const requestedRange = lrcLib.normalizeRange(body.range);
const offsetMs = lrcLib.clampNumber(body.offsetMs, -60000, 60000, 0);
const tailMs = lrcLib.clampNumber(body.tailMs, 0, 60000, 4000);
const parsed = lrcLib.parseLrc(source);
const timeline = lrcLib.buildTimeline(parsed, {
filters,
range: requestedRange,
offsetMs,
tailMs,
});
res.json({
ok: true,
meta: parsed.meta,
metaOffsetMs: parsed.metaOffsetMs,
warnings: parsed.warnings,
filters,
requestedRange,
range: timeline.range,
stats: timeline.stats,
cues: timeline.cues,
candidates: timeline.candidates,
excluded: timeline.excluded.slice(0, 500),
totalMs: timeline.totalMs,
endMs: timeline.endMs,
offsetMs,
tailMs,
});
} catch (err) {
fail(res, 400, err.message);
}
});
/** 开始播放:打点后第一句立即出现,后续按 LRC 时间轴走 */
app.post('/api/lrc-presets/:id/play', (req, res) => {
const preset = stores.lrcPresets.find(req.params.id);
if (!preset) return fail(res, 404, 'LRC 预设不存在');
const body = req.body || {};
const leadInMs = lrcLib.clampNumber(body.leadInMs, 0, 60000, 0);
const overrides = body.overrides && typeof body.overrides === 'object' && !Array.isArray(body.overrides)
? body.overrides
: {};
try {
const built = buildTimelineForConfig(preset, overrides);
if (!built.timeline.cues.length) {
return fail(res, 400, '所选范围内没有可显示的字幕行,请检查 LRC 与范围设置');
}
const anchor = Date.now() + Math.round(leadInMs);
const startedAt = Date.now();
lrcPlayback = {
presetId: preset.id,
presetName: preset.name,
cues: built.timeline.cues,
style: built.style,
anchor,
paused: false,
pausedElapsed: 0,
totalMs: built.timeline.totalMs,
endMs: anchor + built.timeline.endMs,
tailMs: built.timeline.tailMs,
offsetMs: built.timeline.offsetMs,
startedAt,
leadInMs: Math.round(leadInMs),
};
scheduleLrcEnd();
broadcastLrc();
res.json({
ok: true,
state: getLrcStatePayload().state,
stats: built.timeline.stats,
totalMs: built.timeline.totalMs,
});
} catch (err) {
fail(res, 400, err.message);
}
});
app.post('/api/lrc/pause', (req, res) => {
if (!lrcPlayback) return fail(res, 409, '当前没有正在播放的 LRC 字幕');
if (lrcPlayback.paused) return res.json({ ok: true, state: getLrcStatePayload().state });
const elapsed = Math.max(0, Math.min(Date.now() - lrcPlayback.anchor, lrcPlayback.endMs - lrcPlayback.anchor));
lrcPlayback.pausedElapsed = elapsed;
lrcPlayback.paused = true;
clearLrcEndTimer();
broadcastLrc();
res.json({ ok: true, state: getLrcStatePayload().state });
});
app.post('/api/lrc/resume', (req, res) => {
if (!lrcPlayback) return fail(res, 409, '当前没有正在播放的 LRC 字幕');
if (!lrcPlayback.paused) return res.json({ ok: true, state: getLrcStatePayload().state });
const remaining = lrcPlayback.endMs - lrcPlayback.anchor;
const elapsed = Math.min(lrcPlayback.pausedElapsed, remaining);
lrcPlayback.anchor = Date.now() - elapsed;
lrcPlayback.endMs = lrcPlayback.anchor + remaining;
lrcPlayback.paused = false;
scheduleLrcEnd();
broadcastLrc();
res.json({ ok: true, state: getLrcStatePayload().state });
});
app.post('/api/lrc/stop', (req, res) => {
const stopped = stopLrc('stopped');
res.json({ ok: true, stopped });
});
app.get('/api/lrc/state', (req, res) => {
res.json(getLrcStatePayload().state);
});
app.get('/api/health', (req, res) => {
res.json({
ok: true,
uptimeSeconds: Math.round(process.uptime()),
dataDir: DATA_DIR,
presets: stores.appearancePresets.list().length,
contentPresets: stores.contentPresets.list().length,
lrcPresets: stores.lrcPresets.list().length,
});
});
// ── WebSocket ─────────────────────────────────────────────────────────────────
wss.on('connection', (ws) => {
ws.send(JSON.stringify(getActivePayload()));
ws.send(JSON.stringify(getLrcStatePayload()));
ws.on('message', (raw) => {
let message;
try {
message = JSON.parse(String(raw));
} catch (_) {
return;
}
if (!message || typeof message !== 'object') return;
// 客户端时钟校准:原样回传 t0,并附上服务器时间
if (message.type === 'clock') {
ws.send(JSON.stringify({ type: 'clock', t0: message.t0, serverNow: Date.now() }));
return;
}
if (message.type === 'state?') {
ws.send(JSON.stringify(getActivePayload()));
ws.send(JSON.stringify(getLrcStatePayload()));
}
});
});
// ── 404 / 错误处理 ───────────────────────────────────────────────────────────
app.use('/api', (req, res) => {
fail(res, 404, '接口不存在');
});
app.use((err, req, res, next) => {
console.error('[server]', err);
if (res.headersSent) return next(err);
const status = err.type === 'entity.too.large' ? 413 : 400;
fail(res, status, err.message || '服务器错误');
});
server.listen(PORT, () => {
console.log(`Server listening on http://localhost:${PORT}`);
console.log(`Data dir: ${DATA_DIR}`);
console.log('Admin UI: /admin.html, Management: /manage.html, Widget: /widget.html');
});
module.exports = { app, server, stores };