源声AI直播智能体 · 使用教程 v1.7.3 安装说明 下载中心

使用教程:面板每个地方是干什么的

这份教程写给要开播的商家,也写给帮忙测试的人。照着从头走一遍,面板上每个按钮、每个开关都能对上号。

顺序就三步:装程序 → 配一次 → 每天开播。装和配只做一次,之后每天只要双击桌面图标。

Web 版 v1.7.3 更新 2026-09-18 全程无黑窗口 面板地址 127.0.0.1:8901

先看:整体怎么走

三件事,别搞混
阶段要做什么做几次在哪做
① 装程序 下载「免安装版」压缩包,解压后双击里面的「源声AI直播智能体」图标,桌面出现快捷方式 每台开播电脑一次 浏览器下载 → 解压 → 双击
② 装扩展 在浏览器里加载一次扩展,负责把直播间弹幕读进来、把 AI 的话发回去 每台开播电脑一次 Chrome / Edge 扩展页
③ 配一次 首次向导四步:选平台 → 填产品 → 定声音 → 填互动素材 第一次打开自动弹 面板里
④ 每天开播 双击桌面图标 → 填产品 → 点「开始开播」 每天 面板里
前两步一辈子只做一次。以后每天只要双击桌面图标 → 点「开始开播」,程序自己会把服务拉起来、把界面弹出来。
1

装程序(一次性)

推荐用免安装版

方式一:免安装版(最省事,先看这个)

  1. 打开下载中心 download.tb1688.top,点「下载 免安装版」,得到一个约 32MB 的压缩包。
  2. 把压缩包解压到电脑上(建议 D:\源声AI直播智能体别放桌面、别放 C 盘)。
  3. 进文件夹,双击「源声AI直播智能体」图标。第一次启动约 5~15 秒,操作界面会自己弹出来。
  4. 想放桌面:右键那个图标 → 发送到 → 桌面快捷方式。以后就从桌面双击。
这台电脑什么都不用装。运行环境(Python 和全部依赖)已经打包在程序里了,不用装 Python、不用装驱动、不用联网下组件。
以后升级:下载新压缩包解压到别处,把里面的 data 文件夹换成你原来的 data授权和积分都还在

方式二:一键安装脚本(免安装版跑不通时用)

  1. 在下载中心页面底部「其他下载」里点「一键安装脚本」,得到 runhe-install.bat双击它
  2. 浏览器提示「不常下载的文件」点「保留」;Windows 提示「已保护你的电脑」点「更多信息」→「仍要运行」
  3. 按提示按一次回车,等 1–3 分钟。它会自动下载部署包、解压到 D:\源声AI直播智能体、这台电脑缺 Python 就静默补上、建桌面图标、打开面板。
老客户升级也可以双击它:认出旧版本后原地覆盖更新,授权和积分数据都会保留

方式三:手动安装(技术人员 / 要装到服务器时用)

  1. 确认这台电脑有 Python 3.10 或更高版本。没装就下载 Python 3.12 运行环境,安装时务必勾选 Add python.exe to PATH
  2. 下载 手动部署包,解压到目标目录(路径别带特殊符号,不要放在桌面)。
  3. 双击包里的 源声AI直播智能体.vbs:服务后台静默启动,界面自动弹出,没有黑窗口
  4. 要排障看日志时,改双击 _工具\一键启动.bat(这个会显示窗口和运行日志)。
双击报 Python not found,就是这台电脑缺运行环境,按第 1 条装好 Python(记得勾 Add python.exe to PATH),再双击图标。
📁 装在哪

免安装版就装在你解压出来的那个文件夹里(建议 D:\源声AI直播智能体)。运行期数据都在里面的 data\ 目录,换机搬迁只搬业务配置,不要拷 api_token.txt 和整个数据库。

🚀 开机自动待命

免安装版不写注册表、不设开机启动,不占后台。用的时候双击图标,程序自己把服务拉起来、把界面弹出来。

🖥 电脑要求

Windows 10 / 11 普通电脑就行,不需要服务器、不需要显卡,内存占用约 150–300MB。

2

激活授权(第一次必做)

不用抄机器码

