'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 };