直播福利话术自动生成与推送：零门槛Python实操教程

开发环境准备与依赖安装

在开始编写代码之前，必须确保本地环境已经配置好Python运行环境。本指南基于Python 3.8版本开发，兼容Python 3.x全系列。为了实现话术模板的高效渲染和系统剪贴板的自动操作，我们需要引入两个核心第三方库：jinja2（用于模板引擎）和pyperclip（用于跨平台剪贴板操作）。

请打开终端（Windows下为CMD或PowerShell，Mac下为Terminal），依次执行以下命令进行安装。如果遇到权限问题，请自行添加--user参数。

```bash pip install jinja2==3.1.2 pip install pyperclip==1.8.2 ```

安装完成后，建议在终端输入python --version确认环境无误。接着，在本地新建一个文件夹，命名为live_script_tool，所有的代码和配置文件都将放置在此目录下。

数据结构与话术模板设计

为了实现话术的灵活配置，我们将“数据”与“模板”分离。数据部分存储具体的商品信息、库存数量和福利金额；模板部分存储不同场景下的直播话术框架。这种设计可以让你在不修改代码的情况下，仅通过修改配置文件即可更新话术。

在项目根目录下创建一个名为config.json的文件。这个文件将作为我们的数据源。请复制以下完整的JSON内容并粘贴到文件中。这里我们定义了两个商品对象，包含库存、价格、福利券金额等关键字段。

```json { "products": [ { "id": 101, "name": "深层清洁氨基酸洗面奶", "price": 89.00, "stock": 50, "coupon": 20, "original_price": 129.00 }, { "id": 102, "name": "修护舒缓精华液", "price": 159.00, "stock": 5, "coupon": 50, "original_price": 259.00 } ], "settings": { "shop_name": "美妆甄选直播间", "anchor_name": "小美" } } ```

接下来，我们需要定义话术模板。在项目根目录下创建templates.txt文件。我们将使用Jinja2语法{{ variable }}作为占位符。为了应对直播中的不同节奏，我们设计了三种类型的模板：常规上架、库存告急和限时倒计时。请确保文件内容格式严格如下：

```text [template_normal] 宝宝们，这款{{ name }}真的是我们的镇店之宝！ 原价{{ original_price }}，今天直播间只要{{ price }}！ 而且主播手里还有{{ coupon }}元的专属大额券，到手价低至{{ price - coupon }}元！ 库存只有{{ stock }}单，手慢拍大腿！ [template_urgent] ⚠️全网最后{{ stock }}单！最后{{ stock }}单！ 这款{{ name }}真的卖爆了，后台已经显示售罄在即！ 还没抢到的宝宝抓紧最后的机会，直接去拍1号链接！ 只要{{ price }}元，抢到就是赚到！ [template_countdown] 倒计时3分钟！3分钟后我们将下架{{ name }}！ 现在下单还送{{ name }}同款小样一份，仅限这3分钟！ 不要{{ original_price }}，不要{{ price }}，券后只要{{ price - coupon }}元！ ```

核心代码实现：话术生成引擎

现在进入核心开发环节。我们将编写一个Python脚本，读取配置文件，根据库存状态自动选择最合适的模板，渲染生成最终话术，并将其自动复制到剪贴板，同时输出到控制台供预览。在项目根目录下创建main.py文件。

以下代码包含了完整的逻辑实现：文件读取、JSON解析、Jinja2渲染环境配置以及智能模板选择逻辑。请完整复制以下代码，不要遗漏任何导入或函数定义。

```python import json import os import random import time import pyperclip from jinja2 import Template 配置文件路径 CONFIG_PATH = 'config.json' TEMPLATE_PATH = 'templates.txt' def load_config(): """加载配置数据""" if not os.path.exists(CONFIG_PATH): raise FileNotFoundError(f"配置文件 {CONFIG_PATH} 未找到") with open(CONFIG_PATH, 'r', encoding='utf-8') as f: return json.load(f) def load_templates(): """解析并加载话术模板""" if not os.path.exists(TEMPLATE_PATH): raise FileNotFoundError(f"模板文件 {TEMPLATE_PATH} 未找到") with open(TEMPLATE_PATH, 'r', encoding='utf-8') as f: content = f.read() 简单的解析逻辑，将文本分割为字典 templates = {} current_key = None current_content = [] for line in content.split('\n'): line = line.strip() if line.startswith('[') and line.endswith(']'): if current_key: templates[current_key] = '\n'.join(current_content) current_key = line[1:-1] current_content = [] elif current_key: current_content.append(line) if current_key: templates[current_key] = '\n'.join(current_content) return templates def generate_script(product, templates, settings): """ 根据商品库存状态智能选择模板并渲染 """ 计算实际到手价 product['final_price'] = product['price'] - product['coupon'] 智能选择模板逻辑 template_key = 'template_normal' if product['stock'] <= 5: template_key = 'template_urgent' elif product['stock'] <= 20: 库存较少时，随机混合使用urgent和countdown template_key = random.choice(['template_urgent', 'template_countdown']) raw_template = templates.get(template_key, templates['template_normal']) 使用Jinja2渲染 tmpl = Template(raw_template) try: script = tmpl.render(product, settings) return script except Exception as e: return f"话术生成失败: {str(e)}" def main(): print(">>> 正在初始化话术生成系统...") try: config = load_config() templates = load_templates() print(f">>> 配置加载成功，检测到 {len(config['products'])} 个商品数据。") except Exception as e: print(f">>> 初始化失败: {e}") return 模拟直播循环操作 while True: print("\n" + "="40) print("请选择操作：") for idx, p in enumerate(config['products']): print(f"{idx + 1}. 生成 [{p['name']}] 话术 (当前库存: {p['stock']})") print("0. 退出系统") print("="40) choice = input("请输入数字编号: ").strip() if choice == '0': print("系统已退出。") break if choice.isdigit() and 1 <= int(choice) <= len(config['products']): index = int(choice) - 1 product = config['products'][index] 生成话术 script = generate_script(product, templates, config['settings']) print("\n 生成话术预览 ") print(script) print("--\n") 自动复制到剪贴板 pyperclip.copy(script) print(">>> [成功] 话术已自动复制到剪贴板，可直接在直播软件中粘贴 (Ctrl+V)。") 模拟库存扣减（可选，为了演示逻辑） reduce_stock = input("是否模拟扣减库存? (y/n): ").strip().lower() if reduce_stock == 'y' and product['stock'] > 0: product['stock'] -= 1 print(f">>> [更新] {product['name']} 当前剩余库存: {product['stock']}") else: print(">>> 输入无效，请重新输入。") if __name__ == "__main__": main() ```