第一次打开会怎样

  1. 双击桌面「源声AI直播智能体」图标,面板自动弹出(地址是 http://127.0.0.1:8901/)。
  2. 如果这台机器还没授权,页面会提示未激活。打开授权页 http://127.0.0.1:8901/license.html(面板里也有入口)。
  3. 「申请开通」:本机信息会直接送到我们这边,你不用填任何东西、不用抄机器码
  4. 我们这边开通好后,这个页面会自己变成「已授权」(保持联网即可)。也可以点「复制申请码」发给客服。
两种码都能用:RH- 开头的云端码,和一长串离线码。没网也能激活(本机校验,秒过)。

怎么确认已经授权好了

  • 面板左侧进 「⚙️ 更多设置 → 🔌 设备与插件」,找到「授权与积分」,点「刷新授权」,能看到授权类型和到期时间就对了。
  • 顶部状态条不再出现红色的「未授权」提示。
同一授权码只允许一台电脑在线。要换电脑,先在后台把旧设备解绑,再在新电脑上激活。
3

认识面板:左边只留 4 个主菜单

先认路,再干活

面板怎么打开

  • 日常:双击桌面「源声AI直播智能体」图标,会弹出一个没有地址栏的独立窗口(不是浏览器标签页,看起来像个软件)。
  • 手动:浏览器打开 http://127.0.0.1:8901/
  • 关掉窗口服务还在后台跑,再双击是秒开

顶部有什么

位置是什么怎么用
右上角🧭 新手指南随时重跑四步向导,不会清掉你已经填好的产品、素材和声音
右上角💰 余额显示当前积分和折算金额,低于 500 积分会标红。
顶部提示条状态提示出现红色提示条时,说明写操作被拒绝(多半是口令没带上)。关掉页面、重新双击桌面「源声AI直播智能体」图标打开即可恢复。
这一版把「专业模式 / 简单模式」切换去掉了 —— 开播页本身已经只放开播要用的东西,不再需要两套模式。

左边菜单:4 个主项 + 6 个折叠项

左边只留 每天都要用的 4 个;偶尔才动一次的收进最下面的 「⚙️ 更多设置 ▾」,点一下展开。

主菜单一句话说清它是干什么的什么时候用
🚀 开播开播总控台:选平台、开播、调三种声音、填产品、看 AI 正在说什么每天开播都在这一页(打开面板默认就是它)
✍️ 文案与互动每一类话术的原文、互动节奏、关键词自动回复觉得某句话不对、想改口径
🎵 声音选谁的声音、试听、复刻你自己的声音、调声音风格换声音、想用自己的声音
💰 充值余额、充值档位、每一笔明细余额不够、想加钱

⚙️ 更多设置 ▾(折叠项,点一下展开):

折叠菜单一句话说清它是干什么的什么时候用
🎭 主播人设主播是谁、卖什么、优惠发货售后怎么讲、多个产品怎么轮第一次配置、换品的时候
📢 插播设置隔一段时间自动插一段话(福利、转场、暖场)想让直播间不冷场
💭 弹幕监控实时看弹幕、看统计、手动发一条快速回复开播中盯着互动
📊 直播复盘本场数据、AI 洞察、历史场次下播后看效果
🚫 违禁词按平台规则拦掉不能说的话,也能自己加词合规兜底,建议开播前看一眼
🔌 设备与插件采集插件安装引导、操作口令、授权与积分、声音出到哪、服务状态第一次装插件、排障、换设备
找不着某个功能时,先想它属于哪一类:每天要用的在 4 个主菜单里,配一次就够的在「更多设置」里。
4

每个页面逐个讲

按「这页干什么 / 怎么操作 / 注意什么」讲
🚀 4.1 开播 开播总控台 · 每天开播都在这一页
这页干什么

选平台、点开播、调三种角色的声音、填产品、看 AI 正在说什么,全在这一页。打开面板默认就是它。

六张卡,从上往下
  • 🚀 开播总控:左边 5 盏状态灯(服务 / 插件 / 直播间 / 弹幕 / 登录态),右边四个按钮 —— ▶ 开始开播■ 结束开播打开直播间开播前检查。下面选直播平台(抖音 / 淘宝 / 视频号),还有「上次直播间」一键重开。
  • 🎙 声音(核心):三个下拉 —— 主播音色(念产品、讲卖点)、助播音色(欢迎新人、感谢关注)、插播音色(定时插话)。旁边有 试听 ▶。下面三个开关:语音播报人气自动调语速背景音乐。想细调点「声音设置 →」跳到声音页。
  • 🛒 产品清单:卖什么、价格、卖点,这是 AI 说话的内容来源。填得越实,AI 说得越像真主播。
  • 🔊 声音出到哪💻 电脑推流(默认,走电脑声卡)/ 📱 手机直播(声音走局域网送到手机)/ 🔈 本地测试(只从本机音箱出)。旁边能点「放一句测试音」。
  • 🧠 AI 正在说:实时滚动显示 AI 这一句说的是什么,下面有「说得不对?去改关键词 →」直达按钮。
  • 📋 运行日志:服务在干什么、有没有报错,排障看这里。
开播只要两步
① 填好产品 ② 点「开始开播」

点「开始开播」会一次做完四件事:起服务 → 打开语音播报 → 打开 AI 自动说 → 读下一条产品。不用再去别处挨个点开关。

画面和开播本身不在这个程序里做。用平台自己的工具开播就行:淘宝直播中控台、抖音直播伴侣、视频号助手、OBS 都行。本程序只做两件事 —— 读直播间弹幕 + AI 语音回答
「打开直播间」会用一个独立窗口打开直播间网页(优先挑装了采集插件的那个浏览器),方便插件采弹幕。点「开播前检查」会一项项告诉你哪儿还没配好。
✍️ 4.2 文案与互动 AI 说什么话 · 互动节奏 · 关键词自动回复
这页干什么

AI 说出来的每一句话,原文都在这一页。觉得哪句不对,就在这里改。

✍️ AI 文案库

按场景分好的话术原文:开场、讲品、催单、欢迎、感谢、下播等。改完立刻生效,下一句就说新的。

👥 互动节奏(按在线人数自动)

默认自动跟随在线人数:人少时说慢点、人多时说快点。想固定就手动选人少 / 人中 / 人多三档。

💬 关键词回复(AI 说得对不对,在这儿纠)

  • 格式是 一行一条,写成 关键词|回答。观众弹幕里出现这个词,AI 就按你写的答。
  • 面板已经预填了一批常见问答,你可以直接在后面接着加。
  • 开播中 AI 答过的内容会记成 AI 回答记录;哪条答得好,点「存为关键词」,下次开播它就自动按这条答,不会再乱说
  • 答得不好的,回到这一页改掉那一条就行。
这就是「AI 越用越准」的地方:弹幕问了什么 → AI 怎么答 → 答得好的存成关键词 → 下次直接命中。
别把答案写得太长,一句话最好;太长 AI 会念得很慢,观众听着累。
🎵 4.3 声音 选谁的声音 · 试听 · 复刻自己的声音
这页干什么

管所有跟「声音」有关的事。我们的核心就是声音好,所以这一页值得花五分钟调一次。

🎵 音色库(最上面)

  • 卡片上直接看总数和「现成声音 / 我的声音」计数,可以按全部 / 现成声音 / 我的声音筛,也能按主播用 / 助播用筛。
  • 点卡片上的「试听」先听一遍,点「套用」立即换成这个声音(刷新页面后仍然生效)。
  • 想用自己的声音,点 「+ 声音复刻」:上传一段录音 → 起个名字 → 开始复刻,复刻好会自动出现在「我的声音」里。
想用你自己的声音,只有复刻这一条路。不支持把音频文件直接当音色播 —— 平台会判成非 AI 合成语音,也不稳定。

📊 音色使用统计

看哪个声音用得多、每个角色现在绑的是哪个声音。

🎭 主播声音(细调)

点「高级」展开:情绪、语速、音高、音量。可以 A/B 对比两个声音,也能把当前这套设置存成方案,下次一键套用。

这些不用你天天调:系统会按这句话的场景自动匹配(欢迎热情、讲解平缓、中奖惊喜、规则认真)。想调就调,不想调放着就行。

🗣️ 口语化与停顿(像真人说话)

打开抑扬顿挫长句断句,声音就不平了,会像真人一样有起伏。点「看语调曲线」可以先预览。

🛡️ 声音可用性(别哑巴)

「声音自检」:它会真的合成一句话放出来,告诉你现在这个声音能不能正常出声。开播前不确定就点一下。

💰 4.4 充值 余额 · 充值 · 每一笔明细
这页干什么

看余额、加钱、查每一笔扣费。放在主菜单里,就是为了不用翻

  • 最上面显示当前余额(积分 + 折算金额),余额不够时会标红。
  • 中间是充值档位:100 / 500 / 1000 / 3000 元,选一档扫码付款即可。
  • 下面是明细:什么时候充的、什么时候扣的、扣了多少、剩多少,跟云端账本是同一份数据。
余额低于 5 元(500 积分)会暂停 AI 播报、也不能开播;充值到账后最多 60 秒自动接着播,不用重新点开播。
🎭 4.5 主播人设 你是谁 · 卖什么 · 怎么讲(配一次就够)
这页干什么

告诉程序「你是谁、卖什么、优惠发货售后怎么讲」。这是 AI 说话的内容来源,填得越实,AI 说得越像真主播。

🎭 主播人设

主播称呼、性格、说话风格、直播间定位。

🛍 产品信息

产品名、价格、卖点、优惠、发货、售后。在「开播」页填的产品,就是这里的产品。

互动素材(商家必填)

欢迎语、感谢语、常见问答。常见问答每行一条,格式 问题|回答。违禁词填进去,AI 就算生成出来也不会说。

🛒 多产品轮播

一场直播卖好几个品时,把产品排好顺序,AI 会一个个轮着讲。

🎲 定时换主播声音

想让声音有点变化,可以设几个声音轮着用。

🎙️ AI 接口

AI 说话的模型和接口配置。默认已经配好,不用动。

📢 4.6 插播设置 隔一段时间自动插一段话
这页干什么

让直播间不冷场:每隔一段时间自动插一段(发福利、转场、暖场、提醒关注)。

⏰ 定时插播

设好间隔秒数和内容,开播后它自己按节奏插。

📋 插播队列

看接下来要插哪几条,能手动调顺序、跳过当前这条。

➕ 自定义场景

自己加一类插播场景,比如「每半小时报一次优惠」。

插播用的是「插播音色」,在「开播」页第二个下拉里选。
💭 4.7 弹幕监控 开播中盯着互动用
这页干什么

开播中盯着互动用:弹幕有没有进来、AI 回了什么、观众在说什么。

  • 实时弹幕流:观众说了什么,一条条滚出来。
  • 📈 实时统计:弹幕总数、AI 回复数、观众数、违禁词命中数。
  • 快速回复:想临时补一句,在这里手打,AI 立刻说出来。
这里一条弹幕都没有,先去「🔌 设备与插件」看采集插件装没装、直播间页面刷新没刷新。
📊 4.8 直播复盘 下播后看效果
这页干什么

记录每一场的数据,下播后回来看这一场播得怎么样。

  • 开播时点「开始本场」,下播时点「结束本场」,数据落库。
  • 本场数据:播了多久、说了多少句、来了多少人、互动多少。
  • AI 洞察:哪类话术反响好、哪些问题观众问得最多。
  • 历史场次:往期一场场翻。
🚫 4.9 违禁词 合规兜底 · 建议开播前看一眼
这页干什么

按平台规则拦掉不能说的话。AI 就算生成了,也会被替换掉,不会说出口。

  • 内置词库:常见的绝对化用语、医疗功效、承诺类词汇,默认开着。
  • 自己加词:卖特殊品类时,把自己行业不能说的词加进去。
  • 检查开关:建议一直开着。
违禁词只能兜底,不能替代你判断。涉及功效、价格承诺、极限词,自己也要把关。
🔌 4.10 设备与插件 装采集插件 · 授权积分 · 排障
这页干什么

第一次装采集插件、查授权和积分、换声音输出位置、排障,都在这。

🧩 采集插件(三步装好)

  1. 「打开插件文件夹」,会直接弹出程序自带的 integration\extension 文件夹。
  2. 浏览器地址栏输入 chrome://extensions(Edge 是 edge://extensions),打开右上角「开发者模式」,点「加载已解压的扩展程序」,选中那个 extension 文件夹。
  3. 回到这一页点「检查插件状态」,显示已连接就成了。口令程序会自动配好,不用你填。
找不到文件夹就用页面上的「下载插件包」,下载后解压再按上面第 2 步加载。装完记得重新打开一次直播间页面

🔐 服务端操作口令(安全)

本机服务的访问口令,程序自动生成、自动带上,平时不用管

授权与积分

看授权类型、到期时间,点「刷新授权」手动刷一次。

🔊 声音出到哪

和「开播」页那张卡是同一个设置:电脑推流 / 手机直播 / 本地测试。

📱 手机连接(声音自动到位,手机上不用设)

手机直播时,电脑把声音送到手机。手机和电脑要在同一个局域网,手机上音频输出选「润禾麦克风」。

服务状态

服务、插件、直播间、弹幕、登录态,一眼看全。哪项不正常会标红。

5

装浏览器扩展(每台开播电脑做一次)

不装就采不到弹幕

扩展负责两件事:把直播间的弹幕读出来把 AI 的话发回直播间。Chrome 或 Edge 都可以。

下载浏览器扩展包(约 37 KB)

  1. 下载上面的扩展包并解压,得到一个 runhe-extension 文件夹。整个文件夹都要,建议就放在 D:\源声AI直播智能体\ 下面。(程序包里也自带一份,在 integration\extension,效果一样。)
  2. 地址栏输入 chrome://extensions(Edge 是 edge://extensions),右上角打开「开发者模式」,点「加载已解压的扩展程序」,选中刚解压出来的 runhe-extension 文件夹。
  3. 点浏览器右上角的插件图标,在「服务地址」里填 ws://127.0.0.1:8901/ws/extension
    (如果你用的是配好域名的公网版,填 wss://你的域名/ws/extension。)
  4. 「操作口令」留空即可,点「保存配置」;扩展会自动向本机服务索取口令。万一没连上,点弹窗里的「🔄 自动获取本机口令」
  5. 打开直播间页面(抖音 / 淘宝 / 视频号任选),扩展开始采集弹幕,面板上会实时看到数据。
弹窗里能看到「抓取弹幕」和「队列」两个计数在涨,说明采到了。面板「🔌 设备与插件 → 服务状态」里「扩展连接」会变成已连接。
弹窗显示「操作口令错误」:先双击桌面「源声AI直播智能体」图标把服务起起来,再点弹窗里的「🔄 自动获取本机口令」。口令不对时扩展不会反复重连,不用担心刷屏。
刚装完扩展要重新打开一次直播间页面,否则采不到弹幕。
不想找文件夹也行:面板 「⚙️ 更多设置 → 🔌 设备与插件 → 🧩 采集插件」 里有「打开插件文件夹」「下载插件包」两个按钮,口令也是自动配好的。
6

一次完整开播,按这个顺序走

照着勾一遍

开播前(第一次做一次,以后偶尔补)

  1. 装程序 → 桌面出现「源声AI直播智能体」图标。
  2. 装浏览器扩展 → 填服务地址(口令会自动获取,不用填)。
  3. 首次向导走完:选平台 → 填产品 → 定声音 → 填互动素材。
  4. 去「违禁词」确认检查是开着的。
  5. 去「⚙️ 更多设置 → 🔌 设备与插件」确认服务、插件、授权、积分都正常。
  6. 点一次「放一句测试音」,确认声音能到该到的地方。

每天开播

  1. 双击桌面「源声AI直播智能体」图标(秒开,没有黑窗口)。
  2. 「🚀 开播」 页选好直播平台
  3. 「打开直播间」,用一个独立窗口进直播间(采集插件就在这个窗口里工作)。
  4. 确认「🛒 产品清单」里今天是哪个品、价格对不对。
  5. 「▶ 开始开播」,AI 开始按节奏说话。
  6. 播的过程中:用「💭 弹幕监控」盯互动;看「🧠 AI 正在说」确认它说得对不对;想补一句用「快速回复」。

下播

  1. 「■ 结束开播」
  2. 去「📊 直播复盘」点「结束本场」,数据落库。
  3. 看一眼 AI 洞察和本场数据。
  4. 关掉面板窗口就行,服务在后台待命,不影响下次秒开。
7

声音、积分与充值

想控预算看这里

AI 用多少,看你怎么选

  • AI 助播按积分计量:说出去的话和合成的声音都从积分里扣。
  • 1 积分 = 0.01 元。
  • 播报门槛:余额低于 5 元(500 积分)不能开播;已经在播的会暂停 AI 发声——弹幕照常采、互动照常统计,充值到账后最多 60 秒自动接着播,不用重新点开播
  • 门槛按余额合计算(未过期的充值积分 + 赠送积分都算),所以赠送的额度也能撑住播报。

充值档位与赠送

充值到账充值积分赠送积分合计
100 元10000100(1%)10100
500 元500001000(2%)51000
1000 元1000003000(3%)103000
3000 元30000015000(5%)315000
  • 充值积分 12 个月有效,赠送积分 30 天有效。
  • 扣费时先扣充值积分,扣完再扣赠送积分,所以赠送的额度不会白白过期。
  • 赠送只对这四档生效,其他金额按面值给分、不给赠送。
  • 协议全文在 runhe.tb1688.top/pay/agreement。每次提交充值,系统都会记下协议版本与勾选时间,可追溯。
积分中心走云端授权:这台电脑要用授权码完成激活之后,余额与充值才会显示。
8

常见问题

测试时最容易撞上的
现象多半是什么怎么办
面板打不开 / 显示无法访问 服务没起来,或 8901 端口被别的程序占了 双击程序目录里的 _工具\一键启动.bat(会显示窗口和日志),再访问 http://127.0.0.1:8901/。日志里通常直接写着原因。
双击图标没反应 直接在压缩包里双击了 要先解压,在解压后的文件夹里运行。
界面没弹出来 服务在后台起得稍慢 等 10 秒再双击一次图标。要排障就看 data\logs\launcher.logserver.log
双击报 Python not found 用的是老的手动部署包 免安装版最省事(运行环境已打包在里面)。要继续用手动包,就装 Python 3.12,务必勾 Add python.exe to PATH
面板显示「未激活」 这台机器还没激活 http://127.0.0.1:8901/license.html 点「申请开通」,或粘贴客服给的授权码激活。
顶部出现红色提示条 写操作被拒绝(口令没带上) 关掉页面,重新双击桌面「源声AI直播智能体」图标打开;一般就恢复了。
弹幕采不到 / 面板没数据 扩展没启用、服务地址填错、直播间页面没刷新 按顺序查三件事:扩展是否「已启用」;弹窗里的服务地址对不对(口令会自动获取);装完扩展后重新打开一次直播间页面。面板「🔌 设备与插件 → 🧩 采集插件」里有「检查插件状态」可以直接看。
手机里听不到声音 / 看不到「润禾麦克风」 电脑端本身没出声,或手机上选错了设备 先在面板点一次「试听」,本机扬声器应该立刻有声音;再确认手机和电脑在同一个局域网,手机上选中的音频输出设备名字是「润禾麦克风」。
声音听着还是平的,没有起伏 没开抑扬顿挫 去「🎵 声音 → 🗣️ 口语化与停顿」,打开抑扬顿挫长句断句,点「看语调曲线」预览一下。
提示积分不足 / 播报停了 余额低于 500 积分 「💰 充值」 充值,到账后最多 60 秒自动接着播,不用重新开播。
想重新跑一遍首次向导 —— 点面板右上角 「🧭 新手指南」,随时可以重跑四步,不会清掉你已经填好的产品、素材和声音
怎么把配置搬到另一台电脑 —— 搬两样就够了:data\live_data\ 里的业务配置,以及你自己准备的音频文件。不要api_token.txtrunhe.db
9

视频教程

录制中,录好放这里

文字看一遍,视频再跟一遍就更快了。下面几段正在录制,录好后会直接放在这一页。

🎬 01 装程序与激活 约 3 分钟 · 录制中
🎬 02 面板配置全流程 约 5 分钟 · 录制中
🎬 03 装扩展与开播实操 约 5 分钟 · 录制中
🎬 04 声音与积分怎么省 约 3 分钟 · 录制中