nex_animation/frontend/public/help.html

955 lines
46 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

<!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>