润禾AI直播弹幕引擎 · 安装与开播说明

这份说明写给要开播的商家：照着做一遍，电脑上就能跑起自己的 AI 助播——网上弹幕采得到、AI 会接着说、声音直接送到手机，手机里看到的声音名字叫「润禾麦克风」。

全整体流程：四步就能开播

程序、采集插件、配置、开播是四件不同的事，按顺序做一次，以后每天只要「双击启动 → 填产品 → 点开播」。

润禾直播安装与开播流程 四步流程：装程序并启动本机服务、装浏览器采集插件、走首次向导填写平台产品声音素材、在开播页点开始开播。 💻 1 装程序 解压双击，开本机服务 🧩 2 装采集插件 浏览器里加载一次 🧭 3 首次向导 平台·产品·声音·素材 🚀 4 开播 填产品，点开始开播 装一次，之后每天只做第 4 步
四步流程示意：前两步只做一次，第 3 步由程序自己弹出来引导，第 4 步是每天开播的固定动作。

第一次打开会自动弹「首次向导」

四步：选直播平台 → 填产品与卖点 → 定主播声音 → 填互动素材。每一步都直接写进真配置，走完就能开播。

已经配好的项不会再问你；配完以后换浏览器、换电脑打开，也不会重复弹。想重跑，点面板右上角「🧭 新手指南」。

界面就两层，不绕

  • 主区 4 项开播 / 文案与互动 / 声音 / 充值
  • 更多设置点左侧「⚙️ 更多设置 ▾」展开：主播人设 / 插播设置 / 弹幕监控 / 直播复盘 / 违禁词 / 设备与插件
  • 每天只用「开播」页——选音色、填产品、点开始开播

打开程序默认就落在「开播」页，不用到处找。

1装程序并启动

程序跑在开播用的那台电脑上（Windows 10 / 11），不需要服务器、不需要显卡，内存占用 150–300MB。

方式 0：免安装版（推荐，最省事）

  1. 打开下载中心 download.tb1688.top，下载 免安装版（runhe-live-standalone-v1.7.3.zip，约 33MB）。
  2. 解压到任意目录（建议 D:\润禾直播，路径不要带特殊符号），不用装 Python、不用装运行库。
  3. 双击 润禾直播.exe，程序会自己起服务并打开操作面板。以后每天就双击这一个图标。
  4. 想放桌面：右键 润禾直播.exe → 发送到 → 桌面快捷方式。
浏览器可能提示「不常下载的文件」、Windows 可能提示「已保护你的电脑」——这是免安装程序的常规提醒：点「保留」 → 「更多信息」 → 「仍要运行」即可。

方式 A：Web 部署包（公网部署 / 服务器用，本文档所在的那个包）

  1. 先确认这台电脑装了 Python 3.10 或更高版本：打开命令行执行 python --version，能打印出版本号就算合格。没装就去 下载 Python 3.12 运行环境，安装时务必勾选 Add python.exe to PATH，装完重开一次命令行再验证。
  2. 解压《runhe-web-v1.7.3.zip》到目标目录（路径不要带特殊符号）。
  3. 双击 _工具\一键启动.bat服务就会在 http://127.0.0.1:8901/ 起来（等价于手动执行 python server\danmaku_server.py）；想直接开面板，双击 _工具\打开面板.bat。
  4. 要装成开机自启 / 公网访问，按 _说明\deploy\DEPLOY_上线步骤.md 走（nginx + systemd）。
双击报 Python not found：就是这台电脑没装运行环境，按上面第 1 条装好 Python（记得勾 Add python.exe to PATH），再双击 一键启动.bat 即可。
运行期文件都在 data\ 目录。 弹幕、AI 话术、语音任务、场次记录落在 data\runhe.db；产品、声音、互动素材、关键词回复等配置落在 data\live_data\*.json。 换机搬迁时，只搬业务配置，不要把旧机器的 api_token.txt、数据库整包拷过去。

2装采集插件（弹幕从哪来，每台开播电脑做一次）

弹幕靠浏览器插件抓。插件负责「把直播间的弹幕读出来、把 AI 的话发回去」，Chrome 或 Edge 都可以。不装插件，程序收不到弹幕，AI 也就没法回答。

