一、入门准备

1.1 系统要求

项目要求
操作系统Windows 10 / 11（64 位）
网络可访问 https://douyin.dexuebao.com
浏览器Google Chrome（自动作业功能必需）
授权有效卡密或已绑定手机号的 SaaS 账号

1.2 安装客户端

  1. 在 官网首页 的「客户端下载」区域获取最新安装包，或由管理员提供。
  2. 解压或运行安装程序，启动 DouliveMagic.exe（窗口标题为「德学宝 - 抖音直播数据采集」）。
  3. 若启动时提示版本过低，请按提示下载更新包后覆盖安装。
  4. 确认客户端 API 地址为 https://douyin.dexuebao.com（一般无需修改）。
建议将客户端快捷方式固定到任务栏，并关闭 Windows 防火墙对该程序的误拦截。

二、登录与授权

2.1 卡密登录（推荐）

  1. 启动客户端，在登录界面输入管理员发放或在线购买后获得的卡密。
  2. 点击登录，系统会校验卡密是否有效、是否过期、是否被禁用。
  3. 登录成功后可在「授权信息」中查看到期时间与可采集房间数上限。

2.2 手机短信登录

  1. 在登录界面选择手机号登录（若客户端支持），或在 套餐中心 用手机号验证码登录。
  2. 首次手机号登录会自动创建/绑定卡密，与 Web 端账号体系一致。

2.3 续费与延期

访问 /saas/shop，登录后选择套餐并完成支付，系统会自动延长当前卡密有效期并可能提升房间数配额。

卡密泄露可能导致他人占用您的配额。请勿将卡密分享给无关人员；若怀疑泄露请联系管理员重置。

三、抖音账号绑定

采集与自动作业需要绑定至少一个抖音账号（Cookie 或扫码登录）。

  1. 进入客户端侧边栏「账户管理」。
  2. 点击添加账号，按提示在 Chrome 中完成抖音登录（推荐使用专用 Chrome 用户目录）。
  3. 为账号设置类型：采集（仅用于数据采集）或 作业（用于自动私信等）。
  4. 可启用/禁用单个账号；禁用后该账号不再参与任务。
多号限制：同一卡密下最多 3 个账号 同时执行自动作业。超出时请先停止部分任务或禁用账号。

后台管理员可在 管理后台 → Doulive业务 → 抖音账号 中查看各卡密绑定的账号列表（需管理员权限）。

四、雷达采集

功能：实时采集抖音直播间数据（弹幕、礼物、进场、关注、点赞、在线人数等）。

操作步骤

  1. 打开「雷达采集」或「直播间采集」页面。
  2. 在左侧输入框填入直播间号，每行一个，支持批量粘贴。
  3. 勾选需要采集的事件类型（进入、弹幕、礼物、关注、点赞等）。
  4. 点击「开始采集」，数据实时显示在下方表格中。
  5. 需要停止时点击「停止采集」。

高级技巧

  • 配合「必链厅号」可使指定房间优先连接。
  • 「黑名单」中的厅号会被自动跳过。
  • 隐私视频厅可被智能过滤（语音厅通常可正常采集，具体以客户端策略为准）。
  • 支持一键雷达、全局统计与采集报表导出 CSV。
合规提示：采集数据仅供授权范围内运营分析使用，严禁外传或违规用途，违者可能被封卡。

六、老板追踪

追踪指定高价值用户的送礼行为，适合维护大客户、及时跟进。

  1. 输入老板抖号或用户 ID，多个可用逗号或空格分隔，点击「添加老板」。
  2. 点击「开始追踪」启动实时监控。
  3. 追踪结果显示在右侧表格：时间、直播间、礼物、金额等。
  4. 双击「直播间」列可快速进入对应直播页。
  5. 使用「删除选中」「清空全部」管理老板列表。

七、神秘人追踪

针对匿名送礼或昵称含「神秘」「匿名」等特征的用户进行监控。

  1. 设置最低礼物价值阈值（默认 100，可按业务调整）。
  2. 点击「开始追踪」。
  3. 系统约每 5 秒轮询新数据并展示在列表中。
  4. 点击「清空」可清除当前会话内的展示数据。

八、自动作业

通过 Chrome WebDriver 自动执行私信、关注、点赞、评论等操作。

