抖音直播弹幕AI智能回复助手

实时采集抖音直播弹幕，使用DeepSeek AI分析用户意图，结合主播人设智能生成个性化回复并支持自动重连与缓存节省API调用。

功能概述

本 Skill 是一个完整的抖音直播弹幕采集与AI回复系统：

1. 实时弹幕采集 - 通过 WebSocket 连接抖音直播服务器，实时获取弹幕
2. AI 智能分析 - 使用 DeepSeek API 深度分析每条弹幕的用户意图
3. 个性化回复 - 根据主播人设生成专业、亲切的回复建议
4. 智能缓存 - 缓存最近100条回复，避免重复调用API，节省费用
5. 自动重连 - 断线后自动重连，保持稳定运行
6. 多场景支持 - 支持电商、教育、游戏、娱乐等直播类型

适用场景

• 电商直播：回复价格、质量、发货等咨询
• 教育直播：解答学习、育儿、成长问题
• 游戏直播：回应游戏技巧、出装、对局问题
• 知识分享：回应观众提问和互动
• 带货直播：引导下单、处理异议

项目结构

douyin-live-ai/
├── SKILL.md                    # 本文件（Skill说明文档）
├── start.bat                   # 一键启动脚本（Windows）
├── scripts/                    # 核心脚本
│   ├── config.py              # 配置文件（填写直播间ID和API Key）
│   ├── main.py                # 程序入口（基础版）
│   ├── main_with_reconnect.py # 程序入口（推荐，自动重连）
│   ├── douyinlive.py          # WebSocket连接与消息处理
│   ├── deepseek_ai.py         # DeepSeek AI集成
│   ├── reply_cache.py         # 回复缓存管理（LRU）
│   ├── sign.js                # 抖音签名生成脚本
│   ├── get_sign_wrapper.js    # Node.js包装器（解决编码问题）
│   ├── douyin/                # Protobuf定义
│   │   ├── douyin.proto
│   │   └── douyin_pb2.py
│   └── CoreUtils/             # 加密工具
│       ├── __init__.py
│       └── Encrypt.py
└── references/                # 参考资料
    └── prompts.md             # AI提示词参考

环境依赖

• Python 3.7+
• Node.js（用于执行签名生成脚本）
• DeepSeek API Key（在 https://platform.deepseek.com/ 注册获取）

安装Python依赖

pip install websocket-client requests execjs protobuf

快速开始

第一步：配置直播间信息

编辑 scripts/config.py，填写以下必填项：

# 直播间ID（URL最后的数字）
# 例如 https://live.douyin.com/349873582969 → ROOM_ID = "349873582969"
ROOM_ID = "your_room_id_here"

# 直播类型
LIVE_TYPE = "entertainment"  # 可选: ecommerce, education, entertainment

# 主播名称
HOST_NAME = "你的主播名称"

# 主播简介（填写越详细，AI回复越准确）
HOST_INTRO = """
你的主播简介...
"""

# DeepSeek API Key
DEEPSEEK_API_KEY = "your_deepseek_api_key_here"
# 也可通过环境变量设置（推荐）：
# set DEEPSEEK_API_KEY=your_key（Windows）
# export DEEPSEEK_API_KEY=your_key（Linux/Mac）

第二步：启动程序

方式一：双击 start.bat（推荐，Windows）

• 自动设置UTF-8编码
• 在独立窗口运行，支持自动滚动
• 使用带自动重连的版本

方式二：命令行启动

cd scripts
# 基础版
python main.py
# 自动重连版（推荐）
python main_with_reconnect.py

第三步：查看输出

============================================================
[2026-03-21 10:30:15] [API] 用户A: W什么技能
------------------------------------------------------------
DeepSeek AI回复: @用户A 朋友，W是黄金圣盾啊！开盾减速还能加护甲，对线换血的神技！
============================================================