装法不用记路径——面板里已经带着入口：左侧「⚙️ 更多设置 ▾」→「🔌 设备与插件」→「🧩 采集插件」。

  1. 点「打开插件文件夹」会自动弹出资源管理器并选中插件目录（不用自己找路径）。
  2. 打开扩展管理页：浏览器地址栏输入 chrome://extensions（Edge 是 edge://extensions），右上角打开「开发者模式」。
  3. 加载扩展目录：点「加载已解压的扩展程序」，选中第 1 步弹出的那个文件夹。
  4. 回来点「检测插件」：显示「插件已装好，正在收弹幕 ✓」就成了。
  5. 打开直播间页面：抖音 / 淘宝 / 视频号任选一个，插件开始采集弹幕，面板上会实时看到数据。
不用手填服务端地址和口令。 插件会自动向本机服务索取口令（本机走 GET /api/local-token），省掉最容易填错的一步。 如果装到了别的电脑、或要连公网域名，再按插件弹窗里的说明填 wss://你的域名/ws/extension。
换浏览器、或要发给同事？ 在「🧩 采集插件」卡上点「下载插件包」，会下载一个 zip，解压后按上面第 2、3 步装到目标电脑即可。

3走一遍首次向导

第一次打开面板会自动弹出向导，四步走完，程序就知道「你在哪个平台播、卖什么、谁的声音、遇到问题怎么答」。

第 1 步 · 选直播平台

选抖音 / 淘宝 / 视频号。也可以直接把直播间链接粘进去，程序会自己识别是哪个平台。

这一步决定违禁词按哪家的规则来管。

第 2 步 · 填产品与卖点

一行一个产品，格式是：

名称|价格|原价|卖点1;卖点2|用法

多个产品都填上，直播时会一个一个轮着讲，不会只念第一个。

第 3 步 · 定主播声音

选一个主播音色，当场可以点试听。想用自己的声音，就走「声音复刻」把音色传上来。

之后还能让它每 2~4 小时自动换个声音，避免一直一个调。

第 4 步 · 填互动素材

优惠怎么讲、什么时候发货、售后怎么处理、常见问答、不能说的话——填一次，之后 AI 互动就有真内容可说。

不想现在配也能跳过。 点「跳过」只是这次不看，程序里没配的项仍会算「没配好」，下次打开会再提醒一次；已经配过的项不会再问第二遍。

4开播：就 4 步

打开程序默认落在「开播」页，整页就是开播要用的东西，从上到下走一遍就行。

  1. 选主播：在「🎙 声音（核心）」卡里挑一个主播音色（点 ▶ 试听）。旁边还能单独设助播音色（欢迎/感谢）和插播音色。默认全自动，语气、语速、停顿系统按弹幕场景自己配，一般不用动。
  2. 填产品：在「🛒 产品清单」卡里一行一个产品，点「保存产品清单」。AI 会按顺序一个个讲，讲够条数自动换下一个。
  3. 点「▶ 开始开播」：一次点完——AI 开始出文案、主播开始说话、弹幕开始自动回。开播页上「🧠 AI 正在说」会实时显示正在讲的话。
  4. 点「■ 结束开播」：AI 文案和播报都停，本场记录自动存下来，可以在「📊 直播复盘」里看。

开播前看一眼那 5 盏灯

「🚀 开播总控」卡上有 5 盏灯：程序 / 采集插件 / 直播间 / 弹幕 / 余额。全绿=可以开播；哪盏不绿，点它旁边的字就能看到原因，照着修就行。也可以直接点「开播前检查」跑一遍完整体检。

画面和开播在平台自己的「网页版中控台 / 直播伴侣」里做。 本程序只管弹幕和 AI 说话：电脑推流时在直播软件里把麦克风选「润禾无线麦克风」；手机直播用 USB 内录线插手机充电口。
互动是「该回的一定回」。 观众提问、提到你设置的关键词，这类互动必回；其余按在线人数决定频率。互动完 AI 文案会接着往下讲，不会一直重复同一句。
余额低于 5 元（500 积分）会暂停 AI 发声，也开不了播。 弹幕照常采、互动照常统计，充值到账后最多 60 秒自动接着播，不用重新点开播。开播总控卡上有「去充值 →」直达。

声音：听着像真人、送进手机、还能用你自己的声音

听着像真人

语速、音高、音量跟着句子情绪走，不再一条直线念到底。说话前还会「顺一遍嘴」：去掉读不出来的表情和括号动作、书面词换口语、数字按口语读、长句断短句。

手机里叫「润禾麦克风」

程序输出到手机的声音，在手机上显示的名字就是「润禾麦克风」——和 AI 无关，观众看到的是一个正常的设备名。

