konlu/story-studio

选用指南

AI 根据 README 整理 · 2026/10/28 20:16:21

适用场景

适用于制作历史叙事或人物故事类短视频，可全流程一条龙生成，也可只写稿、只拆镜生图或只用现成素材排剪映草稿。

查看 README 依据

[](#) [](#) <p align="center"> <b>用自然语言提需求，让 AI Agent 帮你走完短视频口播制作全流程。</b><br/> 既能「一句话一条龙」生成完整剪映工程，也能像搭积木一样「只写稿 / 只优化开头钩子 / 只拆镜生图 / 用现成素材做剪映草稿」。 </p> [✨ 核心亮点](#-核心亮点) • [🛠️ 四大核心模块详解](#️-四大核心模块详解) • [🚀 快速开始](#-快速开始) • [🎛️ 灵活的工作流开关](#️-灵活的工作流开关) • [💬 常用提示词示例](#-常用提示词示例) • [📦 依赖与隐私说明](#-依赖与隐私说明) </div> --- ## 📖 项目简介 **Story Studio（故事工坊）** 是专为 AI Agent（如 Claude Code、Codex、Cursor 等支持 Skill 的智能体）打造的一站式短视频内容创作技能包。

| **只找选题 / 写口播稿 / 改开头钩子** | ✅ 开 | ❌ 关 | ❌ 关 | 纯文本创作，绝不乱调收费生图或配音接口 | | **文稿已写好，拆解分镜并生成配图** | ❌ 关 | ✅ 开 | ❌ 关 | 支持只出分镜提示词，或直接调用生图工具出图 | | **文件夹里已有配音和图片，直接排剪映草稿** | ❌ 关 | ❌ 关 | ✅ 开 | 自动用 Coli 跑时间轴对齐、加推拉运镜并写入剪映 | | **从 0 到 1 全流程一条龙制作** | ✅ 开 | ✅ 开 | ✅ 开 | 选题写稿 → 确认定稿 → 配音转录 → 生图 → 剪映草稿 | --- ## 💬 常用提示词示例 ### 场景 1：全流程一条龙制作（从选题文案到剪映草稿） ```text 使用 $story-studio，制作一期关于「张居正考成法改革」的历史短视频。 1. 写作：采用历史叙事风，约 1800 字，先给我 3 个不同切入角度的开头钩子让我选，定稿后再继续。 2. 配音：定稿后使用我配置好的豆包语音生成 MP3（如果还没配置请引导我）。 3. 配图：用 Coli 对齐时间轴后拆成 20 镜，采用「厚涂历史漫画风」，9:16 竖屏生成配图，并带 3:4 和 4:3 封面。 4. 草稿：生成 1080x1920 的剪映专业版草稿，加入慢推拉运镜，默认不显示字幕。 ```

目标用户

面向使用支持 Skill 的 AI Agent（如 Claude Code、Codex、Cursor）的短视频创作者。

查看 README 依据

[](#) [](#) <p align="center"> <b>用自然语言提需求，让 AI Agent 帮你走完短视频口播制作全流程。</b><br/> 既能「一句话一条龙」生成完整剪映工程，也能像搭积木一样「只写稿 / 只优化开头钩子 / 只拆镜生图 / 用现成素材做剪映草稿」。 </p> [✨ 核心亮点](#-核心亮点) • [🛠️ 四大核心模块详解](#️-四大核心模块详解) • [🚀 快速开始](#-快速开始) • [🎛️ 灵活的工作流开关](#️-灵活的工作流开关) • [💬 常用提示词示例](#-常用提示词示例) • [📦 依赖与隐私说明](#-依赖与隐私说明) </div> --- ## 📖 项目简介 **Story Studio（故事工坊）** 是专为 AI Agent（如 Claude Code、Codex、Cursor 等支持 Skill 的智能体）打造的一站式短视频内容创作技能包。

使用方式

通过向 AI Agent 发送自然语言指令使用，可一键安装到 Agent 的 skills 目录，并自动配置运行环境。

查看 README 依据

- **防素材丢失与纯净交付**：所有图片与音频自动复制进剪映草稿目录，默认 1080×1920（9:16 竖屏）、30fps、铺满整段配音；默认不强制上屏字幕（需要时只需说一句“加上可编辑字幕”）。 - **可选本地 FFmpeg 渲染**：如果你不需要进剪映微调，也可以明确要求使用内置的高精度亚像素仿射变换脚本，直接在本地渲染输出 `final.mp4`。 --- ## 🚀 快速开始 ### 第一步：一键安装 Skill（提供三种超简便方式） 你可以根据自己的使用习惯，选择以下任意一种方式进行一键安装： #### 方式 A（最推荐·零操作）：在 AI 对话框中发一句话，让 Agent 自动安装 如果你的 Agent（如 Codex、Claude Code、Cursor 等）拥有终端执行权限，你**连命令行都不用打开**，直接在任意对话框中发送： ```text 请帮我把这个 GitHub 仓库克隆安装到你的 skills 目录，并完成依赖环境检查： https://github.com/konlu/story-studio Agent 会自动识别自身 skills 目录（如 `~/.codex/skills/story-studio`），自动拉取并完成接入！ --- #### 方式 B（极客·一行命令直达）：终端一条命令克隆

### 第二步：一句话让 Agent 自动配置环境 无需自己手动折腾 Python、Node.js、FFmpeg 或配置剪映路径！安装后直接对 Agent 发送： ```text 使用 $story-studio，帮我一键检查并自动配置全部运行环境。 ``` > 💡 **智能按需初始化**：如果你只用它写文案，它不会安装任何多媒体组件；当需要配音、转录和导出剪映草稿时，原生启动器（`bootstrap.ps1` / `bootstrap.sh`）会自动在用户独立数据目录配置好 Python 3.11 (`uv`)、Node.js LTS、`Coli`、`FFmpeg`、`pyJianYingDraft` 等全部依赖。 ### 第三步：开始你的创作！ 你可以直接用大白话告诉 Agent 你想做什么。下面看看最常用的几种姿势 👇 --- ## 🎛️ 灵活的工作流开关 Story Studio 内部通过 **写作（`write`）、配图（`illustrate`）、剪映草稿（`draft`）** 三个主开关控制边界，配音与转录作为无缝衔接步骤按需触发。 你不需要写任何配置文件，直接用自然语言指挥，或者显式声明开关状态： | 你的使用场景 | 写作 | 配图 | 剪映草稿 | 说明 | | :--- | :---: | :---: | :---: | :--- |

部署要求

需要支持 Skill 的 AI Agent 环境；自动配置 Python 3.11、Node.js 20+、FFmpeg 等依赖；若使用豆包语音需 API Key，剪映专业版用于草稿导出。

查看 README 依据

### 第二步：一句话让 Agent 自动配置环境 无需自己手动折腾 Python、Node.js、FFmpeg 或配置剪映路径！安装后直接对 Agent 发送： ```text 使用 $story-studio，帮我一键检查并自动配置全部运行环境。 ``` > 💡 **智能按需初始化**：如果你只用它写文案，它不会安装任何多媒体组件；当需要配音、转录和导出剪映草稿时，原生启动器（`bootstrap.ps1` / `bootstrap.sh`）会自动在用户独立数据目录配置好 Python 3.11 (`uv`)、Node.js LTS、`Coli`、`FFmpeg`、`pyJianYingDraft` 等全部依赖。 ### 第三步：开始你的创作！ 你可以直接用大白话告诉 Agent 你想做什么。下面看看最常用的几种姿势 👇 --- ## 🎛️ 灵活的工作流开关 Story Studio 内部通过 **写作（`write`）、配图（`illustrate`）、剪映草稿（`draft`）** 三个主开关控制边界，配音与转录作为无缝衔接步骤按需触发。 你不需要写任何配置文件，直接用自然语言指挥，或者显式声明开关状态： | 你的使用场景 | 写作 | 配图 | 剪映草稿 | 说明 | | :--- | :---: | :---: | :---: | :--- |

- **Python 3.11**（通过 `uv` 自动管理独立虚拟环境，安装 `websockets==15.0.1`、`pyJianYingDraft==0.3.1`、`Pillow`、`NumPy`、`pymediainfo` 等） - **Node.js 20+ LTS & Coli**：用于本地离线语音转字幕（基于 `sherpa-onnx`），**无需调用任何收费云端字幕 API** - **FFmpeg & ffprobe**：用于音频完整性解码校验与可选的本地视频渲染 - **剪映专业版**：Windows 下支持一键检测草稿目录，缺失时可协助通过 WinGet 安装 ### 2. 账号安全与隐私保护边界 - **零私人信息残留**：本开源仓库的源码、示例与语料索引均经过脱敏与哈希化处理，不包含任何个人电脑路径、账户信息或密钥。 - **密钥安全存储**：豆包语音 `API Key` 仅从环境变量 `DOUBAO_TTS_API_KEY` 或系统级安全凭据文件读取（Windows 采用当前用户 DPAPI 加密，macOS/Linux 采用 `0600` 权限私密文件），**绝不写入对话日志、项目 JSON 或 Git 仓库**。

已知限制

内置文案语料库仅用于学习研究，不直接作为已核实的历史事实依据；AI 生成的参考图非历史原照。

查看 README 依据

- **内容与语料说明**：本项目内置的对标文案语料库仅用于叙事结构、开头钩子与写作技法学习研究，**不直接作为已核实的历史事实依据**；AI 生成的画风参考图与封面样例亦非历史原照。 - **第三方生态**：第三方依赖库（如 `pyJianYingDraft`、`Coli`、`websockets` 等）均遵循其各自的开源许可证分发，本仓库不内嵌或重新分发上述外部库源码。