使用说明书 · v1.0.28
新用户使用指南
从安装激活到摆好直播画面，跟着本文走一遍即可开始使用。
1这是什么
直播总控台是一套面向主播与直播团队的抖音直播间工具，一个程序同时完成两件事：
- 取数：加载直播间，实时采集在线观众、弹幕、礼物、进场等公开数据
- 显示：把数据画到一块可自由布局的「直播界面」上，供录屏 / 推流软件（如直播伴侣、OBS）采集
单进程架构，不需要另外开浏览器窗口，也不依赖任何第三方桥接程序。开播前双击运行即可。
只用于展示与统计直播间公开数据，请遵守平台相关规定使用。
2安装与激活
2.1 安装
- 双击 直播总控台-1.0.28-setup.exe
- 按向导选择安装目录（默认即可），可勾选「创建桌面快捷方式」
- 安装完成，桌面 / 开始菜单出现「直播总控台」图标
系统要求：Windows 10 / 11 64 位，4 GB 内存以上；需联网（用于卡密校验与自动更新）。
2.2 首次启动与激活
- 双击桌面图标启动
- 未授权时只会弹出「🔑 卡密授权」窗口（不会创建主界面）
- 填写 主播昵称 与 激活码（形如
XXXX-XXXX-XXXX-XXXX），点「激活」 - 激活成功后授权窗自动关闭，程序依次打开「直播界面」与「直播总控台」
一卡一机：激活码首次激活后与这台电脑绑定。更换电脑、重装系统、更换网卡后，请联系客服解绑设备，再在新机器上重新激活。到期前可联系客服续期，续期后无需重装。
激活状态可随时在 监控页 → 查看授权信息 复核（状态 / 激活码 / 到期时间 / 当前服务器）。
3启动与窗口
双击桌面「直播总控台」启动。程序共涉及 4 个窗口：
| 窗口 | 说明 |
|---|---|
| 直播总控台 | 主控制面板（4 个页签），所有设置都在这里 |
| 直播界面 | 真正要录屏 / 推流的画面，透明背景、可自由布局 |
| 在线观众 | 观众榜单窗口，可切「在线观众 / 消费榜」、手动刷新、记分 |
| 采集窗 | 用于抓取数据的 Edge 浏览器窗口（默认启动后移出屏幕，不打扰直播） |
- 单实例：重复双击不会开第二个，只会把已有窗口唤到前面
- 「直播界面」窗口会最先出现，方便直播伴侣把它当作第一个可用窗口抓取画面
- 采集窗「隐藏」只是移出屏幕，采集仍在继续（防止后台节流导致数据停更），不是关闭
4界面总览
主窗口标题栏左侧是 🔒 锁定 按钮，中间页签为 监控 / 界面 / 头像/视频 / 日志，右侧是版本号与最小化、关闭。
- 锁定：一键锁定 / 解锁直播界面里的全部图层，锁定后不能拖动、缩放、编辑图层，防止直播中误触
- 在线更新条（有新版本时才出现）：整机新版本走「检查更新 / 下载 / 立即重启升级 / 取消」；界面热更新走橙色提示条「界面已更新到最新版 → 立即重启 / 稍后」，两者都会自动出现，不必手动触发
- 底部：联系管理员（微信二维码）与官网入口
5五分钟快速上手
- 监控页 → 点「直播地址设置」→ 填直播间ID（纯数字）→ 保存配置
- 监控页 → 点「采集窗：显示」，在弹出的 Edge 里登录抖音（首次必做，登录一次即可）
- 监控页 → 点「▶ 启动检测」，等状态变为已采集
- 监控页 → 点「直播间界面」打开直播画面；点「在线观众」打开榜单
- 界面页 → 逐个点图层按钮（头像组 / 在线观众 / 弹幕 / 文本 …）调样式
- 头像/视频页 → 设头像闪动快捷键（默认 F3）、添加视频 / 音频素材
- 摆好后点标题栏「锁定」，再把直播界面窗口接入录屏 / 推流软件
建议先摆好「直播界面」窗口的位置与大小，再把它接入推流软件；之后的所有样式调整都会实时反映到画面上。
6监控页
6.1 状态行
- 连接状态：当前采集连接情况
- Cookie：采集端是否已有登录态
- 采集指示灯：未采集 / 采集中
6.2 数据采集开关
四个开关各自独立，关掉哪一类就不再采集哪一类（可降低资源占用）：
| 开关 | 采集内容 |
|---|---|
| 弹幕 | 聊天 / 评论消息 |
| 礼物更新 | 送礼数据（并刷新榜单） |
| 在线观众 | 观众榜与贡献数据 |
| 进场互动 | 进场、点赞、关注、加团等 |
6.3 直播地址设置
点 直播地址设置 展开配置面板：
| 项 | 说明 |
|---|---|
| 直播间ID（纯数字） | 如 546706120320；也支持粘贴 live.douyin.com/<id> 形式的链接 |
| HTTP端口（默认10086） | 本地数据服务端口；被占用时会自动顺延 |
| Cookie（可选） | 一般留空，登录态在采集窗里登录即可 |
改完点 保存配置（或 收起）。启动检测时也会自动保存当前输入。
6.4 启动 / 停止
- 启动时会：校验房间号 → 保存配置 → 清空上一次的临时数据 → 启动采集
- 未填房间号时提示「未指定直播间ID，无法启动采集」
6.5 开窗与显示
| 按钮 | 作用 |
|---|---|
| 直播间界面 / 关闭直播间界面 | 显示 / 隐藏「直播界面」窗口 |
| 在线观众 | 显示 / 隐藏「在线观众」窗口 |
| 采集窗：显示 / 隐藏 | 把采集窗移回屏幕 / 移出屏幕（不停止采集） |
| 拦截视频流：开 / 关 | 拦截直播间视频流省带宽与资源；若直播界面里嵌的网页视频需要播放，可关掉 |
6.6 积分与授权
| 按钮 | 作用 |
|---|---|
| 导出积分 | 把存分数据导出为 TXT（备份 / 换机） |
| 导入积分 | 从 TXT 导入存分（同一观众以文件记录覆盖本地） |
| 重置今日现分 | 立刻清空「今日现分」，不影响累计存分 |
| 查看授权信息 | 显示授权状态、激活码、到期时间、当前授权服务器 |
7界面页：直播画面图层
「直播界面」是多图层叠加的画面。界面页的按钮用来打开某个图层的属性面板、调整它的样式。
7.1 顶部控制
- 吸附标题「直播界面控制」，右侧 位置重置：把所有图层位置一键归到画面中心（只改位置，不动缩放 / 样式 / 内容），重置后需重新摆放
- 16:9：切换画布是否按 16:9 比例显示
7.2 图层按钮与可调项
| 图层 | 主要内容 |
|---|---|
| 头像组 | 显示头像组、图片边缘羽化、图片透明度、同步所有头衔、呼吸律动、缩放强度；名字子图层（水平/垂直位置、缩放、宽/高、字号、颜色、加粗、圆角、透明度、发光强度/颜色）；头像框形状（圆形/方形）、圆角、背景颜色/透明、显示边框/边框颜色/锁定边框色；用户名称、名字、排名、勋章；性别（显示、字号、男女颜色、加粗、显示形式、男女底图颜色、男女字体透明、男女底图透明）；年龄、城市；发光特效（发光效果：关闭 / 流星环绕 / 星光弥散 / 流星+星光；特效强度、光轨颜色、流星条数、环绕速度、粒子数量、光环尺寸） |
| 在线观众 | 显示在线观众、榜单模式（竖屏（列表）/ 流动瓶（横向滚动））、标题（在线观众）、标题样式、标题（消费榜）、标题样式、背景透明、卡片透明、显示条数、整套缩放、卡片间距、hover 放大、浮层透明、编辑布局、自由排列、一字排开；性别（显示性别、性别字号、男性/女性颜色、性别加粗、显示形式、男/女底图颜色、男/女字体透明、男/女底图透明）；离开效果（标题行右侧：直接移除 / 淡出后移除 / 灰显保留 + 保留秒数）；流动瓶专属：流动速度 / 流动行数 / 流动条数 / 头像缩放 |
| 弹幕 | 显示弹幕、弹幕过滤（全部 / 聊天 / 礼物 / 进入 / 点赞）、整体缩放、背景透明、字体大小、字体（多款随包字体）、字体颜色、加粗、字间距、上下间距、隐藏边框 |
| 资料卡 | 整体缩放、卡片宽度、背景颜色/透明、圆角、边框颜色、标题栏颜色、字体颜色/大小、阴影强度 |
| 浏览器 | 整体缩放、宽度、高度、滚动条粗细（资料卡里点「主页」时打开的网页图层） |
| 数字 | 字号、颜色、透明度、加粗、斜体、背景色、背景透明、圆角、描边（大数字 / 倒计时） |
| 文本 / 背景 | ＋ 添加图层 / 删除当前图层 / 当前图层；显示文本、文本内容（保存并渲染，Ctrl+Enter 快捷保存）、字体、字号、颜色、加粗、对齐、行高、字间距、图层透明；文字描边、文字阴影；背景图（选择文件 / 清除、背景透明、边缘羽化、内容透明、圆角、显示边框、纯色背景、纯色颜色） |
| 读文 | 显示读文、背景颜色/透明、羽化；文本目录（选择文件夹 / 清除）；目录图层（按钮字号/宽/高/内边距/圆角/字体颜色/按钮背景/悬停放大）；查看层（字号/颜色/行高） |
「头像组 → 性别」和「在线观众 → 性别」是两套独立设置：分别控制头像框上和榜单卡片里的 ♂/♀ 图标，各自随布局保存，互不影响。
7.3 布局备份
- 导出布局：把整份布局（图层位置、缩放、样式、标题文案等）导出为 JSON 文件，默认文件名
03-layout-<时间戳>.json - 导入布局：从 JSON 文件恢复布局
- 布局也在每次修改后自动保存，重启程序自动恢复
8头像/视频页
8.1 头像闪动（内置摇号）
「头像闪动」就是内置的摇号功能，没有单独的摇号窗口：
| 控件 | 说明 |
|---|---|
| 性别筛选（不限 / 女 / 男 / 未知） | 只让指定性别参与（带人数显示）；「未知」是"额外包含未知性别"开关 |
| ▶ 开始闪动 / ⏹ 停止闪动 | 开始 / 停止摇号 |
| 速度 | 120~1000 ms，数值越小跳得越快 |
| 游戏随机 | 左键：开启后头像位显示游戏名；右键：在直播界面显示 / 隐藏当前游戏的 TXT 正文 |
| 礼物价目 | 查看 / 修改礼物的钻数（用于记分换算） |
| 快捷键 | 全局快捷键，默认 F3 |
| 排名区间 起-止 名 | 只让第 N~M 名的观众参与闪动 |
| 用户头衔 → 计时 | 倒计时（分 / 秒），到点自动停止闪动 |
| 用户头衔 → 游戏+ | 选择一个装满 TXT 的文件夹，每个文件名就是一个游戏 |
| 头衔数量（数子 / 1 ~ 9） | 直播界面显示几个头像位 / 跳动位 |
8.2 游戏玩法（TXT 文件夹）操作步骤
- 点 游戏+ 选择游戏文件夹（日志会提示「已加载游戏目录…，共 N 个游戏」）
- 点 游戏随机（按钮变红，头衔自动切到「数子/0」，下方出现游戏名单）
- 名单中：勾选 = 参与跳动；左键点名字 = 预选中（红框，必中）
- 右键 游戏随机 按钮：在直播界面头像组下方显示 / 隐藏当前游戏的 TXT 正文
- 点 ▶ 开始闪动 摇号，⏹ 停止闪动 定格
直播界面里点一下头像可锁定该头像不参与闪动（锁定数 > 0 时「开始闪动」会变黄提示）；再点一次解锁。
8.3 视频播放
- 每条视频一个按钮：左键播放 / 暂停，右键关闭，可拖拽排序
- 每条可单独设置：名称、文件、快捷键、音量、循环
- 底层放映：视频压在背景之上、其它图层之下，当"动态背景"用
- 顶层放映：全屏浮在最上层
- 自定义窗体：视频变成可拖动 / 缩放的独立图层，窗体大小 30%~1000%
修改「底层放映 / 自定义窗体」后，正在播放的视频会自动重播一次以应用新层级，属正常现象。
8.4 音频与图片
- 音频：每条左键播放、右键停止，可设快捷键与音量；另有三种音效位：🔊 点击音效、🔇 停止音效、🖱️ 悬停音效
- 图片：素材库可添加文件夹 / 收起，图片按钮网格支持拖拽排序（顺序 = 直播界面图层上下层级），可「全部隐藏」
- 抠绿（v1.0.27 新增）：选中一个图片图层，第三行「底层显示」右侧的 抠绿 开关，打开后图片里的绿色部分变透明，下层头像 / 背景直接透上来；开启后下方多出 抠绿强度 滑杆（默认 50%，数值越大判定越宽松、抠得越狠）。只影响直播画面显示，不修改磁盘上的原图，开关与强度随图层保存，重启自动恢复
抠绿按「绿色通道比红蓝两色高出多少」判定，所以白色、黄色、肤色、浅灰不会被误伤，绿色衣服会一起透明（属正常现象）。边缘还残留一圈绿边 → 强度往右调；画面里的绿色物体也被抠掉了 → 强度往左调。素材是白底 / 蓝底的话抠绿去不掉，那属于「按背景色抠图」，不在本功能范围内。
8.5 快捷键设置
在对应行点 设置 → 按钮变为「按快捷键」→ 按下想用的组合键即可；点 清除 取消。若提示「无法注册快捷键，可能已被其他程序占用」，换一个组合键。
9在线观众窗口
| 控件 | 作用 |
|---|---|
| 模式按钮（在线观众 ⇄ 消费榜） | 切换榜单视角 |
| 人数按钮 | 左键：把直播界面的在线观众图层切到「在线排名 / 消费榜」；右键：显示 / 隐藏资料卡里的「现分」栏 |
| 状态文字 | 刷新、抓取结果提示（如「刷新中…」「已刷新 +N」） |
| ↻ | 立即刷新在线观众 |
| 操作 | 效果 |
|---|---|
| 左键点卡片 | 选中 / 取消选中（作为摇号 / 中奖目标同步到直播界面） |
| 右键卡片 | 打开该观众的抖音主页 |
| Ctrl + 右键卡片 | 排除 / 取消排除（黄色高亮） |
点 分 N 标签 | 打开记分面板（方向 加/减、1/5/10/20/50/100、手动输入、备注、确定记账） |
点性别标签 ♂ / ♀ / ? | 浮层选择「♂ 男」/「♀ 女」/「↺ 清除」，可手工修正性别 |
榜单数据是分页加载的：默认先取约 50 条，向下滚动继续追加，滚动到底会自动续抓。
若把直播界面的「在线观众 → 显示条数」调到 20 条以上，名单区域会自动按窗口可视高度收缩并转为可滚动，一路滑到最后一张（v1.0.24 起）。
名单只显示此刻仍在直播间的观众：观众离开后会被判定离场并按「离开效果」的设置退榜（默认淡出后移除），榜单条数与直播间实时在线人数对齐（v1.0.24 起）。
10直播界面窗口操作
| 操作 | 方法 |
|---|---|
| 移动图层 | 按住图层拖动 |
| 缩放图层 | 拖右下角缩放手柄 |
| 选中图层 | 单击图层，出现选中框 |
| 全局锁定 | 主控台标题栏最左的「锁定」按钮（金色 = 已锁） |
| 位置重置 | 界面页 → 位置重置（所有图层回到画面中心） |
| 资料卡 | 双击头像 或 右键头像（点等级图标也可以） |
| 锁定单个头像 | 在头像上"点一下不拖"，锁定后不参与闪动 |
| 榜单卡片资料卡 | 右键「在线观众」卡片 |
| 标题就地编辑 | 双击「在线观众 / 消费榜」标题条，Enter 保存 / Esc 取消 |
| 游戏 TXT 正文 | 右键头像组空白处（需「游戏随机」已开启），再次右键关闭 |
| 读文 | 选中读文图层出现控件；点目录里的 TXT 按钮打开「文本查看层」，正文可直接编辑并随布局保存 |
「直播界面」是透明窗口。若录屏软件抓不到画面，请改用「显示器采集」，或选择 Windows 10 (1903+) 的窗口捕获方式。
11快捷键
| 类型 | 位置 | 默认值 |
|---|---|---|
| 头像闪动（摇号） | 头像/视频页 · 快捷键行 | F3 |
| 视频播放 | 头像/视频页 · 每条视频 | 未设置（旧版单视频字段默认为 F4） |
| 音频播放 | 头像/视频页 · 每条音频 | 未设置 |
| 播放按钮 / 图片 | 头像/视频页 对应编辑器 | 未设置 |
- 快捷键是全局的：直播伴侣 / 游戏在前台时同样生效
- 支持 Ctrl / Alt / Shift 组合、F1~F24、小键盘等
- 冲突时提示「无法注册快捷键，可能已被其他程序占用」，换一个组合即可
12日志页
顶部显示「运行日志」与条数，分类按钮：全部 / 系统 / 观众 / 进场 / 弹幕 / 礼物 / 闪动 / 网络。
- 点「▶ 启动检测」时会自动清空上一轮日志，便于只看本次运行
- 排障时优先看 网络 与 系统 分类
常见故障的对照表、日志关键词与处理步骤，见随程序提供的《问题排查说明书》，或联系客服。
13对接自己的大屏（HTTP 接口）
程序内置本地 HTTP 数据服务（默认 http://localhost:10086，端口被占用会自动顺延并广播实际端口）。
| 接口 | 内容 |
|---|---|
/api/game-data | 汇总数据：观众、弹幕、进场、房间统计、资料、礼物 |
/api/audience | 在线观众快照（items / total） |
/api/chat | 弹幕消息（messages / total） |
/api/room-stats | 房间统计（在线人数、主播昵称等） |
/api/user-rich / /api/user-rich-session | 观众资料库 / 本次会话资料 |
/api/gifts | 礼物清单 |
/images/<category>/<file> | 本地已缓存的头像 / 等级 / 勋章等图片 |
/health | 健康检查 |
/api/status | 运行状态（是否采集中、房间号、端口） |
POST /api/command | {action:'start', roomId} / {action:'stop'} 远程启停采集 |
GET http://localhost:10086/api/audience
GET http://localhost:10086/api/room-stats
POST http://localhost:10086/api/command
{"action":"start","roomId":"546706120320"}
该服务带跨域头且未限制访问来源，请勿把端口直接暴露到公网；仅在本机 / 可信局域网内使用。
14常见问题
双击图标没反应？
多为已在后台运行（单实例），检查任务管理器里的 electron 进程；也可能是窗口跑到屏幕外，程序会尝试拉回主屏。详见《问题排查说明书》第 1 章。
采不到数据 / 观众列表一直是 0？
先在监控页点「采集窗：显示」，确认 Edge 里已登录抖音且直播间正常开播，再点「▶ 启动检测」。详见《问题排查说明书》第 2 章。
有数据但直播界面 / 榜单是空的？
检查「显示条数」是否 ≥1、图层是否被隐藏、是否切到了消费榜而积分为 0。「性别筛选」只影响头像闪动，不影响榜单。详见《问题排查说明书》第 3 章。
给观众标了性别后，在线观众名单就滑不动了？
这是 1.0.26 已修复的问题：旧版本在标注性别后会把整份名单重建，滚动位置被打断，表现为\"滑不动\"或自己跳回顶部。升级到 1.0.26 后标注性别只更新那一行，其余卡片和滚动位置都不动。另外 1.0.26 起名单的空白间隙也能用滚轮滚动，不再必须把鼠标压在卡片上。
头像和名字对不上 / 头像显示成裂图？
1.0.26 已修复：头像缓存现在会核对\"这张图是不是这个人的\"，下载改为整份落盘（不再有半截图被当成有效缓存），浏览器也不会再拿旧头像顶替新头像。昵称里带
%、#、? 等特殊符号的观众，头像同样能正常显示。升级后若个别旧图仍是错的，删掉 %APPDATA%\\douyin-monitor\\output\\images\\avatar\\ 重启即可重新拉取。详见《问题排查说明书》第 4 章。开了抠绿，绿色没抠干净 / 连绿色物体也被抠掉了？
都是抠绿强度的问题，位置在图片编辑器最后一行（只在开启抠绿后出现）。边缘残留一圈绿边 → 往右调高（60~75% 适合布面有褶皱、打光不匀的绿幕）；画面里的绿色物体也被抠掉了 → 往左调低（40~50% 适合纯色绿幕）。另外白色 / 蓝色背景不会被抠掉，那需要「按背景色抠图」，不属于抠绿。抠绿只在显示层计算，不满意随时关掉，原图不会损坏。
调了样式但画面没变化？
确认改的是同一个图层；「锁定」只影响能否拖动，样式改动仍会生效。
参数改好之后，重新打开又变回默认值？
这是 1.0.28 修掉的问题。旧版有两个原因：① 排名区间在每次启动时被程序强行改回「1」并存盘；② 更关键的是，图层属性面板的大部分样式在启动时没有从配置里读回来，面板显示的是代码里的默认值 —— 你只要随手动一下滑块，默认值就被下发给直播画面并存进配置，把原来的设置覆盖掉了。1.0.28 起，面板打开显示的就是当前真实生效的数值，改完重开会保持。
注意：如果之前反复重开过程序、又在面板里动过控件，那部分样式可能已经被覆盖过，需要重调一次；从 1.0.28 起才会稳定保留。
注意：如果之前反复重开过程序、又在面板里动过控件，那部分样式可能已经被覆盖过，需要重调一次；从 1.0.28 起才会稳定保留。
直播中鼠标一动画面就乱？
点标题栏「锁定」（变金色）固定所有图层。
更新要重新下载安装包吗？
不需要。界面部分走增量热更新：运行期间每小时自动复查，发现新界面会在总控台顶部弹出提示条，点「立即重启」即刻生效；主程序有新版本时会自动提示升级。
能同时监控多个直播间吗？
一套程序对应一个直播间。多房间请分开部署、各自授权。
视频黑屏 / 花屏 / 录屏软件抓不到画面？
先关「拦截视频流」复验；花屏多为显卡驱动或硬件加速问题；录屏软件改用显示器采集。详见《问题排查说明书》第 5 章。
15更新与维护
- 自动更新：启动后约 15 秒检查一次新版本，检测到即提示；可下载后自动重启安装（直播中会推迟到结束后）
- 界面热更新：只改界面时无需重装。程序运行期间每小时自动复查一次（启动 2 分钟后先查一次），发现新界面即自动下载校验，并在总控台顶部弹出橙色提示条，点「立即重启」马上生效；点「稍后」本次不再提示，同一版本不会反复打扰
- 布局备份：善用「导出布局」，换机 / 重装后可快速恢复
- 积分备份：用「导出积分 / 导入积分」迁移存分数据
- 客服：激活码购买、续期、解绑换机、安装答疑请通过「联系管理员」微信联系