8.1 基础配置

  1. 在「策略配置」中设置私信发送间隔、线程数、每轮最多私信人数等。
  2. 填写私信文案，每行一条，系统随机选取；支持 {name} 替换对方昵称。
  3. 开启去重选项，避免对同一用户重复私信。

8.2 启动作业

  1. 确保已绑定「作业」类型抖音账号且 Chrome 可正常启动。
  2. 选择作业类型：私信主持、溜厅模式等（以客户端实际选项为准）。
  3. 点击「开始」，在运行日志区查看进度与错误信息。
  4. 出现异常时可点击「停止」安全结束。
自动作业涉及平台规则与风控，请合理设置频率，避免短时间大量操作导致账号限制。 多号同写上限为 3 个账号并发。

九、礼物 / 数据查询

  1. 进入「数据查询」或「礼物查询」页面。
  2. 输入抖号、昵称等关键词。
  3. 点击「查询」查看送礼明细与消费统计。
  4. 可按需导出报表（CSV）。

「来源详情」支持按关键词搜索弹幕记录，可开启自动刷新，并支持跳转用户主页。

十、排行榜

  1. 选择排行维度：礼物、进入、弹幕、直播间等。
  2. 设置时间范围，可按直播间筛选。
  3. 点击「查询」获取排行列表。

「贡献榜 Top1000」可查看指定直播间贡献排行，便于识别核心用户。

十二、关键词 / 风险监控

  1. 在关键词监控或策略中设置敏感词，每行一个。
  2. 保存后，采集到的弹幕若命中关键词将高亮或记录。
  3. 可配合悬浮窗实时提醒运营人员。
  4. 风险事件会写入后台「风险记录」，管理员可审计。

管理员可在 Web 后台「敏感词管理」维护全局词库（与卡密级配置并存时，以客户端实际逻辑为准）。

十三、收藏管理

  1. 在「我的收藏」中分男厅 / 女厅区域维护常用直播间列表。
  2. 每行一个厅号，点击「保存」同步到服务器。
  3. 下次登录自动加载，可快速导入到雷达列表。

十四、黑名单

  1. 输入不需要采集的直播间号，点击「添加」。
  2. 可填写备注说明原因。
  3. 选中条目后点击「删除」移除。
  4. 雷达采集时黑名单房间会被自动跳过。

十五、在线套餐购买（Web）

地址：https://douyin.dexuebao.com/saas/shop

  1. 输入手机号，点击「获取验证码」并完成短信验证登录。
  2. 或直接在「卡密登录」栏输入已有卡密。
  3. 登录后页面展示可购套餐：价格、天数、可采集房间数等。
  4. 点击「立即购买」创建订单并完成支付流程。
  5. 支付成功后卡密到期时间自动延长，客户端重新登录即可生效。

十六、Web 管理后台

管理员登录地址：https://douyin.dexuebao.com/admin

主要菜单（Doulive 业务）

菜单说明
业务概览卡密数、在线用户、采集概况等统计
卡密管理生成、延期、禁用卡密，批量开卡
套餐 / 订单管理配置 SaaS 套餐，查看支付订单
客户端通知向客户端推送公告
客户端版本配置最新版本号、下载地址、强制更新
敏感词管理全局敏感词维护
抖音数据直播间、礼物记录、用户档案、账号、黑名单
风险记录查看各卡密风险事件
普通运营用户一般只需使用客户端与套餐中心；后台账号由超级管理员分配。

十七、常见问题

Q：登录提示卡密无效或已过期？

请检查卡密是否输入正确、是否已在套餐中心续费。联系管理员在后台查询卡密状态。

Q：采集没有数据？

检查：① 直播间是否在开播；② 是否被加入黑名单；③ 房间数是否超过卡密配额；④ 网络是否能访问服务器；⑤ 抖音账号 Cookie 是否失效，尝试重新绑定。

Q：自动作业 Chrome 打不开？

确认已安装 Chrome，且客户端中 ChromeDriver 版本与 Chrome 主版本匹配。关闭占用 Chrome 的僵尸进程后重试。

Q：WebSocket 断开频繁？

检查本地网络与服务器状态。后端通过 Nginx 代理 WebSocket，长时间运行属正常现象，客户端一般会自动重连。

Q：如何联系技术支持？

通过购买渠道或管理员获取支持。部署与 API 文档可参考项目内部运维手册。