企业官网建设流程全解析

FireRed-OpenStoryline新手教程:6个基础操作掌握对话式剪辑、中断重做与文风仿写

【免费下载链接】FireRed-OpenStorylineFireRed-OpenStoryline is an AI video editing agent that transforms manual editing into intention-driven directing through natural language interaction, LLM-powered planning, and precise tool orchestration. It facilitates transparent, human-in-the-loop creation with reusable Style Skills for consistent, professional storytelling.项目地址: https://gitcode.com/gh_mirrors/fi/FireRed-OpenStoryline

本文围绕开源 AI 视频剪辑智能体FireRed-OpenStoryline展开，手把手带你完成 6 个基础操作：安装启动、API-Key 配置、对话式剪辑、自然语言精修重做、中断控制与文风仿写，帮助新手零剪辑经验也能快速产出第一条成片。

FireRed-OpenStoryline 是一个AI 视频剪辑 Agent：你用自然语言描述剪辑意图，它通过 LLM 规划 + 工具编排完成素材理解、文案、配音、BGM 推荐与渲染，全程透明、可随时人工干预。下面按 6 个基础操作逐步上手。

操作一：一键克隆并启动服务

环境要求 Python ≥ 3.11（推荐 Conda）。

1️⃣ 克隆仓库并创建环境：

git clone https://gitcode.com/gh_mirrors/fi/FireRed-OpenStoryline cd FireRed-OpenStoryline conda create -n storyline python=3.11 && conda activate storyline

2️⃣ 安装依赖（Linux / macOS 可一键安装；Windows 手动安装步骤见 README_zh.md）：

sh build_env.sh

3️⃣ 启动 MCP 服务与 Web 界面（两个终端）：

# 终端 1：MCP 服务器 PYTHONPATH=src python -m open_storyline.mcp.server # 终端 2：Web 对话界面，浏览器访问 http://127.0.0.1:7860 uvicorn agent_fastapi:app --host 127.0.0.1 --port 7860

💡 也可以跳过本地安装，直接使用 Docker 镜像一键部署，命令见 README_zh.md 的 Docker 部署章节；偏好命令行交互的可用 cli.py。

操作二：5分钟配好 API-Key

启动后必须先配置模型密钥，否则 Agent 无法工作。两种方式任选：

• Web 侧边栏（推荐新手）：左侧栏可分别填写 LLM、VLM、Pexels、TTS 的模型与 API Key，详见 web/index.html 对应的侧边栏面板；
• 配置文件：编辑根目录 config.toml，在[llm]、[vlm]、[search_media]等段落下填入 model、base_url、api_key。

各平台申请方式与参数对照表见 docs/source/zh/api-key.md。

⚠️ 提示：不填 Pexels Key 就无法在线搜素材，此时请直接上传本地图片/视频。

操作三：对话式剪辑，剪出第一条视频

打开 Web 界面后，有素材和无素材两种玩法（详见 docs/source/zh/guide.md）：

发送后 Agent 会先列出剪辑计划，确认后依次执行：镜头切分 → 筛选/理解片段 → 生成文案与配音 → 推荐 BGM/字体 → 组织时间线 → 渲染成片。你可以在聊天流里实时查看每一步的工具卡片（搜索素材、组织时间线、渲染视频等），过程完全透明。

操作四：自然语言精修与局部重做

成片不满意？不用从头再来。任意阶段完成后可直接用一句话干预，Agent 会定位到需要重跑的步骤执行"局部重做"：

• "帮我去掉那个拍摄天空的片段。"
• "换一个欢快一点的背景音乐。"
• "字幕换成更符合夕阳主题的颜色"

这些修改意图会由 src/open_storyline/nodes/core_nodes/ 下的对应节点重新执行，只重跑受影响环节，其余进度全部保留。

操作五：随时中断，按新指令重做

Agent 执行过程中如果行为不符合预期，有两种中断方式：

• 点击输入框右侧的中止按钮：立即停止模型回复与工具调用；
• 直接按 Enter 发送新指令：系统自动打断当前任务，转而去执行你的新指令。

关键在于：中断不会清空进度。已生成的回复与已执行的工具结果都会保留，你可以基于现有结果继续提要求，比如"刚才的 BGM 太吵了，换一首安静的"。

操作六：文风仿写 + 一键保存剪辑 Skill

这是 FireRed-OpenStoryline 的杀手锏 🎯：

文风仿写：内置 Few-shot 仿写能力，输入参考文本或指定风格，即可精准复刻语感、节奏与句式：

• "用文言文为我进行古风混剪。"
• "模仿鲁迅风格生成文案。"
• "模仿我发朋友圈的语气。"

相关提示词模板位于 prompts/tasks/generate_script/zh/ 与仿写 Skill 目录 src/open_storyline/skills/。

Skill 沉淀：打磨出一条满意成片后，可让 Agent 一键总结其中的剪辑逻辑（节奏、色调、转场习惯）并保存为专属 "Editing Skill"。下次只需换素材 + 调用该 Skill，即可快速复刻同款风格，实现批量生产。自定义 Skill 的方法同样在 docs/source/zh/guide.md 高级教程中。

常见问题与进阶

• 遇到问题：先看 docs/source/zh/faq.md（如 Conda 激活报错等）；
• 想用更好看的字体/BGM：把私有资源放入resource/bgms、resource/fonts并按指南打标签，重启 MCP 服务即可生效；
• 想给镜头间加 AI 过渡镜头：配置 AI 转场（Minimax 海螺 / 通义万相）后按需开启，注意该项调用成本较高，建议先用少量片段试跑。

到这里，你已经掌握了 FireRed-OpenStoryline 的 6 个基础操作：安装启动 → API 配置 → 对话式剪辑 → 精修重做 → 中断控制 → 文风仿写与 Skill 沉淀。现在，上传你的素材，开剪吧 🎬

【免费下载链接】FireRed-OpenStorylineFireRed-OpenStoryline is an AI video editing agent that transforms manual editing into intention-driven directing through natural language interaction, LLM-powered planning, and precise tool orchestration. It facilitates transparent, human-in-the-loop creation with reusable Style Skills for consistent, professional storytelling.项目地址: https://gitcode.com/gh_mirrors/fi/FireRed-OpenStoryline