羽镜世界 · 使用手册
其实你不必读这份手册。软件里所有功能都能直接跟萌萌说,她记得你的偏好、看得懂画面和台词,不满意就让她重新改——卡住问她比翻手册快。
真要查细节(参数含义、排障、目录结构),再看下面这些章节;遇到问题优先看第十一章「常见问题排查」。
安装与首次启动
开拍前的硬件检查
本地生成吃的是显卡,先确认三件事,能省掉后面 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 可用空间 | 安装包 + 运行库 + 模型的总和。安装根目录建议选一个大盘。 |
下载与安装
- 访问唯一下载地址 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。
- 等待安装完成,启动软件。
被提示「病毒 / 不安全」怎么办
这是误报,不是文件有问题。羽镜世界是本地运行的 AI 影视软件,需要调用显卡、读写你指定目录里的大量文件、并在安装时下载运行库——这些行为和「可疑程序」的特征有重叠;再加上安装包目前没有商业代码签名,Windows 与安全软件对没有数字签名的陌生程序会保守拦截。只需在首次安装时放行一次,之后不会再打扰你。
① Windows 11 提示「Windows 已保护你的电脑」(SmartScreen)
- 点弹窗左下角的 「更多信息」(字号很小,容易被忽略)。
- 点随后出现的 「仍要运行」,安装即可继续。
- 如果是在浏览器里下的,先在下载栏右键该文件 → 「保留」,再双击。
② Microsoft Defender 报「威胁」/ 已隔离
- 打开「Windows 安全中心 → 病毒和威胁防护 → 保护历史记录」,找到对应条目,在「操作」里选 「允许」。
- 文件若已被隔离,选 「还原」;然后在该页「排除项」里,把安装包所在目录加进白名单。
③ 360 / 火绒 / 腾讯电脑管家
- 弹窗拦截时选 「信任」「允许本次操作」或「添加信任区」——千万不要点「立即清理 / 立即删除」。
- 文件已经被删或隔离:进软件的「隔离区 / 恢复区」把它还原,再把安装包所在目录加入信任区 / 白名单,重新双击安装。
首次启动向导
第一次打开会进入初始化向导,它会做三件事:
- 硬件体检 检测显卡型号、显存、驱动版本与内存,并给出你这台机器属于哪一档。
- 安装模型 列出需要下载的运行库与模型清单,点「一键安装」开始。这一步是唯一耗时较长的环节。
- 账号登录 新账号注册即自动赠送 3 天免费体验,无需领取。软件启动需联网完成授权校验,生成过程本身在本地完成。
模型安装与运行库
一键安装清单
「一键安装」会依次准备以下内容,你可以看到每一项的进度:
| 项目 | 作用 | 体积参考 |
|---|---|---|
| 生成运行库 | 视频 / 图片 / 声线三条生成管线共用的 PyTorch 与算子库。驱动不足 580 时会标为「待升级驱动后安装」。 | 约 3.5 GB |
| 本地大语言模型 | 负责剧本创作、小说推导、AI 助手对话,190K 上下文。也可以改用在线 API,则无需下载这一项(见下一节)。 | 数十 GB |
| 文生图 / 图生图模型 | 角色定妆照、场景空镜、道具特写,以及阶段素材的指令编辑。 | 数十 GB |
| 视频生成模型 | MiniMax H3 全参考结构 + Turbo 加速,负责片段视频。 | 数十 GB |
| 声线合成模型 | Qwen3-TTS 声音设计,为角色生成专属声线。 | 数 GB |
剧本大模型:本地 / API 两种来源
剧本大模型是整部剧的大脑——剧本质量、分镜拆解、素材规划都由它决定,它直接决定成片的上限。软件支持两种来源,在「⚙ 设置 → 🧠 大模型 → 剧本生成模型来源」里切换:
| 来源 | 显存 / 内存占用 | 适合谁 |
|---|---|---|
| 🌐 API(在线大模型) | 不占显存,也不占内存 | 低显存机型(8–12 GB)强烈建议;想挂更强的模型追求剧本质量上限;内存偏紧的机器。 |
| 💻 本地大模型 | 常驻内存,按显存自动选档 | 断网 / 私有化场景,不希望剧本内容离开本机。 |
驱动过旧怎么办
如果体检发现驱动低于 580,向导会明确提示,并采取「暂缓安装运行库」策略:
- 模型文件可以照常下载,只是暂时不能生成。
- 本地大模型的剧本创作不受影响,你依然可以让 AI 写剧本、规划素材。
- 升级驱动到 580 以上并重启软件后,回到「模型管理」点一键安装,会自动装上全速运行库,模型无需重新下载。
换模型目录 / 重装运行库
- 模型目录可以随时在「模型管理」页更改,改完重启软件生效。已有模型可以手动搬到新目录,避免重下。
- 需要重装运行库(例如升级驱动后、或换了显卡)时,同样在「模型管理」页操作,不会动你的模型文件与素材。
- 软件更新是增量的:只有运行库本身发生变化时,才会要求完整安装,此时用户数据与素材完整保留。
界面导航
左侧导航栏六个入口,日常创作按这个顺序走就够了:
| 入口 | 做什么 |
|---|---|
| 萌萌(AI 助手) | 从这里开始。说需求、丢小说、提改动,她负责把整部剧做完。详见第七章。 |
| 工作台 | 按剧集组织的制作台,逐片段预览、改分镜、生成、调整、导出。 |
| 剧本管理 | 导入 / 导出剧本,查看与编辑分镜,管理剧集结构,续写既有剧。 |
| 素材管理 | 角色定妆照、场景空镜、道具特写、声线样本的统一仓库,负责素材与片段的绑定。 |
| 任务队列 | 查看当前排队与执行中的生成任务,支持取消与重排。 |
| 模型管理 | 模型安装 / 更新 / 迁移,运行库重装,显存档位查看。 |
右上角两个按钮:账号(会员状态、卡密兑换)与 设置(大模型来源、生图模型、技能开关、目录设置等)。
剧本管理
导入剧本(1:1 复刻)
这是羽镜世界最核心的能力之一。支持几乎任何格式的剧本文件,导入即还原分镜结构,不改动你的原文一个字。
- 进入「剧本管理」,选择导入剧本,上传你的文件(txt / docx / 结构化文本等均可)。
- 系统解析出角色、场景与分镜片段,逐条列出供你核对。
- 确认后进入素材规划阶段,或直接交给萌萌出片。
让 AI 写剧本
都在萌萌那里完成,你说一句就行:
- 按需求创作 「写一部 2 集都市逆袭短剧,节奏快一点」——她先跟你确认题材、集数、画风,再动笔。
- 小说改编 把小说文件当附件发给她,她通读后推导人设与剧情线,改编取舍会先给你过目。
- 已有分镜直接建剧 你手上已有素材图 + 写好的分镜提示词,她直接拆集拆段、按名绑定,不重新创作。
修改与润色片段
- 逐字替换 对某一片段的提示词做机械替换,改一处不影响全篇。
- AI 润色 让 AI 改写某个片段的提示词。它会带上时长、前一个镜头、已绑定素材作为上下文,改完直接保存。
- 承接标记 片段之间的切换承接关系可以单独改写,这是保证镜头连贯、不跳戏的关键。
素材与声线
素材类型
| 类型 | 用途 |
|---|---|
| 角色定妆照 | 全身立姿形象图,是该角色在整部剧里的唯一形象锚点。视频阶段每个角色只注入这一张,避免多图互相污染导致脸变。 |
| 阶段素材 | 以定妆照为底做指令编辑:换服装、受伤、变身、换装备、改气场。人还是同一个人,只是状态变了。 |
| 场景空镜 | 场景参考图,用于统一同一场戏的空间质感与光线。 |
| 道具特写 | 关键道具的形象参考。 |
| 声线样本 | 角色专属音色,可绑定到角色,全剧复用。 |
| 画作 | AI 助手自由绘画与改图的产物,可下载、可再编辑。 |
绑定与体检修复
素材只有绑定到片段,生成时才会被注入。手工绑定之外,更推荐让萌萌做体检:
- 逐片段检测绑定问题 她扫描全剧,汇报哪些片段错绑、漏绑、绑了不该绑的素材。
- 确认后一键修复 修正错绑关系,对缺失的素材自动生图并绑定。
建议在开始批量生成片段之前跑一次体检——事后返工的成本远高于事前检查。
声线设计
- 文字描述生成 用一段文字描述你想要的音色(年龄、性别、音调、气质、语速),系统生成声线样本。
- 从成片提取 如果你已经生成过带对白的片段,可以直接把其中的音轨提取出来作为该角色的声线样本,保证后续剧集音色完全一致。
续写与流水线
做整部剧请找萌萌(第七章)。固定流水线没有消失,只是收窄成一件事:给一部已经存在的剧往后加几集。
怎么发起续写
打开「剧本管理」,找到那部剧,点续写,只填一个数字就能开跑:
| 参数 | 说明 |
|---|---|
| 新增集数 | 1–5 集,从这部剧的下一集开始写,新集并入同一部剧,不会新建项目。 |
| 画风 / 时长 / 语言 / 技能 | 自动继承这部剧原来的配置,不用重选,也不会跑着跑着变风格。 |
| 前情衔接 | AI 自己回读已有剧本、角色定妆照和声线,接着往下写,角色不会换脸、不会变声。 |
进度在出剧页查看。多个任务自动排队串行执行,不用等一个跑完再发起下一个。
六阶段流水线
续写跑的是同一套流程,只是每一步都会先读这部剧已有的产物:
- 剧本 回读已有分镜与前情,接着往下写新集。
- 素材 老角色沿用原定妆照,只给新出现的角色和场景补图。
- 声线 老角色沿用原声线,只给新角色配音色。
- 绑定 自动把角色 / 场景 / 道具素材挂到对应片段。
- 片段 批量生成视频片段。每段失败会自动重试。
- 导出 整集交叉淡化拼接成片,可混入背景音。
显存档位怎么选
点「📊 显存档位」可以查看本机的档位、编码器选型、DiT 驻留方式,以及该档可稳定生成的分辨率 × 时长范围。系统给出的可行性分三级:
| 等级 | 含义 |
|---|---|
| 稳定 | 该组合经过实测校准,可以放心跑。 |
| 临界 | 能跑,但显存接近上限。建议在生成期间关闭浏览器大页面与视频播放器。 |
| 不可行 | 会显存溢出。出剧入队前就会被拦下,并提示你降到多少以内。 |
≤ 8 GB 显存的机型,新建项目默认降到 0.4 MP 以保证稳定;你也可以在启动页手动选回 0.6 MP(属临界档)。
生成过程实时跟随
点「🧠 生成过程」可以实时看到各阶段在做什么:采样步数、显存占用、当前片段。任务结束后仍可切换历史快照,回看当时的执行细节——排查问题非常有帮助。
AI 助手 萌萌
萌萌是装在你自己电脑里的私人助手,也是这部软件里真正干活的人。她有记忆(你说过的重要偏好她跨会话记着,只存本机)、 能联网(查最新资料、整理网络素材)、看得懂画面和声音(抽帧看片、转写台词)。 她不是聊天框:读剧本、改提示词、生成图片和声线、绑片段排队、导出成片,每一步都落到文件和素材库上。 整部剧从第一集到最后一集,都是她做的。
第一次用,说这三句
不用记命令,像跟人说话一样讲清楚就行。下面三句覆盖了新手最常做的事:
| 你说 | 她做 |
|---|---|
| 把这份小说改成 2 集都市短剧 | 通读原文、写分镜、备角色和场景素材、配声线、绑片段、出成片,全程自己排完。 |
| 先只写剧本给我看,别生成视频 | 只跑剧本阶段,你确认故事线之后再让她继续。 |
| 第 3 集第 5 段重跑一遍 | 只动那一段,已经跑好的其他片段一个都不碰。 |
她能做的事
八十多项能力,都在她手边,你不需要知道名字,说出来她就知道该调哪个:
| 方向 | 典型的事 |
|---|---|
| 记忆 | 你说过的重要偏好和设定,她跨会话记着,下次不用重复交代;记忆只存在本机。 |
| 联网 | 查最新资讯与资料、把散在多个网页的参考图和信息整理成一份清单,需要时存进素材库。 |
| 剧本 | 按需求创作、小说改编、逐段改写与润色、检查剧情前后矛盾。 |
| 素材 | 规划角色与场景清单、生成定妆照与场景锚点图、入库检索、绑定到片段、全剧体检并修复错绑漏绑。 |
| 设定与笔记 | 批量整理人物设定(外貌 / 性格 / 声线 / 各阶段状态),把需求、规划、分集大纲写成文件留在项目里。 |
| 声线 | 按文字描述造音色、从已有成片里提取音轨,保证同一角色从头到尾一个声音。 |
| 连贯 | 重新规划镜头衔接(承接链过长就改切镜)、检查相邻片段接不接得上、角色有没有换脸换衣、发现问题定点重跑那一段。 |
| 生产 | 批量生成片段、批量微调提示词(先出改动清单、写前自动备份、可还原)、看队列和显存、合并预览、导出整集成片、失败片段补跑。 |
| 绘画 | 海报、壁纸、插画、表情包底图;在已有图上换装、换风格、改表情。 |
| 周边 | 发布文案与话题标签、剧情反转走向、角色档案卡、角色口吻陪聊。 |
怎么配合最省事
- 说目标,不说步骤 「这段拍得不像」比「把提示词第三句删掉」更好用,她自己知道改哪里。
- 她会反过来问你 画风、集数、改编取舍这类要你拍板的事,她弹卡片确认,不自己瞎猜。
- 点名要具体 说「第 3 集第 5 段」,界面序号就是她认的序号,不用报内部编号。
- 不确定就直接问她 「这个能不能做」「现在进行到哪了」,她会照实回答。
- 跑长任务不用守着 她会在后台排队执行,你随时回来问进度,或者让她先停下。
绘图与改图约定
- 说「画 / 做图 / 海报 / 壁纸 / 表情包」→ 直接出图,不反问、不用文字搪塞。
- 在已有图上修改(换装 / 换风格 / P 图)→ 走指令改图,原图保留。
- 只有明确要做视频用的角色 / 场景参考图,才会生成「素材」而非「画作」。
- 对话期间生图任务会暂缓,对话结束后自动执行,产物直接发回对话。
提示词技能(设置页可开关)
| 技能 | 默认 | 用途 |
|---|---|---|
| 镜头提示词写作 | 开 | 按 H3 写法输出镜头提示词 |
| 短视频营销文案 | 开 | 发布文案:标题 ×3 + 简介 + 话题标签 |
| 神反转续写 | 开 | 给剧情来 3 个出人意料但自洽的反转走向 |
| 弹幕吐槽 | 开 | 为剧情 / 片段生成玩梗弹幕 |
| 角色小剧场 | 开 | 以剧本角色的口吻陪你聊天 / 吐槽 / 演小剧场 |
| 角色档案卡 | 关 | 结构化角色档案(外貌 / 性格 / 关系 / 口头禅) |
版本更新新增的默认技能会自动合并进老用户配置。不想用请在设置里关开关,删除会被补回。
技能系统
技能不是提示词模板,而是可执行的创作规范。AI 会从你的需求里提取关键词,做子串匹配,命中后读取对应技能文件并照着执行。
| 分类 | 作用范围 | 选择方式 |
|---|---|---|
| 视觉风格 | 决定画面长什么样(画风 / 美学 / 题材视觉包) | 风格池,全局单选 |
| 剧本技巧 | 写剧本、写提示词用的方法论(H3 规范 / 连贯 / 人物 / 声线 / 分镜运镜 / 打斗等,全部同级) | 规范池,多选,按技能头部「阶段」进入写作或格式化 |
内置 免费专业技能,覆盖影视编剧、导演分镜、打戏调度、画风美学、商业广告、带货转化、营销分析等方向。
生成与导出成片
生成片段
- 在「工作台」里批量生成片段,或直接跟萌萌说一声,可选仅生成未完成的或重新生成全部。
- 每个片段生成完可以单独预览、单独重跑。片段列表提供「查看尾帧」「在目录中定位」「删除片段」等操作。
- 失败片段会自动重试;仍失败时错误会写明原因(多为显存不足,按提示降档即可)。
导出整集
- 导出时按分镜顺序拼接,片段之间做交叉淡化,避免硬切跳帧。
- 可以混入背景音轨,输出为可直接发布的成片文件。
- 成片落在资料目录(data)下,版权与文件都归你,与会员状态无关。
发布文案
用 AI 助手的「短视频营销文案」技能,可以一次生成三条标题、简介与话题标签,直接复制去发布。
账号与授权
| 档位 | 时长 | 价格 |
|---|---|---|
| 正在读取最新价格… | ||
价格实时读取自授权服务,与客户端内「账号与授权」页显示完全一致。限时折扣期间会同时标出折前原价,实际支付以活动价为准。
- 支持卡密兑换与微信扫码支付,支付完成后授权自动开通。
- 登录凭证有效期 1 个月,到期自动续期。
- 软件启动与使用过程中需联网完成授权校验(心跳),请保持网络畅通。
- 会员到期后已生成的成片与资料不受影响,文件都在你自己的硬盘上。
常见问题排查
安装包被杀毒软件删除 / 提示病毒
属于误报。按第一章「被提示「病毒 / 不安全」怎么办」把文件从隔离区还原并加入信任区即可;安装包请只从官方地址重新下载。
生成速度异常慢
- 检查显卡驱动是否 ≥ 580。旧驱动会禁用 int8 / nvfp4 优化算子,推理慢 2–7 倍。
- 生成期间关闭浏览器大页面、视频播放器、其他吃显存/内存的程序。实测内存换页能让单步耗时从 80 秒退化到 210 秒。
- 桌面进程常驻 CUDA 时会影响显存预算,软件已默认关闭该策略,无需手动处理。
提示显存不足 / 生成被拦下
- 降低画质或缩短片段时长。系统拦截时会直接给出建议值(「降到多少以内」)。
- 点「📊 显存档位」确认当前档位与可行矩阵,选「稳定」等级的组合最保险。
- 片段时长越长、参考图越多,token 量越大、显存峰值越高。适当减少同时注入的参考图数量。
界面看起来「卡在最后 15 秒」
这是进度显示的假象:采样结束后进入解码 / 封装阶段,该阶段没有进度回调。低显存机型这一阶段可能需要数分钟。
生成过程中界面无响应
- 多半是系统级内存换页,不是程序死锁。关闭其他占内存的程序后重试。
- 低显存机型建议 32 GB 内存;实测 28 GB 占用时叠加换页极易整机卡死。
角色在不同镜头里长得不一样
- 确认该角色有且只有一张定妆照,并且已绑定到所有相关片段。
- 跑一次「逐片段检测绑定问题」,让 AI 找出漏绑与错绑。
- 需要角色变状态(换装 / 受伤)时,请用「阶段素材」以定妆照为底做指令编辑,不要另生成一张新图。
背景人群数量 / 位置不一致
这是分镜描述的问题。群演的存在、位置、数量需要在每个镜头里重复声明,只有明确要求时才改变。用 AI 润色片段时把这条要求一起说清楚即可。
剧本 / 分镜质量不理想
- 剧本大模型是整部剧的大脑,成片上限首先由它决定。先去「⚙ 设置 → 🧠 大模型」确认当前用的是哪一档模型。
- 低显存机型建议切到 🌐 API(在线大模型):既省下显存让画面更稳,又能用上比本地更强的模型,剧本与分镜质量往往明显提升。
- 用本地模型时,可在同一面板把档位手动调高;档位越高理解力越强,但需要更多内存。
模型下载中断 / 想换盘
- 重新进入「模型管理」点安装,已下载的部分会跳过,断点续传。
- 换盘:先改模型目录,再把已有模型文件整体搬过去,避免重下。
更新提示需要完整安装
这是正常的。当运行库本身发生变化时,增量更新无法送达,需要下载完整安装包重装。重装不会影响你的资料、素材与模型。
还是解决不了
把「🧠 生成过程」里的历史快照、以及出错时的提示信息一并发给技术支持。这些信息包含各阶段耗时与显存占用,能大幅缩短定位时间。