fix(logging): 注释掉调试信息的日志输出,优化日志记录

在clip_video.py和merger_video.py中,注释掉了成功处理视频的日志信息,以减少调试时的冗余输出。同时,在manager.py中更新了提示词渲染成功的日志格式,确保版本信息的清晰展示。这些更改旨在提升日志的可读性和有效性,优化调试过程。
This commit is contained in:
linyq 2025-07-12 02:27:51 +08:00
parent e3a5e34c78
commit 6d8cc671ab
7 changed files with 489 additions and 31 deletions

View File

@ -269,7 +269,7 @@ def execute_ffmpeg_with_fallback(
# 验证输出文件
if os.path.exists(output_path) and os.path.getsize(output_path) > 0:
logger.info(f"✓ 视频裁剪成功: {timestamp}")
# logger.info(f"✓ 视频裁剪成功: {timestamp}")
return True
else:
logger.warning(f"输出文件无效: {output_path}")

View File

@ -221,7 +221,7 @@ def process_single_video(
else:
# 其他硬件编码器
encoder = ffmpeg_utils.get_optimal_ffmpeg_encoder()
logger.info(f"使用硬件编码器: {encoder}")
# logger.info(f"使用硬件编码器: {encoder}")
command.extend(['-c:v', encoder])
# 根据编码器类型添加特定参数
@ -256,7 +256,7 @@ def process_single_video(
try:
# logger.info(f"执行FFmpeg命令: {' '.join(command)}")
process = subprocess.run(command, check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
logger.info(f"视频处理成功: {output_path}")
# logger.info(f"视频处理成功: {output_path}")
return output_path
except subprocess.CalledProcessError as e:
error_msg = e.stderr.decode() if e.stderr else str(e)

View File

@ -53,7 +53,7 @@ class PromptManager:
try:
rendered = prompt_obj.render(parameters)
logger.debug(f"提示词渲染成功: {category}.{name} v{prompt_obj.version}")
logger.debug(f"提示词渲染成功: {category}.{name}-{prompt_obj.version}")
return rendered
except Exception as e:
logger.error(f"提示词渲染失败: {category}.{name} - {str(e)}")

View File

@ -6,66 +6,231 @@
@File : script_generation.py
@Author : viccy同学
@Date : 2025/1/7
@Description: 短剧解说脚本生成提示词
@Description: 短剧解说脚本生成提示词 - 优化版本
"""
from ..base import ParameterizedPrompt, PromptMetadata, ModelType, OutputFormat
class ScriptGenerationPrompt(ParameterizedPrompt):
"""短剧解说脚本生成提示词"""
"""短剧解说脚本生成提示词 - 优化版本"""
def __init__(self):
metadata = PromptMetadata(
name="script_generation",
category="short_drama_narration",
version="v1.0",
description="根据剧情分析生成短剧解说脚本,包含解说文案和原声片段",
version="v2.0",
description="基于短剧解说创作核心要素,生成高质量解说脚本,包含黄金开场、爽点放大、个性吐槽等专业技巧",
model_type=ModelType.TEXT,
output_format=OutputFormat.JSON,
tags=["短剧", "解说脚本", "文案生成", "原声片段"],
tags=["短剧", "解说脚本", "文案生成", "原声片段", "黄金开场", "爽点放大", "个性吐槽", "悬念预埋"],
parameters=["drama_name", "plot_analysis", "subtitle_content"]
)
super().__init__(metadata, required_parameters=["drama_name", "plot_analysis"])
self._system_prompt = "你是一位专业的短视频解说脚本撰写专家。你必须严格按照JSON格式输出不能包含任何其他文字、说明或代码块标记。"
self._system_prompt = "你是一位顶级的短剧解说up主精通短视频创作的所有核心技巧。你必须严格按照JSON格式输出不能包含任何其他文字、说明或代码块标记。"
def get_template(self) -> str:
return """我是一个影视解说up主需要为我的粉丝讲解短剧《${drama_name}》的剧情,目前正在解说剧情,希望能让粉丝通过我的解说了解剧情,并且产生继续观看的兴趣,请生成一篇解说脚本,包含解说文案,以及穿插原声的片段。
return """# 短剧解说脚本创作任务
下面<plot>中的内容是短剧的剧情概述
## 任务目标
我是一位专业的短剧解说up主需要为短剧${drama_name}创作一份高质量的解说脚本目标是让观众在短时间内了解剧情精华并产生强烈的继续观看欲望
## 素材信息
### 剧情概述
<plot>
${plot_analysis}
</plot>
下面<subtitles>中的内容是短剧的原始字幕包含准确的时间戳信息
### 原始字幕(含精确时间戳)
<subtitles>
${subtitle_content}
</subtitles>
请严格按照以下JSON格式输出不要添加任何其他文字说明或代码块标记
## 短剧解说创作核心要素
### 1. 黄金开场3秒法则
**开头3秒内必须制造强烈钩子激发"想知道后续发展"的强烈好奇心**
- **悬念设置**直接抛出最核心的冲突或疑问
- **冲突展示**展现最激烈的对立关系
- **情感共鸣**触及观众内心的普遍情感
- **反转预告**暗示即将发生的惊人转折
### 2. 主线提炼(去繁就简)
**快节奏解说速度超越原剧专注核心主线**
- 舍弃次要情节和配角只保留推动主线的关键人物
- 突出核心矛盾冲突每个片段都要推进主要故事线
- 快速跳过铺垫直击剧情要害
- 确保每个解说片段都有明确的剧情推进作用
### 3. 爽点放大(情绪引爆)
**精准识别剧中"爽点"并用富有感染力的语言放大**
- **主角逆袭**突出弱者变强反败为胜的瞬间
- **反派被打脸**强调恶人得到报应的痛快感
- **智商在线**赞美角色的机智和策略
- **情感爆发**放大感人愤怒震撼等强烈情绪
- 使用激昂语气和富有感染力的词汇调动观众情绪
### 4. 个性吐槽(增加趣味)
**以观众视角进行犀利点评体现解说员独特人设**
- 避免单纯复述剧情要有自己的观点和态度
- 开启"上帝视角"分析角色行为的合理性
- 适当吐槽剧情的套路或角色的愚蠢行为
- 用幽默犀利的语言增加观看趣味
- 站在观众立场说出观众想说的话
### 5. 悬念预埋(引导互动)
**在关键节点和结尾处"卖关子"激发互动欲望**
- 在剧情高潮前停止留下"接下来会发生什么"的疑问
- 提出引导性问题"你们觉得他会怎么做?"
- 预告后续精彩"更劲爆的还在后面"
- 为后续内容预热激发评论点赞关注
### 6. 卡点配合(视听协调)
**考虑文案与画面音乐的完美结合**
- 在情感高潮处预设BGM卡点
- 解说节奏要配合画面节奏
- 重要台词处保留原声解说适时停顿
- 追求文案+画面+音乐的协同效应
## 严格技术要求
### 时间戳管理(绝对不能违反)
- **时间戳绝对不能重叠**确保剪辑后无重复画面
- **时间段必须连续且不交叉**严格按时间顺序排列
- **每个时间戳都必须在原始字幕中找到对应范围**
- 可以拆分原时间片段但必须保持时间连续性
- 时间戳的格式必须与原始字幕中的格式完全一致
### 时长控制1/3原则
- **解说视频总长度 = 原视频长度的 1/3**
- 精确控制节奏和密度既不能过短也不能过长
- 合理分配解说和原声的时间比例
### 剧情连贯性
- **保持故事逻辑完整**确保情节发展自然流畅
- **严格按照时间顺序**禁止跳跃式叙述
- **符合因果逻辑**先发生A再发生BA导致B
## 原声片段使用规范
### 原声片段格式要求
原声片段必须严格按照以下JSON格式
```json
{
"_id": 序号,
"timestamp": "开始时间-结束时间",
"picture": "画面内容描述",
"narration": "播放原片+序号",
"OST": 1
}
```
### 原声片段插入策略
#### 1. 关键情绪爆发点
**在角色强烈情绪表达时必须保留原声**
- **愤怒爆发**角色愤怒咆哮情绪失控的瞬间
- **感动落泪**角色感动哭泣情感宣泄的时刻
- **震惊反应**角色震惊不敢置信的表情和台词
- **绝望崩溃**角色绝望崩溃的情感表达
- **狂欢庆祝**角色兴奋狂欢的情绪高潮
#### 2. 重要对白时刻
**保留推动剧情发展的关键台词和对话**
- **身份揭露**揭示角色真实身份的重要台词
- **真相大白**揭晓谜底真相的关键对话
- **情感告白**爱情告白情感表达的重要台词
- **威胁警告**反派威胁警告的重要对白
- **决定宣布**角色做出重要决定的宣告
#### 3. 爽点瞬间
**"爽点"时刻保留原声增强痛快感**
- **主角逆袭**弱者反击逆转局面的台词
- **反派被打脸**恶人得到报应被揭穿的瞬间
- **智商碾压**主角展现智慧碾压对手的台词
- **正义伸张**正义得到伸张恶有恶报的时刻
- **实力展现**主角展现真实实力震撼全场
#### 4. 悬念节点
**在制造悬念或揭晓答案的关键时刻保留原声**
- **悬念制造**制造悬念留下疑问的台词
- **答案揭晓**揭晓答案解开谜团的对话
- **转折预告**暗示即将发生转折的重要台词
- **危机降临**危机来临紧张时刻的对白
### 原声片段技术规范
#### 格式规范
- **OST字段**设置为1表示保留原声解说片段设置为0
- **narration格式**严格使用"播放原片+序号""播放原片26"
- **picture字段**详细描述画面内容便于后期剪辑参考
- **时间戳精度**必须与字幕中的重要对白时间精确匹配
#### 比例控制
- **原声与解说比例**3:7原声30%解说70%
- **分布均匀**原声片段要在整个视频中均匀分布
- **长度适中**单个原声片段时长控制在3-8
- **衔接自然**原声片段与解说片段之间衔接自然流畅
#### 选择原则
- **情感优先**优先选择情感强烈的台词和对话
- **剧情关键**必须是推动剧情发展的重要内容
- **观众共鸣**选择能引起观众共鸣的经典台词
- **视听效果**考虑台词的声音效果和表演张力
## 输出格式要求
请严格按照以下JSON格式输出绝不添加任何其他文字说明或代码块标记
{
"items": [
{
"_id": 1,
"timestamp": "00:00:05,390-00:00:10,430",
"picture": "剧情描述或者备注",
"narration": "解说文案,如果片段为穿插的原片片段,可以直接使用 '播放原片+_id' 进行占位",
"timestamp": "00:00:01,000-00:00:05,500",
"picture": "女主角林小雨慌张地道歉,男主角沈墨轩冷漠地看着她",
"narration": "一个普通女孩的命运即将因为一杯咖啡彻底改变!她撞到的这个男人,竟然是...",
"OST": 0
},
{
"_id": 2,
"timestamp": "00:00:05,500-00:00:08,000",
"picture": "沈墨轩质问林小雨,语气冷厉威严",
"narration": "播放原片2",
"OST": 1
},
{
"_id": 3,
"timestamp": "00:00:08,000-00:00:12,000",
"picture": "林小雨惊慌失措,沈墨轩眼中闪过一丝兴趣",
"narration": "霸道总裁的经典开场!一杯咖啡引发的爱情故事就这样开始了...",
"OST": 0
}
]
}
重要要求
1. 只输出 json 内容不要输出其他任何说明性的文字
2. 解说文案必须遵循---的线性时间链
3. 解说文案需包含角色微表情动作细节场景氛围的描写每段80-150
4. 通过细节关联普遍情感如遗憾和解成长避免直白抒情
5. 所有细节严格源自<plot>可对角色行为进行合理心理推导但不虚构剧情
6. **时间戳必须严格基于<subtitles>中的原始时间戳**确保与视频画面精确匹配
7. 解说与原片穿插比例控制在7:3关键情绪点保留原片原声
8. 严禁跳脱剧情发展顺序所有描述必须符合先发生A再发生BA导致B的逻辑
9. 强化流程感让观众清晰感知剧情推进的先后顺序
10. 可根据解说内容需要拆分原时间片段如将10秒拆分为两个5秒但必须保持时间连续性
11. **确保每个解说片段的时间戳都能在原始字幕中找到对应的时间范围**"""
## 质量标准
### 解说文案要求:
- **字数控制**每段解说文案80-150
- **语言风格**生动有趣富有感染力符合短视频观众喜好
- **情感调动**能够有效调动观众情绪产生代入感
- **节奏把控**快节奏但不失条理紧凑但不混乱
### 技术规范:
- **解说与原片比例**7:3解说70%原片30%
- **原声片段标识**OST=1表示原声OST=0表示解说
- **原声格式规范**narration字段必须使用"播放原片+序号"格式
- **关键情绪点**必须保留原片原声增强观众代入感
- **时间戳精度**精确到毫秒级别确保与字幕完美匹配
- **逻辑连贯性**严格遵循剧情发展顺序
### 创作原则:
1. **只输出JSON内容**不要任何说明性文字
2. **严格基于提供的剧情和字幕**不虚构内容
3. **突出核心冲突**舍弃无关细节
4. **强化观众体验**始终考虑观看感受
5. **保持专业水准**体现解说up主的专业素养
现在请基于以上要求为短剧${drama_name}创作解说脚本"""

View File

@ -1,5 +1,5 @@
[app]
project_version="0.6.7"
project_version="0.6.8"
# 支持视频理解的大模型提供商
# gemini (谷歌, 需要 VPN)
# siliconflow (硅基流动)

View File

@ -0,0 +1,143 @@
# 短剧解说原声片段集成指南
## 📋 更新概述
本次更新为短剧解说脚本生成提示词添加了详细的原声片段使用规范,确保生成的解说脚本能够在适当位置插入原声片段,增强观众的代入感和情感体验。
## 🎬 原声片段使用规范
### 📢 格式要求
原声片段必须严格按照以下JSON格式
```json
{
"_id": 序号,
"timestamp": "开始时间-结束时间",
"picture": "画面内容描述",
"narration": "播放原片+序号",
"OST": 1
}
```
### 🎯 插入策略
#### 1. 🔥 关键情绪爆发点
在角色强烈情绪表达时必须保留原声:
- **愤怒爆发**:角色愤怒咆哮、情绪失控的瞬间
- **感动落泪**:角色感动哭泣、情感宣泄的时刻
- **震惊反应**:角色震惊、不敢置信的表情和台词
- **绝望崩溃**:角色绝望、崩溃的情感表达
- **狂欢庆祝**:角色兴奋、狂欢的情绪高潮
#### 2. 💬 重要对白时刻
保留推动剧情发展的关键台词和对话:
- **身份揭露**:揭示角色真实身份的重要台词
- **真相大白**:揭晓谜底、真相的关键对话
- **情感告白**:爱情告白、情感表达的重要台词
- **威胁警告**:反派威胁、警告的重要对白
- **决定宣布**:角色做出重要决定的宣告
#### 3. 💥 爽点瞬间
在"爽点"时刻保留原声增强痛快感:
- **主角逆袭**:弱者反击、逆转局面的台词
- **反派被打脸**:恶人得到报应、被揭穿的瞬间
- **智商碾压**:主角展现智慧、碾压对手的台词
- **正义伸张**:正义得到伸张、恶有恶报的时刻
- **实力展现**:主角展现真实实力、震撼全场
#### 4. 🎪 悬念节点
在制造悬念或揭晓答案的关键时刻保留原声:
- **悬念制造**:制造悬念、留下疑问的台词
- **答案揭晓**:揭晓答案、解开谜团的对话
- **转折预告**:暗示即将发生转折的重要台词
- **危机降临**:危机来临、紧张时刻的对白
## ⚙️ 技术规范
### 🔧 格式规范
- **OST字段**设置为1表示保留原声解说片段设置为0
- **narration格式**:严格使用"播放原片+序号"(如"播放原片26"
- **picture字段**:详细描述画面内容,便于后期剪辑参考
- **时间戳精度**:必须与字幕中的重要对白时间精确匹配
### 📊 比例控制
- **原声与解说比例**3:7原声30%解说70%
- **分布均匀**:原声片段要在整个视频中均匀分布
- **长度适中**单个原声片段时长控制在3-8秒
- **衔接自然**:原声片段与解说片段之间衔接自然流畅
### 🎯 选择原则
- **情感优先**:优先选择情感强烈的台词和对话
- **剧情关键**:必须是推动剧情发展的重要内容
- **观众共鸣**:选择能引起观众共鸣的经典台词
- **视听效果**:考虑台词的声音效果和表演张力
## 📝 输出示例
```json
{
"items": [
{
"_id": 1,
"timestamp": "00:00:01,000-00:00:05,500",
"picture": "女主角林小雨慌张地道歉,男主角沈墨轩冷漠地看着她",
"narration": "一个普通女孩的命运即将因为一杯咖啡彻底改变!她撞到的这个男人,竟然是...",
"OST": 0
},
{
"_id": 2,
"timestamp": "00:00:05,500-00:00:08,000",
"picture": "沈墨轩质问林小雨,语气冷厉威严",
"narration": "播放原片2",
"OST": 1
},
{
"_id": 3,
"timestamp": "00:00:08,000-00:00:12,000",
"picture": "林小雨惊慌失措,沈墨轩眼中闪过一丝兴趣",
"narration": "霸道总裁的经典开场!一杯咖啡引发的爱情故事就这样开始了...",
"OST": 0
}
]
}
```
## 🔄 使用方法
使用方法与之前完全一致,无需修改调用代码:
```python
from app.services.prompts import PromptManager
prompt = PromptManager.get_prompt(
category="short_drama_narration",
name="script_generation",
parameters={
"drama_name": "短剧名称",
"plot_analysis": "剧情分析内容",
"subtitle_content": "原始字幕内容"
}
)
```
## 📈 预期效果
通过添加原声片段使用规范,预期能够:
- **增强情感体验**:在关键情绪点保留原声,让观众更有代入感
- **提升观看质量**:重要对白的原声保留,避免信息丢失
- **强化爽点效果**:在爽点时刻保留原声,增强观众的痛快感
- **优化节奏控制**:合理的原声与解说比例,保持观看节奏
- **提高专业水准**:规范的原声片段使用,体现专业制作水平
## ✅ 验证结果
通过测试验证,更新后的提示词:
- ✅ 包含完整的原声片段使用规范
- ✅ 提供详细的插入策略指导
- ✅ 明确技术规范和格式要求
- ✅ 给出具体的输出示例
- ✅ 保持代码完全兼容性
## 🎉 总结
本次更新成功为短剧解说脚本生成提示词添加了专业的原声片段使用规范为AI生成更高质量、更具观赏性的短剧解说脚本提供了强有力的技术支持。

View File

@ -0,0 +1,150 @@
# 短剧解说提示词优化总结
## 📋 优化概述
本次优化基于短剧解说文案创作的核心要素,对 `app/services/prompts/short_drama_narration/script_generation.py` 文件中的提示词模板进行了全面重构,使其更加精确和实用。
## 🎯 优化目标
将短剧解说文案创作的6大核心要素和严格技术要求整合到提示词模板中确保生成的解说文案既符合短剧特点又满足技术要求。
## 🔥 核心要素整合
### 1. 黄金开场3秒法则
- **悬念设置**:直接抛出最核心的冲突或疑问
- **冲突展示**:展现最激烈的对立关系
- **情感共鸣**:触及观众内心的普遍情感
- **反转预告**:暗示即将发生的惊人转折
### 2. 主线提炼(去繁就简)
- 舍弃次要情节和配角,专注核心主线
- 突出核心矛盾冲突
- 快速跳过铺垫,直击剧情要害
- 确保每个片段都有明确的剧情推进作用
### 3. 爽点放大(情绪引爆)
- **主角逆袭**:突出弱者变强、反败为胜的瞬间
- **反派被打脸**:强调恶人得到报应的痛快感
- **智商在线**:赞美角色的机智和策略
- **情感爆发**:放大感人、愤怒、震撼等强烈情绪
### 4. 个性吐槽(增加趣味)
- 以观众视角进行犀利点评
- 开启"上帝视角"分析角色行为
- 适当吐槽剧情套路或角色愚蠢行为
- 用幽默、犀利的语言增加观看趣味
### 5. 悬念预埋(引导互动)
- 在剧情高潮前"卖关子"
- 提出引导性问题激发思考
- 预告后续精彩内容
- 激发评论、点赞、关注
### 6. 卡点配合(视听协调)
- 在情感高潮处预设BGM卡点
- 解说节奏配合画面节奏
- 重要台词处保留原声
- 追求文案+画面+音乐的协同效应
## ⚙️ 严格技术要求
### 🕐 时间戳管理
- **绝对不能重叠**:确保剪辑后无重复画面
- **连续且不交叉**:严格按时间顺序排列
- **精确匹配**:每个时间戳都必须在原始字幕中找到对应范围
- **时间连续性**:可拆分但必须保持连续
### ⏱️ 时长控制1/3原则
- **解说视频总长度 = 原视频长度的 1/3**
- 精确控制节奏和密度
- 合理分配解说和原声的时间比例
### 🔗 剧情连贯性
- **保持故事逻辑完整**
- **严格按照时间顺序**,禁止跳跃式叙述
- **符合因果逻辑**先发生A再发生BA导致B
## 📊 优化前后对比
### 优化前
- 简单的任务描述
- 基础的技术要求
- 缺乏具体的创作指导
- 没有明确的质量标准
### 优化后
- 详细的6大核心要素指导
- 严格的技术规范约束
- 具体的操作指南和示例
- 明确的质量标准和评判原则
## 🎯 质量标准
### 解说文案要求
- **字数控制**每段80-150字
- **语言风格**:生动有趣,富有感染力
- **情感调动**:有效调动观众情绪,产生代入感
- **节奏把控**:快节奏但不失条理
### 技术规范
- **解说与原片比例**7:3解说70%原片30%
- **关键情绪点**:必须保留原片原声
- **时间戳精度**:精确到毫秒级别
- **逻辑连贯性**:严格遵循剧情发展顺序
## 🔧 技术实现
### 版本升级
- 版本号从 v1.0 升级到 v2.0
- 保持与现有代码结构的完全兼容性
- 参数化机制保持不变
### 模板结构
- 使用 Markdown 格式增强可读性
- 采用 emoji 图标提升视觉效果
- 分层级结构便于理解和执行
### 兼容性保证
- 保持原有的类名和方法签名
- 参数列表不变:`drama_name`, `plot_analysis`, `subtitle_content`
- JSON输出格式保持一致
## ✅ 测试验证
通过测试验证,优化后的提示词:
- ✅ 成功渲染所有参数
- ✅ 包含所有6大核心要素
- ✅ 包含所有技术要求
- ✅ 保持代码兼容性
- ✅ 输出格式正确
## 🚀 使用方法
优化后的提示词使用方法与之前完全一致:
```python
from app.services.prompts import PromptManager
prompt = PromptManager.get_prompt(
category="short_drama_narration",
name="script_generation",
parameters={
"drama_name": "短剧名称",
"plot_analysis": "剧情分析内容",
"subtitle_content": "原始字幕内容"
}
)
```
## 📈 预期效果
使用优化后的提示词,预期能够生成:
- 更具吸引力的开场钩子
- 更精准的爽点识别和放大
- 更有个性的解说风格
- 更严格的技术规范遵循
- 更高质量的整体解说文案
## 🎉 总结
本次优化成功将短剧解说创作的专业技巧系统性地整合到提示词模板中为AI生成高质量的短剧解说文案提供了强有力的指导框架。优化后的模板不仅保持了技术兼容性还大幅提升了创作指导的专业性和实用性。