使用文档

快速开始

整条流程只有三步：写脚本 → 切分镜 → 生成视频。第一次使用建议按下面的顺序走一遍。

1. 安装并启动软件，进入左侧「设置」，先配置一个文案大模型（例如 DeepSeek），填入 API Key。
2. 配置视频模型：在「设置 → 视频生成」选择火山方舟 Seedance 并填入方舟 API Key；暂时没有 Key 就选「本地模拟」。
3. 回到「工作台」新建项目，填好选题、平台、时长与卖点，保存后会自动跳到「策划脚本」。
4. 在「策划脚本」点生成脚本，满意后进入「切分镜」一键拆镜头，再把提示词润色一遍。
5. 进入「生成视频」，勾选镜头批量生成；完成后在「分镜表导出」里导出 CSV，拿去剪辑软件对轴。

安装、启动与数据目录

安装

安装包是标准的 Windows NSIS 安装程序，默认按当前用户安装，不需要管理员权限。若 Windows 弹出 SmartScreen 提示，点「更多信息 → 仍要运行」即可。

数据存在哪里

软件不使用云端账号，所有内容都在本机，默认位置如下（%APPDATA% 即 C:\Users\你的用户名\AppData\Roaming）：

软件内「设置 → 存储与关于」会显示当前实际路径，以那里的为准（开发模式下的目录名可能不同）。

自定义媒体目录

在「设置 → 存储与关于」里把媒体目录改成移动硬盘或 NAS 路径，之后生成的片段会直接落到那里。切换目录不会自动搬移旧文件， 换目录前请自行复制历史素材。

界面导览

左侧边栏分为三组，对应「项目 → 创作流程 → 系统」：

• 工作台：所有项目列表与整体进度，也是新建项目的地方。
• 策划脚本：创作简报、脚本生成与编辑、按意见修改、历史版本。
• 切分镜：镜头表编辑、提示词润色、单镜重写、导出分镜表。
• 生成视频：生成参数、批量队列、进度与失败重试、片段下载与定位。
• 设置：文案模型、视频提供方、界面主题与强调色、存储路径。

侧边栏底部会显示当前项目与模型配置状态；如果你看到「模型未配置」，说明还没填 API Key，去设置里补上即可。 点击侧栏底部的按钮可以收起侧栏，正文区会变得更宽。

配置文案大模型

策划脚本、切分镜、提示词润色都依赖文案大模型。软件只支持OpenAI 兼容接口， 也就是说任何提供 /chat/completions 的服务都能用。

配置步骤

1. 打开「设置 → 文案大模型」。
2. 在预设里点选服务商（DeepSeek、通义千问、Kimi、智谱 GLM、OpenAI、本地 Ollama），会自动填好 Base URL 与模型名。
3. 把该服务商的 API Key 粘贴进去。Key 只保存在本机 settings.json 里，不会上传。
4. 如果你的服务商不在列表里，选「自定义」手动填 Base URL（通常以 /v1 结尾）和模型名。

自定义系统提示词

系统提示词决定 AI 的"人设"。例如：

注意：自定义提示词只替换"风格层"，程序仍会强制附加本次任务的上下文（选题、平台、时长、受众等）和 输出结构契约，所以你改坏提示词也不会导致模型漏掉必要信息。

常见报错

• 401 Unauthorized：Key 填错或已失效。
• 404 Not Found：Base URL 不对，多数服务商需要以 /v1 结尾。
• 429 Too Many Requests：触发限流，降低生成频率或提升账号额度。
• 超时：本地 Ollama 首次加载模型较慢，属正常现象，稍等或换更小的模型。

配置视频模型（即梦 / Seedance）

即梦（Dreamina）与 Seedance 同源，目前官方对外通道是火山方舟。 在「设置 → 视频生成」选择提供方，有三个选项：

• 火山方舟 Seedance：填入方舟 API Key，可选模型见下表。
• 自定义 HTTP：填你自己的接口地址，用于对接自建服务或其它视频模型通道。
• 本地模拟：不调用任何接口，生成占位结果，用来验证流程。

可选的 Seedance 模型

方舟 API Key 怎么拿

1. 注册并登录火山引擎，进入「火山方舟」控制台。
2. 在模型广场开通 Seedance 系列的视频生成模型。
3. 在「API Key 管理」创建密钥，复制后粘贴到软件设置里。
4. 如提示权限或额度问题，检查是否已实名认证、账户是否有余额。

费用、并发与限流

软件本身不参与计费，也不中转请求——你的 Key 直接调用服务商接口，费用按服务商定价结算。