============================================================
[2026-03-21 10:30:45] [缓存] 用户B: 这出装怎么出？
------------------------------------------------------------
DeepSeek AI回复: @用户B 亲，这英雄核心装备是...
============================================================

标识说明：

• [API] - 调用 DeepSeek API 实时生成的回复
• [缓存] - 相同问题命中缓存，直接复用（节省API调用）

配置说明

config.py 完整配置

# ==================== 直播间配置 ====================
ROOM_ID = "your_room_id_here"           # 直播间ID（必填）
LIVE_TYPE = "entertainment"             # 直播类型

# ==================== 主播简介配置 ====================
HOST_NAME = "你的主播名称"               # 主播名称（必填）
HOST_INTRO = """主播详细介绍..."""       # 主播简介（必填，越详细越好）
HOST_PERSONA = "主播人设风格"            # 人设风格
REPLY_STYLE = "humorous"               # 回复风格

# ==================== DeepSeek API 配置 ====================
DEEPSEEK_API_KEY = "your_api_key"       # API Key（必填）
DEEPSEEK_API_URL = "https://api.deepseek.com/v1/chat/completions"
DEEPSEEK_MODEL = "deepseek-chat"        # 模型名称
TEMPERATURE = 0.7                       # 温度参数（0-2）
MAX_TOKENS = 500                        # 最大token数

# ==================== 过滤配置 ====================
IGNORED_USERS = ["管理员", "系统消息"]   # 忽略用户
IGNORED_KEYWORDS = ["666", "哈哈哈"]     # 忽略关键词
MIN_MESSAGE_LENGTH = 2                  # 最小消息长度

直播类型说明

LIVE_TYPE	适用场景	回复风格
entertainment	游戏、娱乐直播	轻松幽默、积极互动
ecommerce	电商带货	引导下单、强调优惠
education	知识分享、教学	专业解答、耐心指导

回复风格说明

REPLY_STYLE	风格描述
humorous	幽默风趣，活跃气氛
friendly	亲切友好，温暖互动
professional	专业严谨，权威解答

核心功能详解

智能过滤

• 自动过滤欢迎消息、礼物消息、系统消息
• 忽略纯数字、纯表情、无意义内容
• 可配置忽略特定用户和关键词

LRU 缓存机制

• 保存最近100条回复
• 相同问题直接返回缓存，节省API调用费用
• 缓存持久化到本地 ai_replies_cache.json

自动重连

• 连接断开后自动重连，最多100次
• 每次重连间隔5秒
• Ctrl+C 可手动停止

示例回复

直播类型	用户弹幕	AI 回复
游戏	"W什么技能？"	"@用户 朋友，W是黄金圣盾啊！开盾减速还能加护甲，对线换血的神技！"
电商	"这个多少钱？"	"@用户 宝子，这款今天直播间专属福利价！具体看左下角小黄车~"
教育	"高敏感孩子怎么引导"	"@用户 亲，高敏感孩子天赋满满！建议：1.接纳特质 2.提前告知变化..."
娱乐	"晚上好"	"@用户 欢迎宝子！今天福利多多，喜欢什么告诉我~"

故障排查

问题	解决方案
GBK编码错误	使用 start.bat 启动，会自动设置UTF-8编码
连接失败/断开	使用 main_with_reconnect.py，自动重连
没有弹幕输出	确认直播间ID正确且正在直播
AI回复很慢	检查网络；降低 TEMPERATURE；善用缓存
Node.js 报错	确保已安装 Node.js：https://nodejs.org

注意事项

1. Node.js 环境：必须安装 Node.js，用于执行抖音签名生成
2. API Key 安全：建议通过环境变量 DEEPSEEK_API_KEY 设置，避免硬编码
3. 网络连接：需要稳定的网络连接抖音服务器
4. 频率限制：注意 DeepSeek API 的调用频率和费用

免责声明

本项目仅供学习与技术交流使用，请勿用于任何商业或非法用途。