feat: add manual subtitle timing shift

This commit is contained in:
TTlaji committed 2026-06-03 14:15:11 +08:00
1 parent ae4791143c
commit b66034c8a9
4 files changed
+127 -7

No files matched your search

+10
View File
@@ -58,6 +58,16 @@
</div>
<p id="aiSubtitleReport" class="admin-ai-report" hidden></p>
</section>
<section class="admin-subtitle-shift">
<div>
<h3>字幕时间校准</h3>
<p id="subtitleShiftStatus">先编辑一个已有素材,再整体提前或延后字幕。</p>
</div>
<div class="admin-shift-actions">
<button id="shiftSubtitleEarlierBtn" class="secondary-action" type="button" disabled>字幕 -0.5 秒</button>
<button id="shiftSubtitleLaterBtn" class="secondary-action" type="button" disabled>字幕 +0.5 秒</button>
</div>
</section>
<div id="adminSubtitleEditor" class="admin-subtitle-editor" hidden></div>
<button id="adminSubmitBtn" type="submit">添加到视频库</button>
</form>
+87 -1
View File
@@ -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) {
+11 -5
View File
@@ -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;
+19 -1
View File
@@ -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");