全整体流程：四步就能开播
程序、浏览器扩展、配置、开播是四件不同的事，按顺序做一次，以后每天只要「双击启动 → 开播」。
第一次打开会自动弹「首次向导」
四步：选直播平台 → 填产品与卖点 → 定主播声音 → 填互动素材。每一步都直接写进真配置，走完就能开播。
已经配好的项不会再问你；配完以后换浏览器、换电脑打开，也不会重复弹。想重跑，点面板右上角「🧭 新手指南」。
两种模式，随时切换
- 简单模式只留开播要用的：开播、在线人数与互动节奏、主播声音、产品与卖点
- 专业模式完整 9 个设置页，全部能力都在这里
- 切换位置面板顶部「专业模式 / 简单模式」
默认是专业模式，用过一次简单模式后会记住你的选择。
1装程序并启动
程序跑在开播用的那台电脑上（Windows 10 / 11），不需要服务器、不需要显卡，内存占用 150–300MB。
方式 A：绿色包（推荐，最省事）
- 解压到本机目录路径里不要带特殊符号，例如
D:\润禾直播。 - 双击
润禾直播智能体.exe程序会起服务，并自动把面板打开；没自动打开就手动访问http://127.0.0.1:8901/。 - 首次启动会生成一个「操作口令」写在
data\api_token.txt，启动日志里也会打印。这个口令是整套系统的钥匙，装扩展时要用。
方式 B：脚本包（带 1–5 号按钮，方便日常用）
| 文件 | 用途 | 什么时候点 |
|---|---|---|
1_启动润禾.bat | 启动服务（内部调 tools\run_server.ps1） | 每天开播前 |
2_停止润禾.bat | 停止服务 | 播完收工 |
3_重启润禾.bat | 重启服务 | 改了配置想立刻生效 |
4_查看日志.bat | 看运行日志 | 出问题时排查 |
5_命名润禾麦克风.bat | 把输出到手机的声音名字设成「润禾麦克风」 | 装完点一次，手机里就显示这个名字 |
data\ 目录。
弹幕、AI 话术、语音任务、场次记录落在 data\runhe.db；产品、声音、互动素材等配置落在 data\live_data\*.json。
换机搬迁时，只搬业务配置，不要把旧机器的 api_token.txt、数据库整包拷过去。
2装浏览器扩展（每台开播电脑做一次）
扩展负责「把直播间的弹幕读出来、把 AI 的话发回去」，Chrome 或 Edge 都可以。
- 打开扩展管理页地址栏输入
chrome://extensions（Edge 是edge://extensions），右上角打开「开发者模式」。 - 加载扩展目录点「加载已解压的扩展程序」，选择包里的
integration\extension目录（绿色包在_internal\integration\extension）。 - 填服务端地址点插件图标，地址填
ws://127.0.0.1:8901/ws/extension；已经配了域名和 HTTPS 的话，填wss://你的域名/ws/extension。 - 填操作口令把
data\api_token.txt里的口令粘进插件的「操作口令」，点「保存配置」。 - 打开直播间页面抖音 / 淘宝 / 视频号任选一个，扩展开始采集弹幕，面板上会实时看到数据。
data\api_token.txt 复制粘贴保存即可；口令不对时扩展不会反复重连，不用担心刷屏。
3走一遍首次向导
第一次打开面板会自动弹出向导，四步走完，程序就知道「你在哪个平台播、卖什么、谁的声音、遇到问题怎么答」。
第 1 步 · 选直播平台
选抖音 / 淘宝 / 视频号。也可以直接把直播间链接粘进去，程序会自己识别是哪个平台。
这一步决定违禁词按哪家的规则来管。
第 2 步 · 填产品与卖点
一行一个产品，格式是：
名称|价格|原价|卖点1;卖点2|用法
多个产品都填上，直播时会一个一个轮着讲，不会只念第一个。
第 3 步 · 定主播声音
选一个主播音色，当场可以点试听。想用自己的声音，就走「声音复刻」把音色传上来。
之后还能让它每 2~4 小时自动换个声音，避免一直一个调。
第 4 步 · 填互动素材
优惠怎么讲、什么时候发货、售后怎么处理、常见问答、不能说的话——填一次，之后 AI 互动就有真内容可说。
4开播：简单模式点四下
切到简单模式后，屏幕上只剩开播真正要用的东西。
- 开始直播：一键启动 AI 助播，文案开始按节奏输出。
- 在线人数与互动节奏：可以选自动，也可以手动选「人少 / 中等 / 人多」——人少时互动频繁些，人多时偶尔互动，不刷屏。
- 我的主播声音：换音色、试听、看现在正在用哪个。
- 产品与卖点：随时补产品、改卖点，下一个产品立刻按新内容讲。
播放中想跳过当前这段，用「跳过当前语音」；要改细项，每个卡片上都有直达专业页的入口，不用回去翻菜单。
声音：抑扬顿挫、送进手机、还能用你自己的声音
听着像真人
语速、音高、音量跟着句子情绪走，不再一条直线念到底。
手机里叫「润禾麦克风」
程序输出到手机的声音，在手机上显示的名字就是「润禾麦克风」——和 AI 无关，观众看到的是一个正常的设备名。
用自己的声音
想用店主自己的声音，走「声音复刻」上传音色；前台只留复刻这一条路，不能随便填个音色 id 就生效。
定时自动换音色
默认每 2~4 小时随机换一次主播声音，可以关掉，也可以自己设区间。
文案与合规：客户自己就能改
AI 文案可以改
25 类话术都能打开改。文案有不合适的地方，商家自己改一下，下一版就按新的说，不用等我们发版。
违禁词有兜底
按直播平台的规则内置了违禁词，商家还能自己再加。踩线的话不会说出去。
多产品轮着讲
一件一件来：讲够条数就换下一个产品，价格、卖点、用法各说各的。
互动随人数
人少高频、人中适当、人多偶尔；同时保证被问到的必回。
常见问题
面板打不开、浏览器显示无法访问
先确认服务在跑：绿色包看程序窗口是否还在，脚本包点一次 1_启动润禾.bat；然后访问 http://127.0.0.1:8901/。
仍然不行，点 4_查看日志.bat（绿色包看 server_stdout.log），日志里通常直接写着原因，最常见的是 8901 端口被别的程序占用。
操作口令在哪里？忘了怎么办
口令在 data\api_token.txt，启动日志里也会打印一段「润禾直播弹幕引擎 · 安全设置」。
带口令才能改配置；没带口令打开面板只能看不能改。所以装扩展时记得把口令一并填进去。
面板显示「未激活」
说明这台机器还没激活。用后台给这台机器生成的激活码激活一次即可；激活页入口是 http://127.0.0.1:8901/license.html。
同一账号只允许一台电脑在线，换机需要在后台先把旧设备解绑。
手机里听不到声音 / 看不到「润禾麦克风」
先确认电脑端确实在出声：面板上点一次「试听」，本机扬声器应该立刻有声音。
再确认手机和电脑在同一个局域网，并且手机上选中的音频输出设备名字是「润禾麦克风」（脚本包里可点一次 5_命名润禾麦克风.bat 让名字就位）。
弹幕采不到 / 面板没有数据
检查三件事：扩展是否处于「已启用」；插件弹窗里的服务端地址和操作口令是否正确；直播间页面是否已经刷新过（装完扩展要先重开一次直播间）。
声音听着还是平的，没有起伏
确认用的是支持情绪起伏的引擎（EdgeTTS 或后台配置的第三方引擎），且在面板里选择了启用抑扬顿挫的播报方式。
如果后台没配第三方 Key，系统只有 EdgeTTS 一路可用，音色数量会少一些，这是正常的。
想重新跑一遍首次向导
点面板右上角「🧭 新手指南」，随时可以重跑四步，不会清掉你已经填好的产品、素材和声音。
怎么把配置搬到另一台电脑
搬两样就够了：data\live_data\ 里的业务配置（产品、声音、互动素材、话术），以及你自己准备的音频文件。
不要把 api_token.txt、runhe.db 一起拷过去：前者是这台机器的钥匙，后者含旧机器的真实直播数据。
附：装到服务器（这部分是给我们自己看的）
如果要部署成公网可访问的版本，用部署包 润禾直播Web部署包_v1.4.0，步骤写在随包的 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 | 从装依赖到上线、升级、回滚的完整步骤 |
本轮验收（我们做完的证据）
这一版把「AI 输出与互动（P16，7 项）」「商家可运营化（P17，5 项）」「首次向导 + 简单模式（P13-2 / P13-3）」全部做完，每一项都过了两层验收：引擎/静态自检 + 起真服务联调。
| 项目 | 自检 | 联调 |
|---|---|---|
| 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 |
| P17-3 文案客户可改 | 78 / 0 | 45 / 0 |
| P17-4 违禁词体系 | 89 / 0 | 59 / 0 |
| P17-5 互动随在线人数 + 互动要准 | 88 / 0 | 55 / 0 |
| P13-2 / P13-3 首次向导 + 简单模式 | 110 / 0 | 67 / 0 |
最后跑了一次全量回归：30 套件全部 rc=0（含面板 JS 语法校验与面板结构校验），也就是这一版交付前的整体状态是干净的。
唯一还卡在代码之外的，是三平台真机标定（淘宝真机校验、视频号选择器标定），必须在真实直播间页面上做，清单见随包的《真机验收清单_三平台.md》。