📝 AI 文档声明：本文档由 AI 辅助生成和优化，内容基于项目源码与功能设计整理。虽然经过人工校对，但仍可能存在细节偏差或版本不同步的情况。如发现任何错误或过时信息，欢迎通过 GitHub Issues 提交反馈，我们会及时修正。
🚀 一款专为抖音设计的自动化续火脚本，支持多用户批量发送、一言API、专属文案、随机时间、智能重试，配合后端调度器实现 7×24 小时无人值守。
📌 快速导航：星火云 · 抖音续火云端自动化平台 · 1.5元/月 · 功能特性 · 界面预览 · 油猴脚本安装与使用 · 调度器管理器安装与使用 · 完整协同部署流程 · 挂机方案 · 配置说明 · 更新日志 · 故障排除 · 贡献指南
| 模块 | 功能 | 说明 |
|---|---|---|
| 🔥 火花天数 | [天数] 占位符 |
自动记录每位好友的火花持续天数，每天首次发送自动 +1 |
| 💫 专属一言 | [专属一言] 占位符 |
按周一~周日配置专属文案，支持随机/顺序发送，防重复 |
| 🎲 随机时间 | 跨天时间范围 | 在指定区间内每日随机选取发送时间，避免固定模式 |
| 👥 多用户批量 | 可视化选择 | 自动解析聊天列表，支持全选/去重/状态标识 |
| 🔄 智能重试 | 自动重置 | 10 分钟自动重试 + 定时重置，重试计数持久化 |
| 🎯 用户查找 | 多层点击策略 | 直接点击 + 事件触发，防抖节流避免卡顿 |
| 📊 观察器监控 | 详细状态 | 运行时长、DOM 变化、停止原因实时统计 |
| ⏸️ 暂停/继续 | 状态持久化 | 随时暂停或恢复，页面刷新后保留状态 |
| 🔗 调度器回调 | HTTP 通知 | 任务完成自动通知后端，支持多账号无人值守 |
{hitokoto} / {from} / {from_who} 变量[API] / [TXTAPI] / [天数] / [专属一言] 占位符，支持多行| 控制面板 | 设置界面 |
|---|---|
 |
 |
| 用户选择面板 | 历史日志 |
|---|---|
 |
 |
