Documentation
羽镜世界 · 使用手册
从装好到出第一集成片，这份手册覆盖全部环节。遇到问题优先看第十一章「常见问题排查」——绝大多数情况那里已经有答案。
Chapter 01
安装与首次启动
开拍前的硬件检查
本地生成吃的是显卡，先确认三件事，能省掉后面 90% 的麻烦。
| 项目 | 要求 | 说明 |
|---|---|---|
| 显卡 | NVIDIA，显存 ≥ 8 GB | 档位按显存自动匹配（取下不取上，10G 卡按 8G 档跑）：8G 档 2080 / 3060Ti / 3070 / 4060 / 4060Ti 8G / 3080 10G；11G 档 2080Ti / 3060 12G / 3080 12G / 4070；16G 档 4060Ti 16G / 4070Ti Super / 4080 / 5070Ti / 5080；24G 档 3090 / 3090Ti / 4090；32G 档 5090。低于 8G 无法运行，AMD 与 Apple 芯片不在支持范围内。 |
| 内存 | 32 GB | 低显存机型大量靠内存做权重流式卸载，内存不足会整机卡顿。 |
| 显卡驱动 | ≥ 580 | 旧驱动会让推理慢 2–7 倍、视频容易卡死。这是最容易被忽略的一项。 |
| 磁盘 | 约 100 GB 可用空间 | 安装包 + 运行库 + 模型的总和。安装根目录建议选一个大盘。 |
先升级驱动，再装模型
驱动低于 580 时，软件不会安装生成运行库——装了也只能跑慢速兼容版、视频易卡死。请先把驱动升到 580 以上并重启，再回到软件里点一键安装。
驱动下载：NVIDIA 驱动程序下载中心（中文官网），
选择「产品类型 GeForce → 对应系列 → Windows 11 → Game Ready 驱动（GRD）→ 简体中文」，安装时选「精简安装」即可，无需 GeForce Experience。
下载与安装
- 访问唯一下载地址 https://yujing.yechen.chat/api/download/latest，得到最新版安装包（约 60–70 MB，很快）。
- 双击安装包。安装过程只需要你选一次「安装根目录」，其余目录由软件自动派生，不必自己规划：
- 你选的根目录 例如 D:\yujing。有 D 盘时默认就是它。
- apps 程序本体，自动生成为 D:\yujing\apps。
- data 素材库、剧本、剧集成片、数据库，自动生成为 D:\yujing\data。
- models 上百 GB 的模型权重，自动生成为 D:\yujing\models。
- 等待安装完成，启动软件。
为什么软件要自动分成三个子目录？
程序、资料、模型职责不同，混在一起会出事：资料或模型一旦落进程序目录内部，全量更新会原地覆盖，卸载脚本更会连根删除。
所以软件固定按 apps / data / models 三个同级子目录派生——你只管选根目录，这个风险由软件替你规避。
之后想换位置也简单：直接改根目录，或用「模型管理」页单独迁移模型目录。
首次启动向导
第一次打开会进入初始化向导，它会做三件事：
- 硬件体检 检测显卡型号、显存、驱动版本与内存，并给出你这台机器属于哪一档。
- 安装模型 列出需要下载的运行库与模型清单，点「一键安装」开始。这一步是唯一耗时较长的环节。
- 账号登录 新账号注册即自动赠送 3 天免费体验，无需领取。生成过程本身完全离线。
安装期间可以放着不管
模型总量约 100 GB，视网速可能要几小时。向导会轮换鼓励文案陪着你，可以最小化去做别的事。
Chapter 02
模型安装与运行库
一键安装清单
「一键安装」会依次准备以下内容，你可以看到每一项的进度：
| 项目 | 作用 | 体积参考 |
|---|---|---|
| 生成运行库 | 视频 / 图片 / 声线三条生成管线共用的 PyTorch 与算子库。驱动不足 580 时会标为「待升级驱动后安装」。 | 约 3.5 GB |
| 本地大语言模型 | 负责剧本创作、小说推导、AI 助手对话，190K 上下文。也可以改用在线 API，则无需下载这一项（见下一节）。 | 数十 GB |
| 文生图 / 图生图模型 | 角色定妆照、场景空镜、道具特写，以及阶段素材的指令编辑。 | 数十 GB |
| 视频生成模型 | MiniMax H3 全参考结构 + Turbo 加速，负责片段视频。 | 数十 GB |
| 声线合成模型 | Qwen3-TTS 声音设计，为角色生成专属声线。 | 数 GB |
剧本大模型：本地 / API 两种来源
剧本大模型是整部剧的大脑——剧本质量、分镜拆解、素材规划都由它决定，它直接决定成片的上限。软件支持两种来源，在「⚙ 设置 → 🧠 大模型 → 剧本生成模型来源」里切换：
| 来源 | 显存 / 内存占用 | 适合谁 |
|---|---|---|
| 🌐 API（在线大模型） | 不占显存，也不占内存 | 低显存机型（8–12 GB）强烈建议；想挂更强的模型追求剧本质量上限；内存偏紧的机器。 |
| 💻 本地大模型 | 常驻内存，按显存自动选档 | 断网 / 私有化场景，不希望剧本内容离开本机。 |
低显存机型怎么配？把大脑放到 API 上
切到 🌐 API 后，视频、生图、声线三条管线可以独占显卡，不再与大模型抢显存，画面生成反而更稳；同时能挂上比本地更强的模型，剧本与分镜质量更高。API 模式需要填 Base URL、API Key 与模型名，界面里附有「📖 API 申请指引」，配置可存成档案随时切换（支持搜索与分页）；上下文长度填 0 表示按模型自动取值。
用本地大模型时，它会自动让路
本地模式按显存自动推荐档位（也可手动指定档位）。开始生成视频 / 图片 / 声线时，软件会临时暂停本地大模型服务腾出显存，任务结束自动恢复；默认监听 8391 端口，设为 0 可关闭这一行为。
驱动过旧怎么办
如果体检发现驱动低于 580，向导会明确提示，并采取「暂缓安装运行库」策略：
- 模型文件可以照常下载，只是暂时不能生成。
- 本地大模型的剧本创作不受影响，你依然可以让 AI 写剧本、规划素材。
- 升级驱动到 580 以上并重启软件后，回到「模型管理」点一键安装，会自动装上全速运行库，模型无需重新下载。
换模型目录 / 重装运行库
- 模型目录可以随时在「模型管理」页更改，改完重启软件生效。已有模型可以手动搬到新目录，避免重下。
- 需要重装运行库（例如升级驱动后、或换了显卡）时，同样在「模型管理」页操作，不会动你的模型文件与素材。
- 软件更新是增量的：只有运行库本身发生变化时，才会要求完整安装，此时用户数据与素材完整保留。
Chapter 03
界面导航
左侧导航栏一共七个入口，按创作顺序排列：
| 入口 | 做什么 |
|---|---|
| 🚀 一键出剧 | 全自动流水线总入口：写需求 → 生成剧本 → 生成素材 → 设计声线 → 绑定 → 生成片段 → 导出成片。 |
| 📜 剧本管理 | 导入 / 创作剧本，查看与编辑分镜、片段提示词，管理剧集结构。 |
| 🎨 素材管理 | 角色定妆照、场景空镜、道具特写、声线样本的统一仓库，负责素材与片段的绑定。 |
| 📋 任务队列 | 查看当前排队与执行中的生成任务，支持取消与重排。 |
| 🧠 模型管理 | 模型安装 / 更新 / 迁移，运行库重装，显存档位查看。 |
| 💬 AI 助手 | 能真正动手干活的智能体：改剧本、生图、配音、排队出片。 |
| 🎬 短剧制作 | 按剧集组织的工作台，逐片段生成、预览、调整。 |
右上角两个按钮：👤 账号（会员状态、卡密兑换）与 ⚙ 设置（生图模型选择、提示词技能开关、目录设置等）。
Chapter 04
剧本管理
导入剧本（1:1 复刻）
这是羽镜世界最核心的能力之一。支持几乎任何格式的剧本文件，导入即还原分镜结构，不改动你的原文一个字。
- 进入「剧本管理」，选择导入剧本，上传你的文件（txt / docx / 结构化文本等均可）。
- 系统解析出角色、场景与分镜片段，逐条列出供你核对。
- 确认后进入素材规划阶段，或直接投喂给一键出剧流水线。
你负责内容，我们负责画面
你写好的剧本不会被「AI 改写」。系统只做一件事——把它完整格式化成生成管线能直接执行的镜头语言，让同一批素材、同一套提示词约束能贯穿全篇，把「像同一部剧」做到最好。最终画面表现取决于你选用的模型。
让 AI 写剧本
三种方式任选：
- 一键出剧里写需求 给一句需求描述，系统按你选的题材与集数生成完整分镜。
- 小说出剧 丢一份小说进去，AI 自动读取、推导人设与剧情线，安排任务并执行。适合把长篇内容改编成短剧。
- AI 助手对话创作 在对话框里直接说「写一部关于……的短剧」，AI 会调用剧本创作工具，产物直接进入一键出剧队列。
修改与润色片段
- 逐字替换 对某一片段的提示词做机械替换，改一处不影响全篇。
- AI 润色 让 AI 改写某个片段的提示词。它会带上时长、前一个镜头、已绑定素材作为上下文，改完直接保存。
- 承接标记 片段之间的切换承接关系可以单独改写，这是保证镜头连贯、不跳戏的关键。
Chapter 05
素材与声线
素材类型
| 类型 | 用途 |
|---|---|
| 角色定妆照 | 全身立姿形象图，是该角色在整部剧里的唯一形象锚点。视频阶段每个角色只注入这一张，避免多图互相污染导致脸变。 |
| 阶段素材 | 以定妆照为底做指令编辑：换服装、受伤、变身、换装备、改气场。人还是同一个人，只是状态变了。 |
| 场景空镜 | 场景参考图，用于统一同一场戏的空间质感与光线。 |
| 道具特写 | 关键道具的形象参考。 |
| 声线样本 | 角色专属音色，可绑定到角色，全剧复用。 |
| 画作 | AI 助手自由绘画与改图的产物，可下载、可再编辑。 |
写实题材的一致性铁律
写实角色的特写必须继承原始形象：真实皮肤、毛孔、细纹，禁止磨皮、禁止年轻化、禁止卡通化五官。动画与插画角色则保持同样的风格化处理。系统会在生成时自动附加这些约束。
绑定与体检修复
素材只有绑定到片段，生成时才会被注入。手工绑定之外，更推荐让 AI 做体检：
- 逐片段检测绑定问题 AI 扫描全剧，汇报哪些片段错绑、漏绑、绑了不该绑的素材。
- 确认后一键修复 修正错绑关系，对缺失的素材自动生图并绑定。
建议在开始批量生成片段之前跑一次体检——事后返工的成本远高于事前检查。
声线设计
- 文字描述生成 用一段文字描述你想要的音色（年龄、性别、音调、气质、语速），系统生成声线样本。
- 从成片提取 如果你已经生成过带对白的片段，可以直接把其中的音轨提取出来作为该角色的声线样本，保证后续剧集音色完全一致。
Chapter 06
一键出剧
出剧参数
点「开始出剧」会弹出参数窗口，默认沿用你上一次的出剧配置，改完确认即开始：
| 参数 | 说明 |
|---|---|
| 需求描述 | 你想拍什么。一句话即可，越具体越好。 |
| 集数 / 时长 | 本次要产出多少集，单集多长。 |
| 画质 | 0.4 / 0.5 / 0.6 / 0.7 / 0.8 / 0.9 / 1.0 MP，实际可选范围由你的显存档位决定。 |
| 画面风格 | 从「视觉风格」技能池中全局单选，决定整部剧的画面长什么样。 |
| 提示词语言 | 生成提示词使用的语言。 |
| 图像风格 | 生图阶段的风格取向。 |
| 剧本技能 | 多选，只作用于剧本写作与生图规划阶段。 |
| 模型格式 | 多选，只作用于 H3 格式化阶段，决定镜头语言与拍摄手法。 |
| 仅生成剧本 | 勾选后只跑剧本阶段，不生成素材与视频。适合先确认故事线。 |
可以连续发起多个任务
多个出剧任务会自动排队串行执行，不需要等一个跑完再点下一个。睡前排三部，早上收成片。
六阶段流水线
- 剧本 按需求生成连贯分镜，或导入你自己的剧本。
- 素材 为每个角色生成定妆照、为每个场景生成空镜参考图。角色形象在这一步被永久锁定。
- 声线 为每个角色设计并绑定专属声线。
- 绑定 自动把角色 / 场景 / 道具素材挂到对应片段。
- 片段 批量生成视频片段。每段失败会自动重试。
- 导出 整集交叉淡化拼接成片，可混入背景音。
显存档位怎么选
点「📊 显存档位」可以查看本机的档位、编码器选型、DiT 驻留方式，以及该档可稳定生成的分辨率 × 时长范围。系统给出的可行性分三级：
| 等级 | 含义 |
|---|---|
| 稳定 | 该组合经过实测校准，可以放心跑。 |
| 临界 | 能跑，但显存接近上限。建议在生成期间关闭浏览器大页面与视频播放器。 |
| 不可行 | 会显存溢出。出剧入队前就会被拦下，并提示你降到多少以内。 |
≤ 8 GB 显存的机型，新建项目默认降到 0.4 MP 以保证稳定；你也可以在启动页手动选回 0.6 MP（属临界档）。
8G 机型生产参考（实测）
RTX 2080（Turing 算力）安全生产线为 0.4 MP，5 秒片段约 5–6 分钟。
同为 8 GB 的 3060 Ti（sm_86 原生 bf16）可以按 0.6 MP / 5s 生产，约 8 分钟。
差异来自算力而非显存容量。
生成过程实时跟随
点「🧠 生成过程」可以实时看到各阶段在做什么：采样步数、显存占用、当前片段。任务结束后仍可切换历史快照，回看当时的执行细节——排查问题非常有帮助。
Chapter 07
AI 助手
它不是一个只会聊天的对话框。AI 助手能真的读取你的剧本、改写提示词、生成图片、配音、排队出片，每一步都落到文件和素材库上。
能调用的 22 个工具
| 分类 | 工具 |
|---|---|
| 剧本 | 列出剧本、读取完整分镜、AI 创作剧本、逐字替换片段提示词、AI 润色某个片段 |
| 素材 | 列出素材库、浏览检索素材（可对话内预览下载）、AI 规划素材清单、生图入素材库、绑定素材到片段、逐片段检测绑定问题、执行绑定修复 |
| 绘画 | 自由绘画（文生图：海报 / 壁纸 / 插画 / 表情包底图）、指令改图（换装 / 换风格 / 改表情 / 加元素） |
| 声音 | 设定角色声线描述、生成声线样本、从已生成片段提取音轨作为声线 |
| 生产 | 批量生成片段（仅未完成 / 全部）、导出整集成片、列出某集可播放片段、查看队列与系统状态 |
| 附件 | 读取你上传的附件（txt / py / json 等，分段读取） |
对话框上方还有八个模式条入口，用来快速切换意图：图片生成 / 视频生成 / 素材库 / 翻译 / 文字提取 / 声线生成 / 一键出剧 / 剧本创作。
绘图与改图约定
- 说「画 / 做图 / 海报 / 壁纸 / 表情包」→ 直接出图，不反问、不用文字搪塞。
- 在已有图上修改（换装 / 换风格 / P 图）→ 走指令改图，原图保留。
- 只有明确要做视频用的角色 / 场景参考图，才会生成「素材」而非「画作」。
- 对话期间生图任务会暂缓，对话结束后自动执行，产物直接发回对话。
提示词技能（设置页可开关）
| 技能 | 默认 | 用途 |
|---|---|---|
| 镜头提示词写作 | 开 | 按 H3 写法输出镜头提示词 |
| 短视频营销文案 | 开 | 发布文案：标题 ×3 + 简介 + 话题标签 |
| 神反转续写 | 开 | 给剧情来 3 个出人意料但自洽的反转走向 |
| 弹幕吐槽 | 开 | 为剧情 / 片段生成玩梗弹幕 |
| 角色小剧场 | 开 | 以剧本角色的口吻陪你聊天 / 吐槽 / 演小剧场 |
| 角色档案卡 | 关 | 结构化角色档案（外貌 / 性格 / 关系 / 口头禅） |
版本更新新增的默认技能会自动合并进老用户配置。不想用请在设置里关开关，删除会被补回。
Chapter 08
技能系统
技能不是提示词模板，而是可执行的创作规范。AI 会从你的需求里提取关键词，做子串匹配，命中后读取对应技能文件并照着执行。
| 分类 | 作用范围 | 选择方式 |
|---|---|---|
| 视觉风格 | 决定画面长什么样（画风 / 美学 / 题材视觉包） | 风格池，全局单选 |
| 剧本技能 | 写剧本用的题材 / 结构 / 带货方法论 | 规范池，多选，只进剧本写作与生图规划 |
| 模型格式 | H3 契约、镜头语言、拍摄手法等「怎么输出 / 怎么拍」 | 规范池，多选，只进 H3 格式化阶段 |
加技能不用改代码
技能目录就是分类，往目录里丢一个 txt 就多一个技能。文件里写清「触发关键词」和「执行规范」两段即可。团队可以把自家方法论沉淀成技能，越用越强。
内置 免费专业技能，覆盖影视编剧、导演分镜、打戏调度、画风美学、商业广告、带货转化、营销分析等方向。
Chapter 09
生成与导出成片
生成片段
- 在「短剧制作」或「一键出剧」里批量生成片段，可选仅生成未完成的或重新生成全部。
- 每个片段生成完可以单独预览、单独重跑。片段列表提供「查看尾帧」「在目录中定位」「删除片段」等操作。
- 失败片段会自动重试；仍失败时错误会写明原因（多为显存不足，按提示降档即可）。
导出整集
- 导出时按分镜顺序拼接，片段之间做交叉淡化，避免硬切跳帧。
- 可以混入背景音轨，输出为可直接发布的成片文件。
- 成片落在资料目录（data）下，版权与文件都归你，与会员状态无关。
发布文案
用 AI 助手的「短视频营销文案」技能，可以一次生成三条标题、简介与话题标签，直接复制去发布。
Chapter 10
账号与授权
| 档位 | 时长 | 价格 |
|---|---|---|
| 正在读取最新价格… | ||
价格实时读取自授权服务，与客户端内「账号与授权」页显示完全一致。限时折扣期间会同时标出折前原价，实际支付以活动价为准。
- 支持卡密兑换与微信扫码支付，支付完成后授权自动开通。
- 登录凭证有效期 1 个月，到期自动续期。
- 离线宽限期 24 小时：断网时软件仍可正常使用，超过后需要联网校验一次。
Chapter 11
常见问题排查
生成速度异常慢
- 检查显卡驱动是否 ≥ 580。旧驱动会禁用 int8 / nvfp4 优化算子，推理慢 2–7 倍。
- 生成期间关闭浏览器大页面、视频播放器、其他吃显存/内存的程序。实测内存换页能让单步耗时从 80 秒退化到 210 秒。
- 桌面进程常驻 CUDA 时会影响显存预算，软件已默认关闭该策略，无需手动处理。
提示显存不足 / 生成被拦下
- 降低画质或缩短片段时长。系统拦截时会直接给出建议值（「降到多少以内」）。
- 点「📊 显存档位」确认当前档位与可行矩阵，选「稳定」等级的组合最保险。
- 片段时长越长、参考图越多，token 量越大、显存峰值越高。适当减少同时注入的参考图数量。
界面看起来「卡在最后 15 秒」
这是进度显示的假象：采样结束后进入解码 / 封装阶段，该阶段没有进度回调。低显存机型这一阶段可能需要数分钟。
此时请不要操作界面
不要点界面、不要切换窗口，等它落盘。软件会显示「收尾中（解码 / 封装）」提示，看到这行字就说明一切正常。
生成过程中界面无响应
- 多半是系统级内存换页，不是程序死锁。关闭其他占内存的程序后重试。
- 低显存机型建议 32 GB 内存；实测 28 GB 占用时叠加换页极易整机卡死。
角色在不同镜头里长得不一样
- 确认该角色有且只有一张定妆照，并且已绑定到所有相关片段。
- 跑一次「逐片段检测绑定问题」，让 AI 找出漏绑与错绑。
- 需要角色变状态（换装 / 受伤）时，请用「阶段素材」以定妆照为底做指令编辑，不要另生成一张新图。
背景人群数量 / 位置不一致
这是分镜描述的问题。群演的存在、位置、数量需要在每个镜头里重复声明，只有明确要求时才改变。用 AI 润色片段时把这条要求一起说清楚即可。
剧本 / 分镜质量不理想
- 剧本大模型是整部剧的大脑，成片上限首先由它决定。先去「⚙ 设置 → 🧠 大模型」确认当前用的是哪一档模型。
- 低显存机型建议切到 🌐 API（在线大模型）：既省下显存让画面更稳，又能用上比本地更强的模型，剧本与分镜质量往往明显提升。
- 用本地模型时，可在同一面板把档位手动调高；档位越高理解力越强，但需要更多内存。
模型下载中断 / 想换盘
- 重新进入「模型管理」点安装，已下载的部分会跳过，断点续传。
- 换盘：先改模型目录，再把已有模型文件整体搬过去，避免重下。
更新提示需要完整安装
这是正常的。当运行库本身发生变化时，增量更新无法送达，需要下载完整安装包重装。重装不会影响你的资料、素材与模型。
还是解决不了
把「🧠 生成过程」里的历史快照、以及出错时的提示信息一并发给技术支持。这些信息包含各阶段耗时与显存占用，能大幅缩短定位时间。