Skip to content

Make videos on the computer you already own. FreeVideo runs MiniMax H3 in as little as 8 GB of VRAM and 16 GB of RAM, and adapts its acceleration path to your hardware.

Guide how-tos: short walk-throughs over the real interface, started from Settings User guide

Bowen Xue2f1e84fd05c2
diff --git a/MANIFEST.in b/MANIFEST.in
index 2309e5f..04d51b0 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -6,6 +6,7 @@ recursive-include example_workflows *.json
recursive-include web *.js *.css
include web/vendor/three/LICENSE
recursive-include web/assets *.svg *.png *.webp
+recursive-include web/howto *.png
recursive-include web/fonts *.woff2
recursive-include freevideo_engine/assets *.png *.ico
recursive-include freevideo_engine/launcher *.qml
diff --git a/web/editor_references.js b/web/editor_references.js
index 9476cbf..9dbb790 100644
--- a/web/editor_references.js
+++ b/web/editor_references.js
@@ -20,7 +20,7 @@ export function createEditorReferences({t, source, size = () => null, error = ()
const add = el('button', 'fv-ed-ref-add'); add.type = 'button';
add.setAttribute('aria-haspopup', 'menu'); add.setAttribute('aria-expanded', 'false');
add.setAttribute('aria-label', t('Reference image', '参考图')); add.title = t('Reference image', '参考图');
- add.textContent = '+';
+ add.textContent = '+'; add.dataset.fvGuide = 'editor-refs';
const menu = el('div', 'fv-ed-ref-menu'); menu.hidden = true; menu.setAttribute('role', 'menu');
const picker = el('input'); picker.type = 'file'; picker.accept = 'image/*'; picker.multiple = true; picker.hidden = true;
root.append(add, chips, menu, picker);
diff --git a/web/first_run_guide.css b/web/first_run_guide.css
index 3865573..1c74a51 100644
--- a/web/first_run_guide.css
+++ b/web/first_run_guide.css
@@ -20,6 +20,8 @@
.fv-studio .fv-guide-bubble[data-side=below] .fv-guide-arrow{top:-7px;border-left:1px solid var(--fv-border);border-top:1px solid var(--fv-border)}
.fv-studio .fv-guide-wait{position:absolute;top:76px;right:24px;z-index:40;display:flex;align-items:center;gap:16px;max-width:calc(100% - 48px);padding:14px 18px;background:var(--fv-raised);border:1px solid var(--fv-border);border-radius:var(--fv-r-sm);box-shadow:0 8px 24px #0005}
.fv-studio .fv-guide-wait p{margin:0;font-size:14px;line-height:1.6}
+.fv-studio .fv-guide-bubble[data-side=center] .fv-guide-arrow{display:none}
+.fv-studio .fv-guide-picture{display:block;width:100%;height:auto;margin:0 0 14px;border-radius:8px;border:1px solid var(--fv-border)}
@media(prefers-reduced-motion:reduce){.fv-studio .fv-guide-layer *{transition:none!important;animation:none!important}}
.fv-studio .fv-entry-showcase{display:grid;place-items:center;pointer-events:auto;padding:24px;background:#0008;overflow:auto}
diff --git a/web/first_run_guide.js b/web/first_run_guide.js
index c4aa3b8..85affe1 100644
--- a/web/first_run_guide.js
+++ b/web/first_run_guide.js
@@ -14,8 +14,6 @@ export const REPLAY_TEXT = {
unavailable: ['Open a creation workflow to view the guide.', '请先打开创作工作流,再查看指引。'],
manual: ['User guide', '使用说明'],
};
-// The written guide is in Chinese only, so only the Chinese interface links it.
-export const MANUAL_URL = 'https://github.com/FlashML-org/FreeVideo/blob/main/docs/zh-CN/%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md';
export const CHAPTERS = [
{id: 'describe', anchor: '[data-fv-guide="describe"]', added: false,
@@ -120,6 +118,13 @@ export function showGuide({all = true} = {}) {
return (all ? current?.replay() : current?.show()) || Promise.resolve(false);
}
+// A how-to is a short list of steps played over the live interface. The same layer, ring and bubble as the guide are used,
+// nothing is recorded, and a step whose control is not on screen shows its picture instead of a ring.
+export function showHowTo(steps) {
+ current = [...document.querySelectorAll('dialog[open]')].map(dialog => guides.get(dialog)).filter(Boolean).at(-1) || current;
+ return current?.tour(steps) || Promise.resolve(false);
+}
+
const el = (tag, text, cls) => { const e = document.createElement(tag); if (text != null) e.textContent = text; if (cls) e.className = cls; return e; };
const visible = e => {
if (!e?.isConnected || e.closest('[hidden], [inert]') || !e.getClientRects().length) return false;
@@ -131,18 +136,42 @@ const visible = e => {
};
const clamp = (n, low, high) => Math.max(low, Math.min(high, n));
+// The tutorial book's "walk me through it" buttons call this; the how-tos load only when one is asked for.
+if (typeof window !== 'undefined') window.freevideoHowTo = {start: id => import('./howto.js').then(({startHowTo}) => startHowTo(id)),
+ available: id => import('./howto.js').then(({howToAvailable}) => howToAvailable(id))};
+
export function createGuideReplayEntry({dialog, cn, openWorkspace, replay = showGuide}) {
const text = key => REPLAY_TEXT[key][cn ? 1 : 0];
const section = el('section', null, 'fv-guide-replay'), row = el('div', null, 'fv-guide-replay-row');
const button = el('button', text('again')); button.type = 'button';
const status = el('div', null, 'fv-muted'); status.setAttribute('role', 'status'); status.hidden = true;
const actions = el('div', null, 'fv-guide-replay-actions');
- if (cn) {
- const manual = el('a', text('manual')); manual.href = MANUAL_URL; manual.target = '_blank'; manual.rel = 'noopener noreferrer';
- actions.append(manual);
- }
- actions.append(button);
- row.append(el('h3', text('title')), actions); section.append(row, status);
+ // "User guide" lists a few how-tos; choosing one plays it over the real interface.
+ const manual = el('button', text('manual')); manual.type = 'button'; manual.setAttribute('aria-haspopup', 'menu'); manual.setAttribute('aria-expanded', 'false');
+ const menu = el('div', null, 'fv-guide-howtos'); menu.setAttribute('role', 'menu'); menu.hidden = true;
+ const closeMenu = () => { menu.hidden = true; manual.setAttribute('aria-expanded', 'false'); };
+ manual.onclick = async () => {
+ if (!menu.hidden) { closeMenu(); return; }
+ try {
+ const {availableHowToList, startHowTo} = await import('./howto.js');
+ menu.replaceChildren(...(await availableHowToList(cn)).map(item => {
+ const choice = el('button', item.title); choice.type = 'button'; choice.setAttribute('role', 'menuitem');
+ choice.onclick = async () => {
+ closeMenu();
+ try {
+ if (!await openWorkspace()) { status.textContent = text('unavailable'); status.hidden = false; return; }
+ await new Promise(resolve => { dialog.addEventListener('close', resolve, {once: true}); dialog.close(); });
+ await startHowTo(item.id, {openWorkspace});
+ } catch { status.textContent = text('unavailable'); status.hidden = false; }
+ };
+ return choice;
+ }));
+ menu.hidden = false; manual.setAttribute('aria-expanded', 'true');
+ } catch { status.textContent = text('unavailable'); status.hidden = false; }
+ };
+ section.addEventListener('keydown', event => { if (event.key === 'Escape' && !menu.hidden) { event.stopPropagation(); closeMenu(); manual.focus(); } });
+ actions.append(manual, button);
+ row.append(el('h3', text('title')), actions); section.append(row, menu, status);
button.onclick = async () => {
button.disabled = true;
try {
@@ -162,6 +191,7 @@ export function createGuideReplayEntry({dialog, cn, openWorkspace, replay = show
// Custom targets return viewport rectangles on every layout pass. They never
// insert hit targets or change the editor's pointer handling.
export function guideTarget(dialog, chapter, targets = {}) {
+ if (chapter.target) return chapter.target(dialog);
if (targets[chapter.id]) return targets[chapter.id]();
const nodes = (chapter.anchors || [chapter.anchor]).map(selector => dialog.querySelector(selector));
if (nodes.some(node => !visible(node))) return null;
@@ -182,7 +212,7 @@ export function createFirstRunGuide({dialog, api, cn, isBusy = () => false, grou
let disposed = false, touched = false, stopped = false, layer = null, bubble = null, ring = null, arrow = null;
let steps = [], index = 0, record = null, manual = false, restoreFocus = null, pollTimer = null, frame = null;
let serverBlocked = false, checking = false, preparing = false;
- let waiting = null, replayTimer = null;
+ let waiting = null, replayTimer = null, touring = false;
let showcase = null;
const heldKeys = new Set();
const target = chapter => dialog.querySelector(chapter.anchor);
@@ -191,6 +221,7 @@ export function createFirstRunGuide({dialog, api, cn, isBusy = () => false, grou
return value && visible(value.node) && value.rect.width > 0 && value.rect.height > 0 ? value : null;
};
const available = () => chapters.filter(c => resolved(c)).map(c => c.id);
+ const shown = step => resolved(step) || (step.image && touring);
function blocked() {
return !dialog.open || !dialog.isConnected || dialog.inert || serverBlocked || isBusy()
// Create stays open underneath Edit. It is an inactive workspace,
@@ -217,7 +248,7 @@ export function createFirstRunGuide({dialog, api, cn, isBusy = () => false, grou
layer?.remove(); layer = bubble = ring = arrow = null;
if (restore && focused && restoreFocus?.isConnected) restoreFocus.focus({preventScroll: true});
}
- function interrupt() { if (automatic && dialog.open) attempted.add(group); stopped = true; clearTimeout(pollTimer); hide(); }
+ function interrupt() { if (automatic && dialog.open) attempted.add(group); stopped = true; touring = false; clearTimeout(pollTimer); hide(); }
function remember() {
if (manual) return;
// Empty projects acknowledge the optional trim chapter too, so importing
@@ -226,13 +257,23 @@ export function createFirstRunGuide({dialog, api, cn, isBusy = () => false, grou
// A failed write stays quiet. This page's single attempt is already used.
saveGuideRecord(api, record).then(ok => { if (!ok && !disposed) interrupt(); });
}
- function finish() { remember(); stopped = true; clearTimeout(pollTimer); hide(); }
+ function finish() { remember(); stopped = true; touring = false; clearTimeout(pollTimer); hide(); }
function position() {
if (!layer) return;
if (blocked()) { interrupt(); return; }
if (showcase) return; // The entry card is centered with CSS at every size.
let value = resolved(steps[index]);
if (value?.reveal) { value.reveal(); value = resolved(steps[index]); }
+ if (!value && steps[index].image && touring) {
+ // No control to point at: the picture stands in for it, in the middle of the window.
+ const frame = dialog.getBoundingClientRect(), wide = Math.min(440, frame.width - 48);
+ ring.hidden = arrow.hidden = true; bubble.style.width = `${wide}px`;
+ const box = bubble.getBoundingClientRect();
+ Object.assign(bubble.style, {left: `${clamp(frame.left + (frame.width - box.width) / 2, 12, innerWidth - box.width - 12)}px`,
+ top: `${clamp(frame.top + (frame.height - box.height) / 2, 12, innerHeight - box.height - 12)}px`});
+ bubble.dataset.side = 'center';
+ return;
+ }
if (!value) {
steps.splice(index, 1);
if (!steps.length) interrupt();
@@ -253,14 +294,16 @@ export function createFirstRunGuide({dialog, api, cn, isBusy = () => false, grou
const below = {side: 'below', x, y: r.bottom + 24}, above = {side: 'above', x, y: r.top - b.height - 24};
const narrow = innerWidth <= 680;
const candidates = editor
- ? [{...above, x: steps[index].id === 'editor-describe' ? clamp(r.left, xmin, xmax - b.width) : x}]
+ ? steps[index].id === 'editor-refs' && narrow ? [below, above] // the description box stays in view
+ : [{...above, x: steps[index].id === 'editor-describe' ? clamp(r.left, xmin, xmax - b.width) : x}]
: steps[index].id === 'longer'
? [{side: 'below', x: clamp(r.right - b.width, xmin, xmax - b.width), y: r.bottom + 24}, above, below]
: narrow ? [{side: 'below', x, y: ymax - b.height}, above, below]
: [{side: 'right', x: r.right + 24, y}, {side: 'left', x: r.left - b.width - 24, y}, below, above];
const fits = c => c.x >= xmin && c.y >= ymin && c.x + b.width <= xmax + .5 && c.y + b.height <= ymax + .5
&& !(c.x < r.right + 8 && c.x + b.width > r.left - 8 && c.y < r.bottom + 8 && c.y + b.height > r.top - 8);
- const place = candidates.find(fits);
+ // A how-to's ring may be a whole section; with no clear spot the bubble sits over its lower part rather than ending the walk-through.
+ const place = candidates.find(fits) || (touring && !editor ? candidates[0] : null);
if (!place) { interrupt(); return; }
const style = getComputedStyle(node);
const pad = editor ? 0 : 4;
@@ -288,13 +331,17 @@ export function createFirstRunGuide({dialog, api, cn, isBusy = () => false, grou
if (layer) { bubble.focus({preventScroll: true}); remember(); }
return;
}
+ if (touring) try { steps[index]?.prepare?.(dialog); } catch { /* the step then falls back to its picture */ }
resolved(steps[index])?.reveal?.();
- while (steps[index] && !resolved(steps[index])) steps.splice(index, 1);
+ while (steps[index] && !shown(steps[index])) steps.splice(index, 1);
if (!steps[index]) { interrupt(); return; }
- const {node, rect: r} = resolved(steps[index]), bounds = dialog.getBoundingClientRect();
- const clip = node.closest('.fv-controls, .fv-preview-column')?.getBoundingClientRect() || bounds;
- if (!editor && (innerWidth <= 680 || r.top < clip.top + 8 || r.bottom > clip.bottom - 8))
- node.scrollIntoView({block: 'center', inline: 'nearest', behavior: 'instant'});
+ const found = resolved(steps[index]), bounds = dialog.getBoundingClientRect();
+ if (found) {
+ const {node, rect: r} = found;
+ const clip = node.closest('.fv-controls, .fv-preview-column')?.getBoundingClientRect() || bounds;
+ if (!editor && (innerWidth <= 680 || r.top < clip.top + 8 || r.bottom > clip.bottom - 8))
+ node.scrollIntoView({block: 'center', inline: 'nearest', behavior: 'instant'});
+ }
layer = el('div', null, 'fv-guide-layer'); layer.dataset.chapter = steps[index].id; layer.dataset.group = group;
ring = el('div', null, 'fv-guide-ring'); ring.setAttribute('aria-hidden', 'true');
bubble = el('div', null, 'fv-guide-bubble'); bubble.setAttribute('role', 'dialog'); bubble.setAttribute('aria-modal', 'false');
@@ -310,8 +357,12 @@ export function createFirstRunGuide({dialog, api, cn, isBusy = () => false, grou
const next = el('button', index === steps.length - 1 ? t('Got it', '知道了') : t('Next', '下一步'), 'fv-guide-next');
next.type = 'button'; next.onclick = () => { if (index === steps.length - 1) finish(); else { remember(); index++; draw(); } };
actions.append(next); footer.append(dots, actions); arrow = el('span', null, 'fv-guide-arrow'); arrow.setAttribute('aria-hidden', 'true');
+ if (!found && steps[index].image) {
+ const picture = el('img', null, 'fv-guide-picture'); picture.alt = ''; picture.src = new URL('./howto/' + steps[index].image + (cn ? '-zh' : '-en') + '.png', import.meta.url).href;
+ picture.onerror = () => { picture.remove(); follow(); }; picture.onload = follow; bubble.prepend(picture);
+ }
bubble.append(message, footer, arrow); layer.append(ring, bubble); dialog.append(layer);
- resizeObserver.disconnect(); resizeObserver.observe(node); resizeObserver.observe(dialog);
+ resizeObserver.disconnect(); if (found) resizeObserver.observe(found.node); resizeObserver.observe(dialog);
position(); if (layer) next.focus({preventScroll: true});
}
async function poll() {
@@ -378,13 +429,23 @@ export function createFirstRunGuide({dialog, api, cn, isBusy = () => false, grou
await retryReplay();
return true;
}
+ async function tour(list) {
+ if (disposed || !dialog.open) return false;
+ attempted.add(group); clearTimeout(startTimer); interrupt(); cancelReplay();
+ stopped = false; serverBlocked = false; manual = true; touring = true; record = null;
+ steps = list.map(step => ({...step})); index = 0; restoreFocus = document.activeElement;
+ draw();
+ return Boolean(layer);
+ }
const touch = event => {
- if (!dialog.contains(event.target) || layer?.contains(event.target)) return;
+ if (touring || !dialog.contains(event.target) || layer?.contains(event.target)) return;
if (automatic) attempted.add(group);
touched = true;
if (layer) finish(); else stopped = true;
};
const key = event => {
+ // While a how-to plays the person types and clicks as asked; only Escape belongs to the bubble.
+ if (layer && touring && event.key !== 'Escape' && !bubble.contains(event.target)) return;
if (layer) {
heldKeys.add(event.key); event.stopImmediatePropagation();
if (event.key === 'Escape' || event.key === 'Enter') {
@@ -426,7 +487,7 @@ export function createFirstRunGuide({dialog, api, cn, isBusy = () => false, grou
// The editor can be opened with a bare request helper that has no events.
const events = api?.addEventListener && api.removeEventListener;
if (events) { api.addEventListener('status', status); api.addEventListener('execution_start', execution); }
- const handle = {show, replay, suspend() { cancelReplay(); interrupt(); },
+ const handle = {show, replay, tour, suspend() { cancelReplay(); interrupt(); },
handleKey(event) {
if (!['keydown', 'keypress', 'keyup'].includes(event.type)) return false;
const handled = !!layer || heldKeys.has(event.key);
diff --git a/web/howto.js b/web/howto.js
new file mode 100644
index 0000000..b4ca7ad
--- /dev/null
+++ b/web/howto.js
@@ -0,0 +1,79 @@
+import {showHowTo} from './first_run_guide.js';
+
+// Short walk-throughs played over the live interface (the same ring and bubble as the first-run guide).
+// A step names its control; when that control is not on screen (nothing generated yet, say) `image` stands in for it.
+const shown = node => Boolean(node?.isConnected && node.getClientRects().length);
+
+// The whole Media section, from its title to the last line, and it is opened if it was folded.
+const mediaSection = dialog => {
+ const title = dialog.querySelector('[data-fv-guide="media"]'), details = title?.closest('details');
+ if (!details || !shown(details)) return null;
+ const r = details.getBoundingClientRect();
+ return {node: details, rect: {left: r.left, top: r.top, right: r.right, bottom: r.bottom, width: r.width, height: r.height}, reveal: () => { details.open = true; }};
+};
+// Only the part on the timeline: the selected clip or range, else the first part.
+const selectedPart = dialog => {
+ const find = selector => [...dialog.querySelectorAll(selector)].filter(shown)[0];
+ const node = find('.fv-ed-clip[aria-selected="true"]') || find('[data-fv-guide="editor-timeline"] .fv-ed-selection') || find('.fv-ed-clip');
+ if (!node) return null;
+ const r = node.getBoundingClientRect();
+ return {node, rect: {left: r.left, top: r.top, right: r.right, bottom: r.bottom, width: r.width, height: r.height}};
+};
+const HOWTOS = [
+ {id: 'reference-video', view: 'studio', title: ['Make a video from reference images', '参考图生成视频'],
+ steps: [
+ {id: 'media', target: mediaSection, en: 'Add images here and set each one as a reference, first frame, or last frame.',
+ zh: '在这里添加图片,每张可选作参\u2060考、首\u2060帧或尾\u2060帧。'},
+ {id: 'describe', anchor: '[data-fv-guide="describe"]', en: 'Type @ in the prompt and choose an image, then say what it does in the scene.',
+ zh: '在描述里输入 @ 选一张图,并说明它在画面里做什么。'},
+ {id: 'generate', anchor: '[data-fv-guide="generate"]', en: 'Choose "Generate video".', zh: '点“生成视频”。'}]},
+ {id: 'long-video', view: 'studio', needsParts: true, title: ['Make a longer video', '连续的长视频'],
+ steps: [
+ {id: 'seconds', anchor: '[data-fv-guide="seconds"]', en: 'Enter a longer duration. It is made in parts automatically.',
+ zh: '把时长填长一些,会自动分段生成。'},
+ {id: 'generate', anchor: '[data-fv-guide="generate"]', en: 'Choose "Generate video".', zh: '点“生成视频”。'},
+ {id: 'extend', anchor: '.fv-action-extend', image: 'extend-button',
+ en: 'To carry on from a finished video, click "Extend" on its result.', zh: '想接着做下去,在生成好的视频上点“接着生成”。'},
+ {id: 'longer', anchor: '[data-view="editor"]', en: 'Or add parts one by one in "Edit".', zh: '也可以到“剪辑视图”里一段段接。'}]},
+ {id: 'editor-extend-refs', view: 'editor', title: ['Add reference images when extending in Edit', '在剪辑视图延长时加参考图'],
+ steps: [
+ {id: 'editor-timeline', target: selectedPart, en: 'Select the part to continue.', zh: '选中要接着生成的那一段。'},
+ {id: 'editor-refs', anchor: '[data-fv-guide="editor-refs"]', image: 'editor-refs',
+ en: 'Click + next to the prompt to upload or generate images, up to 3.', zh: '点描述框旁的 +,上传或生成图片,最多 3 张。'},
+ {id: 'editor-describe', anchor: '[data-fv-guide="editor-describe"]', en: 'Describe it, then choose "Generate".', zh: '写一句描述,再点“生成”。'}]},
+];
+
+export const howToList = cn => HOWTOS.map(({id, title}) => ({id, title: title[cn ? 1 : 0]}));
+
+// Devices that cannot make longer videos in parts have no Extend button, so that how-to is not offered.
+// An unreadable answer keeps it, as the length field's own line does.
+async function canMakeParts() {
+ try {
+ const {api} = await import('../../scripts/api.js');
+ const reply = await api.fetchApi('/freevideo/chains');
+ return !(reply?.ok && (await reply.json())?.continuation === false);
+ } catch { return true; }
+}
+export async function howToAvailable(id) {
+ const howTo = HOWTOS.find(item => item.id === id);
+ return Boolean(howTo) && (!howTo.needsParts || await canMakeParts());
+}
+export async function availableHowToList(cn) {
+ const parts = await canMakeParts();
+ return HOWTOS.filter(item => parts || !item.needsParts).map(({id, title}) => ({id, title: title[cn ? 1 : 0]}));
+}
+
+const wait = ms => new Promise(resolve => setTimeout(resolve, ms));
+
+// Plays one how-to. The editor ones open the Edit view first; the others open the creation panel.
+export async function startHowTo(id, {openWorkspace = async () => (await import('./view_navigation.js')).openCreativeWorkspace()} = {}) {
+ const howTo = HOWTOS.find(item => item.id === id);
+ if (!howTo || !await howToAvailable(id) || !await openWorkspace()) return false;
+ if (howTo.view === 'editor') {
+ document.querySelector('dialog.fv-studio [data-view="editor"]')?.click();
+ for (let i = 0; i < 40 && !document.querySelector('dialog.fv-editor[open]'); i++) await wait(100);
+ }
+ await document.fonts.ready;
+ await wait(250);
+ return showHowTo(howTo.steps);
+}
diff --git a/web/howto/editor-refs-en.png b/web/howto/editor-refs-en.png
new file mode 100644
index 0000000..fc0fee0
Binary files /dev/null and b/web/howto/editor-refs-en.png differ
diff --git a/web/howto/editor-refs-zh.png b/web/howto/editor-refs-zh.png
new file mode 100644
index 0000000..535d3dc
Binary files /dev/null and b/web/howto/editor-refs-zh.png differ
diff --git a/web/howto/extend-button-en.png b/web/howto/extend-button-en.png
new file mode 100644
index 0000000..cbb4f62
Binary files /dev/null and b/web/howto/extend-button-en.png differ
diff --git a/web/howto/extend-button-zh.png b/web/howto/extend-button-zh.png
new file mode 100644
index 0000000..406990b
Binary files /dev/null and b/web/howto/extend-button-zh.png differ
diff --git a/web/setup.css b/web/setup.css
index 6f30a70..2fff248 100644
--- a/web/setup.css
+++ b/web/setup.css
@@ -24,6 +24,9 @@
.fv-setup .fv-guide-replay-row{display:flex;align-items:center;justify-content:space-between;gap:16px}
.fv-setup .fv-guide-replay-row h3{margin:0}
.fv-setup .fv-guide-replay-actions{display:flex;align-items:center;gap:16px}
+.fv-setup .fv-guide-howtos{display:flex;flex-direction:column;align-items:stretch;gap:4px;margin-top:10px;width:100%}
+.fv-setup .fv-guide-howtos [role=menuitem]{width:100%;justify-content:flex-start;text-align:left}
+.fv-setup .fv-guide-howtos[hidden]{display:none}
.fv-setup .fv-guide-replay [role=status]{margin-top:8px}
/* Sections: one card each; details use the Studio's chevron, not the UA marker. */
diff --git a/web/studio.js b/web/studio.js
index 33aaacd..1174493 100644
--- a/web/studio.js
+++ b/web/studio.js
@@ -739,7 +739,7 @@ export function openStudio(node, {extendFrom = null} = {}) {
resolutionSelect.append(mp, resolutionValue, icon('chevron'));
const legacyOption = [...mp.options].find(o => Number(o.value) === 1);
mp.disabled = dimensionsLinked;
- const seconds = el('input'); seconds.type = 'number'; seconds.required = true; seconds.min = '1.625'; seconds.step = 'any'; seconds.value = savedSeconds(node, value(node, 'seconds')); seconds.disabled = linked(node, 'seconds'); seconds.setAttribute('aria-label', t('Duration in seconds', '时长(秒)'));
+ const seconds = el('input'); seconds.type = 'number'; seconds.required = true; seconds.min = '1.625'; seconds.step = 'any'; seconds.value = savedSeconds(node, value(node, 'seconds')); seconds.disabled = linked(node, 'seconds'); seconds.setAttribute('aria-label', t('Duration in seconds', '时长(秒)')); seconds.dataset.fvGuide = 'seconds';
const fields = el('div', null, 'fv-fields'); fields.append(field(t('Resolution', '清晰度'), resolutionSelect), field(t('Duration · seconds', '时长 · 秒'), seconds)); canvas.append(fields);
const canvasNote = el('div', null, 'fv-canvas-note'), dimensions = el('span'), duration = el('span'); canvasNote.append(dimensions, duration); canvas.append(canvasNote);
const rangeMount = el('div'); canvas.append(rangeMount);