955 lines
46 KiB
HTML
955 lines
46 KiB
HTML
<!doctype html>
|
||
<html lang="zh-CN" data-theme="dark">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
<meta name="description" content="Nex Animation Studio 长视频编导平台图文使用手册">
|
||
<title>Nex Animation Studio · 使用手册</title>
|
||
<style>
|
||
:root {
|
||
color-scheme: dark;
|
||
--bg: #091016;
|
||
--bg-soft: #0f1820;
|
||
--panel: #131e27;
|
||
--panel-2: #17242e;
|
||
--line: #2a3a46;
|
||
--line-soft: #21303a;
|
||
--text: #edf3f5;
|
||
--muted: #91a1ac;
|
||
--green: #b8f35b;
|
||
--green-soft: #263c20;
|
||
--blue: #83c9f4;
|
||
--orange: #f2bd74;
|
||
--danger: #ff857c;
|
||
--radius: 14px;
|
||
--sidebar: 250px;
|
||
}
|
||
|
||
:root[data-theme="light"] {
|
||
color-scheme: light;
|
||
--bg: #f2f6fa;
|
||
--bg-soft: #e9eff5;
|
||
--panel: #ffffff;
|
||
--panel-2: #f7f9fc;
|
||
--line: #cbd6e1;
|
||
--line-soft: #dce5ee;
|
||
--text: #18232d;
|
||
--muted: #5d6d7b;
|
||
--green: #416600;
|
||
--green-soft: #edf5dd;
|
||
--blue: #176a95;
|
||
--orange: #8c5700;
|
||
--danger: #b42f29;
|
||
}
|
||
|
||
* { box-sizing: border-box; }
|
||
html { scroll-behavior: smooth; }
|
||
body {
|
||
margin: 0;
|
||
background:
|
||
radial-gradient(circle at 88% -8%, rgba(184, 243, 91, .08), transparent 34rem),
|
||
linear-gradient(180deg, #0b1219 0, var(--bg) 42rem);
|
||
color: var(--text);
|
||
font: 14px/1.75 -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC",
|
||
"Hiragino Sans GB", "Microsoft YaHei", sans-serif;
|
||
}
|
||
a { color: var(--green); text-decoration: none; }
|
||
a:hover { text-decoration: underline; }
|
||
code, kbd, pre {
|
||
font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace;
|
||
}
|
||
code {
|
||
padding: 2px 6px;
|
||
border: 1px solid var(--line-soft);
|
||
border-radius: 5px;
|
||
background: #0b141b;
|
||
color: #cce7ad;
|
||
font-size: .9em;
|
||
}
|
||
pre {
|
||
margin: 12px 0;
|
||
padding: 15px 17px;
|
||
overflow: auto;
|
||
border: 1px solid var(--line);
|
||
border-radius: 10px;
|
||
background: #0a1218;
|
||
color: #d5e1e7;
|
||
font-size: 12px;
|
||
line-height: 1.7;
|
||
}
|
||
pre code { padding: 0; border: 0; background: none; color: inherit; }
|
||
img { display: block; max-width: 100%; }
|
||
|
||
.layout {
|
||
display: grid;
|
||
grid-template-columns: var(--sidebar) minmax(0, 1fr);
|
||
min-height: 100vh;
|
||
}
|
||
aside {
|
||
position: sticky;
|
||
top: 0;
|
||
height: 100vh;
|
||
overflow: auto;
|
||
padding: 24px 18px;
|
||
border-right: 1px solid var(--line-soft);
|
||
background: rgba(8, 15, 21, .92);
|
||
backdrop-filter: blur(16px);
|
||
}
|
||
.brand {
|
||
display: flex;
|
||
align-items: center;
|
||
gap: 11px;
|
||
margin: 0 4px 24px;
|
||
}
|
||
.brand-mark {
|
||
display: grid;
|
||
width: 42px;
|
||
height: 42px;
|
||
place-items: center;
|
||
border-radius: 11px;
|
||
background: var(--green);
|
||
color: #10170b;
|
||
font-size: 22px;
|
||
font-weight: 900;
|
||
box-shadow: 0 0 24px rgba(184, 243, 91, .18);
|
||
}
|
||
.brand b { display: block; font-size: 14px; }
|
||
.brand small {
|
||
display: block;
|
||
margin-top: 2px;
|
||
color: var(--muted);
|
||
font-size: 9px;
|
||
letter-spacing: .12em;
|
||
}
|
||
.theme-toggle {
|
||
width: 100%;
|
||
margin: -12px 0 4px;
|
||
padding: 8px 10px;
|
||
border: 1px solid var(--line);
|
||
border-radius: 8px;
|
||
background: var(--panel);
|
||
color: var(--text);
|
||
font-family: inherit;
|
||
font-size: 11px;
|
||
font-weight: 600;
|
||
line-height: 1.4;
|
||
text-align: left;
|
||
}
|
||
.theme-toggle:hover { border-color: var(--green); }
|
||
.theme-toggle:focus-visible { outline: 2px solid var(--green); outline-offset: 2px; }
|
||
.toc-title {
|
||
margin: 22px 9px 8px;
|
||
color: #6f808b;
|
||
font-size: 10px;
|
||
font-weight: 700;
|
||
letter-spacing: .16em;
|
||
text-transform: uppercase;
|
||
}
|
||
nav a {
|
||
display: flex;
|
||
align-items: center;
|
||
gap: 9px;
|
||
padding: 8px 10px;
|
||
border-radius: 8px;
|
||
color: #aab8c1;
|
||
text-decoration: none;
|
||
font-size: 12px;
|
||
}
|
||
nav a:hover { background: #121e27; color: var(--text); text-decoration: none; }
|
||
nav a::before { content: "›"; color: #62737f; }
|
||
.side-links {
|
||
display: grid;
|
||
gap: 7px;
|
||
margin-top: 24px;
|
||
padding-top: 18px;
|
||
border-top: 1px solid var(--line-soft);
|
||
}
|
||
.side-links a {
|
||
padding: 9px 10px;
|
||
border: 1px solid var(--line);
|
||
border-radius: 8px;
|
||
background: #111c24;
|
||
font-size: 11px;
|
||
}
|
||
.side-links a:hover { border-color: #657f3e; text-decoration: none; }
|
||
|
||
main {
|
||
width: min(1200px, 100%);
|
||
padding: 42px clamp(24px, 5vw, 72px) 90px;
|
||
}
|
||
.hero {
|
||
position: relative;
|
||
overflow: hidden;
|
||
padding: 36px 38px;
|
||
border: 1px solid #33462e;
|
||
border-radius: 20px;
|
||
background:
|
||
radial-gradient(circle at 82% 10%, rgba(184, 243, 91, .16), transparent 21rem),
|
||
linear-gradient(130deg, #142019, #111b23 64%);
|
||
}
|
||
.hero::after {
|
||
position: absolute;
|
||
right: 26px;
|
||
bottom: -58px;
|
||
color: rgba(184, 243, 91, .05);
|
||
content: "N";
|
||
font-size: 250px;
|
||
font-weight: 900;
|
||
line-height: 1;
|
||
pointer-events: none;
|
||
}
|
||
.eyebrow {
|
||
margin: 0 0 9px;
|
||
color: var(--green);
|
||
font-size: 10px;
|
||
font-weight: 700;
|
||
letter-spacing: .18em;
|
||
text-transform: uppercase;
|
||
}
|
||
h1, h2, h3 { line-height: 1.35; }
|
||
h1 { margin: 0; font-size: clamp(30px, 4vw, 48px); letter-spacing: -.035em; }
|
||
h2 {
|
||
margin: 0 0 14px;
|
||
font-size: 23px;
|
||
letter-spacing: -.02em;
|
||
}
|
||
h3 { margin: 24px 0 9px; font-size: 16px; }
|
||
.hero > p {
|
||
position: relative;
|
||
z-index: 1;
|
||
max-width: 760px;
|
||
margin: 14px 0 20px;
|
||
color: #b4c1c7;
|
||
font-size: 14px;
|
||
}
|
||
.pills { position: relative; z-index: 1; display: flex; flex-wrap: wrap; gap: 8px; }
|
||
.pill {
|
||
padding: 5px 10px;
|
||
border: 1px solid #40533a;
|
||
border-radius: 999px;
|
||
background: rgba(30, 46, 30, .7);
|
||
color: #cce7ad;
|
||
font-size: 10px;
|
||
}
|
||
|
||
section {
|
||
scroll-margin-top: 24px;
|
||
margin-top: 46px;
|
||
}
|
||
.section-head {
|
||
display: flex;
|
||
align-items: flex-end;
|
||
justify-content: space-between;
|
||
gap: 20px;
|
||
margin-bottom: 18px;
|
||
padding-bottom: 13px;
|
||
border-bottom: 1px solid var(--line-soft);
|
||
}
|
||
.section-head p { max-width: 620px; margin: 0; color: var(--muted); font-size: 12px; }
|
||
.step-no {
|
||
color: var(--green);
|
||
font: 11px/1 "SFMono-Regular", Menlo, monospace;
|
||
letter-spacing: .12em;
|
||
}
|
||
.grid-2, .grid-3, .grid-4 {
|
||
display: grid;
|
||
gap: 13px;
|
||
}
|
||
.grid-2 { grid-template-columns: repeat(2, minmax(0, 1fr)); }
|
||
.grid-3 { grid-template-columns: repeat(3, minmax(0, 1fr)); }
|
||
.grid-4 { grid-template-columns: repeat(4, minmax(0, 1fr)); }
|
||
.card {
|
||
padding: 17px;
|
||
border: 1px solid var(--line);
|
||
border-radius: 11px;
|
||
background: linear-gradient(180deg, rgba(23, 36, 46, .9), rgba(15, 24, 32, .9));
|
||
}
|
||
.card b { display: block; margin-bottom: 6px; font-size: 13px; }
|
||
.card p { margin: 0; color: var(--muted); font-size: 11.5px; }
|
||
.card .icon {
|
||
display: grid;
|
||
width: 30px;
|
||
height: 30px;
|
||
margin-bottom: 11px;
|
||
place-items: center;
|
||
border: 1px solid #40533a;
|
||
border-radius: 8px;
|
||
background: #20301d;
|
||
color: var(--green);
|
||
font-size: 14px;
|
||
}
|
||
.callout {
|
||
margin: 16px 0;
|
||
padding: 13px 15px;
|
||
border-left: 3px solid var(--green);
|
||
border-radius: 0 8px 8px 0;
|
||
background: #142019;
|
||
color: #b9c8bd;
|
||
font-size: 12px;
|
||
}
|
||
.callout.warn {
|
||
border-color: var(--orange);
|
||
background: #241e15;
|
||
color: #d7c5a8;
|
||
}
|
||
.callout.info {
|
||
border-color: var(--blue);
|
||
background: #121f28;
|
||
color: #b9cfdb;
|
||
}
|
||
.flow {
|
||
display: grid;
|
||
grid-template-columns: repeat(6, minmax(0, 1fr));
|
||
gap: 7px;
|
||
margin: 20px 0;
|
||
}
|
||
.flow div {
|
||
position: relative;
|
||
min-height: 74px;
|
||
padding: 11px 10px;
|
||
border: 1px solid var(--line);
|
||
border-radius: 8px;
|
||
background: var(--panel);
|
||
color: #b8c4ca;
|
||
font-size: 10.5px;
|
||
}
|
||
.flow div::after {
|
||
position: absolute;
|
||
top: 31px;
|
||
right: -8px;
|
||
color: #50626e;
|
||
content: "›";
|
||
font-size: 15px;
|
||
}
|
||
.flow div:last-child::after { content: ""; }
|
||
.flow b { display: block; margin-bottom: 4px; color: var(--text); font-size: 11px; }
|
||
ol.steps, ul.checks { margin: 12px 0; padding: 0; list-style: none; }
|
||
ol.steps { counter-reset: steps; }
|
||
ol.steps li {
|
||
position: relative;
|
||
margin: 9px 0;
|
||
padding: 9px 11px 9px 43px;
|
||
border: 1px solid var(--line-soft);
|
||
border-radius: 8px;
|
||
background: #101a22;
|
||
color: #b8c5cb;
|
||
font-size: 12px;
|
||
}
|
||
ol.steps li::before {
|
||
position: absolute;
|
||
top: 9px;
|
||
left: 11px;
|
||
display: grid;
|
||
width: 22px;
|
||
height: 22px;
|
||
place-items: center;
|
||
border-radius: 6px;
|
||
background: #24341f;
|
||
color: var(--green);
|
||
counter-increment: steps;
|
||
content: counter(steps);
|
||
font: 10px/1 Menlo, monospace;
|
||
}
|
||
ul.checks li {
|
||
padding-left: 23px;
|
||
color: #b8c5cb;
|
||
font-size: 12px;
|
||
}
|
||
ul.checks li::before { margin-left: -21px; margin-right: 8px; color: var(--green); content: "✓"; }
|
||
.screenshot {
|
||
overflow: hidden;
|
||
margin: 18px 0 24px;
|
||
border: 1px solid var(--line);
|
||
border-radius: 13px;
|
||
background: #090f14;
|
||
box-shadow: 0 18px 45px rgba(0, 0, 0, .25);
|
||
}
|
||
.screenshot a { display: block; }
|
||
.screenshot img { width: 100%; height: auto; }
|
||
.screenshot figcaption {
|
||
display: flex;
|
||
justify-content: space-between;
|
||
gap: 12px;
|
||
padding: 10px 14px;
|
||
border-top: 1px solid var(--line-soft);
|
||
color: var(--muted);
|
||
font-size: 10.5px;
|
||
}
|
||
.shot-grid {
|
||
display: grid;
|
||
grid-template-columns: repeat(2, minmax(0, 1fr));
|
||
gap: 14px;
|
||
}
|
||
.shot-grid .screenshot { margin: 0; }
|
||
.shot-grid figcaption { min-height: 50px; }
|
||
.table-wrap { overflow-x: auto; border: 1px solid var(--line); border-radius: 10px; }
|
||
table { width: 100%; border-collapse: collapse; font-size: 11.5px; }
|
||
th, td {
|
||
padding: 10px 12px;
|
||
border-bottom: 1px solid var(--line-soft);
|
||
text-align: left;
|
||
vertical-align: top;
|
||
}
|
||
th { background: #15222b; color: #a9bac4; font-size: 10px; letter-spacing: .04em; }
|
||
td { color: #b8c5cb; }
|
||
tr:last-child td { border-bottom: 0; }
|
||
kbd {
|
||
padding: 1px 5px;
|
||
border: 1px solid #53636d;
|
||
border-bottom-width: 2px;
|
||
border-radius: 4px;
|
||
background: #17232c;
|
||
font-size: 10px;
|
||
}
|
||
footer {
|
||
margin-top: 52px;
|
||
padding-top: 18px;
|
||
border-top: 1px solid var(--line-soft);
|
||
color: #71828d;
|
||
font-size: 10.5px;
|
||
}
|
||
|
||
:root[data-theme="light"] body {
|
||
background:
|
||
radial-gradient(circle at 88% -8%, rgba(65, 102, 0, .10), transparent 34rem),
|
||
linear-gradient(180deg, #f7f9fc 0, var(--bg) 42rem);
|
||
}
|
||
:root[data-theme="light"] code {
|
||
background: #f5f8f2;
|
||
color: #315500;
|
||
}
|
||
:root[data-theme="light"] pre {
|
||
background: #f8fafc;
|
||
color: #26343e;
|
||
}
|
||
:root[data-theme="light"] aside {
|
||
background: rgba(244, 247, 250, .94);
|
||
}
|
||
:root[data-theme="light"] .brand-mark {
|
||
color: #fff;
|
||
box-shadow: 0 0 24px rgba(65, 102, 0, .14);
|
||
}
|
||
:root[data-theme="light"] .toc-title { color: #6a7c89; }
|
||
:root[data-theme="light"] nav a { color: #40515e; }
|
||
:root[data-theme="light"] nav a:hover { background: #e7edf3; }
|
||
:root[data-theme="light"] nav a::before { color: #8a99a4; }
|
||
:root[data-theme="light"] .side-links a { background: #fff; }
|
||
:root[data-theme="light"] .hero {
|
||
border-color: #c8d7b0;
|
||
background:
|
||
radial-gradient(circle at 82% 10%, rgba(65, 102, 0, .12), transparent 21rem),
|
||
linear-gradient(130deg, #edf5df, #f8fafc 64%);
|
||
}
|
||
:root[data-theme="light"] .hero::after { color: rgba(65, 102, 0, .06); }
|
||
:root[data-theme="light"] .hero > p { color: #485964; }
|
||
:root[data-theme="light"] .pill {
|
||
border-color: #b6c99e;
|
||
background: #eef5e3;
|
||
color: #315500;
|
||
}
|
||
:root[data-theme="light"] .card {
|
||
background: linear-gradient(180deg, #fff, #f7f9fb);
|
||
}
|
||
:root[data-theme="light"] .card .icon {
|
||
border-color: #c3d4aa;
|
||
background: #edf5df;
|
||
}
|
||
:root[data-theme="light"] .callout {
|
||
background: #eef6e4;
|
||
color: #34422d;
|
||
}
|
||
:root[data-theme="light"] .callout.warn {
|
||
background: #fff5e7;
|
||
color: #6f4b17;
|
||
}
|
||
:root[data-theme="light"] .callout.info {
|
||
background: #ebf5fb;
|
||
color: #285068;
|
||
}
|
||
:root[data-theme="light"] .flow div {
|
||
color: #4b5c68;
|
||
}
|
||
:root[data-theme="light"] .flow div::after { color: #95a3ae; }
|
||
:root[data-theme="light"] ol.steps li,
|
||
:root[data-theme="light"] ul.checks li {
|
||
color: #475865;
|
||
}
|
||
:root[data-theme="light"] ol.steps li { background: #f7fafc; }
|
||
:root[data-theme="light"] ol.steps li::before { background: #edf5df; }
|
||
:root[data-theme="light"] .screenshot {
|
||
background: #e7edf2;
|
||
box-shadow: 0 18px 45px rgba(40, 61, 79, .12);
|
||
}
|
||
:root[data-theme="light"] th {
|
||
background: #edf2f7;
|
||
color: #43535f;
|
||
}
|
||
:root[data-theme="light"] td { color: #475865; }
|
||
:root[data-theme="light"] kbd {
|
||
border-color: #b7c2cb;
|
||
background: #f4f7fa;
|
||
}
|
||
:root[data-theme="light"] footer { color: #657581; }
|
||
|
||
@media (max-width: 980px) {
|
||
.layout { display: block; }
|
||
aside {
|
||
position: relative;
|
||
width: 100%;
|
||
height: auto;
|
||
padding: 16px 20px;
|
||
border-right: 0;
|
||
border-bottom: 1px solid var(--line-soft);
|
||
}
|
||
aside nav { display: flex; flex-wrap: wrap; gap: 4px; }
|
||
.toc-title, .side-links, .brand small { display: none; }
|
||
.brand { margin-bottom: 10px; }
|
||
.theme-toggle { width: auto; margin: 0; }
|
||
main { padding: 28px 20px 70px; }
|
||
.flow { grid-template-columns: repeat(3, minmax(0, 1fr)); }
|
||
.grid-4 { grid-template-columns: repeat(2, minmax(0, 1fr)); }
|
||
}
|
||
@media (max-width: 680px) {
|
||
.hero { padding: 27px 22px; }
|
||
.grid-2, .grid-3, .grid-4, .shot-grid { grid-template-columns: 1fr; }
|
||
.flow { grid-template-columns: repeat(2, minmax(0, 1fr)); }
|
||
.section-head { display: block; }
|
||
.section-head p { margin-top: 7px; }
|
||
.screenshot figcaption { display: block; }
|
||
}
|
||
@media print {
|
||
:root { color-scheme: light; }
|
||
body { background: #fff; color: #172027; }
|
||
aside { display: none; }
|
||
.layout { display: block; }
|
||
main { width: 100%; padding: 0; }
|
||
.hero, .card, pre, .screenshot, .table-wrap { break-inside: avoid; }
|
||
a { color: #315d00; }
|
||
}
|
||
</style>
|
||
<script>
|
||
(() => {
|
||
const key = 'nex-the'
|
||
const media = window.matchMedia('(prefers-color-scheme: light)')
|
||
const saved = (() => {
|
||
try { return localStorage.getItem(key) } catch { return null }
|
||
})()
|
||
const initial = saved === 'light' || saved === 'dark'
|
||
? saved
|
||
: (media.matches ? 'light' : 'dark')
|
||
document.documentElement.dataset.theme = initial
|
||
const sync = (mode) => {
|
||
document.documentElement.dataset.theme = mode
|
||
const button = document.getElementById('theme-toggle')
|
||
if (button) {
|
||
button.textContent = mode === 'light' ? '☀ 浅色模式' : '☾ 深色模式'
|
||
button.setAttribute('aria-label', `切换明暗主题,当前为${mode === 'light' ? '浅色' : '深色'}`)
|
||
}
|
||
}
|
||
window.addEventListener('DOMContentLoaded', () => {
|
||
sync(initial)
|
||
document.getElementById('theme-toggle')?.addEventListener('click', () => {
|
||
const next = document.documentElement.dataset.theme === 'light' ? 'dark' : 'light'
|
||
try { localStorage.setItem(key, next) } catch { /* ignore */ }
|
||
sync(next)
|
||
})
|
||
})
|
||
window.addEventListener('storage', (event) => {
|
||
if (event.key === key && (event.newValue === 'light' || event.newValue === 'dark')) {
|
||
sync(event.newValue)
|
||
}
|
||
})
|
||
})()
|
||
</script>
|
||
</head>
|
||
<body>
|
||
<div class="layout">
|
||
<aside>
|
||
<div class="brand">
|
||
<div class="brand-mark">N</div>
|
||
<div><b>长视频编导平台</b><small>NEX ANIMATION STUDIO</small></div>
|
||
</div>
|
||
<button class="theme-toggle" id="theme-toggle" type="button" aria-label="切换明暗主题">☾ 深色模式</button>
|
||
<div class="toc-title">使用手册</div>
|
||
<nav aria-label="目录">
|
||
<a href="#quick-start">快速开始</a>
|
||
<a href="#workflow">完整业务流程</a>
|
||
<a href="#models">模型管理中心</a>
|
||
<a href="#assets">资产管理</a>
|
||
<a href="#storyboard">分镜与脚本</a>
|
||
<a href="#dispatch">任务调度</a>
|
||
<a href="#review">质检与审核</a>
|
||
<a href="#timeline">时间线与导出</a>
|
||
<a href="#troubleshooting">故障排查</a>
|
||
<a href="#api">接口文档</a>
|
||
</nav>
|
||
<div class="side-links">
|
||
<a href="/">进入工作台 →</a>
|
||
<a href="/models">打开模型管理中心 →</a>
|
||
<a href="/docs" target="_blank" rel="noreferrer">查看 FastAPI 接口 →</a>
|
||
</div>
|
||
</aside>
|
||
|
||
<main>
|
||
<header class="hero">
|
||
<p class="eyebrow">NEX ANIMATION STUDIO · USER GUIDE</p>
|
||
<h1>长视频编导平台使用手册</h1>
|
||
<p>
|
||
从模型配置、资产管理、脚本导入,到分镜生成、自动质检、人工审核与长视频合成,
|
||
本手册按实际业务流程说明每个页面的用途与关键操作。所有截图均来自正在运行的系统。
|
||
</p>
|
||
<div class="pills">
|
||
<span class="pill">四类模型统一管理</span>
|
||
<span class="pill">资产独立生成与镜头关联</span>
|
||
<span class="pill">队列入队 / 重试 / 断点续跑</span>
|
||
<span class="pill">质检、时间线与完整导出</span>
|
||
</div>
|
||
</header>
|
||
|
||
<section id="quick-start">
|
||
<div class="section-head">
|
||
<div><span class="step-no">00 · GET STARTED</span><h2>快速开始</h2></div>
|
||
<p>建议先确认模型可用,再创建项目并导入分镜。单机模式下默认使用 SQLite 与进程内任务执行器。</p>
|
||
</div>
|
||
<div class="grid-3">
|
||
<article class="card">
|
||
<span class="icon">▶</span>
|
||
<b>一键启动</b>
|
||
<p>在仓库根目录执行启动脚本,脚本会自检依赖、环境变量和端口。</p>
|
||
</article>
|
||
<article class="card">
|
||
<span class="icon">◫</span>
|
||
<b>配置模型</b>
|
||
<p>在模型管理中心检查大模型、视频、图像、声音四类模型的连接状态与默认项。</p>
|
||
</article>
|
||
<article class="card">
|
||
<span class="icon">◎</span>
|
||
<b>进入项目</b>
|
||
<p>从项目总览创建或打开项目,按左侧业务模块依次推进。</p>
|
||
</article>
|
||
</div>
|
||
<div class="callout info">
|
||
<b>界面导航:</b>顶部应用栏左侧是平台标识;正中间是<b>流程进度控制台</b>——项目名、项目状态、
|
||
12 个业务节点轨道(按完成 / 进行中 / 需处理 / 待处理着色;进行中的那一段更高、带光晕并与需处理一起呼吸闪烁,
|
||
扫一眼就知道卡在哪一段)、
|
||
流程进度(已完成节点 ÷ 全部节点)与当前节点,点一下控制台就回到流程概览;12 个节点全部走完时这里改说
|
||
<b>「全部 12 个节点已完成」</b>,不会在「已交付」旁边再挂一个假的当前节点。这条口径由
|
||
<code>frontend/src/pipeline.ts</code> 统一定义,侧栏项目副标题、项目页头标签、流程进度条
|
||
(含总览右侧的示例流程)、项目设置面板的状态标签(流程推进中 / <b>流程已完成</b> / 已归档)、
|
||
「下一步建议」抬头、项目总览表格与卡片的<b>「流程节点」列</b>、资产库「引入项目」下拉的副标题
|
||
全部复用它,任何一处都不会各说各话。右侧固定放使用手册、显示模式(深色 / 浅色,
|
||
<code>⌘/Ctrl+Shift+L</code> 随时切换)和账号胶囊;点开账号胶囊即是二级菜单——我的账号、用户管理、退出登录都在这里。
|
||
接口文档不再占用顶栏入口,需要时直接访问 <a href="/docs" target="_blank" rel="noreferrer"><code>/docs</code></a>。
|
||
左侧栏只保留模块导航:全局三个模块 + 当前项目的七个业务节点。页面底部不再常驻系统信息。
|
||
</div>
|
||
<figure class="screenshot">
|
||
<a href="/help/overview.png" target="_blank" rel="noreferrer" aria-label="查看项目总览页截图">
|
||
<img src="/help/overview.png" alt="项目总览页:顶部应用栏(平台标识、居中的流程进度控制台、手册 / 显示模式 / 账号胶囊)与左侧模块导航">
|
||
</a>
|
||
<figcaption><span>项目内页面:顶栏居中的进度控制台常驻,轨道颜色、流程进度与当前节点跟着轮询实时更新;右侧手册 / 显示模式 / 账号胶囊固定。</span><span>点击图片查看原图 ↗</span></figcaption>
|
||
</figure>
|
||
<div class="callout">
|
||
<b>环境自检:</b>执行器、ffmpeg、字幕烧录 / 内嵌、数据库、调度守护这些后台能力不再常驻页面,
|
||
只有真的出问题时才会在账号菜单里出现一行警告;需要随时核对,直接打开
|
||
<a href="/health" target="_blank" rel="noreferrer"><code>/health</code></a> 与
|
||
<a href="/api/meta" target="_blank" rel="noreferrer"><code>/api/meta</code></a>。
|
||
</div>
|
||
<pre><code>./scripts/dev.sh # 启动前后端
|
||
./scripts/dev.sh status # 查看端口、健康状态和默认模型
|
||
./scripts/dev.sh logs # 跟踪前后端日志
|
||
./scripts/dev.sh stop # 停止服务
|
||
|
||
# 默认地址
|
||
# 工作台 http://127.0.0.1:5173
|
||
# 接口文档 http://127.0.0.1:8000/docs</code></pre>
|
||
<div class="callout info">
|
||
如果页面能打开但页面顶部出现「后端连接异常」,先运行 <code>./scripts/dev.sh status</code>,
|
||
再检查 <code>http://127.0.0.1:8000/health</code> 是否返回 JSON。
|
||
</div>
|
||
</section>
|
||
|
||
<section id="workflow">
|
||
<div class="section-head">
|
||
<div><span class="step-no">01 · PIPELINE</span><h2>完整业务流程</h2></div>
|
||
<p>项目的流程条会实时汇总镜头、任务、质检、时间线与导出状态。任何一步跳过或失败,都会在上方流程条中暴露。</p>
|
||
</div>
|
||
<div class="flow">
|
||
<div><b>① 创建项目</b>设定片长、画幅与风格</div>
|
||
<div><b>② 导入分镜</b>脚本与关键帧一起入库</div>
|
||
<div><b>③ 绑定资产</b>人物、场景、声线关联镜头</div>
|
||
<div><b>④ 生成任务</b>按镜头生成任务清单</div>
|
||
<div><b>⑤ 预检调度</b>检查素材、参数与容量</div>
|
||
<div><b>⑥ 调用模型</b>执行视频和配音生成</div>
|
||
<div><b>⑦ 保存产物</b>下载并登记新素材版本</div>
|
||
<div><b>⑧ 自动质检</b>解码、时长、分辨率、帧率等</div>
|
||
<div><b>⑨ 人工审核</b>合格通过或带修改意见重做</div>
|
||
<div><b>⑩ 时间线合成</b>裁剪、转场、字幕、配音、BGM</div>
|
||
<div><b>⑪ 出片预检</b>检查缺片、字幕与音轨</div>
|
||
<div><b>⑫ 导出交付</b>生成成片并记录成本与校验和</div>
|
||
</div>
|
||
<div class="callout">
|
||
推荐顺序:<b>模型管理中心 → 资产管理 → 分镜与脚本 → 任务调度中心 → 质检与审核 → 时间线合成 → 导出与成本</b>。
|
||
资产可以先独立生成,再在分镜的“资产绑定”页中关联,不要求先有镜头的生成产物。
|
||
</div>
|
||
</section>
|
||
|
||
<section id="models">
|
||
<div class="section-head">
|
||
<div><span class="step-no">02 · MODEL OPERATIONS</span><h2>模型管理中心</h2></div>
|
||
<p>统一管理机构可调用的四类能力。资产独立生成和分镜任务都会读取这里的默认模型与供应能力。</p>
|
||
</div>
|
||
<div class="grid-4">
|
||
<article class="card"><span class="icon">✦</span><b>大模型</b><p>剧本拆解、编导指令与提示词补全,修正跨镜头一致性。</p></article>
|
||
<article class="card"><span class="icon">▶</span><b>视频模型</b><p>文生视频、图生视频、首尾帧;配置并发、RPM、时长与分辨率。</p></article>
|
||
<article class="card"><span class="icon">▧</span><b>图像模型</b><p>人物定妆图、三视图、服装、表情以及场景参考图。</p></article>
|
||
<article class="card"><span class="icon">◉</span><b>声音模型</b><p>TTS 配音与声线试听样本,可绑定到人物和镜头台词。</p></article>
|
||
</div>
|
||
<figure class="screenshot">
|
||
<a href="/help/model-center.png" target="_blank" rel="noreferrer" aria-label="查看模型管理中心截图">
|
||
<img src="/help/model-center.png" alt="模型管理中心:大模型、视频、图像、声音四类模型统一管理">
|
||
</a>
|
||
<figcaption><span>模型管理中心:四类模型分类、默认模型、连接状态、容量与价格。</span><span>点击图片查看原图 ↗</span></figcaption>
|
||
</figure>
|
||
<h3>常用操作</h3>
|
||
<ol class="steps">
|
||
<li>点击右上角“登记模型”,填写 Provider、Model、媒体类型与适配器;媒体类型必须与适配器匹配。</li>
|
||
<li>为大模型、视频、图像、声音分别设置一个启用中的默认模型,资产页会自动选中对应默认项。</li>
|
||
<li>展开模型卡片编辑并发、RPM、时长、分辨率、价格和默认参数。</li>
|
||
<li>点击「检测连接」检查适配器与外部服务是否可达;不可用时先修复连接再执行生成。</li>
|
||
<li>在故障演练中使用可控失败率验证重试与断点续跑,验证完成后恢复为正常配置。</li>
|
||
</ol>
|
||
<div class="callout warn">
|
||
<b>提示:</b>切换默认模型只影响后续任务,不会重写已经完成的任务记录。历史任务仍保留当时的 Provider、Model、参数和产物版本。
|
||
</div>
|
||
</section>
|
||
|
||
<section id="assets">
|
||
<div class="section-head">
|
||
<div><span class="step-no">03 · ASSET MANAGEMENT</span><h2>资产管理</h2></div>
|
||
<p>集中维护人物、场景、声线与项目素材。资产可以独立调用模型生成,也可在分镜中绑定并参与后续视频生成。</p>
|
||
</div>
|
||
<div class="grid-4">
|
||
<article class="card"><b>人物</b><p>外观、性格、一致性提示词、默认声线;定妆图 / 三视图 / 服装 / 表情。</p></article>
|
||
<article class="card"><b>场景</b><p>描述、光线、时间、色调;场景图可作为镜头参考与关键帧来源。</p></article>
|
||
<article class="card"><b>声线</b><p>Provider voice_id、语言、性别、语速、效果与试听样本。</p></article>
|
||
<article class="card"><b>项目素材</b><p>BGM、音效、通用参考图与视频,可挂到时间线音轨。</p></article>
|
||
</div>
|
||
<figure class="screenshot">
|
||
<a href="/help/asset-management.png" target="_blank" rel="noreferrer" aria-label="查看资产管理人物页截图">
|
||
<img src="/help/asset-management.png" alt="资产管理人物页:独立生成、默认模型、版本与被镜头使用情况">
|
||
</a>
|
||
<figcaption><span>人物资产:默认图像 / 大模型已自动选中,并显示镜头使用位置与模型生成版本。</span><span>点击图片查看原图 ↗</span></figcaption>
|
||
</figure>
|
||
<h3>独立生成人物或场景资产</h3>
|
||
<ol class="steps">
|
||
<li>打开“资产管理”,选择人物或场景页签。</li>
|
||
<li>在对应的 AI 生成卡片中选择图像模型和生成类型;需要文本补全时选择大模型。</li>
|
||
<li>生成描述可以留空,系统会使用人物外观、场景描述、光线与风格设定自动组装提示词。</li>
|
||
<li>点击「生成母版图像」(人物定妆图 / 三视图 / 场景图)。完成后资产自动登记新版本,并显示 Provider / Model。</li>
|
||
<li>点击“AI 补全一致性提示词”,检查建议内容后选择“采用”,写回人物或场景设定。</li>
|
||
</ol>
|
||
<div class="callout">
|
||
<b>与分镜的关联:</b>每个资产卡片显示“被 N 个镜头使用”。点击镜头链接会进入分镜页并自动选中对应镜头;
|
||
在分镜右侧“资产绑定”页可调整人物、场景和声音。生成视频时,有效的参考资产会进入模型请求。
|
||
</div>
|
||
<figure class="screenshot">
|
||
<a href="/help/scene-assets.png" target="_blank" rel="noreferrer" aria-label="查看场景资产页截图">
|
||
<img src="/help/scene-assets.png" alt="场景资产页:场景独立生成、模型选择、镜头使用关系和场景参考图">
|
||
</a>
|
||
<figcaption><span>场景资产:同样可以选择图像 / 大模型独立生成,结果自动登记版本并显示关联镜头。</span><span>点击图片查看原图 ↗</span></figcaption>
|
||
</figure>
|
||
<figure class="screenshot">
|
||
<a href="/help/voice-assets.png" target="_blank" rel="noreferrer" aria-label="查看声音资产页截图">
|
||
<img src="/help/voice-assets.png" alt="声音资产页:TTS 模型选择、AI 试听生成和可播放音色样本">
|
||
</a>
|
||
<figcaption><span>声音资产:选择声音模型生成试听样本,音频版本可直接播放;下方展示绑定的镜头。</span><span>点击图片查看原图 ↗</span></figcaption>
|
||
</figure>
|
||
<h3>声音资产</h3>
|
||
<ul class="checks">
|
||
<li>选择可用声音模型,填写试听文本后点击「生成试听样本」。</li>
|
||
<li>生成完成会得到带时长、Provider、Model 与任务 ID 的新版本音频。</li>
|
||
<li>macOS 系统语音可使用 Tingting、Meijia、Fred 等 voice_id;外星角色可选择降调与金属共振效果。</li>
|
||
<li>人物默认声线绑定后,镜头台词可自动进入 TTS 配音与时间线混音流程。</li>
|
||
</ul>
|
||
</section>
|
||
|
||
<section id="storyboard">
|
||
<div class="section-head">
|
||
<div><span class="step-no">04 · STORYBOARD</span><h2>分镜与脚本</h2></div>
|
||
<p>分镜工作台:顶栏看总量与预检指标,看板或分镜表浏览镜头序列,右侧常驻检查器按“镜头 / 资产 / 提示词 / 产物”组织细节。</p>
|
||
</div>
|
||
<figure class="screenshot">
|
||
<a href="/help/storyboard.png" target="_blank" rel="noreferrer" aria-label="查看分镜工作台截图">
|
||
<img src="/help/storyboard.png" alt="分镜工作台:指标条、搜索筛选、批量操作与网格看板">
|
||
</a>
|
||
<figcaption><span>分镜工作台:镜头数 / 计划时长 / 已合格 / 有阻塞一眼可见,卡片显示缩略图、景别运镜、QC 分、绑定与逐镜预检问题。</span><span>点击图片查看原图 ↗</span></figcaption>
|
||
</figure>
|
||
<div class="grid-3">
|
||
<article class="card"><b>导入脚本</b><p>支持 Markdown、CSV、TSV、JSON 与纯文本,可先预览再落库。</p></article>
|
||
<article class="card"><b>关键帧匹配</b><p>图片可按镜号自动匹配,也支持 ZIP 批量导入。</p></article>
|
||
<article class="card"><b>资产绑定</b><p>人物、场景和声音可逐镜头关联,并即时看到使用关系。</p></article>
|
||
</div>
|
||
<figure class="screenshot">
|
||
<a href="/help/storyboard-inspector.png" target="_blank" rel="noreferrer" aria-label="查看分镜检查器截图">
|
||
<img src="/help/storyboard-inspector.png" alt="分镜工作台:选中镜头后右侧常驻检查器的镜头页签">
|
||
</a>
|
||
<figcaption><span>选中任一镜头后检查器常驻右侧并与看板并排:镜头参数、资产绑定、提示词版本、产物与质检各占一个页签,改动未保存会有「未保存」标记。</span><span>点击图片查看原图 ↗</span></figcaption>
|
||
</figure>
|
||
<h3>推荐操作</h3>
|
||
<ol class="steps">
|
||
<li>点击“导入脚本 / 关键帧”,粘贴脚本并上传关键帧;先用“导入预演”确认镜头数量与图片匹配,再正式导入。</li>
|
||
<li>用搜索框和状态 / 模式 / 排序筛选定位镜头,或点“仅看阻塞”“仅看缺关键帧”直接清理预检问题。</li>
|
||
<li>拖动卡片即可改镜序(分镜表视图也可拖行或用 ↑↓);勾选多个镜头后可批量复制、移到最前、统一改参数或删除。</li>
|
||
<li>选中镜头后在检查器编辑参数与绑定;提示词页可切换“自动组装 / 人工覆盖”,并回填任意历史版本。</li>
|
||
<li>卡片上的“生成”“审核”带 <code>?shot=镜头ID</code> 深链,跳到调度中心或审核页时会自动选中同一镜头。</li>
|
||
<li>需要交给编剧或外部工具时,用右上角导出 Markdown / CSV / JSON,导出的 Markdown 可以直接再导回来。</li>
|
||
</ol>
|
||
<div class="callout">
|
||
<b>快捷键:</b><code>J</code> / <code>K</code> 或 <code>↑</code><code>↓</code> 切换镜头,<code>X</code> 勾选当前镜头,
|
||
<code>⌘S</code> 保存检查器改动,<code>Esc</code> 关闭检查器或导入面板。首屏只拉轻量看板数据,
|
||
几十上百镜也不会拖慢页面。
|
||
</div>
|
||
</section>
|
||
|
||
<section id="dispatch">
|
||
<div class="section-head">
|
||
<div><span class="step-no">05 · DISPATCH</span><h2>任务调度</h2></div>
|
||
<p>任务清单先解释执行原因,再按模型容量和限流派发。已完成镜头会被跳过,避免重复消耗真实模型时长。</p>
|
||
</div>
|
||
<figure class="screenshot">
|
||
<a href="/help/dispatch.png" target="_blank" rel="noreferrer" aria-label="查看任务调度中心截图">
|
||
<img src="/help/dispatch.png" alt="任务调度中心:分镜任务清单、预检结果、执行开关和异常处理">
|
||
</a>
|
||
<figcaption><span>调度中心:任务状态、Provider / Model、预计成本、入队选项与断点续跑入口。</span><span>点击图片查看原图 ↗</span></figcaption>
|
||
</figure>
|
||
<div class="grid-2">
|
||
<article class="card">
|
||
<b>入队前</b>
|
||
<p>检查预检阻塞项、镜头状态、模型容量与预计成本。默认只入队预检通过的镜头,缺素材或缺参数的镜头会被跳过,需要时再勾选「放行预检未通过的镜头」。</p>
|
||
</article>
|
||
<article class="card">
|
||
<b>执行中</b>
|
||
<p>查看运行任务、心跳、尝试次数与进度。失败任务会按配置重试,超时任务可从中断点续跑。</p>
|
||
</article>
|
||
</div>
|
||
<ol class="steps">
|
||
<li>确认任务清单中的 Provider / Model 与预期一致。</li>
|
||
<li>按需开启「入队时一并排配音任务」「放行预检未通过的镜头」「强制重建任务(忽略幂等)」,并设置优先级与单次派发上限。</li>
|
||
<li>点击「入队所选 / 全部待生成」。勾选「派发后同步排空」会一直等到任务跑完再返回;不勾选时任务在后台执行,页面自动刷新进度。</li>
|
||
<li>失败时查看错误码与错误历史;修复后使用“重排全部失败任务”或“断点续跑”。</li>
|
||
<li>已完成且仍需强制重做的镜头,勾选“强制重建任务”后再派发。</li>
|
||
</ol>
|
||
</section>
|
||
|
||
<section id="review">
|
||
<div class="section-head">
|
||
<div><span class="step-no">06 · QUALITY & REVIEW</span><h2>质检与审核</h2></div>
|
||
<p>先自动检查文件完整性、时长、分辨率、帧率等指标,再由人工确认画面和声音。驳回可携带修改意见重新生成。</p>
|
||
</div>
|
||
<figure class="screenshot">
|
||
<a href="/help/review.png" target="_blank" rel="noreferrer" aria-label="查看质检与审核页面截图">
|
||
<img src="/help/review.png" alt="质检与审核页面:自动质检清单、镜头预览、检查项得分和人工审核">
|
||
</a>
|
||
<figcaption><span>质检与审核:自动质检清单、视频预览、逐项指标解释和人工通过 / 驳回操作。</span><span>点击图片查看原图 ↗</span></figcaption>
|
||
</figure>
|
||
<ul class="checks">
|
||
<li>在自动质检清单中按镜头检查得分为 100 的项,确认没有解码、时长或分辨率异常。</li>
|
||
<li>播放右侧产物,检查人物一致性、动作、构图、音轨和字幕风险。</li>
|
||
<li>合格后填写审核人并提交;不合格时填写修改意见与新的提示词,选择是否立即重新生成。</li>
|
||
<li>驳回镜头会回到任务计划状态,再次进入调度中心,不会覆盖之前的历史产物。</li>
|
||
<li>镜头多时用顶部“批量放行质检合格镜头”一次性放过全部质检通过且待审核的镜头,只手工盯有问题的几个。</li>
|
||
<li>从分镜工作台点“审核”跳过来时带 <code>?shot=镜头ID</code>,右侧直接定位到该镜头。</li>
|
||
</ul>
|
||
</section>
|
||
|
||
<section id="timeline">
|
||
<div class="section-head">
|
||
<div><span class="step-no">07 · COMPOSE & DELIVER</span><h2>时间线与导出</h2></div>
|
||
<p>时间线只收集已审核合格产物,统一处理片段顺序、转场、字幕、配音、BGM、响度与最终编码。</p>
|
||
</div>
|
||
<div class="shot-grid">
|
||
<figure class="screenshot">
|
||
<a href="/help/timeline.png" target="_blank" rel="noreferrer" aria-label="查看时间线合成页面截图">
|
||
<img src="/help/timeline.png" alt="时间线合成:片段、转场、字幕、音轨和交付预检">
|
||
</a>
|
||
<figcaption><span>时间线:片段与转场、字幕、音轨和交付预检。</span><span>查看原图 ↗</span></figcaption>
|
||
</figure>
|
||
<figure class="screenshot">
|
||
<a href="/help/delivery.png" target="_blank" rel="noreferrer" aria-label="查看项目交付页面截图">
|
||
<img src="/help/delivery.png" alt="导出与成本:出片预设、成本台账、成片记录与下载">
|
||
</a>
|
||
<figcaption><span>交付:选择预设、检查成本、生成并下载成片。</span><span>查看原图 ↗</span></figcaption>
|
||
</figure>
|
||
</div>
|
||
<h3>时间线合成</h3>
|
||
<ol class="steps">
|
||
<li>点击“构建 / 重建时间线”,系统自动收集已审核合格镜头。</li>
|
||
<li>调整片段顺序、时长、入点、转场和音量;补齐缺失字幕与配音。</li>
|
||
<li>检查交付预检报告,确保缺片、字幕、声轨和总时长均为通过状态。</li>
|
||
<li>如使用外挂字幕,保持字幕模式为 SRT;当前 ffmpeg 未启用烧录滤镜时会明确降级。</li>
|
||
</ol>
|
||
<h3>导出与成本</h3>
|
||
<ul class="checks">
|
||
<li>选择横屏或竖屏的 720p 试片、1080p 投放、高质量 1080p 或超清 4K 预设,可多选依次入队。</li>
|
||
<li>确认成片名称、字幕策略与优先级,然后点击“开始合成导出”。</li>
|
||
<li>在成片记录中检查分辨率、帧率、时长、大小、校验和与下载地址。</li>
|
||
<li>成本台账按 Provider、Model 汇总实际费用;mock 模型的单价为 0。</li>
|
||
</ul>
|
||
</section>
|
||
|
||
<section id="troubleshooting">
|
||
<div class="section-head">
|
||
<div><span class="step-no">08 · TROUBLESHOOTING</span><h2>故障排查</h2></div>
|
||
<p>先看页面错误和任务错误历史,再看后端健康状态与日志;不要在未确认原因时反复重烧真实模型。</p>
|
||
</div>
|
||
<div class="table-wrap">
|
||
<table>
|
||
<thead><tr><th>现象</th><th>优先检查</th><th>处理方式</th></tr></thead>
|
||
<tbody>
|
||
<tr><td>前后端服务未启动</td><td><code>./scripts/dev.sh status</code></td><td>运行 <code>./scripts/dev.sh restart --no-install</code>,再查看 <code>.local/logs/</code>。</td></tr>
|
||
<tr><td>启动时报 unbound variable</td><td>脚本是否将变量写作 <code>${VAR}</code></td><td>Bash 3.2 下变量紧邻中文或全角符号时必须使用花括号形式。</td></tr>
|
||
<tr><td>模型下拉框为空</td><td>模型管理中心是否启用对应媒体类型</td><td>启用并设置默认模型;资产页加载完成后会自动同步默认值。</td></tr>
|
||
<tr><td>资产显示被 0 个镜头使用</td><td>分镜“资产绑定”页</td><td>逐镜头绑定人物、场景或声音;预检会提示缺失绑定。</td></tr>
|
||
<tr><td>派发被拒或镜头被跳过</td><td>预检问题与镜头状态</td><td>优先补齐阻塞项;只有确认需要重做时才开启强制重建。</td></tr>
|
||
<tr><td>任务超时或进程重启</td><td>任务心跳和检查点</td><td>使用断点续跑,保留已成功镜头,避免重复调用模型。</td></tr>
|
||
<tr><td>时间线为空</td><td>是否存在已审核合格镜头</td><td>先完成质检与人工审核,再重建时间线。</td></tr>
|
||
<tr><td>字幕烧录失败</td><td><code>/health</code> 中的 <code>ffmpeg_capabilities.subtitle_burn</code></td><td>改为外挂 SRT,或安装带 libass / subtitles 滤镜的 ffmpeg。</td></tr>
|
||
<tr><td>真实模型连接不可达</td><td>模型中心的探测结果(含中文结论)</td><td>按探测提示确认那台机器上的 ComfyUI 进程与端口是否还在。<b>平台直连 ComfyUI,不走系统代理</b>,因此本机开了 Clash / VPN 也不影响出片,排查时不必检查代理设置。</td></tr>
|
||
<tr><td>点录音没有弹授权框,或提示打不开麦克风</td><td>页面会先体检麦克风:设备数、系统权限、当前地址是否 https</td><td>按提示逐条处理:系统设置 → 隐私与安全性 → 麦克风里放开浏览器;地址栏左侧图标把麦克风改回「允许」;用 IP + http 从别的机器访问时浏览器根本没有录音接口,请改用 <code>localhost</code> 或 https。急着出片可先在外部录好再走「上传文件」。</td></tr>
|
||
<tr><td>点了「开始录制」一直转圈,系统授权框始终没出现(macOS)</td><td>macOS 的麦克风授权框<b>出现在屏幕左下角</b>(不是窗口正中),很容易被忽略;一旦误点「不允许」,Chrome 会记住结论,之后<b>不再弹框</b>,页面只会收到一句 <code>Requested device not found</code></td><td>录音面板顶部有一行麦克风自检:<b>✓ 麦克风已就绪:设备名</b> 表示可以直接录;⚠ 时按下面的说明逐条走,需要重置系统权限时点<b>「复制修复命令」</b>,粘到终端执行 <code>tccutil reset Microphone com.google.Chrome</code> 后回到面板点「重新检测」即可,<b>不用重启浏览器</b>。换了麦克风或改了系统权限也不用刷新:面板会自动重新体检。</td></tr>
|
||
<tr><td>录到一半录音面板自己消失了</td><td>是否正好切走了类型 / 筛选(母版列表换了内容,卡片上的面板随之关闭)</td><td>录音期间平台的自动刷新会主动让路(不重建列表),录完或关掉面板后下一轮自动恢复;切换类型、翻页会离开当前母版,请先停止录制并保存这段录音。</td></tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
<pre><code># 快速收集运行时信息
|
||
./scripts/dev.sh status
|
||
curl -fsS http://127.0.0.1:8000/health
|
||
tail -n 200 .local/logs/backend.log
|
||
tail -n 200 .local/logs/frontend.log</code></pre>
|
||
</section>
|
||
|
||
<section id="api">
|
||
<div class="section-head">
|
||
<div><span class="step-no">09 · API REFERENCE</span><h2>接口文档</h2></div>
|
||
<p>所有前后端操作都通过同一组 REST 接口完成,便于脚本化、自动测试和后续接入其他客户端。</p>
|
||
</div>
|
||
<div class="grid-3">
|
||
<article class="card"><b>Swagger UI</b><p><a href="/docs" target="_blank" rel="noreferrer">/docs</a>:浏览并直接调用全部接口。</p></article>
|
||
<article class="card"><b>OpenAPI JSON</b><p><a href="/openapi.json" target="_blank" rel="noreferrer">/openapi.json</a>:供代码生成与自动化测试使用。</p></article>
|
||
<article class="card"><b>健康检查</b><p><a href="/health" target="_blank" rel="noreferrer">/health</a>:执行器、数据库、ffmpeg、守护调度器与模型数量。</p></article>
|
||
</div>
|
||
<div class="callout info">
|
||
常用接口包括 <code>GET /api/providers</code>、<code>POST /api/projects/{id}/assets/generate</code>、
|
||
<code>POST /api/projects/{id}/assets/text-assist</code>、<code>GET /api/projects/{id}/assets/usage</code>、
|
||
<code>POST /api/projects/{id}/dispatch</code> 与 <code>POST /api/projects/{id}/compose</code>。
|
||
</div>
|
||
</section>
|
||
|
||
<footer>
|
||
Nex Animation Studio · 本手册随平台代码维护。截图来自项目《铁血战士的猎人晚宴》的实际运行状态。
|
||
</footer>
|
||
</main>
|
||
</div>
|
||
</body>
|
||
</html>
|