用自己的声音

想用店主自己的声音，走「+ 声音复刻」上传一段录音；复刻完成后这个声音就进音色库，能当主播音色用。前台只留复刻这一条路。

三个角色分别选

主播（讲货）、助播（欢迎/感谢）、插播，可以各选各的音色，不用一个声音讲全场。在「开播」页的「🎙 声音（核心）」卡里直接换。

音色库怎么分

「声音」页的音色库里按来源分：现成声音（我们云端复刻好的主播音色）、我的声音（你自己复刻的）、系统音色。都能筛「主播用 / 助播用」，点卡片就换声音。

不会哑巴

主引擎不行会自动重试、换别的引擎；音色本身有问题会退回系统音色；实在都挂了就降级纯文字播报，不会整场没声音。「声音」页有「声音自检」可以随时探活。

第三方接口（MiniMax 等）配在后台。 前端只留一个出口，客户看不到也不需要拿到别人的 Key；要用自己的复刻与高级音色，在后台填 Key 即可。

文案与互动：客户自己就能改

AI 文案可以改

话术都能打开改。文案有不合适的地方，商家自己改一下，下一版就按新的说，不用等我们发版。

关键词回复：问了就照你说的答

在「文案与互动」→「💬 关键词回复」里写「客户这么问 → AI 这么答」。点「一键预填常见问答」先把常用的一批铺上，再按自己的话改。

AI 回答记录：答得好的存下来

开播时 AI 每次答了什么，都能在「看看 AI 刚才都答了啥」里回看。答得好的点「存为关键词」，下次开播自动照这个答；答得不对的改成你要的说法再存。

违禁词有兜底

按直播平台的规则内置了违禁词，商家还能自己再加。踩线的话不会说出去。

多产品轮着讲

一件一件来：讲够条数就换下一个产品，价格、卖点、用法各说各的。

互动随人数

人少高频、人中适当、人多偶尔；同时保证被问到的必回。

常见问题

面板打不开、浏览器显示无法访问

免安装版看 润禾直播.exe 是否还在运行（窗口是否还在）；脚本包点一次 _工具\一键启动.bat；然后访问 http://127.0.0.1:8901/。

仍然不行，看 data\log\ 里的日志，通常直接写着原因，最常见的是 8901 端口被别的程序占用。

操作口令在哪里？忘了怎么办

口令在 data\api_token.txt，启动日志里也会打印一段「润禾直播弹幕引擎 · 安全设置」。

面板打开时会自动带上口令（打开面板的链接里就含口令），所以平时不用手填；只有把面板挂到公网域名、或插件装到别的电脑时才需要。

弹幕采不到 / 面板没有数据

去「更多设置 ▾ → 设备与插件 → 🧩 采集插件」点一下「检测插件」，看它怎么说：

· 显示「没找到插件文件夹」→ 安装包不完整，重新解压一次；
· 显示「插件文件在，但还没连上」→ 插件没装好，按卡上的三步重装一遍；
· 显示「插件已装好」但面板还是没数据 → 直播间页面刷新一次（装完插件要先重开一次直播间）。

手机里听不到声音 / 看不到「润禾麦克风」

先确认电脑端确实在出声：在「声音」页点一次「试听当前音色」，本机扬声器应该立刻有声音。

再确认手机和电脑在同一个局域网，并且手机上选中的音频输出设备名字是「润禾麦克风」。默认播放位置就是「服务端直接放音」，声音由本机直接送到设备上，手机上不用做任何设置。

面板显示「未激活」

说明这台机器还没激活。用后台给这台机器生成的激活码激活一次即可：打开「更多设置 ▾ → 设备与插件 → 授权与积分」按提示走，或直接访问 http://127.0.0.1:8901/license.html。

同一账号只允许一台电脑在线，换机需要在后台先把旧设备解绑。

AI 答得不对 / 老是说一样的话

去「文案与互动」页：关键词回复里把那个问题的答案写清楚（写得越具体越像你的人）；开播时答得好的，在AI 回答记录里点「存为关键词」，下次自动照这个答。

觉得整段文案都不合适，就在「AI 文案库」里改，改完下一版生效，不用重启程序。

想重新跑一遍首次向导

点面板右上角「🧭 新手指南」，随时可以重跑四步，不会清掉你已经填好的产品、素材和声音。

怎么把配置搬到另一台电脑