• 先试一镜：把整表提示词风格定下来之后再批量跑，能省掉大量废片费用。
• 并发别拉满：并发数 1–4 可调。免费或低额度账号建议先用 1–2 路，否则容易触发限流。
• 分辨率与时长：480p / 5 秒最省，1080p / 10 秒最贵；试错阶段用低档，定稿再重跑关键镜头。
• 失败重试：失败镜头用「重试失败项」补跑即可，不用整批重来。

策划脚本

简报决定质量

同一句选题，简报填写得越具体，脚本就越像"你要的那条"。几个容易被忽略的字段：

• 发布平台：决定节奏和开头写法，不是装饰。
• 必须讲到的信息点：把卖点、数字、结论写进去，避免 AI 只讲正确的废话。
• 参考账号 / 作品：想模仿谁的结构，写上去比描述风格更有效。
• 其他要求：例如"不要出现具体品牌名""结尾引导关注""不要用问句开头"。

按意见修改怎么写

不用重写简报，直接在「按意见修改」里说人话就行。有效的意见通常包含"位置 + 问题 + 期望"：

历史版本

每次生成与修改都会留档，改坏了可以直接回滚到之前的版本，不必重新生成。

切分镜与提示词写法

从脚本到镜头表

点「切分镜」后，软件会把脚本拆成镜头，并给每个镜头补上景别、运镜、时长、画面描述、英文视频提示词、 旁白台词、屏幕字幕与音效备注。整表可以直接编辑，也能拖动排序。

提示词怎么写更容易出片

视频模型对画面描述的容忍度比大模型低，一句提示词里塞进这五类信息，出片率会明显提升：

• 用英文写，逗号分隔，不要写完整句子。
• 一次只描述一个动作，动作太多画面会糊。
• 避免抽象词（"高级感""氛围感"），改成具体的画面元素（"暖色台灯""窗外雨滴"）。
• 镜头运动写清楚：slow push in、orbit、static shot、handheld。

润色与单镜重写

「润色提示词」会把中文画面描述改写成更规范的英文提示词；「重写这一镜」则重新生成整个镜头的描述与提示词。 两者都只影响当前镜头，不会动其它镜头。

批量生成视频

参数怎么选

• 画幅：竖屏短视频用 9:16；横屏科普、B站内容用 16:9；图文卡片用 1:1。
• 分辨率：480p 用于试跑，720p 日常够用，1080p 留给重点镜头。
• 时长：5 秒更省，10 秒镜头更完整；与分镜表里的单镜时长保持一致。
• 并发：1–4 路，视账号额度而定。
• 生成音频：需要模型自带音效时开启；后续要自己配音就关掉。

队列操作

1. 在镜头列表里勾选要生成的镜头（支持「全选」「只选未完成」「清空」）。
2. 点「开始生成」，队列按并发数依次投递任务，列表里能看到百分比进度。
3. 用筛选器切换「全部 / 待处理 / 已完成 / 失败」查看结果。
4. 失败镜头点「重试失败项」批量补跑，或进单镜详情单独重跑。

片段去哪了

生成完成后软件会把视频下载到媒体目录，并在镜头详情里记录本地文件路径、远端地址、任务 ID、使用模型与完成时间。 列表里可以直接播放预览、在文件夹中定位，或用系统播放器打开。

导出与剪辑对轴

「切分镜」页面的导出支持三种格式，用途不同：

进剪辑软件时按镜头号命名素材（shot-01.mp4、shot-02.mp4…）， 把 CSV 里的时长列当作时间轴参考，配音和字幕直接照抄表格，基本不需要再回头问脚本细节。

效率技巧

• 先建"模板项目"：把常用的平台、调性、受众填好，之后复制这个项目的简报改选题，比每次从零填快很多。
• 批量选择有捷径：生成页支持「只选未完成」，重跑整条片子时不用一个个勾。
• 用筛选定位问题：切到「失败」筛选，一眼看到哪几镜需要重跑。
• 界面按习惯调：设置里可切深色/浅色主题与 4 种强调色，侧栏能收起，宽屏下编辑长提示词更舒服。
• 一个选题一个项目：项目之间互不干扰，重做方案时不用把旧内容删干净。

备份、迁移与卸载

备份

• 项目文件：复制 data\projects 整个目录。
• 视频片段：复制你在设置里指定的媒体目录（默认 data\media）。
• 模型配置：data\settings.json 里有 API Key，分享备份文件前请先去掉密钥。

换电脑

1. 在新电脑装好软件并启动一次，让它生成默认目录。
2. 退出软件，把旧的 projects、media 与 settings.json 覆盖过去。
3. 重新打开软件，项目与生成状态都会回来；如果片段显示路径失效，把媒体目录指到新位置即可。

卸载

走 Windows「设置 → 应用 → 已安装的应用」卸载即可。卸载程序不会删除你的项目和素材， 需要手动清理 %APPDATA%\AI 视频工坊。

常见问题排查