全整体流程：四步就能开播
程序、浏览器扩展、配置、开播是四件不同的事，按顺序做一次，以后每天只要「双击启动 → 开播」。
装好之后，想知道面板上每个按钮、每个开关分别是干什么的，看配套的 《使用教程》：每个页面逐个讲，按「装 → 配 → 播」的顺序走一遍就能全跑通。
第一次打开会自动弹「首次向导」
四步：选直播平台 → 填产品与卖点 → 定主播声音 → 填互动素材。每一步都直接写进真配置，走完就能开播。
已经配好的项不会再问你；配完以后换浏览器、换电脑打开，也不会重复弹。想重跑，点面板右上角「🧭 新手指南」。
面板结构：6 个主菜单 + 更多设置
- 🚀 开播开播总控台，每天开播都在这一页（打开面板默认就是它）
- ▶️ 播放器循环放你的产品视频，声音直接送进直播口子
- ❓ 核心问题客户最常问的问题，先答好，开播后照着答
- ✍️ 文案与互动话术原文、互动节奏、关键词自动回复
- 🎵 声音选声音、试听、复刻自己的声音
- 💰 充值套餐直购、积分充值、每一笔明细
- ⚙️ 更多设置主播人设、插播、弹幕监控、直播复盘、违禁词、画面去重、设备与插件（折叠，点一下展开）
每天要用的都在主菜单里，配一次就够的收在「更多设置」里，不用翻菜单。
1装程序并启动
程序跑在开播用的那台电脑上（Windows 10 / 11），不需要服务器、不需要显卡，内存占用 150–300MB。
方式 0：免安装版（最省事，先看这个）
- 打开下载中心 download.tb1688.top，点「下载 免安装版」，得到一个约 340MB 的压缩包（内置专用浏览器和采集插件）。
- 把压缩包解压到电脑上，建议
D:\源声AI直播智能体（别放桌面、别放 C 盘）。 - 进文件夹，你会看到两个挨着的程序：「源声视频播放器」（循环放产品视频）和 「源声AI直播智能体」（AI 助播）。先双击「源声AI直播智能体」，第一次启动约 5～15 秒，操作界面会自己弹出来。
- 想放桌面：双击文件夹里的
发送到桌面.bat，两个图标都会出现在桌面上。以后每天从桌面双击即可。 - 不知道怎么下手？双击文件夹里的
源声AI直播智能体_5步开播引导.html，跟着 5 张图走一遍就行。
6_装虚拟声卡.bat 装一次就行，不用自己去网上找。data 文件夹换成你原来的 data，授权与积分数据都会保留。方式 A：手动部署包（技术人员 / 服务器部署时用，需要自己装 Python）
- 先确认这台电脑装了 Python 3.10 或更高版本：打开命令行执行
python --version，能打印出版本号就算合格。没装就去 下载 Python 3.12 运行环境，安装时务必勾选Add python.exe to PATH，装完重开一次命令行再验证。 - 解压《源声AI_手动部署包.zip》到目标目录（路径不要带特殊符号）。
- 双击包根目录的
源声AI直播智能体.vbs：服务在后台静默启动（没有黑窗口），界面自动弹出，地址是http://127.0.0.1:8901/。要排障看日志时再双击_工具\一键启动.bat（这个会显示窗口和运行日志）。 - 要装成开机自启 / 公网访问，按
_说明\deploy\DEPLOY_上线步骤.md走（nginx + systemd）。
Python not found：就是这台电脑没装运行环境，按上面第 1 条装好 Python（记得勾 Add python.exe to PATH），再双击 源声AI直播智能体.vbs 即可。data\ 目录。
弹幕、AI 话术、语音任务、场次记录落在 data\runhe.db；产品、声音、互动素材等配置落在 data\live_data\*.json。
换机搬迁时，只搬业务配置，不要把旧机器的 api_token.txt、数据库整包拷过去。
2打开直播间（免安装版不用装扩展）
免安装版自带一个专用浏览器，弹幕采集插件也随包带好了：不用装扩展、不用开开发者模式、不用填口令。
- 先双击「源声AI直播智能体」把服务起起来——插件要连本机服务，所以顺序别反。
- 面板 「🚀 开播」 页选好直播平台，点「打开直播间」。程序会用自带浏览器打开直播平台页面。
- 第一次要扫码登录一次（抖音 / 淘宝都要求登录后才放弹幕）。登录状态存在程序目录的
data\browser_profile里，以后打开都是登录好的，不用再扫。 - 那个浏览器窗口就是观众视角的直播页，开着别关，插件在里面自动采弹幕。
- 确认插件在跑：面板 「⚙️ 更多设置 → 🔌 设备与插件 → 🧩 采集插件」 里显示已连接就对了。当前扩展版本 1.7.4。
chrome://extensions（Edge 是 edge://extensions）→ 打开右上角「开发者模式」 → 点「加载已解压的扩展程序」 → 选包里的 integration\extension 目录；服务地址填 ws://127.0.0.1:8901/ws/extension，口令留空会自动获取。详见 《使用教程》第 5 节。3走一遍首次向导
第一次打开面板会自动弹出向导，四步走完，程序就知道「你在哪个平台播、卖什么、谁的声音、遇到问题怎么答」。
第 1 步 · 选直播平台
选抖音 / 淘宝 / 视频号。也可以直接把直播间链接粘进去，程序会自己识别是哪个平台。
这一步决定违禁词按哪家的规则来管。
第 2 步 · 填产品与卖点
在「🚀 开播 → 🛒 产品清单」里逐项填，一共 4 项：产品标题、核心卖点、正常售卖价、今天直播间价格。
核心卖点至少填 3 条（越多越好）：默认给你 3 行，不够就点「＋ 继续添加卖点」，填完点「收起」。卖点写得越具体，AI 讲得越像真主播。
主推款、副推款分开填，直播时会一个一个轮着讲，不会只念第一个。
第 3 步 · 定主播声音
选一个主播音色，当场可以点试听。想用自己的声音，就走「声音复刻」把音色传上来。
之后还能让它每 2~4 小时自动换个声音，避免一直一个调。
第 4 步 · 填互动素材
优惠怎么讲、什么时候发货、售后怎么处理、常见问答、不能说的话——填一次，之后 AI 互动就有真内容可说。
4开播：两步就够
打开面板默认就是「🚀 开播」页，每天开播只做两件事：确认产品 → 点「▶ 开始开播」。
- 🚀 开播总控：左边 5 盏状态灯（服务 / 插件 / 直播间 / 弹幕 / 登录态），右边四个按钮 —— 开始开播、结束开播、打开直播间、开播前检查。
- 🎙 声音（核心）：主播音色 / 助播音色 / 插播音色三个下拉，都能当场试听；下面三个开关：语音播报、人气自动调语速、背景音乐。
- ▶️ 播放器：循环放你的产品视频，声音直接送进直播口子；同一页还能开「🎥 画面自然化」。
- 🔊 声音出到哪：电脑推流 / 手机直播 / 本地测试，旁边能点「放一句测试音」。
- 🛒 产品清单：随时补产品、改卖点，下一个产品立刻按新内容讲。
- 🧠 AI 正在说：实时看 AI 这一句说的什么，说得不对点「去改关键词 →」。
点「开始开播」会一次做完四件事：起服务 → 打开语音播报 → 打开 AI 自动说 → 读下一条产品，不用再去别处挨个点开关。
声音：抑扬顿挫、送进手机、还能用你自己的声音
听着像真人
语速、音高、音量跟着句子情绪走，不再一条直线念到底。
手机里叫「源声麦克风」
手机直播时，用 USB 内录线插手机充电口（Type-C / Lightning），电脑的声音就直接进手机了，手机上什么都不用选。
系统给它的名字是「源声麦克风」，手机和直播软件里看到的就是这个名字——和 AI 无关，观众看到的是一个正常的设备名。
用自己的声音
想用店主自己的声音，走「声音复刻」上传音色；前台只留复刻这一条路，不能随便填个音色 id 就生效。
声音按积分计费
「现成声音」（我们云端复刻好的官方音色）和「我的声音」（你自己复刻的）都走云端合成，按积分计费。
两条路在面板 「🎵 声音 → 音色库」里分得清清楚楚，卡片上直接标了「现成声音 / 我的声音」。
定时自动换音色
默认每 2~4 小时随机换一次主播声音，可以关掉，也可以自己设区间。
文案与合规：客户自己就能改
AI 文案可以改
25 类话术都能打开改。文案有不合适的地方，商家自己改一下，下一版就按新的说，不用等我们发版。
违禁词有兜底
按直播平台的规则内置了违禁词，商家还能自己再加。踩线的话不会说出去。
多产品轮着讲
一件一件来：讲够条数就换下一个产品，价格、卖点、用法各说各的。
互动随人数
人少高频、人中适当、人多偶尔；同时保证被问到的必回。
常见问题
面板打不开、浏览器显示无法访问
先确认服务在跑：双击包里的 _工具\一键启动.bat（这个会显示窗口和运行日志），然后访问 http://127.0.0.1:8901/。
仍然不行，看 _工具\一键启动.bat 窗口里打印的日志，通常直接写着原因，最常见的是 8901 端口被别的程序占用。
操作口令在哪里？需要自己填吗
不用自己填。双击桌面「源声AI直播智能体」图标打开界面时，启动器会自动把口令带进去；浏览器扩展也会自动向本机服务索取口令。全程零配置。
口令文件仍在 data\api_token.txt，它是这台机器的钥匙，换机搬迁时不要拷给别人。
面板显示「未激活」
说明这台机器还没激活。用后台给这台机器生成的激活码激活一次即可；激活页入口是 http://127.0.0.1:8901/license.html。
同一账号只允许一台电脑在线，换机需要在后台先把旧设备解绑。
手机里听不到声音 / 看不到「源声麦克风」
先确认电脑端确实在出声：面板上点一次「试听」，本机扬声器应该立刻有声音。
再确认 USB 内录线已经插进手机充电口（Type-C / Lightning）。到面板 →「⚙️ 更多设置 → 🔌 设备与插件」→「📱 手机连接」点一次「放一句测试音」，手机上应该就能听到。手机上什么都不用选，声音是自动到位的。
弹幕采不到 / 面板没有数据
检查三件事：扩展是否处于「已启用」；桌面「源声AI直播智能体」是否已经启动（插件弹窗里点一下「🔄 自动获取本机口令」）；直播间页面是否已经刷新过（装完扩展要先重开一次直播间）。
声音听着还是平的，没有起伏
确认用的是支持情绪起伏的引擎（EdgeTTS 或后台配置的第三方引擎），且在面板里选择了启用抑扬顿挫的播报方式。
如果后台没配第三方 Key，系统只有 EdgeTTS 一路可用，音色数量会少一些，这是正常的。
想重新跑一遍首次向导
点面板右上角「🧭 新手指南」，随时可以重跑四步，不会清掉你已经填好的产品、素材和声音。
怎么把配置搬到另一台电脑
搬两样就够了：data\live_data\ 里的业务配置（产品、声音、互动素材、话术），以及你自己准备的音频文件。
不要把 api_token.txt、runhe.db 一起拷过去：前者是这台机器的钥匙，后者含旧机器的真实直播数据。
充积分与充值：AI 用多少、在哪充
AI 助播按「积分」计量，说出去的话和合成的声音都从积分里扣。1 积分 = 0.01 元（也就是 1 元 = 100 积分 = 1000 汉字）。余额低于 5 元（500 积分）会暂停 AI 播报，也不能开播；充值到账后自动恢复，不需要重新开播。面板「💰 充值」里看到的余额、充值积分、赠送积分和明细，跟云端账本是同一份数据。
| 套餐 | 价格 | 有效期 | 赠送积分 |
|---|---|---|---|
| 星耀月卡 | 298 元 | 31 天 | 20000 |
| 星耀终身 | 998 元 | 3650 天 | 90000 |
| 星耀多机 | 1980 元 | 5 台独立授权 | 180000（每台 36000） |
| 畅播 · 月 | 598 元 | 31 天 | 80000 |
| 畅播 · 季 | 1498 元 | 93 天 | 230000 |
套餐赠送的积分随授权到期一并失效；同一台机器续期时，剩余天数自动叠加，不会浪费。星耀试用（含 1000 积分）加客服微信领取，客服顺手教你开播；加客服还能再送 3 天 + 1000 积分。
| 充值 | 到账充值积分 | 赠送积分 | 合计 |
|---|---|---|---|
| 100 元 | 10000 | 100（1%） | 10100 |
| 500 元 | 50000 | 1000（2%） | 51000 |
| 1000 元 | 100000 | 3000（3%） | 103000 |
| 3000 元 | 300000 | 15000（5%） | 315000 |
充值积分 12 个月有效，赠送积分 30 天有效；扣费时先扣充值积分，扣完再扣赠送积分，所以赠送的额度不会白白过期。赠送只对这四档生效，其他金额按面值给分、不给赠送。
- 打开面板 → 💰 充值，先看一眼余额、充值积分、赠送积分和剩余天数。
- 选一个档位 → 勾选《积分充值与使用协议》→ 点「去支付」，浏览器会跳到支付宝收银台付款。
- 付完回到面板点「我已支付 · 查一下」，到账后余额自动刷新；一直没到账就点「复制支付链接」重开收银台，或联系客服补单。
协议全文在 https://runhe.tb1688.top/pay/agreement（现行版本 v1.1）：预付费算力额度、有效期、扣减顺序、不可提现转让、退款口径、播报门槛都写在里面。每次提交充值，系统都会记下协议版本与勾选时间，可追溯。
充值走云端授权：这台电脑要用授权码完成激活（面板 → ⚙️ 更多设置 → 🔌 设备与插件 → 授权与积分）之后，余额与充值才会显示。
附：装到服务器（这部分是给我们自己看的）
如果要部署成公网可访问的版本，用部署包 源声AI_手动部署包.zip，步骤写在随包的 _说明\README_部署说明.md 与 _说明\deploy\DEPLOY_上线步骤.md 里，部署资产包括：
| 文件 | 用途 |
|---|---|
_说明\deploy\runhe.service | systemd 单元：数据目录外置、AI 队列与限流参数、掉线自动重启 |
_说明\deploy\nginx_runhe.conf | Nginx 反代：80 跳 443、HTTPS、WebSocket 升级头、长连接与安全头 |
_说明\deploy\logrotate_runhe.conf | 日志按天轮转，保留 14 份 |
_说明\deploy\prod_selfcheck.py | 上线后自检脚本：从健康检查到真机链路逐项验 |
_说明\deploy\DEPLOY_上线步骤.md | 从装依赖到上线、升级、回滚的完整步骤 |
本轮验收（我们做完的证据）
下面这张表是 P13–P26 那几版的验收记录，留档备查；每一项都过了两层验收：引擎/静态自检 + 起真服务联调。
本轮（P52 / v1.7.3）把面板的信息架构整个重排了一遍：导航收成 4 个主菜单 + 6 个「更多设置」折叠项（P54 起扩到 6 个主菜单 + 7 个折叠项），新增「🚀 开播」页（默认首页，6 张卡、5 盏状态灯、一键开播），删掉「简单模式 / 专业模式」切换和一批点了没反应的死开关，关键词回复改成落盘持久化（data/live_data/ai_keywords.json），「设备与插件」页新增采集插件三步安装引导。
| 项目 | 自检 | 联调 |
|---|---|---|
| P16-1 主播声音抑扬顿挫 | 60 / 0 | 真机 10 / 10 |
| P16-2 输出到手机 · 源声麦克风 | 33 / 33、48 / 48 | 37 / 37、56 / 56 |
| P16-3 声音复刻 | 71 / 0、59 / 0 | 71 / 0 |
| P16-4 文案随机 + 互动后继续 | 49 / 0 | 38 / 0 |
| P16-5 商家必填互动素材 | 59 / 0 | 34 / 0 |
| P16-6 多产品逐个播 | 75 / 0 | 51 / 0 |
| P16-7 定时自动换主播声音 | 74 / 0 | 64 / 0 |
| P17-1 第三方接口全收后台 | 31 / 0 | 49 / 0 |
| P17-2 自带声音只能走复刻 | 54 / 0 | 50 / 0 |
| P26 免费声音收敛（已在 P48 全部下架） | 6 / 0 | 11 / 0 |
| P17-3 文案客户可改 | 78 / 0 | 45 / 0 |
| P17-4 违禁词体系 | 89 / 0 | 59 / 0 |
| P17-5 互动随在线人数 + 互动要准 | 88 / 0 | 55 / 0 |
| P13-2 首次向导（简单模式已在 P52 下线） | 110 / 0 | 67 / 0 |
| P52 面板信息架构重构（导航 4+6 / 开播页 / 失效项清零） | 全通过 | 10 页 · 6 开关 · 0 报错 |
| P53–P56 套餐直购 · 自带播放器 · 核心问题 · 计时扣费 · 去重画质 | 全通过 | 13 页 · 播放器 3 轮 ×10 分钟 |
本轮 P52 另外做了三项实测：① 静态自检 —— 面板 10 个页面、6 个开关、25 个关键函数全部在位；② 起真服务联调 —— 关键词落盘后重启读回 5 条全部正确，采集插件三个接口全部返回正常；③ 无头浏览器全量交互 —— Console 零报错、10 个页面逐一切换都有内容、6 个开关点击全部生效。
唯一还卡在代码之外的，是三平台真机标定（淘宝真机校验、视频号选择器标定），必须在真实直播间页面上做，清单见随包的《_说明\真机验收清单_三平台.md》。