抖音私信自动发送
项目简介
一款基于抖音网页版私信自动发送脚本，适配 douyin.com/chat 私信页面，支持定时每日发送一言文案/表情、掉线登录监控、消息推送通知、本地可视化配置面板、运行日志、后端监控上报等全套能力，无需抓包、无需接口逆向，纯页面 DOM 模拟操作实现自动化私信。
开源说明：脚本仅用于个人学习、自动化日常问候，请勿批量骚扰他人账号，违规使用造成账号封禁由使用者自行承担责任。
核心功能
- 可视化配置面板
- 可添加多个目标好友（一行一个昵称）
- 两种发送模式：纯文字（一言API随机文案）/ 自动发送表情
- 自定义文字消息，留空自动调用 Hitokoto 一言接口
- 定时任务配置（北京时间 HH:mm，每日仅发送一次）
- 自定义后端监控服务地址
- 定时自动发送
- 跨天自动重置发送记录，保证每天到点仅执行一轮发送
- 同分钟防重复触发机制，误差±5秒内只运行一次
- 批量遍历好友，内置间隔延迟，模拟人工操作防风控
- 消息推送通知（PushPlus）
- 定时任务执行完成推送通知
- 账号掉线、需要扫码登录时推送二维码图片
- 多次未扫码推送告警，提醒及时登录避免任务中断
- 登录状态自动监控
- 每10分钟自动检测登录状态，掉线自动刷新页面
- 检测到账号安全验证弹窗，自动填充预设密码并点击确认
- 实时监控登录二维码变化，推送最新二维码至微信
- 监控面板（深色可视化）
- 定时运行状态、设置时间、今日是否已发送概览卡片
- 已配置目标好友标签展示
- 完整运行日志（发送成功/失败/定时触发/错误），最多保存100条
- 数据持久化
- 好友列表、定时时间、发送类型、监控地址使用油猴存储持久化
- 发送记录、运行日志存储在浏览器 LocalStorage
- 页面刷新自动恢复定时任务，无需重复开启
- 配套辅助能力
- 悬浮可拖拽按钮，随时打开配置/监控面板
- 一键手动立即发送，无需等待定时
- 定时启停开关，随时关闭自动任务
- 后端服务定时上报运行数据（10秒上报一次）
环境依赖
- 浏览器：Chrome / Edge / Firefox / 360 等支持油猴扩展的浏览器
- 扩展：Tampermonkey（油猴脚本管理器）
- 推送服务：PushPlus（免费微信推送，需自行获取 Token）
- 访问地址：仅适配抖音网页私信页面
https://www.douyin.com/chat*
安装&配置教程
1. 获取 PushPlus Token（消息推送必备）
打开 PushPlus 官网：https://www.pushplus.plus/
微信扫码登录，复制个人 Token
关键修改步骤
打开脚本代码，找到第21行常量：
const PUSHPLUS_TOKEN = '';
将引号内内容替换为你自己的 PushPlus Token，否则无法接收任务完成、掉线登录推送。
2. 油猴安装脚本
- 浏览器安装 Tampermonkey 扩展程序
- 新建脚本，清空默认模板代码
- 粘贴本项目完整 JS 源码
- 修改第20行 PushPlus Token（必填，否则推送失效）
- Ctrl+S / 文件-保存，脚本自动启用
3. 使用操作步骤
- 打开抖音网页版私信页：https://www.douyin.com/chat
- 页面右侧出现两个可拖拽悬浮按钮：
私信发送：打开配置面板，设置好友、定时、发送内容监控面板：查看运行状态、发送日志、定时信息
- 配置面板操作：
- 好友列表：每行填写一个抖音好友昵称，支持模糊匹配查找会话
- 发送类型：文字消息（一言文案）/ 表情
- 自定义消息：文字模式下填写则覆盖一言API内容，留空随机获取文案
- 定时发送：输入北京时间（如 08:30）
- 监控服务器：本地后端监控地址，无自建后端可默认不修改
- 保存好友：持久化配置到油猴存储
- 开始发送：立即手动执行一轮私信发送
- 开启定时：启动每日定点自动发送任务
- 关闭定时：停止自动定时任务
推送触发场景说明（PushPlus）
修改第20行 Token 后即可接收以下微信推送：
- ✅ 定时任务执行完毕：提示今日消息发送完成
- ⚠️ 账号掉线告警：检测到登录弹窗，推送登录提醒
- 📷 二维码更新推送：登录二维码刷新时推送图片，直接微信扫码
- 🚨 登录超时警告：多次推送二维码仍未扫码，提醒登录防止任务失效
脚本常量与自定义参数说明
| 常量 |
作用 |
修改位置 |
PUSHPLUS_TOKEN |
微信推送密钥，必须修改 |
代码第21行 |
REFRESH_INTERVAL |
登录状态检测间隔（毫秒） |
代码23行，默认10分钟 |
MONITOR_REPORT_INTERVAL |
后端数据上报间隔 |
代码24行，默认10秒 |
sendDelay |
单条消息输入延迟 |
CONFIG配置，默认2000ms |
intervalDelay |
多个好友发送间隔 |
CONFIG配置，默认4000ms |
MAX_QR_REFRESH |
最大二维码推送次数 |
代码417行，默认10次 |
日志存储规则
- 日志存储在浏览器 LocalStorage，最多保留100条记录，超出自动删除最早记录
- 日志类型：
send_success：消息发送成功send_fail：消息发送失败（未找到好友/输入框加载失败）schedule_trigger：定时任务触发记录error：运行异常（登录失效等）
- 通过「监控面板」实时查看格式化日志，支持手动刷新数据
注意事项 & 风控提醒
- 账号安全
- 脚本模拟人工点击、自带随机延迟，请勿设置极低间隔批量发送大量好友
- 短时间高频私信易触发抖音风控，导致私信限制、账号封禁
- 建议每日仅设置1次定时，好友数量控制在10人以内
- 推送相关
- PushPlus 免费版有每日推送次数限制，高频掉线会消耗推送额度
- 第21行 Token 不修改则所有推送功能完全失效
- 页面限制
- 脚本仅作用于抖音
/chat 私信页面，首页、视频页不会加载按钮
- 抖音前端更新 DOM 类名后，选择器可能失效，需同步更新脚本内 selector 配置
- 浏览器限制
- 清除浏览器缓存/LocalStorage 会清空发送日志，定时配置保存在油猴存储不受影响
开源声明
- 本项目仅用于编程学习、前端自动化技术研究，禁止商用、批量营销、骚扰他人。
- 脚本完全开源免费，可自由修改、二次分发，但禁止去除原作者注释、倒卖脚本获利。
- 因违规使用本脚本产生的抖音账号处罚、法律纠纷，作者不承担任何连带责任。
- Hitokoto 一言API、PushPlus 推送服务均为第三方公共服务，稳定性受第三方平台影响。
常见问题 FAQ
Q1：收不到微信推送？
A：1. 确认第21行 PUSHPLUS_TOKEN 替换为你自己的密钥；
2. PushPlus 微信公众号已绑定账号；
3. 检查当日推送次数未超限。
Q2：找不到好友、发送失败？
A：1. 好友昵称填写错误，脚本为模糊匹配，尽量使用完整昵称；
2. 抖音会话列表未加载完成，脚本内置等待延时，等待几秒重试；
3. 抖音更新页面DOM，需更新脚本内选择器。
Q3：定时到点不发送？
A：1. 监控面板查看定时状态是否为「运行中」；
2. 当天已完成发送会自动跳过，跨天才会重置；
3. 浏览器页面不能关闭/休眠，页面关闭定时循环会失效。
Q4：页面刷新后定时任务消失？
A：脚本会在页面加载时自动读取本地存储恢复定时，若未自动启动，重新在配置面板点击「开启定时」即可。
Q5：检测到登录弹窗不推送二维码？
A：检查第21行 Token 是否正确，网络是否可访问 PushPlus 接口，浏览器不要拦截 GM_xmlhttpRequest 跨域请求。
