# ruoyi-drama **Repository Path**: hanzhi-code/ruoyi-drama ## Basic Information - **Project Name**: ruoyi-drama - **Description**: AI 短剧创作前端，基于 Vue 3 + Vite + Pinia，对接 ruoyi-ai 后台 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 41 - **Created**: 2026-10-09 - **Last Updated**: 2026-10-10 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # ruoyi-drama ruoyi-drama 是基于 Vue 3、TypeScript 和 Vite 的短剧工作台，配套 ruoyi-ai 后端使用。前端负责剧本编辑、素材审阅和任务进度展示，登录权限、模型调用、素材存储和视频合成由后端处理。 制作流程分为想法、剧本、资产和分镜四步。每一步审阅后再进入下一步，角色、场景和道具可以在项目里反复使用。 工作台操作与制作维护规范见[项目文档索引](docs/README.md)。 第一步的[原始创作输入](docs/creative-idea-persistence.md)随项目保存，刷新或切换项目后会回显；已有项目可单独“保存想法”，后续剧本修改保留这份输入。 有对白的角色可在资产页生成或上传样音并提前绑定；单镜、批量和重生成视频会按实际发言人带入固定样音。操作与接口见[角色声音与视频生成](docs/character-voices.md)。 ## 本地运行 先启动 ruoyi-ai 后端，完成数据库、缓存和模型配置。前端默认连接本机 6039 端口。 在当前项目目录执行： ```bash npm install npm run dev ``` 开发页面地址以 Vite 启动输出为准。连接配置放在 `.env.development`： ```dotenv VITE_API_URL=/dev-api VITE_API_PROXY_TARGET=http://127.0.0.1:6039 VITE_CLIENT_ID=后台配置的客户端ID ``` `VITE_API_URL` 使用相对路径，开发请求通过 Vite 代理转发。切换后台时修改 `VITE_API_PROXY_TARGET`，客户端 ID 与后台保持一致。登录使用后台已有账号。 ## 模型与合成环境 在后台模型管理中配置写作、图片、视频和音频模型。前端按用途读取可用模型及默认优先级，API Key 保存在后台。使用 Atlas Cloud 时，在工作台头像菜单打开「Key 配置」，填写密钥并保存，系统会更新 Atlas 提供商下的模型配置；账号需要模型编辑权限。 剧本、资产分析和分镜默认使用 `deepseek-ai/deepseek-v4.1-flash`，关闭思考模式。三步共用文字生成参数和流式读取逻辑。模型名称按实际型号填写，默认优先级由后台模型管理维护。豆包 Seed 2.1 Pro 与 Evolving 是不同型号。 视频合成需要后端安装 FFmpeg 和 ffprobe，并支持 `libx264`、`aac` 编码器。Windows 可在 ruoyi-ai 仓库根目录执行： ```powershell powershell -ExecutionPolicy Bypass -File .\docs\script\install-ffmpeg-windows.ps1 ``` 脚本通过 winget 安装 FFmpeg，配置 `FFMPEG_PATH`、`FFPROBE_PATH` 和 `Path`。安装后重启 IDE 与后端服务，让进程读取新的环境变量。后端 Docker 镜像已包含 FFmpeg。 RUOYI DRAMA · 功能更新 ## 短剧工作台，从对话到镜头完成 这次整理 RuoYi Drama 的短剧工作台，用现有项目展示各个功能。做片时需要来回改剧本、选形象、听声音、检查镜头，所以这些内容都留在项目里，随时可以回到对应步骤继续处理。 工作台分四步：输入想法、剧本审阅、资产配置、分镜确认。视频生成和成片合成都在第四步完成。下面按使用顺序讲，截图保留完整桌面页面和操作入口。 ![创作中心：输入故事想法，也可以从最近项目继续制作。](docs/demo/short-drama-workflow/01.jpg) 创作中心：输入故事想法，也可以从最近项目继续制作。 ### 01 Key 配置：一次填写，供模型调用 右上角头像菜单里有「Key 配置」。打开后填入 Atlas Cloud API Key，点击「保存并应用」。有模型编辑权限的账号可以在这里统一更新 Atlas 提供商的密钥，省去逐个模型粘贴的操作。截图中的输入框留空。 ![头像菜单：Key 配置与技能市场都在这里。](docs/demo/short-drama-workflow/02.jpg) 头像菜单：Key 配置与技能市场都在这里。 ![Key 配置：填写密钥后保存并应用。](docs/demo/short-drama-workflow/03.jpg) Key 配置：填写密钥后保存并应用。 后台仍负责维护可用模型及其用途。制作前把文字、图片、视频和需要用到的声音模型配置好，前端再按对应步骤调用。 ### 02 技能市场：查看每一步使用的规则 从头像菜单进入「技能市场」，能看到系统提示词、默认制作技能、审美风格和导演风格。支持搜索和查看正文，选择一项就能了解它负责什么，也能查看附属资料。开发者需要调整规则时，在后台维护；这里方便制作人员核对。 ![系统提示词：按剧本、资产、分镜等业务步骤区分。](docs/demo/short-drama-workflow/04.jpg) 系统提示词：按剧本、资产、分镜等业务步骤区分。 ![默认制作技能：查看专业分镜的具体要求。](docs/demo/short-drama-workflow/05.jpg) 默认制作技能：查看专业分镜的具体要求。 审美风格管人物和场景的画面要求，导演风格管镜头重点、动作与反应、前后承接。两类内容分开维护，修改拍法时可以继续沿用已经选好的形象。 ![审美风格目录：查看不同题材的画面要求。](docs/demo/short-drama-workflow/06.jpg) 审美风格目录：查看不同题材的画面要求。 ![导演风格目录：查看各类分镜方式的说明。](docs/demo/short-drama-workflow/07.jpg) 导演风格目录：查看各类分镜方式的说明。 ### 03 输入想法：先生成初版剧本 在创作中心输入故事想法，点击「开始创作」，或者进入工作台第一步填写「故事想法」，生成草稿剧本。人物关系、主要冲突和想要的结尾可以一起写进去。初版只处理剧本，资产与分镜留到后面的步骤。 ![第一步：填写故事想法，生成草稿剧本。](docs/demo/short-drama-workflow/08.jpg) 第一步：填写故事想法，生成草稿剧本。 这里直接展示项目现有内容。制作过程中的入口与结果分开介绍，读者可以按自己的进度进入相应步骤。 ### 04 剧本审阅：正文、风格和修改意见放在一起 第二步可以编辑项目名称、剧本名称、风格 / 基调、剧情大纲和剧本正文。这个案例的基调是中式志怪、真人电影写实，后面的资产制作沿用这一设定。已有剧本也可以在正文框里直接编辑。 ![剧本审阅：先确认故事内容和整部片子的风格。](docs/demo/short-drama-workflow/09.jpg) 剧本审阅：先确认故事内容和整部片子的风格。 需要改剧情时，点击「打磨剧本」，填入修改意见，再按意见打磨。比如对白太像解释设定，可以直接指出是哪一段、人物应该用什么语气说。自己改正文后点「保存剧本」；准备往下做，就点「保存并分析资产」。 ![打磨剧本：把具体修改意见交给模型，而后继续审阅正文。](docs/demo/short-drama-workflow/10.jpg) 打磨剧本：把具体修改意见交给模型，而后继续审阅正文。 ### 05 分析资产：整理角色、场景和道具 资产分析把剧本里需要用到的人物、地点和道具整理成项目档案。先检查提取是否完整，再做图片，避免每个镜头都重新描述一遍。角色、场景和道具分别有自己的页签，「重新分析」用于再次梳理剧本，「一键生成」用于补齐缺少的资产图片。 ![资产配置：角色库可以搜索、筛选，并查看已有形象数量。](docs/demo/short-drama-workflow/11.jpg) 资产配置：角色库可以搜索、筛选，并查看已有形象数量。 这份项目目前有 8 位角色、18 个形象版本、8 个场景条目和 18 个道具素材条目。道具素材中包含同一器物的不同参考与备份，条目数量不等于不同道具的数量。 ### 06 角色档案：保留形象版本，选定使用的图片 点开角色卡片，可以查看身份、人物设定和形象版本。每个版本都有自己的提示词、参考照片和图片候选；支持生成、重新生成、放大查看和选用候选。新衣装和重制图可以留在独立版本里，方便比较。 ![婉娘角色档案：已有衣装版本与重制候选保存在一起。](docs/demo/short-drama-workflow/12.jpg) 婉娘角色档案：已有衣装版本与重制候选保存在一起。 ### 07 角色声音：先听样音，再绑定 角色档案下方展开「角色声音」，填写音色、年龄感、方言和表演描述，再写一句样音正文。可以生成样音，也可以上传已有音频。试听后选用，绑定结果会显示在角色档案中。 ![婉娘的声音设定、样音台词、试听与选用入口。](docs/demo/short-drama-workflow/13.jpg) 婉娘的声音设定、样音台词、试听与选用入口。 ### 08 场景与道具：复用外观，也保留候选 场景页展示地点描述和已选图片。展开「场景资料与图片」，可以编辑提示词、上传参考、查看图片候选并选用。客栈日景和夜景分别保存，柜台、楼梯、木柱的位置则需要保持一致。 ![场景页：同一客栈的日景、夜景与其他空间分开维护。](docs/demo/short-drama-workflow/14.jpg) 场景页：同一客栈的日景、夜景与其他空间分开维护。 ![展开场景资料：提示词、参考图片和候选图集中查看。](docs/demo/short-drama-workflow/15.jpg) 展开场景资料：提示词、参考图片和候选图集中查看。 道具素材页用于维护器物的提示词与参考图，支持保存、生成、重新生成；已有撤销入口的条目可以退回上一版。阳寿丹、蓝绸木盒、盘龙玉牌等重复出现的物件，在这里留下一份固定外观。 ![道具素材页：外观描述、图片和参考图保存在同一条目。](docs/demo/short-drama-workflow/16.jpg) 道具素材页：外观描述、图片和参考图保存在同一条目。 「维护固定道具」可以填写名称、固定外观和出现镜号，也能指定参考图。生成分镜前可以先存外观，之后补上镜号，让需要它的镜头使用相同参考。 ![固定道具维护：名称、外观、出现镜号和参考图。](docs/demo/short-drama-workflow/17.jpg) 固定道具维护：名称、外观、出现镜号和参考图。 ### 09 生成分镜：按内容安排镜头，再自行调整 资产确认后点击「生成分镜」，工作台进入第四步。首次生成前可以在资产页选择分镜方式；已经有分镜的项目直接进入镜头编辑。分镜数量要随动作与对白安排，简单内容用少量镜头，内容多的场次再拆开。预计时长帮助判断节奏，制作时仍可以调整。 第四步左侧按场次列出镜头，可以筛选拍摄场次，也可以用上一镜、下一镜切换。右侧编辑标题和视频提示词。「新增镜头」用于补段落，「删除镜头」用于删去多余镜头，镜号会随之整理。 ![分镜编辑：场次筛选、镜头切换、标题、提示词和增删操作。](docs/demo/short-drama-workflow/18.jpg) 分镜编辑：场次筛选、镜头切换、标题、提示词和增删操作。 ### 10 生成视频前：核对声音、参考图和首帧 展开「本镜发言人与声音」，检查实际说话的人，包括画外对白。可以调整发言人、保存或恢复自动识别，再查看角色样音映射。画面里的人未必都说话，声音也未必来自画面内。 ![本镜声音映射：婉娘与钱掌柜对应各自已绑定的样音。](docs/demo/short-drama-workflow/19.jpg) 本镜声音映射：婉娘与钱掌柜对应各自已绑定的样音。 下方展示本镜角色、场景与道具参考，还可以上传补充素材。「本镜起始帧」是可选参考，可以上传或修正构图；选择使用时勾选「使用已有首帧」。不用首帧，也可以从已经确认的资产和起始构图生成视频。 ![参考图、可选起始帧与镜头视频操作区。](docs/demo/short-drama-workflow/20.jpg) 参考图、可选起始帧与镜头视频操作区。 「视频秒数」与分镜预计时长分开：留空使用模型默认值，需要明确长度时再填写。生成视频后，任务状态和结果留在原镜头里。遇到待确认的请求，先查询已有任务，避免重复提交。 ### 11 镜头完成：播放、检查和单独下载 任务返回后，点击「播放视频」查看结果，播放器中可以下载该镜头。检查对白是否完整、声音是否对应人物、动作与道具位置是否接得上。需要改一镜时，回到该镜修改提示词并保存，再决定是否重新生成。 ![已有第四镜的播放器：直接检查视频，并下载单个镜头。](docs/demo/short-drama-workflow/21.jpg) 已有第四镜的播放器：直接检查视频，并下载单个镜头。 文字生成过程与视频任务的状态分别展示。分镜生成期间在第四步看规划草稿和进度；出现问题后查看失败详情，再决定怎样调整。已生成的视频则逐镜审阅，任务完成只代表拿到了文件。 ### 12 合成与下载：选择完成的镜头，接成一版 第四步顶部的「成片合成」用于选择已经完成的镜头，设置转场、画幅和水印。合成完成后显示状态与成片时长，点击「下载合成视频」即可保存。需要先看一个片段，就只选择那几镜。 ![现有合成记录：38 个镜头，16:9，无转场，时长约 359.6 秒。](docs/demo/short-drama-workflow/22.jpg) 现有合成记录：38 个镜头，16:9，无转场，时长约 359.6 秒。 这一轮工作台更新，把剧本修改、资产版本、声音绑定、分镜增删和视频结果放到了各自的步骤里。做片时发现问题，可以找到对应内容继续改，选好的图片、声音和已有镜头也有地方保留。 ## 剧本打磨与风格 在剧本审阅中直接编辑正文，或填写修改意见后打磨。人物关系、时代背景和资源条件确认后，再推进资产与分镜；修改正文后需要重新检查旧分镜。 项目的画面方向在剧本审阅中的「风格 / 基调」维护。分镜方式来自后台启用的导演技能，保存绑定后参与后续生成。开发时沿用后端的技能加载和内容审阅流程，让同一套规则覆盖新的生成入口。修订提示词时保留已批准的图片、素材任务编号和连续性字段。 ## 部署与数据 ```bash npm run build ``` 前端产物在 `dist/`。生产接口前缀由 `.env.production` 配置，默认 `/prod-api`；Nginx 将该路径转发到后端。仓库中的 `nginx.conf` 包含页面路由回退、较长的接口等待时间，以及关闭代理缓冲的配置，部署时按后台位置调整。 数据库与后端本地文件一起备份。角色、分镜和任务关联保存在数据库；本地素材、声音和技能内容使用以下目录： | 数据 | 后端运行目录 | | --- | --- | | 上传及导入素材 | `data/short-drama-materials/` | | 声音与音乐任务 | `data/short-drama-sounds/` | | 制作技能及历史版本 | `data/short-drama-skills/` | | 本地成片 | 默认 `logs/short-drama-compositions/`，可通过 `short-drama.composition.local-output-directory` 修改 | 迁移服务时同步这些目录及实际使用的对象存储配置，避免项目记录还在、素材文件丢失。