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");