graph TD
A[打开抖音创作者平台] --> 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
F12 打开开发者工具查看控制台是否有报错00:01:00）或开启随机时间模式| 占位符 | 作用 | 示例 |
|---|---|---|
[天数] |
自动替换为当前火花天数 | 第[天数]天 → 第15天 |
[专属一言] |
自动替换为当天星期对应文案 | 见下方配置 |
[API] |
自动获取一言 API 句子 | 随机优美句子 |
[TXTAPI] |
从自定义文本/API 随机获取 | 自定义文案 |
📝 模板示例：
第[天数]天，[专属一言][API]→ 实际发送：第15天，周一快乐今天天气真不错樱花飘落的季节总是让人心生欢喜
为避免浏览器后台休眠导致脚本停止，必须配置以下设置（以 Chrome/百分浏览器为例）：
chrome://settings/performancecreator.douyin.comwww.douyin.comEdge 浏览器：设置 → 系统和性能 → 「从不进入睡眠状态的这些站点」中添加上述域名。
Firefox 浏览器：安装 Auto Tab Discard 扩展，将上述域名加入白名单。
F12 打开控制台查看是否有红色报错creator.douyin.com/... 或 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：
# 使用 Homebrew 安装（推荐）
brew install python
# 验证
python3 --version
⚠️ 版本要求：Python 3.7 及以上版本。低于此版本可能导致部分语法不兼容。
Linux/macOS 下的调度器 Shell 脚本依赖 jq 处理 JSON 数据。
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 版本号 |
配套工具 压缩包D:\Tools\抖音续火\配套工具\）解压后的目录结构：
配套工具/
├── shell/ # 调度器核心文件
│ ├── callback_server.py # Python HTTP 回调服务器
│ ├── scheduler.ps1 # Windows 调度器脚本
│ ├── scheduler.sh # Linux/macOS 调度器脚本
│ ├── config.json # 调度器配置文件（★ 核心配置）
│ └── logs/ # 调度器日志目录（自动生成）
├── profiles/ # 浏览器 Profile 存放目录（自动生成）
├── manager_history.log # 管理器操作日志（自动生成）
└── 抖音续火综合管理器.pyw # Windows 图形化管理工具 v1.0
💡 关于
profiles/目录：存放每个抖音账号的独立浏览器配置（Cookie、登录态等），首次运行时自动创建。位于配套工具/profiles/，而非shell/子目录下。
💡 关于综合管理器的位置：
抖音续火综合管理器.pyw可以放在任意目录运行。但请注意：综合管理器会在 其自身所在的目录 下生成profiles/文件夹和manager_history.log。如果将管理器放在项目根目录，则profiles/会在根目录生成；如果放在配套工具/目录（默认位置），则在配套工具/profiles/生成。请保持管理器位置与调度器期望的 profiles 路径一致，推荐保持默认位置不变。
编辑 配套工具/shell/config.json，这是调度器的核心配置文件：
{
// 全局默认发送时间
"send_time": "00:01:00",
// 回调服务器端口（必须与油猴脚本中设置的一致）
"callback_port": 7788,
// 默认浏览器类型
// 可选值: "centbrowser" | "chrome" | "firefox" | "firefox-esr" | "edge"
"default_browser": "centbrowser",
// 各浏览器可执行文件路径（留空则自动检测）
"browser_paths": {
"centbrowser": "",
"chrome": "",
"firefox": "",
"firefox-esr": "",
"edge": ""
},
// 目标页面 URL
// 可选: "creator" (creator.douyin.com) 或 "chat" (www.douyin.com/chat)
"target_url": "creator",
// 账号列表（每个账号使用独立的浏览器 Profile）
"accounts": [
{
"name": "账号1", // 账号备注名（仅用于日志显示）
"profile": "account1", // Profile 文件夹名称（对应 配套工具/profiles/ 下的子目录）
"send_time": "00:01:00", // 可选，不填则使用全局 send_time
"browser": "" // 可选，不填则使用全局 default_browser
},
{
"name": "账号2",
"profile": "account2",
"send_time": "00:05:00"
}
]
}
| 配置项 | 必填 | 说明 |
|---|---|---|
callback_port |
✅ | 回调监听端口，默认 7788，必须与油猴脚本设置中的端口一致 |
default_browser |
✅ | 浏览器类型，挂机推荐 centbrowser |
browser_paths |
❌ | 各浏览器路径，留空自动检测。如果自动检测失败需手动填写绝对路径 |
target_url |
✅ | creator 或 chat，决定打开哪个抖音页面 |
accounts |
✅ | 至少配置一个账号 |
accounts[].profile |
✅ | Profile 目录名，每个账号必须不同，否则会互相干扰。对应 配套工具/profiles/ 下的子目录名 |
accounts[].send_time |
❌ | 可为每个账号设置不同的发送时间，留空使用全局时间 |
如果 browser_paths 留空，调度器会按以下顺序自动查找：
| 浏览器 | 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（相当于独立的浏览器实例，Cookie/登录态互不干扰）。
所有 Profile 统一存放在 配套工具/profiles/ 目录下，每个账号一个子文件夹：
配套工具/profiles/
├── account1/ # 对应 config.json 中 "profile": "account1"
├── account2/ # 对应 config.json 中 "profile": "account2"
└── account3/ # 对应 config.json 中 "profile": "account3"
详见下方「第五步」。
在 配套工具/profiles/ 目录下，为每个账号创建一个子文件夹（如 account1、account2）
使用对应浏览器以指定 Profile 启动并登录抖音：
Windows (PowerShell)：
# 以 centbrowser 为例，替换为你的实际浏览器路径和配套工具路径
& "C:\Path\To\centbrowser.exe" --user-data-dir="D:\Tools\抖音续火\配套工具\profiles\account1" "https://creator.douyin.com"
Linux/macOS (Terminal)：
# 以 chrome 为例
google-chrome --user-data-dir="/path/to/配套工具/profiles/account1" "https://creator.douyin.com"
在打开的浏览器中登录对应的抖音账号
确认登录成功后关闭浏览器，Profile 会自动保存登录状态
💡 提示：只需首次登录一次，之后调度器会自动使用已保存的登录状态。
如果你使用 Windows 系统，强烈推荐使用图形化管理器，无需记忆任何命令。
⚠️ 位置提醒：默认情况下综合管理器位于
配套工具/目录中，此时profiles/也会在配套工具/下生成，与调度器的路径预期一致。如果你将管理器移动到其他位置，请确保调度器配置中的 profiles 路径能够正确找到管理器生成的 profiles 目录。
双击运行 抖音续火综合管理器.pyw
⚠️ 首次启动需要 Python 环境。如果双击无反应，尝试在命令行中运行：
python "抖音续火综合管理器.pyw"查看报错信息。
📝 首次启动会在管理器 所在目录 下自动生成
profiles/文件夹和默认配置文件。
shell/scheduler.ps1，在下方日志区域实时显示运行状态manager_history.log 中点击「停止调度器」按钮，当前正在执行的任务会等待当前账号完成（或超时）后停止。
# 进入调度器目录
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）：
# 创建 plist 文件
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 执行策略限制。以管理员身份打开 PowerShell，运行：
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
然后重新执行调度器脚本。
Linux/macOS 需要安装 jq：
# Ubuntu/Debian
sudo apt install jq
# CentOS/RHEL
sudo yum install jq
# macOS
brew install jq
部分系统 Python 3 命令为 python 而非 python3。创建软链接：
sudo ln -s /usr/bin/python3 /usr/bin/python
或直接修改 scheduler.sh 中的 python3 为 python。
config.json 中 browser_paths 路径是否正确（包含完整的 .exe 路径）\\ 或 /）--no-sandbox 权限问题（root 用户运行需要加此参数）配套工具/profiles/ 目录中对应账号的 Profile 文件夹确实已保存登录状态config.json 中 profile 字段与 配套工具/profiles/ 下的目录名是否完全一致http://localhost:7788，应返回响应config.json 中 callback_port 与油猴脚本设置中的端口是否一致config.json 和油猴脚本设置中的端口为其他未被占用的端口Windows 查找占用进程：
netstat -ano | findstr :7788
taskkill /PID <进程ID> /F
Linux/macOS 查找占用进程：
lsof -i :7788
kill -9 <PID>
或者修改 config.json 和油猴脚本设置中的端口为其他值（如 8899）。
python "抖音续火综合管理器.pyw" 查看报错tcl/tk and IDLEsudo apt install python3-tkbrew install python-tkshell/logs/ 下的日志文件，确认回调服务器是否收到请求需要安装虚拟显示器：
sudo apt install xvfb
# 使用 xvfb-run 启动调度器
xvfb-run ./scheduler.sh
或在 browser_paths 中为 Chrome 添加 --headless 参数（注意：headless 模式下抖音页面可能无法正常工作，不建议使用）。
综合管理器会在 它自身所在的目录 下生成 profiles/ 文件夹。例如：
配套工具/ → profiles 在 配套工具/profiles/ ✅（默认，与调度器一致）项目根目录/profiles/ ⚠️（调度器找不到）桌面/profiles/ ⚠️（调度器找不到）如果移动了管理器，需要同步修改调度器的 profiles 路径配置，或通过符号链接将 profiles 目录关联到 配套工具/profiles/。
以下是从零开始部署多账号无人值守方案的完整流程清单，按顺序执行即可。
安装浏览器 → 安装脚本管理器 → 安装油猴脚本 → 打开抖音页面 → 选择用户 → 配置模板 → 设置定时 → 保持浏览器活跃 ✅
1. 环境准备
├── 安装浏览器（所有账号使用同一种浏览器）
├── 安装脚本管理器
├── 安装 Python 3
└── 安装 jq（Linux/macOS）
2. 油猴脚本部署
├── 安装抖音续火脚本
└── 打开抖音页面验证脚本生效
3. 调度器部署
├── 下载并解压配套工具
├── 编辑 配套工具/shell/config.json 配置账号列表
├── 在 配套工具/profiles/ 下为每个账号创建独立 Profile
├── 在每个 Profile 的浏览器中登录对应抖音账号
└── 在每个 Profile 中启用油猴脚本的「后端调度器回调」
4. 启动运行
├── Windows: 启动综合管理器 → 点击「启动调度器」
└── Linux/macOS: 终端运行 ./scheduler.sh（或配置 systemd/launchd 开机自启）
5. 验证
├── 查看调度器日志，确认第一个账号浏览器已启动
├── 确认油猴脚本控制面板正常显示
├── 等待脚本执行完成，确认回调成功
└── 确认调度器自动关闭第一个浏览器并启动第二个 ✅
| 平台 | 配置 | 价格 | 特点 |
|---|---|---|---|
| ⭐ 星火云平台（推荐） | 无需本地设备 | 1.5 元/月 | 真正的 SaaS 云端，无需下载软件，无需保持电脑开机 |
| 阿里云轻量服务器 | 1 核 1G / 20GB | ≈24 元/月 | 稳定可靠，性能强劲 |
| 腾讯云轻量服务器 | 1 核 1G / 25GB | ≈25 元/月 | 网络优化，访问快速 |
| 专业挂机宝 | 基础配置 | ≈10-20 元/月 | 专为挂机优化，价格低廉 |
为仅需续火花脚本的用户提供的 SaaS 云端服务，无需下载软件、无需保持电脑开机，7×24 小时云端自动执行。
🔗 购买地址：https://dyxh.503555.xyz
核心特性
开通流程
💡 购买后自动开通，无需人工干预。
Win+R → shell:startup）| 配置项 | 默认值 | 说明 |
|---|---|---|
| 观察器状态监控 | 开启 | 实时显示运行状态和详细信息 |
| 详细日志记录 | 开启 | 记录启动、运行、停止全过程 |
| 查找尝试限制 | 50 次 | 避免无限循环 |
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 初始天数 | 1 | 火花初始天数 |
| 天数占位符 | [天数] |
模板中自动替换为当前天数 |
| 增加逻辑 | 自动 | 每天首次发送成功 +1 |
| 手动调整 | 支持 | 设置中可手动修改 |
| 配置项 | 说明 |
|---|---|
| 启用专属一言 | 开启/关闭功能 |
| 星期文案配置 | 周一~周日分别设置文案 |
| 发送模式 | 随机 / 顺序 |
| 专属占位符 | [专属一言] 自动替换为当天文案 |
| 防重复机制 | 每日记录已发送文案，避免重复 |
| 配置项 | 格式 | 说明 |
|---|---|---|
| 启用随机时间 | 开关 | 开启/关闭随机时间模式 |
| 开始时间 | HH:mm:ss |
随机时间起始 |
| 结束时间 | HH:mm:ss |
随机时间结束，可小于开始时间（跨天） |
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 自动重试间隔 | 10 分钟 | 达到最大重试后自动重置的间隔 |
| 启用自动重试 | 开启 | 达到最大重试后自动重置 |
| 定时重置间隔 | 10 分钟 | 定时重置重试计数 |
| 重置重试按钮 | — | 控制面板手动重置按钮 |
| 重试状态持久化 | 开启 | 避免意外重置为 0 |
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 点击方法 | 直接点击 | 直接点击（推荐）/ 事件触发 |
| 查找超时 | 30 秒 | 用户查找最大等待时间 |
| 页面加载等待 | 5000 ms | 点击用户后等待页面加载时间 |
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 发送时间 | 00:01:00 |
每日发送时间（HH:mm:ss） |
| 重试次数 | 3 次 | 发送失败最大重试次数（1-10） |
| 聊天框重试限制 | 5 次 | 查找聊天输入框最大重试次数 |
| 初始加载延迟 | 30 秒 | 页面加载后延迟启动自动检测 |
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 启用一言 API | 开启 | 使用一言 API 获取优美句子 |
| API 超时 | 5000 ms | 请求超时时间 |
| 消息格式 | 自定义 | 支持 {hitokoto} / {from} / {from_who} |
| 配置项 | 说明 |
|---|---|
| 启用 TXTAPI | 开启/关闭功能 |
| 模式选择 | API 模式（从 URL 获取）/ 手动模式（自定义文本） |
| 随机发送 | 手动模式下是否随机选择 |
| 文本内容 | 每行一个文本，支持换行 |
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 防抖延迟 | 500 ms | 控制查找频率 |
| 节流延迟 | 1000 ms | 最小查找间隔 |
| 日志数量 | 200 条 | 最大历史日志数量 |
| 观察器日志级别 | 标准 | 标准 / 详细 |
[API] / [TXTAPI] / [天数] / [专属一言]第[天数]天，[专属一言][API]| 配置项 | 默认值 | 说明 |
|---|---|---|
| Chat 页面换行替换符 | | |
Chat 页面不支持换行，自动替换 |
| Chat 页面搜索等待 | 动态 | 网络慢时可适当增加超时 |
| 配置项 | 默认值 | 说明 |
|---|---|---|
default_browser |
centbrowser |
默认浏览器（centbrowser/chrome/firefox/firefox-esr/edge） |
browser_paths |
空字符串 | 自定义各浏览器路径，留空则自动检测 |
target_url |
creator.douyin.com |
目标页面 |
用户界面层
├── 控制面板 (状态显示、日志、操作按钮)
├── 设置面板 (功能配置、参数调整)
└── 用户选择面板 (可视化用户选择)
↓
业务逻辑层
├── 定时调度模块 (固定/随机时间触发)
├── 用户管理模块 (多用户批量处理)
├── 消息生成模块 (API集成、模板渲染)
├── 状态管理模块 (火花天数、发送记录)
├── 重试管理模块 (自动重试、定时重置)
└── 观察器管理模块 (状态监控、详细日志)
↓
数据访问层
├── 本地存储 (GM_setValue/GM_getValue)
├── API接口 (一言API、自定义API)
└── DOM操作 (抖音网页自动化)
↓
抖音网页 API
├── 用户查找 (聊天列表解析)
├── 消息发送 (输入框操作)
└── 状态监控 (页面变化监听)
外部工具（调度器 & 管理器）
├── 后端调度器 (多账号顺序执行、超时重试)
├── 综合管理器 v1.0 (图形化配置、一键控制)
└── HTTP回调接口 (脚本与调度器通信)
http://localhost:7788/done（与调度器通信）ScriptCat-Douyin-Fire-Helper/
├── scriptcat-douyin-fire-helper.user.js # 主脚本文件 (v2026.07.13)
├── README.md # 项目说明文档
├── LICENSE # 开源许可证
├── CHANGELOG.md # 更新日志
├── images/ # 项目图片资源
│ ├── screenshot-panel.png
│ ├── screenshot-settings.png
│ ├── screenshot-user-select.png
│ └── screenshot-logs.png
└── 配套工具/
├── shell/ # 调度器核心文件目录
│ ├── callback_server.py # Python HTTP 回调服务器
│ ├── scheduler.ps1 # Windows 调度器脚本
│ ├── scheduler.sh # Linux/macOS 调度器脚本
│ └── config.json # 调度器配置文件
├── profiles/ # 浏览器 Profile 存放目录（自动生成）
├── manager_history.log # 管理器操作日志（自动生成）
└── 抖音续火综合管理器.pyw # Windows 图形化管理工具 v1.0
完整历史版本请查看 Releases
✨ 新增功能
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.07.13，新增 Chat 页面支持、暂停控制、用户火花天数独立记录与后端调度器集成。
油猴脚本和调度器的专属常见问题已在各自教程章节中覆盖，以下为其他通用问题。
| ？这是正常行为，Chat 页面不支持换行。可在设置中修改「Chat 页面换行替换符」自定义分隔符，建议使用空格或逗号。
v2026.07.13 已修复此问题（改用 InputEvent 替代 KeyboardEvent）。请升级到最新版本。
lastFireDate 记录是否正确v2026.07.13 已修复此问题，失败用户自动标记并继续下一用户。请检查失败用户名是否正确，是否在好友列表中，并查看历史日志了解具体失败原因。
这是 v3.0 的正常行为，当用户列表为空时自动关闭。添加目标用户后功能会自动开启。
升级到 v2026.03.22 及以上版本已修复此问题。检查是否启用了自动重试功能，查看重试设置中的自动重试间隔配置，必要时使用控制面板的「重置重试」按钮手动重置。
升级到 v2026.03.22 及以上版本已修复此问题。检查脚本是否处于处理状态（避免重复发送），查看历史日志了解自动发送触发情况，尝试手动点击「立即发送」测试功能。
| 场景 | 建议配置 |
|---|---|
| 多用户模式（>20 人） | 使用顺序发送模式 |
| 网络环境差/页面卡顿 | 防抖延迟 800-1000ms |
| 大量用户 | 节流延迟 1500-2000ms |
| 随机时间范围 | 建议 2-6 小时，避免过于集中 |
| 长期 24 小时运行 | 日志数量 100-150 条 |
| 网络慢 | 页面等待时间 8000-10000ms |
| 重试间隔 | 10-30 分钟，根据网络稳定性 |
| 定时重置间隔 | 10-30 分钟，保持重试活跃性 |
| 观察器日志级别 | 日常标准模式，调试详细模式 |
| 查找尝试限制 | 保持默认 50 次 |
| 初始加载延迟 | 页面加载慢时 60-90 秒 |
| Chat 页面搜索等待 | 网络慢时适当增加超时时间 |
我们欢迎各种形式的贡献！
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 | 技术讨论与问题解答 |
如果这个项目对您有帮助，请给它一个 ⭐ Star！您的支持是我持续更新的动力。