搬两样就够了：data\live_data\ 里的业务配置（产品、声音、互动素材、话术、关键词回复），以及你自己准备的音频文件。

不要把 api_token.txt、runhe.db 一起拷过去：前者是这台机器的钥匙，后者含旧机器的真实直播数据。

充积分与充值：AI 用多少、在哪充

AI 助播按「积分」计量，说出去的话和合成的声音都从积分里扣。1 积分 = 0.01 元。余额低于 5 元（500 积分）会暂停 AI 播报，也不能开播；充值到账后自动恢复，不需要重新开播。面板「充值」页里看到的余额、充值积分、赠送积分和明细，跟云端账本是同一份数据。

播报门槛（2026-09-16 起生效）：余额低于 5 元（500 积分） 不能开播；已经在播的会暂停 AI 发声——弹幕照常采、互动照常统计，充值到账后最多 60 秒自动接着播，不用重新点开播。 门槛按余额合计算（未过期的充值积分 + 赠送积分都算），所以赠送的额度也能撑住播报。
充值档位与赠送（赠送积分 30 天内有效）
充值到账充值积分赠送积分合计
100 元10000100（1%）10100
500 元500001000（2%）51000
1000 元1000003000（3%）103000
3000 元30000015000（5%）315000

充值积分 12 个月有效，赠送积分 30 天有效；扣费时先扣充值积分，扣完再扣赠送积分，所以赠送的额度不会白白过期。赠送只对这四档生效，其他金额按面值给分、不给赠送。

  1. 打开面板左侧 充值 页，先看一眼余额、充值积分、赠送积分和剩余天数。
  2. 选一个档位 → 勾选《积分充值与使用协议》→ 点「去支付」，浏览器会跳到支付宝收银台付款。
  3. 付完回到面板点「我已支付 · 查一下」，到账后余额自动刷新；一直没到账就点「复制支付链接」重开收银台，或联系客服补单。

协议全文在 https://runhe.tb1688.top/pay/agreement（现行版本 v1.1）：预付费算力额度、有效期、扣减顺序、不可提现转让、退款口径、播报门槛都写在里面。每次提交充值，系统都会记下协议版本与勾选时间，可追溯。

充值页走云端授权：这台电脑要用授权码完成激活之后，余额与充值才会显示。

附：装到服务器（这部分是给我们自己看的）

如果要部署成公网可访问的版本，用部署包 runhe-web-v1.7.3.zip，步骤写在随包的 _说明\README_部署说明.md 与 _说明\deploy\DEPLOY_上线步骤.md 里，部署资产包括：

服务器侧部署资产
文件用途
deploy\runhe.servicesystemd 单元：数据目录外置、AI 队列与限流参数、掉线自动重启
deploy\nginx_runhe.confNginx 反代：80 跳 443、HTTPS、WebSocket 升级头、长连接与安全头
deploy\logrotate_runhe.conf日志按天轮转，保留 14 份
deploy\prod_selfcheck.py上线后自检脚本：从健康检查到真机链路逐项验
_说明\deploy\DEPLOY_上线步骤.md从装依赖到上线、升级、回滚的完整步骤

本轮验收（我们做完的证据）

这一版（P52）把面板按「客户开播动线」重排了一遍，并逐项实测。验收分两层：静态自检 + 起真服务联调（含无头浏览器全量点击）。

P52 各项验收结果
项目结果
面板结构自检（标签闭合 / 页面与导航双向匹配 / 重复 id）0 错误
面板 JS 语法校验（147499 字符单块编译）通过
10 个页面逐个切换 + 主区内容10 / 10 可见
开关逐个点击（语音播报 / 自动语速 / 背景音乐 / 闪避 / 换主播 / 定时插播）6 / 6 有变化
关键函数存在性（含采集插件三函数）25 / 25
浏览器控制台报错0
关键词落盘：新增 / 去重更新 / 批量 / 删除全通过
关键词重启读回（客户改的不丢）通过
AI 回答记录接口 / 回退接口通过
采集插件引导接口（info / open_folder / download）通过

「开关都能点、没有失效的页面和按钮」这件事是逐个点出来的：10 个页面全部切得到、有内容；6 个开关点下去都真的调了后端接口、状态有变化；页面里没有指向不存在功能的死按钮。

唯一还卡在代码之外的，是三平台真机标定（淘宝真机校验、视频号选择器标定），必须在真实直播间页面上做，清单见随包的《_说明\真机验收清单_三平台.md》。