代码逻辑深度解析与实操细节

上述代码中，load_templates函数采用了自定义的解析逻辑。这是因为标准的Jinja2通常期望加载单个文件，而我们需要在一个文本文件中管理多个话术块。代码通过检测[key]格式的行来分割不同的模板，并将其存储在字典中，这种方式维护成本极低，不需要数据库支持。

关键逻辑点：在generate_script函数中，我们内置了一套简单的决策树。当库存小于等于5时，系统强制触发“库存告急”模板；当库存在5到20之间时，系统会随机在“库存告急”和“限时倒计时”中切换。这种随机性对于直播非常重要，可以避免话术听起来过于机械和重复。

关于数据计算：注意代码中product['final_price']的计算是在运行时动态进行的。这意味着你在config.json中修改了price或coupon，无需重启脚本，下次生成话术时会自动应用新的价格逻辑。这对于直播中频繁改价、临时加赠福利的场景非常实用。

进阶功能：实现OBS自动推流字幕

作为技术专家，我们不仅要生成文本，还要解决“展示”的问题。如果你的直播使用OBS Studio，可以通过Python将生成的话术实时写入到一个本地文本文件，OBS通过“文本源”读取该文件，从而实现字幕自动跟随话术更新。

请在main.py中引入write_to_obs_file函数，并在生成话术后调用它。在项目根目录下手动新建一个空文件obs_subtitle.txt。

修改main.py，在import部分后添加以下函数：

```python OBS_FILE_PATH = 'obs_subtitle.txt' def write_to_obs_file(text): """将话术写入OBS可读取的文本文件""" try: with open(OBS_FILE_PATH, 'w', encoding='utf-8') as f: OBS读取长文本可能需要换行处理，这里取前50字作为滚动字幕 f.write(text) print(">>> [OBS联动] 字幕文件已更新。") except Exception as e: print(f">>> [OBS联动] 写入失败: {e}") ```

接着，找到main函数中pyperclip.copy(script)这一行，在其下方添加：

```python write_to_obs_file(script) ```

配置OBS Studio步骤：

1. 添加文本源：在OBS“来源”区域，点击“+”，选择“文本 (GDI+)”。
2. 设置读取文件：勾选“从文件读取文本”，点击“浏览”，选中我们项目目录下的obs_subtitle.txt。
3. 调整外观：设置字体大小、颜色、描边等，确保在直播画面中清晰可见。

完成配置后，当你运行Python脚本生成话术时，OBS画面上的字幕会同步变更为最新生成的话术内容。这实现了完全自动化的直播辅助。

常见报错与解决方案

在实操过程中，新手可能会遇到以下具体问题，请对照排查：

• ModuleNotFoundError: No module named 'jinja2'

  这表示依赖库未正确安装。请检查是否在正确的Python环境中执行了pip install命令。如果同时安装了Python2和Python3，请使用pip3 install jinja2 pyperclip。

• JSONDecodeError

  这通常是因为config.json中使用了中文标点符号（如中文逗号、引号）。JSON标准必须使用英文半角符号。请使用代码编辑器（如VS Code）打开文件，检查是否有红色波浪线提示。

• OBS字幕不更新或显示乱码

  乱码通常是编码问题，确保Python写入文件时使用了encoding='utf-8'。如果不更新，请检查OBS中“文本源”属性里是否正确勾选了“从文件读取文本”，并且文件路径绝对正确。

• 剪贴板功能失效

  pyperclip在Linux系统下可能需要依赖gtk或xclip库。如果在Windows/Mac下失效，请尝试以管理员身份运行终端，或者检查是否有其他剪贴板管理软件（如Ditto）正在拦截操作。

通过以上步骤，你已经拥有了一套完整的、可落地的直播福利话术自动化系统。从配置管理到智能生成，再到OBS联动，所有环节均可直接操作。建议在实际直播前，模拟库存变化多测试几次，熟悉不同库存阈值下的话术输出效果。