让文稿，成为能看、能听的故事。
文字 + 图片 → 可编辑分镜 → 配音、字幕与 MP4
下载 Windows 版 · 快速上手 · 反馈与建议 · English
不是再学一套复杂时间线。 把讲解稿、知识笔记或产品介绍，排成一页页能播放的故事。文字、画面和配音分开编辑，做完直接导出视频。
下载前看这里： 当前为 Windows x64 解压版，界面为中文，电脑需要可写的 D 盘。第一次运行需联网配置一次媒体组件；之后创作和导出可以离线完成。不需要账号、API Key、Node.js 或 Python。
以上为实际软件录制，不是概念图。可以下载示例工程，或在 Release 中观看示例成片。示例成片未添加配音；实际配音需在编辑器中生成或导入。
- 在下载页找到 StoryFrame-1.2.0-Windows-x64.zip，把整个压缩包解压到 D 盘文件夹。
- 仅首次： 双击 Setup-Media.cmd，等待出现
Media engine installed。它从 BtbN 的 GitHub 发布页下载固定版本的 FFmpeg（约 92 MB），校验 SHA-256 后安装。不要直接在压缩包内运行。 - 双击 映述.exe → 从文稿开始 → 修改分镜 → 导出视频。
要有人声：选中分镜，进入右侧 配音，点击 生成这一页配音，每页分别生成；也可以导入自己的 WAV。未添加配音的页面保持静音。
请保留软件文件夹内的所有文件。首次配置失败时查看窗口中的原因；网络失败可重试，校验失败不要跳过。固定上游版本若被移除，需要下载更新后的软件包。详细版本与下载校验见 media-manifest.json。
| 你要做的事 | 映述提供的工具 |
|---|---|
| 从稿子开始 | 粘贴文字、导入 TXT / Markdown，按规则生成可编辑分镜 |
| 调整讲述顺序 | 新增、复制、删除、拖动排序、撤销与重做 |
| 做好每页画面 | 三套主题、三种版式、PNG / JPEG / WebP 图片、缓慢运镜与文字入场 |
| 做横屏或竖屏 | 16:9 / 9:16，一键切换并实时预览 |
| 加上声音与字幕 | Windows 系统配音、语速调整、WAV 导入、独立旁白编辑、SRT 导出 |
| 检查成片 | 播放、暂停、拖动进度、静音、专注预览、真实画面缩略图 |
| 导出与继续编辑 | 720p / 1080p MP4、导出进度与取消、工程保存、最近草稿恢复 |
编辑器不上传素材，不调用云端模型。媒体组件只在你主动执行首次配置时下载；正常创作和导出无需联网。
工程 .storyframe 包含图片与已生成的声音，方便备份。应用数据默认位于 D:\StoryFrameData，导出默认位于 D:\StoryFrameData\exports，保存时可另选位置。最近草稿不代替独立工程备份；当前数据路径固定，不适合多个 Windows 用户共用一份工作目录。
映述是 规则分镜 + 模板动画 + 系统配音，不是输入一句话就生成电影的云端 AI，也不是完整的视频剪辑工作站。目前没有自动抓取文章网址、视频素材剪辑、云端生成画面或自动配乐。
- 每工程最多 40 个分镜、10 分钟、100 MB；每页 2–60 秒。
- 导出固定 24 fps、H.264 视频 / AAC 音频，支持 720p、1080p。
- SRT 时间按文字与页面时长估算，不是逐字语音对齐。
- 声音取决于 Windows 已安装的语音包；缺少合适声音时可导入 WAV。
- 当前没有 macOS / Linux / 手机版本，没有应用内自动更新。
- 尚未购买 Windows 发布者代码签名证书。Release 提供 SHA-256 校验值，但它不等同于发布者签名。
Ctrl+S 保存 · Ctrl+Shift+S 另存 · Ctrl+O 打开 · Ctrl+N 新建
Ctrl+Z 撤销 · Ctrl+Shift+Z 重做 · 工作区空格播放/暂停
分镜区域方向键切换，Home / End 跳到首尾；专注预览按 Esc 返回。
普通用户直接下载 Release。开发者需要 Windows x64、可写 D 盘、Node.js 22.12+；在 D 盘克隆项目：
git clone https://github.com/chanha666/StoryFrame.git D:\Projects\StoryFrame
cd D:\Projects\StoryFrame
$env:npm_config_cache = 'D:\CodexCache\StoryFrame\npm'
$env:ELECTRON_CACHE = 'D:\CodexCache\StoryFrame\electron'
npm ci
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\setup-media.ps1
npm startnpm test 运行核心与 Windows 后端测试；npm run test:core 只运行无需媒体组件的核心测试。界面测试与验收范围见 测试说明。
npm run package 生成不含独立 FFmpeg 命令行编码组件的公开包目录，默认输出到 D:\软件成品\映述。可通过 STORYFRAME_OUT_DIR 指定其他 D 盘目录。首次配置脚本随包提供；不要把本机已经下载的编码组件重新打入公开包。Electron 自带媒体库及许可证仍随运行时保留。
欢迎提交具体问题、使用场景和小而清晰的改进。请附软件版本、操作步骤和脱敏截图，不要上传私人文稿。
如果映述帮你把一个想法讲清楚了，可以点一个 Star，也欢迎把作品或使用体验分享在 Issue 中。
应用代码采用 MIT 许可。Electron 和用户自行配置的 FFmpeg 分别遵循各自许可，详见第三方说明。