diff --git a/admin.html b/admin.html index ba80435..b776581 100644 --- a/admin.html +++ b/admin.html @@ -58,6 +58,16 @@ +
+
+

字幕时间校准

+

先编辑一个已有素材,再整体提前或延后字幕。

+
+
+ + +
+
diff --git a/admin.js b/admin.js index 01f01bd..6fa2857 100644 --- a/admin.js +++ b/admin.js @@ -22,6 +22,9 @@ const els = { aiReport: IS_BROWSER ? document.querySelector("#aiSubtitleReport") : null, testAiBtn: IS_BROWSER ? document.querySelector("#testAiBtn") : null, processAiSubtitlesBtn: IS_BROWSER ? document.querySelector("#processAiSubtitlesBtn") : null, + subtitleShiftStatus: IS_BROWSER ? document.querySelector("#subtitleShiftStatus") : null, + shiftSubtitleEarlierBtn: IS_BROWSER ? document.querySelector("#shiftSubtitleEarlierBtn") : null, + shiftSubtitleLaterBtn: IS_BROWSER ? document.querySelector("#shiftSubtitleLaterBtn") : null, refreshBtn: IS_BROWSER ? document.querySelector("#refreshVideosBtn") : null, message: IS_BROWSER ? document.querySelector("#adminMessage") : null, videoList: IS_BROWSER ? document.querySelector("#adminVideoList") : null, @@ -88,6 +91,8 @@ function initializeAdmin() { els.cancelEditBtn.addEventListener("click", resetFormMode); els.testAiBtn?.addEventListener("click", testAiConnection); els.processAiSubtitlesBtn?.addEventListener("click", processAiSubtitles); + els.shiftSubtitleEarlierBtn?.addEventListener("click", () => shiftEditableSubtitles(-0.5)); + els.shiftSubtitleLaterBtn?.addEventListener("click", () => shiftEditableSubtitles(0.5)); bindFileInputs(); loadAiStatus(); loadVideos(); @@ -320,6 +325,7 @@ function startEditingVideo(video) { renderSubtitleEditor(); renderVideos(); loadAiStatus(); + updateSubtitleShiftControls(); } function resetFormMode() { @@ -335,6 +341,7 @@ function resetFormMode() { renderSubtitleEditor(); renderVideos(); loadAiStatus(); + updateSubtitleShiftControls(); } function pickVideoAfterSave(videoList, response, previousEditingVideo) { @@ -411,6 +418,8 @@ if (typeof module !== "undefined" && module.exports) { buildWebVtt, getAiSubtitleButtonState, pickVideoAfterSave, + shiftCueTimeRange, + shiftSubtitleCues, }; } @@ -511,6 +520,82 @@ function hasSubtitleText(textRows) { .trim().length > 0; } +function shiftEditableSubtitles(offsetSeconds) { + const tracks = [editableSubtitles.en, editableSubtitles.zh].filter(Boolean); + if (!editingVideo || !tracks.length) { + showMessage("请先编辑一个带字幕的素材。", true); + return; + } + + tracks.forEach((track) => { + track.cues = shiftSubtitleCues(track.cues, offsetSeconds); + track.dirty = true; + }); + renderSubtitleEditor(); + updateSubtitleShiftControls(offsetSeconds); +} + +function updateSubtitleShiftControls(lastOffset = 0) { + const hasEditableCues = Boolean(editingVideo && [editableSubtitles.en, editableSubtitles.zh] + .filter(Boolean) + .some((track) => track.cues.length)); + [els.shiftSubtitleEarlierBtn, els.shiftSubtitleLaterBtn].forEach((button) => { + if (button) button.disabled = !hasEditableCues; + }); + if (!els.subtitleShiftStatus) return; + + if (!editingVideo) { + els.subtitleShiftStatus.textContent = "先编辑一个已有素材,再整体提前或延后字幕。"; + return; + } + if (!hasEditableCues) { + els.subtitleShiftStatus.textContent = "当前素材没有可校准的字幕。"; + return; + } + if (lastOffset > 0) { + els.subtitleShiftStatus.textContent = `字幕已整体延后 ${lastOffset.toFixed(1)} 秒,点“保存修改”生效。`; + return; + } + if (lastOffset < 0) { + els.subtitleShiftStatus.textContent = `字幕已整体提前 ${Math.abs(lastOffset).toFixed(1)} 秒,点“保存修改”生效。`; + return; + } + els.subtitleShiftStatus.textContent = "如果字幕太早,点 +0.5 秒;如果字幕太晚,点 -0.5 秒。"; +} + +function shiftSubtitleCues(cues, offsetSeconds) { + return cues.map((cue) => ({ + ...cue, + timeRange: shiftCueTimeRange(cue.timeRange, offsetSeconds), + })); +} + +function shiftCueTimeRange(timeRange, offsetSeconds) { + const [startRaw, endRaw] = String(timeRange).split("-->").map((part) => part.trim()); + return `${formatVttTimestamp(parseVttTimestamp(startRaw) + offsetSeconds)} --> ${formatVttTimestamp(parseVttTimestamp(endRaw) + offsetSeconds)}`; +} + +function parseVttTimestamp(value) { + const clean = String(value).replace(",", ".").split(/\s+/)[0]; + const parts = clean.split(":").map(Number); + if (parts.length === 3) return parts[0] * 3600 + parts[1] * 60 + parts[2]; + if (parts.length === 2) return parts[0] * 60 + parts[1]; + return Number(clean) || 0; +} + +function formatVttTimestamp(seconds) { + const totalMilliseconds = Math.max(0, Math.round((Number(seconds) || 0) * 1000)); + const hours = Math.floor(totalMilliseconds / 3600000); + const minutes = Math.floor((totalMilliseconds % 3600000) / 60000); + const wholeSeconds = Math.floor((totalMilliseconds % 60000) / 1000); + const milliseconds = totalMilliseconds % 1000; + return [ + String(hours).padStart(2, "0"), + String(minutes).padStart(2, "0"), + String(wholeSeconds).padStart(2, "0"), + ].join(":") + `.${String(milliseconds).padStart(3, "0")}`; +} + function renderSubtitleEditor() { if (!els.subtitleEditor) return; els.subtitleEditor.innerHTML = ""; @@ -561,8 +646,9 @@ function renderSubtitleEditor() { }); } - els.subtitleEditor.appendChild(section); + els.subtitleEditor.appendChild(section); }); + updateSubtitleShiftControls(); } function appendEditedSubtitleContent(formData) { diff --git a/styles.css b/styles.css index d38ef41..0f83ca7 100644 --- a/styles.css +++ b/styles.css @@ -719,7 +719,8 @@ video { gap: 12px; } -.admin-ai-panel { +.admin-ai-panel, +.admin-subtitle-shift { display: grid; gap: 10px; padding: 12px; @@ -729,21 +730,26 @@ video { } .admin-ai-panel h3, -.admin-ai-panel p { +.admin-ai-panel p, +.admin-subtitle-shift h3, +.admin-subtitle-shift p { margin: 0; } -.admin-ai-panel h3 { +.admin-ai-panel h3, +.admin-subtitle-shift h3 { font-size: 14px; } -.admin-ai-panel p { +.admin-ai-panel p, +.admin-subtitle-shift p { color: var(--muted); font-size: 13px; line-height: 1.45; } -.admin-ai-actions { +.admin-ai-actions, +.admin-shift-actions { display: flex; flex-wrap: wrap; gap: 8px; diff --git a/tests/admin-subtitle-editor.test.mjs b/tests/admin-subtitle-editor.test.mjs index 38c43fb..11e088b 100644 --- a/tests/admin-subtitle-editor.test.mjs +++ b/tests/admin-subtitle-editor.test.mjs @@ -1,5 +1,7 @@ import assert from "node:assert/strict"; -import { buildWebVtt, parseSubtitleBlocks } from "../admin.js"; +import adminHelpers from "../admin.js"; + +const { buildWebVtt, parseSubtitleBlocks, shiftCueTimeRange, shiftSubtitleCues } = adminHelpers; const cues = parseSubtitleBlocks(`WEBVTT @@ -38,3 +40,19 @@ assert.equal(buildWebVtt(cues), `WEBVTT Second line continued `); + +assert.equal( + shiftCueTimeRange("00:00:00.200 --> 00:00:01.200", -0.5), + "00:00:00.000 --> 00:00:00.700", +); + +assert.equal( + shiftCueTimeRange("00:00:04.000 --> 00:00:08.000", 0.5), + "00:00:04.500 --> 00:00:08.500", +); + +const shifted = shiftSubtitleCues([ + { timeRange: "00:00:04.000 --> 00:00:08.000", text: "Second line" }, +], 1.25); +assert.equal(shifted[0].timeRange, "00:00:05.250 --> 00:00:09.250"); +assert.equal(shifted[0].text, "Second line");