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

\r

功能概述\r

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

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

适用场景\r

\r

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

项目结构\r

\r

douyin-live-ai/\r
├── SKILL.md                    # 本文件（Skill说明文档）\r
├── start.bat                   # 一键启动脚本（Windows）\r
├── scripts/                    # 核心脚本\r
│   ├── config.py              # 配置文件（填写直播间ID和API Key）\r
│   ├── main.py                # 程序入口（基础版）\r
│   ├── main_with_reconnect.py # 程序入口（推荐，自动重连）\r
│   ├── douyinlive.py          # WebSocket连接与消息处理\r
│   ├── deepseek_ai.py         # DeepSeek AI集成\r
│   ├── reply_cache.py         # 回复缓存管理（LRU）\r
│   ├── sign.js                # 抖音签名生成脚本\r
│   ├── get_sign_wrapper.js    # Node.js包装器（解决编码问题）\r
│   ├── douyin/                # Protobuf定义\r
│   │   ├── douyin.proto\r
│   │   └── douyin_pb2.py\r
│   └── CoreUtils/             # 加密工具\r
│       ├── __init__.py\r
│       └── Encrypt.py\r
└── references/                # 参考资料\r
    └── prompts.md             # AI提示词参考\r
```\r
\r
## 环境依赖\r
\r
- Python 3.7+\r
- Node.js（用于执行签名生成脚本）\r
- DeepSeek API Key（在 https://platform.deepseek.com/ 注册获取）\r
\r
### 安装Python依赖\r
\r
```bash\r
pip install websocket-client requests execjs protobuf\r
```\r
\r
## 快速开始\r
\r
### 第一步：配置直播间信息\r
\r
编辑 `scripts/config.py`，填写以下必填项：\r
\r
```python\r
# 直播间ID（URL最后的数字）\r
# 例如 https://live.douyin.com/349873582969 → ROOM_ID = "349873582969"\r
ROOM_ID = "your_room_id_here"\r
\r
# 直播类型\r
LIVE_TYPE = "entertainment"  # 可选: ecommerce, education, entertainment\r
\r
# 主播名称\r
HOST_NAME = "你的主播名称"\r
\r
# 主播简介（填写越详细，AI回复越准确）\r
HOST_INTRO = """\r
你的主播简介...\r
"""\r
\r
# DeepSeek API Key\r
DEEPSEEK_API_KEY = "your_deepseek_api_key_here"\r
# 也可通过环境变量设置（推荐）：\r
# set DEEPSEEK_API_KEY=your_key（Windows）\r
# export DEEPSEEK_API_KEY=your_key（Linux/Mac）\r
```\r
\r
### 第二步：启动程序\r
\r
**方式一：双击 `start.bat`（推荐，Windows）**\r
- 自动设置UTF-8编码\r
- 在独立窗口运行，支持自动滚动\r
- 使用带自动重连的版本\r
\r
**方式二：命令行启动**\r
```bash\r
cd scripts\r
# 基础版\r
python main.py\r
# 自动重连版（推荐）\r
python main_with_reconnect.py\r
```\r
\r
### 第三步：查看输出\r
\r
```\r
============================================================\r
[2026-03-21 10:30:15] [API] 用户A: W什么技能\r
------------------------------------------------------------\r
DeepSeek AI回复: @用户A 朋友，W是黄金圣盾啊！开盾减速还能加护甲，对线换血的神技！\r
============================================================\r
\r
============================================================\r
[2026-03-21 10:30:45] [缓存] 用户B: 这出装怎么出？\r
------------------------------------------------------------\r
DeepSeek AI回复: @用户B 亲，这英雄核心装备是...\r
============================================================\r
```\r
\r
**标识说明：**\r
- `[API]` - 调用 DeepSeek API 实时生成的回复\r
- `[缓存]` - 相同问题命中缓存，直接复用（节省API调用）\r
\r
## 配置说明\r
\r
### config.py 完整配置\r
\r
```python\r
# ==================== 直播间配置 ====================\r
ROOM_ID = "your_room_id_here"           # 直播间ID（必填）\r
LIVE_TYPE = "entertainment"             # 直播类型\r
\r
# ==================== 主播简介配置 ====================\r
HOST_NAME = "你的主播名称"               # 主播名称（必填）\r
HOST_INTRO = """主播详细介绍..."""       # 主播简介（必填，越详细越好）\r
HOST_PERSONA = "主播人设风格"            # 人设风格\r
REPLY_STYLE = "humorous"               # 回复风格\r
\r
# ==================== DeepSeek API 配置 ====================\r
DEEPSEEK_API_KEY = "your_api_key"       # API Key（必填）\r
DEEPSEEK_API_URL = "https://api.deepseek.com/v1/chat/completions"\r
DEEPSEEK_MODEL = "deepseek-chat"        # 模型名称\r
TEMPERATURE = 0.7                       # 温度参数（0-2）\r
MAX_TOKENS = 500                        # 最大token数\r
\r
# ==================== 过滤配置 ====================\r
IGNORED_USERS = ["管理员", "系统消息"]   # 忽略用户\r
IGNORED_KEYWORDS = ["666", "哈哈哈"]     # 忽略关键词\r
MIN_MESSAGE_LENGTH = 2                  # 最小消息长度\r
```\r
\r
### 直播类型说明\r
\r
| LIVE_TYPE | 适用场景 | 回复风格 |\r
|-----------|---------|---------|\r
| `entertainment` | 游戏、娱乐直播 | 轻松幽默、积极互动 |\r
| `ecommerce` | 电商带货 | 引导下单、强调优惠 |\r
| `education` | 知识分享、教学 | 专业解答、耐心指导 |\r
\r
### 回复风格说明\r
\r
| REPLY_STYLE | 风格描述 |\r
|-------------|---------|\r
| `humorous` | 幽默风趣，活跃气氛 |\r
| `friendly` | 亲切友好，温暖互动 |\r
| `professional` | 专业严谨，权威解答 |\r
\r
## 核心功能详解\r
\r
### 智能过滤\r
- 自动过滤欢迎消息、礼物消息、系统消息\r
- 忽略纯数字、纯表情、无意义内容\r
- 可配置忽略特定用户和关键词\r
\r
### LRU 缓存机制\r
- 保存最近100条回复\r
- 相同问题直接返回缓存，节省API调用费用\r
- 缓存持久化到本地 `ai_replies_cache.json`\r
\r
### 自动重连\r
- 连接断开后自动重连，最多100次\r
- 每次重连间隔5秒\r
- `Ctrl+C` 可手动停止\r
\r
## 示例回复\r
\r
| 直播类型 | 用户弹幕 | AI 回复 |\r
|---------|---------|---------|\r
| 游戏 | "W什么技能？" | "@用户 朋友，W是黄金圣盾啊！开盾减速还能加护甲，对线换血的神技！" |\r
| 电商 | "这个多少钱？" | "@用户 宝子，这款今天直播间专属福利价！具体看左下角小黄车~" |\r
| 教育 | "高敏感孩子怎么引导" | "@用户 亲，高敏感孩子天赋满满！建议：1.接纳特质 2.提前告知变化..." |\r
| 娱乐 | "晚上好" | "@用户 欢迎宝子！今天福利多多，喜欢什么告诉我~" |\r
\r
## 故障排查\r
\r
| 问题 | 解决方案 |\r
|------|---------|\r
| GBK编码错误 | 使用 `start.bat` 启动，会自动设置UTF-8编码 |\r
| 连接失败/断开 | 使用 `main_with_reconnect.py`，自动重连 |\r
| 没有弹幕输出 | 确认直播间ID正确且正在直播 |\r
| AI回复很慢 | 检查网络；降低 `TEMPERATURE`；善用缓存 |\r
| Node.js 报错 | 确保已安装 Node.js：https://nodejs.org |\r
\r
## 注意事项\r
\r
1. **Node.js 环境**：必须安装 Node.js，用于执行抖音签名生成\r
2. **API Key 安全**：建议通过环境变量 `DEEPSEEK_API_KEY` 设置，避免硬编码\r
3. **网络连接**：需要稳定的网络连接抖音服务器\r
4. **频率限制**：注意 DeepSeek API 的调用频率和费用\r
\r
## 免责声明\r
\r
本项目仅供学习与技术交流使用，请勿用于任何商业或非法用途。\r