AI视频解说神器NarrotoAI Windows桌面版，一键安装使用指南AI视频解说神器NarrotoAI Windo

零基础玩转 AI 视频解说：NarrotoAI Windows 版完整上手指南

本文介绍如何在 Windows 上一键安装并使用 NarrotoAI，实现「上传视频 → AI 写脚本 → 自动配音 → 一键成片」的完整工作流。
项目仓库：github.com/brainShake/…
上游开源项目：linyqh/NarratoAI

写在前面：我为什么做 Windows 安装版？

NarratoAI 本身功能非常强大，但原版需要自行安装 Python、FFmpeg、配置虚拟环境和依赖，对普通用户并不友好。

于是我基于上游项目封装了 NarrotoAI Windows 桌面版：

✅ 双击 setup.exe 即可安装
✅ 内置 Python + FFmpeg + 全部依赖
✅ Electron 桌面窗口，无需手动开浏览器
✅ 支持桌面快捷方式、卸载程序

项目地址（下载安装包 & 使用文档）：

🔗 github.com/brainShake/…

安装包在 Releases 页面下载，当前最新版本 v0.7.9。

一、NarrotoAI 能做什么？

简单来说，NarrotoAI 是一款 AI 驱动的视频解说/混剪工具，核心能力包括：

能力	说明
🎬 视频画面分析	AI 理解视频内容，提取关键帧
✍️ 解说脚本生成	自动生成 JSON 格式分镜脚本
🎙️ 文本转语音	默认 Edge TTS，支持多种云端 TTS
✂️ 自动剪辑合成	裁剪、拼接、加字幕、导出成片

适合场景：

影视解说、纪录片解说
短视频二创、混剪
教程视频自动配音
已有脚本快速批量出片

二、整体工作流程

先看一张流程图，了解从素材到成片的完整路径：请添加图片描述

标准流程：

上传视频 → AI 分析画面 → 生成解说脚本 → 配置配音 → 一键生成成片

如果你已有写好的 JSON 脚本，也可以跳过 AI 生成，直接进入剪辑合成环节。

三、安装指南（3 步搞定）

系统要求

项目	要求
系统	Windows 10 / 11（64 位）
磁盘	建议预留 2 GB+
网络	AI 功能与 Edge TTS 需要联网
环境	无需安装 Python / FFmpeg

安装步骤

请添加图片描述

第 1 步：下载安装包

打开 GitHub Releases 页面：

👉 github.com/brainShake/…

下载 setup.exe（约 250 MB）。

第 2 步：运行安装程序

双击 setup.exe，按向导操作：

选择安装目录（默认即可）
✅ 勾选 「创建桌面快捷方式」
✅ 可勾选 「安装完成后立即运行」

💡 提示： 安装包未签名，Windows 可能弹出 SmartScreen 拦截，点击 「更多信息」→「仍要运行」 即可。

第 3 步：启动应用

从桌面或开始菜单打开 NarratoAI。首次启动约需 30 秒～2 分钟，后台正在加载 Python 与界面服务，请耐心等待。

四、首次使用：配置 API Key

应用可以安装后直接打开，但 AI 自动生成解说脚本 需要配置大模型 API。

4.1 进入基础设置

启动后，在界面左侧找到 「基础设置」，需要配置两组模型：

模型类型	用途	示例平台
视觉模型	分析视频画面	SiliconFlow、OpenAI、Gemini
文本模型	生成解说文案	DeepSeek、Qwen、OpenAI

4.2 推荐配置（国内用户）

以 SiliconFlow 硅基流动为例：

视觉模型 Base URL: https://api.siliconflow.cn/v1
文本模型 Base URL: https://api.siliconflow.cn/v1
API Key: （在平台注册后获取）

填写完成后，点击 「连通性测试」，显示成功即可保存。

4.3 配音配置（默认即可）

默认使用 Edge TTS（微软免费语音），无需额外配置，联网即可使用。

如需更高质量的配音，可在 「音频设置」 中切换为 Azure、腾讯云、豆包等引擎。

五、实战：从视频到成片

方式 A：AI 全自动（推荐新手）

① 上传视频

在「脚本设置」区域：

「视频文件」选择 「上传本地文件」
选择 MP4 / MOV / AVI 等格式

② 选择 AI 生成模式

脚本模式选择 「AI 自动生成解说脚本」（或类似选项）。

③ 填写主题（可选）

在提示词/主题栏描述你想要的解说风格，例如：

用轻松幽默的语气解说这部科幻电影，突出视觉特效和剧情反转。

④ 生成脚本

点击 「AI 生成画面解说脚本」，等待 AI 分析视频并输出 JSON 脚本。耗时取决于视频长度和 API 响应速度。

⑤ 检查脚本

在脚本编辑区检查每一段的：

时间戳是否准确
解说文案是否通顺
画面描述是否匹配

⑥ 生成视频

配置好配音、字幕等选项后，点击 「生成视频」。程序会自动完成：

视频裁剪
TTS 配音
字幕叠加
音视频合成

完成后在任务输出目录查看 combined.mp4 等文件。

方式 B：使用已有脚本（适合老手）

如果你已经有 JSON 脚本：

「脚本文件」选择 「上传脚本文件」
上传 .json 脚本
选择对应源视频
直接点击 「生成视频」

六、目录结构说明

安装后，数据保存在：

%LOCALAPPDATA%\Programs\NarratoAI\resources\narratoai\

目录	内容
`resource\scripts\`	保存的 AI 脚本
`resource\videos\`	上传的源视频
`storage\tasks\`	任务输出（成片、音频、字幕）
`config.toml`	配置文件

日志文件位置：

%APPDATA%\narratoai-desktop\logs\streamlit.log

遇到问题时，优先查看这个日志。

七、常见问题 FAQ

Q1：双击 setup.exe 没反应？

等待 10～30 秒（杀毒软件可能在扫描）
检查任务管理器是否已有 setup.exe 在运行
被 SmartScreen 拦截时手动允许运行

Q2：安装后桌面没有快捷方式？

确认安装时勾选了「创建桌面快捷方式」
OneDrive 用户请到 OneDrive\桌面 文件夹查找
也可从开始菜单搜索 NarratoAI

Q3：AI 脚本生成失败？

检查 API Key 是否正确、是否有余额
确认 Base URL 与模型名称匹配
在「基础设置」执行连通性测试
国内用户建议使用 SiliconFlow 等国内平台

Q4：下拉列表里有旧脚本/旧视频？

下拉列表读取的是本机已保存文件。删除以下目录中的文件后重启应用即可：

resource\scripts\
resource\videos\

Q5：和原版 NarratoAI 有什么区别？

对比项	原版 NarratoAI	Windows 安装版
安装方式	手动配 Python 环境	setup.exe 一键安装
使用方式	浏览器打开 Streamlit	Electron 桌面窗口
FFmpeg	需自行安装	已内置
功能	完整	完整（基于上游封装）