快导 (KD)

快导(KD)是一个跨平台、跨行业的短视频脚本批量生成与管理工具。

⚠️ CRITICAL — 首次使用必读

使用前必须完成以下配置：

1. 安装依赖： pip install openpyxl
2. 配置搜索关键词： 编辑 config/platforms.json
3. 设置文案库路径： 编辑 config/user_config.json

详见 README.md 完整文档。

核心功能

Shortcuts（快速使用参考）

执行模式

自动模式（默认）

from scripts import WorkflowManager
workflow = WorkflowManager('xiaohongshu')
result = workflow.run_full()

交互模式（每步完成后暂停）

from scripts import WorkflowManager

# 启用交互模式
workflow = WorkflowManager('xiaohongshu', interactive=True)

# 执行，每步完成后返回等待
result = workflow.run_full()
if result.get('paused'):
    print(result['message'])  # "Step X 完成，是否继续？"

# 用户确认后继续
result = workflow.resume()

回调模式（即时回复每步结果）

def on_step_complete(step_num, result, should_pause):
    print(f"Step {step_num} 完成")  # 即时回复用户

workflow = WorkflowManager('xiaohongshu')
workflow.run_full(callback=on_step_complete)

核心模块

• ConfigManager - 配置管理
• ScriptGenerator - 脚本生成
• ExcelManager - Excel操作

详细用法和示例见 README.md

版本

v1.1.0 新功能详解

1. 智能时长计算

系统会自动计算并调整每个分镜的时间段：

• 台词时长：字数 × 0.25秒
• 运镜时长：固定2秒、推拉3秒、摇移4秒、复杂6秒、航拍8秒
• 建议时长：max(台词, 运镜) + 1秒缓冲
• 自动调整：使用建议时长更新B列时间段

配置（config/platforms.json）：

"duration_policy": {
  "xiaohongshu": {
    "auto_adjust": true,  // 开启自动调整
    "calculation_rules": {
      "speech_rate": 0.25,
      "motion_base": { "static": 2, "push_pull": 3, ... },
      "buffer_seconds": 1
    }
  }
}

2. 活动管理

支持自然语言管理活动：

• 添加活动：添加活动：春节特惠，关键词：春节、过年
• 列出活动：列出所有活动
• 查询活动：查询活动：春节
• 删除活动：删除活动：春节特惠

系统会根据脚本主题自动匹配活动，填入L列（关联活动）。

3. 详细内容格式

分镜内容现在支持更详细的描述：

• C列-镜头：设备/焦段/内容
• D列-运镜：方式/轨迹/速度
• E列-技巧：光线/ISO/对焦/色调
• F列-画面：场景/构图/色彩/氛围

4. BGM详细生成

I列BGM现在要求详细格式：

音乐名：《稻香》周杰伦
风格：田园治愈、轻快温暖
使用时机：0-30秒前奏，30-60秒主歌，60-90秒副歌

5. Excel行高统一

数据行统一设置为100，标题行20.4：

"row_height": {
  "title_row": 20.4,
  "data_row": 100
}

6. 外网搜索自动收集

user_config.json 新增 external_search 配置：

{
  "external_search": {
    "auto_collect": true,      // 空关键词时自动获取热门
    "collect_count": 20,
    "platforms": ["TikTok", "YouTube"],
    "default_keywords": []       // 备用关键词（可选）
  }
}

三种使用场景：

1. external_keywords 有值 → 使用用户配置的关键词
2. external_keywords 为空，default_keywords 有值 → 使用默认关键词
3. 两者都为空 + auto_collect: true → 调用 web_search 自动获取当前热门

注意： 场景3如果搜索失败会直接报错，不使用备用数据。

联系我们

如有问题或建议，欢迎交流：

• 微信号： huitouyoujianta
• 用途： 快导(KD)技能使用咨询、功能建议、技术交流

欢迎加微信交流学习！