📝 AI 文档声明:本文档由 AI 辅助生成和优化,内容基于项目源码与功能设计整理。虽然经过人工校对,但仍可能存在细节偏差或版本不同步的情况。如发现任何错误或过时信息,欢迎通过 GitHub Issues 提交反馈,我们会及时修正。
🚀 一款专为抖音设计的自动化续火脚本,支持多用户批量发送、一言API、专属文案、随机时间、智能重试,配合后端调度器实现 7×24 小时无人值守。
📌 快速导航:星火云 · 抖音续火云端自动化平台 · 1.5元/月 · 功能特性 · 界面预览 · 油猴脚本安装与使用 · 调度器管理器安装与使用 · 完整协同部署流程 · 挂机方案 · 配置说明 · 更新日志 · 故障排除 · 贡献指南
⚠️ v2026.10.02 起:本项目将 Chat 页面(
https://www.douyin.com/chat*)与 Creator 创作者平台(creator.douyin.com/...)拆分维护,本版本仅包含 Chat 页面相关逻辑,Creator 页面版本将在后续独立发布。当前请使用 Chat 页面运行脚本。
| 模块 | 功能 | 说明 |
|---|---|---|
| 🔥 火花天数 | [天数] 占位符 |
自动记录每位好友的火花持续天数,两种获取模式可选 |
| 💫 专属一言 | [专属一言] 占位符 |
按周一~周日配置专属文案,支持随机/顺序发送,防重复 |
| 🎲 随机时间 | 跨天时间范围 | 在指定区间内每日随机选取发送时间,避免固定模式 |
| 👥 多用户批量 | 可视化选择 | 自动解析聊天列表,支持全选/去重/滚动加载 |
| 🔄 智能重试 | 自动重置 | 10 分钟自动重试 + 定时重置,重试计数持久化 |
| 🎯 用户查找 | Chat 页面搜索 | 在搜索框中输入用户名 → 点击「聊天」按钮 → 进入会话 |
| 📋 结构化日志 | 多维筛选 | 级别/分类/日期/关键词筛选,按天分片存储,批量写入 |
| ⏸️ 暂停/继续 | 状态持久化 | 随时暂停或恢复,页面刷新后保留状态 |
| 🔗 调度器回调 | HTTP 通知 | 任务完成自动通知后端,支持多账号无人值守 |
| 👁️ 消息预览 | 只渲染不发送 | 调用 API 后展示最终消息内容,方便调试模板 |
| 📖 内置帮助 | 搜索 + 高亮 | 完整功能说明,支持关键词搜索,跳转后自动高亮定位 |
{hitokoto} / {from} / {from_who} 变量[API] / [TXTAPI] / [天数] / [专属一言] 占位符,支持多行logs:YYYY-MM-DD,只加载当前日期nextSendTime 计算下一次唤醒,而非 1 秒轮询| 控制面板 | 设置界面 |
|---|---|
![]() |
![]() |
| 用户选择面板 | 历史日志(带筛选) |
|---|---|
![]() |
![]() |
| 火花天数管理 | 使用帮助(带搜索) |
|---|---|
![]() |
![]() |
graph TD
A[打开 Chat 页面] --> B[脚本自动加载]
B --> C[显示控制面板]
C --> D[点击用户选择按钮]
D --> E[滚动解析聊天列表]
E --> F[显示用户选择面板]
F --> G[勾选目标用户]
G --> H{点击更新目标用户?}
H -->|是| I[保存用户列表]
H -->|否| J[取消操作]
I --> K{用户列表是否为空?}
K -->|是| L[自动关闭目标用户查找]
K -->|否| M[自动开启目标用户查找]
M --> N[获取下一个目标用户]
N --> O[搜索框输入用户名]
O --> P[点击聊天按钮]
P --> Q[等待聊天界面加载]
Q --> R[查找聊天输入框]
R --> S[准备消息内容<br/>包含天数/专属一言等占位符]
S --> T[发送续火消息]
T --> U[标记用户为已发送]
U --> V[更新火花天数记录]
V --> W{还有未发送用户?}
W -->|是| N
W -->|否| X[全部发送完成]
X --> Y[显示成功通知]
L --> Z[显示提示信息]
本章节涵盖油猴脚本从零开始的完整安装与使用流程,包括浏览器、脚本管理器等所有依赖的安装。
推荐使用以下任一浏览器以保证最佳兼容性:
| 浏览器 | 推荐指数 | 说明 | 下载地址 |
|---|---|---|---|
| 百分浏览器 | ⭐⭐⭐ | 挂机首选,内存占用低,内置 Chromium 内核 | 官网下载 |
| Chrome | ⭐⭐⭐ | 官方 Chromium 内核,兼容性最好 | 官网下载 |
| Edge | ⭐⭐ | Windows 自带,无需额外安装 | 官网下载 |
| Firefox | ⭐⭐ | 支持 ESR 长期支持版,隐私性好 | 官网下载 |
💡 挂机建议:如果需要长时间 7×24 挂机,强烈推荐百分浏览器,内存占用显著低于 Chrome。
脚本管理器是运行油猴脚本的前提条件,任选其一安装即可:
ScriptCat 对定时任务和多标签管理支持更好,适合挂机场景。
| 浏览器 | 安装方式 |
|---|---|
| Chrome | Chrome 商店安装 |
| Edge | Edge 商店安装 |
| Firefox | Firefox 商店安装 |
📖 详细安装文档可参考 ScriptCat 官方安装指南
全球最流行的脚本管理器,生态最完善。
| 浏览器 | 安装方式 |
|---|---|
| Chrome | Chrome 商店安装 |
| Edge | Edge 商店安装 |
| Firefox | Firefox 商店安装 |
⚠️ 验证安装:安装完成后,点击浏览器工具栏应出现脚本管理器图标(ScriptCat 为猫爪图标,Tampermonkey 为黑色方块图标)。
点击上方按钮,脚本管理器会自动识别并弹出安装确认页,确认脚本权限后点击「安装」即可。
适用于无法访问脚本仓库或一键安装失败的情况:
scriptcat-douyin-fire-helper.user.js 文件.user.js 文件,将全部内容复制粘贴到编辑器中Ctrl + S(Mac 为 Cmd + S)保存在脚本管理器中点击「+」或「添加新脚本」,在编辑器上方的 URL 输入框中粘贴以下链接并回车:
https://raw.githubusercontent.com/dr-190/ScriptCat-Douyin-Fire-Helper/main/scriptcat-douyin-fire-helper.user.js
⚠️ v2026.10.02 起仅支持 Chat 页面。
F12 打开开发者工具查看控制台是否有报错00:01:00)或开启随机时间模式| 占位符 | 作用 | 示例 |
|---|---|---|
[天数] |
自动替换为当前火花天数 | 第[天数]天 → 第15天 |
[专属一言] |
自动替换为当天星期对应文案 | 见下方配置 |
[API] |
自动获取一言 API 句子 | 随机优美句子 |
[TXTAPI] |
从自定义文本/API 随机获取 | 自定义文案 |
📝 模板示例:
第[天数]天,[专属一言][API]→ 实际发送:第15天,周一快乐今天天气真不错樱花飘落的季节总是让人心生欢喜
点击「📅 天数管理」按钮,可以:
点击「📖 使用帮助」按钮,打开帮助面板:
为避免浏览器后台休眠导致脚本停止,必须配置以下设置(以 Chrome/百分浏览器为例):
chrome://settings/performancewww.douyin.comEdge 浏览器:设置 → 系统和性能 → 「从不进入睡眠状态的这些站点」中添加 www.douyin.com。
Firefox 浏览器:安装 Auto Tab Discard 扩展,将 www.douyin.com 加入白名单。
F12 打开控制台查看是否有红色报错www.douyin.com/chat[天数],不能是全角 [天数][API] 需开启一言 API)HH:mm:ss(如 23:00:00)本章节涵盖后端调度器和图形化综合管理器从零开始的完整安装与使用流程,实现多账号 7×24 小时无人值守。
┌──────────────────────────────────────────────────────┐
│ 调度器管理器 │
│ ┌─────────────────┐ ┌──────────────────────────┐ │
│ │ 综合管理器 (GUI) │ │ 后端调度器 │ │
│ │ Windows 专用 │───▶│ 跨平台命令行 │ │
│ │ 可视化操作 │ │ 顺序执行多账号 │ │
│ └─────────────────┘ └──────────┬───────────────┘ │
│ │ │
│ ┌──────────▼───────────────┐ │
│ │ Python 回调服务器 │ │
│ │ 接收脚本完成通知 │ │
│ │ 端口: 7788 │ │
│ └──────────┬───────────────┘ │
└────────────────────────────────────┼──────────────────┘
│ HTTP POST
▼
┌──────────────────────────────────────────────────────┐
│ 浏览器实例(独立 Profile,互不干扰) │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 账号 A │ │ 账号 B │ │ 账号 C │ ... │
│ │ 油猴脚本 │ │ 油猴脚本 │ │ 油猴脚本 │ │
│ └──────────┘ └──────────┘ └──────────┘ │
└──────────────────────────────────────────────────────┘
回调服务器依赖 Python 3 运行环境。
Windows:
python --version,应显示 Python 3.x.xLinux (Ubuntu/Debian):
sudo apt update && sudo apt install -y python3 python3-pip
python3 --version
Linux (CentOS/RHEL):
sudo yum install -y python3 python3-pip
python3 --version
macOS:
brew install python
python3 --version
⚠️ 版本要求:Python 3.7 及以上版本。低于此版本可能导致部分语法不兼容。
Ubuntu/Debian:
sudo apt install -y jq
CentOS/RHEL:
sudo yum install -y jq
macOS:
brew install jq
Windows:Windows 调度器使用 PowerShell 原生 ConvertFrom-Json,无需安装 jq。
| 命令 | Windows | Linux/macOS | 预期输出 |
|---|---|---|---|
python --version 或 python3 --version |
✅ | ✅ | Python 3.x.x |
jq --version |
— | ✅ | jq-1.x |
powershell -Version(仅 Windows) |
✅ | — | PowerShell 版本号 |
⚠️ 重要:配套工具不单独发布到 Releases,直接放在 GitHub 仓库根目录。不要在 Releases 页面找。
下载方式一:GitHub 直链(推荐海外用户)
https://github.com/dr-190/ScriptCat-Douyin-Fire-Helper/raw/refs/heads/main/配套工具.zip
下载方式二:国内加速(推荐国内用户)
https://gh-proxy.org/https://github.com/dr-190/ScriptCat-Douyin-Fire-Helper/raw/refs/heads/main/配套工具.zip
💡 也可在脚本的「📖 使用帮助 → ⚡ 调度器」中,点击对应下载按钮直接下载。
解压到任意目录(路径中不要包含中文或空格,例如 D:\DouyinFire\)。
解压后的目录结构:
配套工具/
├── shell/ # 调度器核心文件
│ ├── callback_server.py
│ ├── scheduler.ps1
│ ├── scheduler.sh
│ ├── config.json
│ └── logs/
├── profiles/ # 浏览器 Profile 存放目录(自动生成)
├── manager_history.log
└── 抖音续火综合管理器.pyw
💡 关于
profiles/目录:存放每个抖音账号的独立浏览器配置(Cookie、登录态等),首次运行时自动创建。位于配套工具/profiles/,而非shell/子目录下。
编辑 配套工具/shell/config.json:
{
"send_time": "00:01:00",
"callback_port": 7788,
"default_browser": "centbrowser",
"browser_paths": {
"centbrowser": "",
"chrome": "",
"firefox": "",
"firefox-esr": "",
"edge": ""
},
"target_url": "chat",
"accounts": [
{
"name": "账号1",
"profile": "account1",
"send_time": "00:01:00",
"browser": ""
},
{
"name": "账号2",
"profile": "account2",
"send_time": "00:05:00"
}
]
}
⚠️ v2026.10.02 起:
target_url只支持chat(www.douyin.com/chat),不再支持creator。
| 配置项 | 必填 | 说明 |
|---|---|---|
callback_port |
✅ | 回调监听端口,默认 7788,必须与油猴脚本设置中的端口一致 |
default_browser |
✅ | 浏览器类型,挂机推荐 centbrowser |
browser_paths |
❌ | 各浏览器路径,留空自动检测 |
target_url |
✅ | 固定为 chat |
accounts |
✅ | 至少配置一个账号 |
accounts[].profile |
✅ | Profile 目录名,每个账号必须不同 |
accounts[].send_time |
❌ | 可为每个账号设置不同的发送时间 |
| 浏览器 | Windows 检测路径 | Linux 检测路径 | macOS 检测路径 |
|---|---|---|---|
| centbrowser | %LOCALAPPDATA%\CentBrowser\Application\centbrowser.exe |
— | — |
| chrome | %PROGRAMFILES%\Google\Chrome\Application\chrome.exe |
/usr/bin/google-chrome |
/Applications/Google Chrome.app/Contents/MacOS/Google Chrome |
| firefox | %PROGRAMFILES%\Mozilla Firefox\firefox.exe |
/usr/bin/firefox |
/Applications/Firefox.app/Contents/MacOS/firefox |
| edge | %PROGRAMFILES(x86)%\Microsoft\Edge\Application\msedge.exe |
/usr/bin/microsoft-edge |
/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge |
⚠️ 如果浏览器安装在非默认位置(如 D 盘),必须在
browser_paths中手动填写完整路径。
所有 Profile 统一存放在 配套工具/profiles/ 目录下,每个账号一个子文件夹:
配套工具/profiles/
├── account1/
├── account2/
└── account3/
详见下方「第五步」。
在 配套工具/profiles/ 目录下,为每个账号创建一个子文件夹(如 account1)
使用对应浏览器以指定 Profile 启动并登录抖音:
Windows (PowerShell):
& "C:\Path\To\centbrowser.exe" --user-data-dir="D:\Tools\抖音续火\配套工具\profiles\account1" "https://www.douyin.com/chat"
Linux/macOS (Terminal):
google-chrome --user-data-dir="/path/to/配套工具/profiles/account1" "https://www.douyin.com/chat"
在打开的浏览器中登录对应的抖音账号
确认登录成功后关闭浏览器
双击运行 抖音续火综合管理器.pyw。
shell/scheduler.ps1,在下方日志区域实时显示运行状态点击「停止调度器」按钮,当前正在执行的任务会等待当前账号完成(或超时)后停止。
cd "D:\Tools\抖音续火\配套工具\shell"
.\scheduler.ps1
.\scheduler.ps1 -Mode once
⚠️ 如果遇到执行策略限制,先运行:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
cd /path/to/配套工具/shell
chmod +x scheduler.sh
./scheduler.sh
./scheduler.sh once
Linux(使用 nohup):
nohup ./scheduler.sh > /dev/null 2>&1 &
ps aux | grep scheduler
kill <PID>
Linux(使用 systemd 服务):
sudo tee /etc/systemd/system/douyin-fire.service << 'EOF'
[Unit]
Description=Douyin Fire Helper Scheduler
After=network.target
[Service]
Type=simple
User=你的用户名
WorkingDirectory=/path/to/配套工具/shell
ExecStart=/path/to/配套工具/shell/scheduler.sh
Restart=always
RestartSec=60
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable douyin-fire
sudo systemctl start douyin-fire
sudo systemctl status douyin-fire
journalctl -u douyin-fire -f
macOS(使用 launchd):
cat > ~/Library/LaunchAgents/com.douyin.fire.helper.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.douyin.fire.helper</string>
<key>ProgramArguments</key>
<array>
<string>/path/to/配套工具/shell/scheduler.sh</string>
</array>
<key>WorkingDirectory</key>
<string>/path/to/配套工具/shell</string>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
<key>StandardOutPath</key>
<string>/path/to/配套工具/shell/logs/launchd.log</string>
<key>StandardErrorPath</key>
<string>/path/to/配套工具/shell/logs/launchd.err</string>
</dict>
</plist>
EOF
launchctl load ~/Library/LaunchAgents/com.douyin.fire.helper.plist
launchctl list | grep douyin
launchctl unload ~/Library/LaunchAgents/com.douyin.fire.helper.plist
config.json 中的 callback_port 一致(默认 7788)💡 此配置只需在每个 Profile 的浏览器中设置一次,之后会持久化保存。
以管理员身份打开 PowerShell:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
sudo apt install jq # Ubuntu/Debian
sudo yum install jq # CentOS/RHEL
brew install jq # macOS
sudo ln -s /usr/bin/python3 /usr/bin/python
或直接修改 scheduler.sh 中的 python3 为 python。
config.json 中 browser_paths 路径是否正确\\ 或 /)--no-sandbox 权限问题配套工具/profiles/ 中对应账号的 Profile 文件夹已保存登录状态config.json 中 profile 字段与目录名是否完全一致http://localhost:7788callback_port 与油猴脚本设置中的端口是否一致Windows:
netstat -ano | findstr :7788
taskkill /PID <进程ID> /F
Linux/macOS:
lsof -i :7788
kill -9 <PID>
或修改 config.json 和油猴脚本中的端口为其他值。
python "抖音续火综合管理器.pyw" 查看报错tcl/tk and IDLEsudo apt install python3-tkbrew install python-tkshell/logs/ 下的日志文件sudo apt install xvfb
xvfb-run ./scheduler.sh
安装浏览器 → 安装脚本管理器 → 安装油猴脚本 → 打开 Chat 页面 → 选择用户 → 配置模板 → 设置定时 → 保持浏览器活跃 ✅
1. 环境准备
├── 安装浏览器
├── 安装脚本管理器
├── 安装 Python 3
└── 安装 jq(Linux/macOS)
2. 油猴脚本部署
├── 安装抖音续火脚本
└── 打开 Chat 页面验证脚本生效
3. 调度器部署
├── 从仓库根目录下载 配套工具.zip 并解压
│ · GitHub 直链:https://github.com/dr-190/ScriptCat-Douyin-Fire-Helper/raw/refs/heads/main/配套工具.zip
│ · 国内加速:https://gh-proxy.org/https://github.com/dr-190/ScriptCat-Douyin-Fire-Helper/raw/refs/heads/main/配套工具.zip
├── 编辑 shell/config.json 配置账号列表(target_url 固定为 chat)
├── 在 配套工具/profiles/ 下为每个账号创建独立 Profile
├── 在每个 Profile 的浏览器中登录对应抖音账号
└── 在每个 Profile 中启用油猴脚本的「后端调度器回调」
4. 启动运行
├── Windows: 启动综合管理器 → 点击「启动调度器」
└── Linux/macOS: 终端运行 ./scheduler.sh
5. 验证
├── 查看调度器日志,确认第一个账号浏览器已启动
├── 确认油猴脚本控制面板正常显示
├── 等待脚本执行完成,确认回调成功
└── 确认调度器自动关闭第一个浏览器并启动第二个 ✅
| 平台 | 配置 | 价格 | 特点 |
|---|---|---|---|
| ⭐ 星火云平台(推荐) | 无需本地设备 | 1.5 元/月 | 真正的 SaaS 云端,无需下载软件 |
| 阿里云轻量服务器 | 1 核 1G / 20GB | ≈24 元/月 | 稳定可靠 |
| 腾讯云轻量服务器 | 1 核 1G / 25GB | ≈25 元/月 | 网络优化 |
| 专业挂机宝 | 基础配置 | ≈10-20 元/月 | 专为挂机优化 |
🔗 购买地址:https://dyxh.503555.xyz
核心特性
shell:startup 放入调度器快捷方式⚠️ 下表为 v2026.10.02 配置项,已移除 Creator 页面相关。
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 初始天数 | 1 | 火花初始天数 |
| 天数占位符 | [天数] |
模板中自动替换为当前天数 |
| 增加逻辑 | 自动 | 每天首次发送成功 +1(关闭自动获取时) |
| 自动获取 | 开启 | 从抖音页面实时读取并覆盖本地 |
| 手动调整 | 支持 | 「📅 天数管理」面板可单独修改 |
| 配置项 | 说明 |
|---|---|
| 启用专属一言 | 开启/关闭功能 |
| 星期文案配置 | 周一~周日分别设置文案 |
| 发送模式 | 随机 / 顺序 |
| 专属占位符 | [专属一言] 自动替换为当天文案 |
| 防重复机制 | 每日记录已发送文案,避免重复 |
| 配置项 | 格式 | 说明 |
|---|---|---|
| 启用随机时间 | 开关 | 开启/关闭随机时间模式 |
| 开始时间 | HH:mm:ss |
随机时间起始 |
| 结束时间 | HH:mm:ss |
随机时间结束,可小于开始时间(跨天) |
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 自动重试间隔 | 10 分钟 | 达到最大重试后自动重置的间隔 |
| 启用自动重试 | 开启 | 达到最大重试后自动重置 |
| 定时重置间隔 | 10 分钟 | 定时重置重试计数 |
| 重置重试按钮 | — | 控制面板手动重置按钮 |
| 重试状态持久化 | 开启 | 避免意外重置为 0 |
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 发送时间 | 00:01:00 |
每日发送时间(HH:mm:ss) |
| 重试次数 | 3 次 | 发送失败最大重试次数(1-10) |
| 聊天框重试限制 | 5 次 | 查找聊天输入框最大重试次数 |
| 初始加载延迟 | 30 秒 | 页面加载后延迟启动自动检测 |
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 启用一言 API | 开启 | 使用一言 API 获取优美句子 |
| API 超时 | 60000 ms | 请求超时时间 |
| 消息格式 | 自定义 | 支持 {hitokoto} / {from} / {from_who} |
| 配置项 | 说明 |
|---|---|
| 启用 TXTAPI | 开启/关闭功能 |
| 模式选择 | API 模式(从 URL 获取)/ 手动模式(自定义文本) |
| 随机发送 | 手动模式下是否随机选择 |
| 文本内容 | 每行一个文本,支持换行 |
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 实时面板显示条数 | 8 | 控制面板下方实时日志区显示条数 |
| 历史面板默认显示条数 | 100 | 打开日志面板时默认展示条数 |
| 每日日志上限 | 500 | 每天日志最多保留条数,超出自动轮转 |
| 日志保留天数 | 7 | 超期的日志分片自动删除 |
| 日志筛选 | — | 支持按级别/分类/日期/关键词/条数筛选 |
| 导出格式 | .txt + .json |
支持"当前筛选"和"全部"两种导出 |
[API] / [TXTAPI] / [天数] / [专属一言]第[天数]天,[专属一言][API]| 配置项 | 默认值 | 说明 |
|---|---|---|
| Chat 页面换行替换符 | | |
Chat 页面不支持换行,自动替换 |
| 配置项 | 默认值 | 说明 |
|---|---|---|
default_browser |
centbrowser |
默认浏览器 |
browser_paths |
空字符串 | 自定义各浏览器路径 |
target_url |
chat |
固定为 chat |
用户界面层
├── 控制面板 (状态显示、实时日志、9 个功能按钮)
├── 设置面板 (schema 驱动渲染)
├── 用户选择面板 (可视化用户选择,滚动加载)
├── 火花天数管理面板 (批量查看、修改、扫描)
├── 历史日志面板 (多维筛选、分页、导出)
├── 消息预览面板 (调用 API 后展示内容)
└── 使用帮助面板 (6 大分节 + 搜索 + 高亮定位)
↓
业务逻辑层
├── 定时调度模块 (精确 nextSendTime 计算)
├── 用户管理模块 (多用户批量处理)
├── 消息生成模块 (API集成、模板渲染)
├── 状态管理模块 (火花天数、发送记录)
├── 重试管理模块 (自动重试、定时重置)
├── 错误边界模块 (流程异常捕获和恢复)
└── 日志系统 (批写、分片、筛选)
↓
数据访问层
├── 本地存储 (GM_setValue/GM_getValue)
├── 分片日志 (logs:YYYY-MM-DD)
├── 用户火花天数 (userFireDays)
├── API接口 (一言API、自定义API)
└── DOM操作 (选择器表 + fallback)
↓
抖音网页 API
├── 用户查找 (搜索框输入 → 点击聊天)
├── 消息发送 (整段插入 + Enter)
└── 状态读取 (火花天数)
外部工具(调度器 & 管理器)
├── 后端调度器 (多账号顺序执行、超时重试)
├── 综合管理器 v1.0 (图形化配置、一键控制)
└── HTTP回调接口 (脚本与调度器通信)
http://localhost:7788/doneScriptCat-Douyin-Fire-Helper/
├── scriptcat-douyin-fire-helper.user.js # 主脚本文件 (v2026.10.02)
├── README.md
├── LICENSE
├── CHANGELOG.md
├── 配套工具.zip # ★ 配套工具(含调度器)
├── images/
│ ├── screenshot-panel.png
│ ├── screenshot-settings.png
│ ├── screenshot-user-select.png
│ ├── screenshot-logs.png
│ ├── screenshot-fire-days.png
│ └── screenshot-help.png
💡 关于配套工具:不单独发布到 Releases,直接以
配套工具.zip形式放在仓库根目录。下载后解压使用。
完整历史版本请查看 Releases
🗑️ 移除功能
@match https://creator.douyin.com/creator-micro/data/following/chatgetPageType() 的 creator 分支interceptUserDetailApi / processUserApiResponse / detectAndUpdateRenamedUserschatObserver / initChatObserver / stopChatObserver 整套 DOM 观察器ensureAllTabActive("全部"标签页切换)scrollToFindAndClickUser 虚拟列表滚动查找sendAndVerifytestSendinsertText 一次性插入🐛 问题修复
_logFlushBuffer 拼写错误(导致面板无法加载)searchAttemptCount 超限后不清零导致反复刷"观察器不存在"日志setInterval(autoSendIfNeeded, 1000) 空转[data-e2e="conversation-item"] 精准锚定✨ 新增/重做
ts / level / cat / user / msg / ctxlogs:YYYY-MM-DDmaxLiveLogs / maxViewLogs / maxHistoryLogs / logRetentionDays.txt + .json 双格式导出ctx 诊断上下文{name: {days, lastDate}}SELECTORS 每键多候选,queryFirst / queryAllFirst 自动降级STATE / LEVEL / CAT 替代裸字符串SETTINGS_SCHEMAinjectStyles()min(1000px, 95vw)⚡ 性能优化
✨ 新增功能
https://www.douyin.com/chat*,专用搜索、换行输入(Shift+Enter)、自动读取火花天数failedUsersToday 数组|🐛 问题修复
⚡ 性能优化
[天数] 占位符,每日自动 +1| 版本 | 核心亮点 |
|---|---|
| v2.3.1 | 多用户时间重置修复,日期检查机制完善 |
| v2.3 | 倒计时状态修复,重试策略完善,「发送中」状态显示 |
| v2.2 | 抖音风格深色主题 UI,面板可拖动 |
| v2.1 | 多用户批量发送,顺序/随机模式,进度可视化 |
| v2.0 | 目标用户自动查找,防抖节流,完整日志系统 |
| v1.0 | 基础定时发送,一言 API 与 TXTAPI 支持 |
💡 升级建议:强烈推荐升级到 v2026.10.02。相比 v2026.07.13,本次更新大幅简化了代码结构(移除 Creator 页面支持)、重做了日志系统、修复了性能问题、新增火花天数管理面板和帮助搜索功能。
油猴脚本和调度器的专属常见问题已在各自教程章节中覆盖,以下为其他通用问题。
| ?这是正常行为,Chat 页面不支持换行。可在设置中修改「Chat 页面换行替换符」自定义分隔符。
v2026.07.13 已修复此问题(改用 InputEvent 替代 KeyboardEvent)。
v2026.10.02 已修复此问题:
如果仍出现异常,请点击「📅 天数管理 → 🗑️ 清空全部」后重新扫描。
lastFireDate 记录是否正确v2026.07.13 已修复此问题。检查失败用户名是否正确、是否在好友列表中,并查看日志了解具体失败原因。
这是正常行为,当用户列表为空时自动关闭。添加目标用户后功能会自动开启。
升级到 v2026.03.22 及以上版本已修复此问题。检查是否启用了自动重试功能。
升级到 v2026.03.22 及以上版本已修复此问题。检查脚本是否处于处理状态,查看日志了解自动发送触发情况,尝试手动点击「🚀 立即发送」测试。
在日志面板中,将「级别」筛选设置为 error,然后点击「导出当前筛选」。
在「偏好设置 → 高级设置 → 日志设置」中调整:
| 场景 | 建议配置 |
|---|---|
| 多用户模式(>20 人) | 使用顺序发送模式 |
| 网络环境差/页面卡顿 | 用户查找超时 20000ms+ |
| 随机时间范围 | 建议 2-6 小时,避免过于集中 |
| 长期 24 小时运行 | 实时日志条数 5,每日日志上限 200 |
| 网络慢 | 页面等待时间 8000-10000ms |
| 重试间隔 | 10-30 分钟 |
| 初始加载延迟 | 页面加载慢时 60-90 秒 |
我们欢迎各种形式的贡献!
git checkout -b feature/AmazingFeaturegit commit -m 'Add some AmazingFeature'git push origin feature/AmazingFeature本项目采用 MIT 协议 - 查看 LICENSE 文件了解详情。
| 权限 | 限制 |
|---|---|
| ✅ 商业使用 | ❌ 无担保责任 |
| ✅ 修改源代码 | ❌ 必须保留版权声明 |
| ✅ 分发原版或修改版 | ❌ 不得使用原作者名义背书 |
| ✅ 私人使用 |
| 风险类型 | 说明 |
|---|---|
| 账号风险 | 过度使用可能导致账号功能受限 |
| 隐私风险 | 确保不在公共设备上保存敏感配置 |
| 法律风险 | 遵守当地法律法规和平台用户协议 |
| 技术风险 | 脚本可能因平台更新而失效,需及时更新 |
重要声明:本脚本由 AI 辅助开发完成,结合了人工测试和优化。
感谢以下项目和服务的支持:
| 渠道 | 链接 | 用途 |
|---|---|---|
| 项目主页 | GitHub Repository | 源码浏览 |
| 问题反馈 | GitHub Issues | Bug 报告与功能建议 |
| 版本更新 | Releases | 更新内容与升级指南 |
| 讨论区 | GitHub Discussions | 技术讨论与问题解答 |