ScriptCat-Douyin-Fire-Helper 🔥

抖音续火花自动发送助手 - 每天自动发送续火消息，保持好友火花不熄灭！学生党狂喜！

✨ 功能特性

🎯 智能目标用户查找

• 自动查找点击: 配置目标用户名，自动在聊天列表中查找并点击
• 实时状态监控: 显示用户查找状态（寻找中/已找到/未找到）
• 智能防抖节流: 优化查找频率，避免页面卡顿
• 多层点击策略: 支持直接点击和事件触发两种方式

🕒 智能定时发送

• 精准定时: 支持自定义发送时间（默认 00:01:00）
• 自动重试: 可配置重试机制，最多重试10次
• 每日检测: 智能判断当日是否已发送，避免重复
• 实时倒计时: 显示下次发送的精确倒计时

🎭 丰富消息内容

• 一言API集成: 自动获取优美句子，支持自定义格式
• TXTAPI支持: 支持外部API和手动文本两种模式
• 灵活格式: 自定义消息模板，支持占位符替换
• 随机选择: 手动模式下支持随机或顺序发送文本

📊 增强日志系统

• 完整历史记录: 记录所有操作日志，支持查看和导出
• 智能日志管理: 自动限制日志数量（默认200条），避免内存占用
• 实时状态显示: 显示API状态、重试次数等关键信息
• 一键清空: 支持快速清空所有日志记录

🎛️ 人性化控制

• 可视化面板: 实时显示状态、倒计时和操作日志
• 图形化设置: 友好的设置界面，配置简单直观
• 状态监控: 实时显示一言API和TXTAPI状态
• 桌面通知: 发送成功时显示系统通知

⚡ 性能优化

• 智能观察器: 优化DOM监听机制，减少性能消耗
• 防抖节流: 控制查找频率，避免页面卡顿
• 内存管理: 及时清理观察器，防止内存泄漏
• 超时机制: 所有操作都有超时控制，避免无限等待

📸 界面展示

graph TD
    A[打开抖音创作者平台] --> B[脚本自动加载]
    B --> C[显示控制面板]
    C --> D{启用目标用户查找?}
    D -->|是| E[自动查找目标用户]
    D -->|否| F[手动进入聊天界面]
    E --> G[点击目标用户]
    G --> H[等待页面加载]
    H --> I[查找聊天输入框]
    F --> I
    I --> J[准备消息内容]
    J --> K[发送续火消息]
    K --> L[记录发送状态]
    L --> M[显示成功通知]

🛠️ 安装使用

前提条件

• 浏览器安装 ScriptCat（推荐） 或 Tampermonkey 脚本管理器
• 现代浏览器（Chrome、Edge、Firefox等）

快速安装

已经安装ScriptCat或Tampermonkey的用户点击下方链接快速安装：


手动安装

1. 下载 scriptcat-douyin-fire-helper.user.js 文件
2. 在脚本管理器中点击"添加新脚本"
3. 将文件内容粘贴到编辑器中保存
4. 启用脚本

使用步骤

1. 打开抖音创作者平台私信管理页面
2. 页面右上角会出现控制面板
3. 点击"设置"按钮配置发送时间和消息内容
4. 目标用户功能：在设置中启用目标用户查找，填写要自动点击的用户名
5. 脚本将在指定时间自动查找用户并发送续火消息

⚠️ 重要设置

浏览器保持活跃设置（Chrome为例）：

1. 打开浏览器设置
2. 进入"性能"设置
3. 找到"始终让以下网站保持活跃状态"
4. 添加网站：creator.douyin.com
5. 保存设置

💻 挂机方案

云电脑挂机推荐

为了实现24小时不间断运行，推荐使用云服务器或挂机宝：

挂机部署步骤

1. 购买云服务器

   • 选择Windows系统（推荐Windows Server）
   • 基础配置即可满足需求

2. 环境配置

   • 安装浏览器（推荐百分浏览器）
   • 安装脚本管理器（Tampermonkey或ScriptCat）
   • 安装本脚本并配置
   • 设置浏览器保持活跃状态

3. 日常维护

   • 定期检查脚本运行状态
   • 关注更新通知
   • 备份重要配置

⚙️ 配置说明

🎯 目标用户设置

• 启用目标用户查找: 开启自动查找功能
• 目标用户名: 要自动点击的用户名（精确匹配）
• 点击方法:
  • 直接点击：更可靠，推荐使用
  • 事件触发：更安全，兼容性更好
• 查找超时: 用户查找的最大等待时间

⏰ 基本设置

• 发送时间: 设置每天的发送时间（格式: HH:mm:ss）
• 重试次数: 发送失败时的最大重试次数（1-10次）
• 页面加载等待: 点击用户后等待页面加载的时间

🤖 一言API设置

• 启用一言API: 是否使用一言API
• 消息格式: 自定义显示格式，支持变量：
  • {hitokoto} - 一言内容
  • {from} - 出处
  • {from_who} - 作者
• API超时: 一言API请求超时时间

📝 TXTAPI设置

• 启用TXTAPI: 是否使用TXTAPI功能
• 模式选择:
  • API模式: 从指定URL获取文本内容
  • 手动模式: 使用自定义文本列表
• 随机发送: 手动模式下是否随机选择文本
• 文本内容: 每行一个文本，支持换行

⚡ 性能设置

• 防抖延迟: 控制查找频率，减少性能消耗
• 节流延迟: 最小查找间隔，避免频繁操作
• 日志数量: 最大历史日志数量

💬 消息模板

• 自定义格式: 使用 [API] 和 [TXTAPI] 作为占位符
• 多行支持: 支持换行符，创建更丰富的消息格式
• 基础消息: API获取失败时的备用消息

🔧 技术架构

🏗️ 系统架构

用户界面层
    ↓
业务逻辑层
    ↓
数据访问层
    ↓
抖音网页API

🔌 API集成

• 一言API: https://v1.hitokoto.cn/
• 自定义API: 支持任何返回纯文本的API接口
• 抖音网页API: 通过DOM操作实现自动化

🛡️ 安全特性

• 本地存储: 所有配置数据存储在本地
• 无数据收集: 不收集任何用户隐私数据
• 开源透明: 代码完全开源，可审查

📁 项目结构

ScriptCat-Douyin-Fire-Helper/
├── scriptcat-douyin-fire-helper.user.js  # 主脚本文件
├── README.md                             # 项目说明文档
├── LICENSE                              # 开源许可证
└── images/                              # 项目图片资源
    ├── screenshot-panel.png             # 控制面板截图
    ├── screenshot-settings.png          # 设置界面截图
    └── screenshot-logs.png              # 日志界面截图

🚀 更新日志

📋 版本概览

v2.0 (最新版本) - 智能目标用户查找系统

🎯 核心功能升级

• ✨ 智能目标用户查找: 自动在聊天列表中查找并点击指定用户
• 🔄 动态DOM监控: 实时监控页面变化，适应动态加载内容
• 🎯 状态管理: 智能状态切换（寻找中/已找到/未找到）
• 🤖 全自动流程: 从查找到发送的完整自动化

📊 增强日志系统

• 🗃️ 历史日志面板: 完整的操作记录查看界面
• 📤 日志导出功能: 支持导出为.txt格式文件
• 🔢 智能日志限制: 自动管理日志数量（默认200条）
• 🧹 一键清空: 快速清理所有历史记录

⚡ 性能优化

• 🚀 防抖节流机制: 大幅降低性能消耗，解决页面卡顿
• 🔍 优化观察器: 智能DOM监听，减少内存占用
• ⏱️ 超时控制: 所有操作都有超时保护
• 🛡️ 内存管理: 防止内存泄漏的观察器管理

🎛️ 用户体验提升

• 👀 实时状态显示: 清晰的状态指示（寻找中/已找到/未找到）
• 🎨 改进UI布局: 更美观直观的控制面板
• ⚙️ 增强设置面板: 新增目标用户配置和性能设置
• 🔔 智能通知: 更完善的系统通知机制

🔧 技术架构改进

• 🏗️ 模块化代码: 更清晰的项目结构
• 💾 优化存储管理: 改进数据持久化机制
• 🛠️ 增强兼容性: 更好的浏览器兼容支持
• 🔄 错误处理: 完善的异常恢复机制

v1.0 (基础版本) - 核心功能实现

🎉 基础功能

• ⏰ 定时发送: 支持自定义发送时间（HH:mm:ss格式）
• 🤖 一言API集成: 自动获取优美句子丰富消息内容
• 📝 TXTAPI支持: 支持外部API和手动文本模式
• 💾 本地存储: 使用GM_setValue/GM_getValue持久化配置

🖥️ 用户界面

• 🎛️ 控制面板: 可视化操作界面，实时状态显示
• ⚙️ 设置界面: 图形化配置，操作简单直观
• 📊 操作日志: 实时显示脚本运行状态
• 🔄 状态监控: API状态和重试次数显示

🔧 稳定性和兼容性

• 🔄 自动重试: 发送失败时的智能重试机制
• 📅 每日检测: 避免重复发送的日期检查
• 🐛 错误处理: 完善的异常捕获和处理
• 🔍 元素定位: 精确的DOM元素查找方法

🔄 消息系统

• 🎨 自定义模板: 支持消息格式自定义
• 🔤 占位符替换: [API]和[TXTAPI]占位符支持
• 📋 多行消息: 完整的换行符支持
• 🔄 随机选择: 手动模式下的随机文本选择

🔄 版本对比

🎯 升级亮点

v2.0 重大改进

1. 自动化程度: 从半自动升级到全自动，支持目标用户自动查找点击
2. 性能表现: 通过防抖节流机制大幅降低资源消耗
3. 用户体验: 完整的日志系统和实时状态监控
4. 稳定可靠: 多层错误恢复和内存管理机制
5. 配置灵活: 丰富的性能调优选项

v1.0 核心价值

1. 基础功能: 提供稳定的定时发送和消息自定义
2. API集成: 一言API和TXTAPI的完整支持
3. 简单易用: 直观的控制面板和设置界面
4. 稳定运行: 经过验证的可靠性和兼容性

📈 版本规划

已实现功能

• ✅ 基础定时发送 (v1.0)
• ✅ 消息内容自定义 (v1.0)
• ✅ API集成 (v1.0)
• ✅ 目标用户自动查找 (v2.0)
• ✅ 性能优化 (v2.0)
• ✅ 完整日志系统 (v2.0)

未来规划

• 🔄 多用户支持
• 🔄 云端配置同步

💡 提示: 建议所有用户升级到 v2.0 版本，享受更智能、更稳定、更高效的使用体验！

🐛 故障排除

常见问题

Q: 脚本无法找到目标用户怎么办？
A:

1. 检查目标用户名是否完全匹配（包括特殊符号和空格）
2. 确认用户存在于聊天列表中
3. 尝试调整查找超时时间
4. 查看历史日志了解具体错误信息

Q: 点击用户后无法发送消息？
A:

1. 增加页面加载等待时间
2. 检查网络连接是否稳定
3. 确认聊天输入框选择器是否正确
4. 尝试切换点击方法

Q: 页面卡顿或性能问题？
A:

1. 增加防抖和节流延迟时间
2. 关闭不必要的观察器
3. 减少日志数量限制
4. 重启浏览器释放内存

Q: 如何查看详细的错误信息？
A:

1. 打开控制面板的历史日志
2. 查看浏览器开发者工具的控制台
3. 导出日志文件进行分析

性能优化建议

1. 防抖延迟: 网络环境差时设置为800-1000ms
2. 节流延迟: 页面卡顿时设置为1500-2000ms
3. 页面等待: 网络慢时设置为8000-10000ms
4. 日志数量: 长期运行时设置为100-150条

🤝 贡献指南

我们欢迎各种形式的贡献！

报告问题

• 使用 GitHub Issues 报告bug
• 提供详细的错误描述和重现步骤
• 附上相关的日志和截图

功能建议

• 在Issues中提出新功能想法
• 描述使用场景和预期效果
• 讨论技术实现的可行性

代码贡献

1. Fork本项目
2. 创建功能分支
3. 提交代码更改
4. 发起Pull Request

开发环境

• 使用现代浏览器进行测试
• 确保代码兼容Tampermonkey和ScriptCat
• 遵循现有的代码风格

📜 开源协议

本项目采用 MIT 协议 - 查看 LICENSE 文件了解详情

协议要点

• 允许商业使用
• 允许修改和分发
• 允许私人使用
• 无担保责任

⚠️ 使用声明

重要提醒

• 请合理使用，避免频繁发送消息干扰他人
• 本脚本仅用于学习交流和技术研究目的
• 使用前请确保遵守抖音平台的相关规则
• 开发者不对滥用造成的任何后果负责

合规使用

1. 尊重平台规则，不要用于恶意目的
2. 控制发送频率，避免被系统检测为异常行为
3. 仅与同意续火的好友使用此功能
4. 如遇平台规则变更，请及时停止使用

🤖 AI 开发声明

重要声明: 本脚本由 AI 辅助开发完成，结合了人工测试和优化。

开发历程

• AI辅助开发: 主要代码逻辑和功能实现由AI生成
• 人工优化: 经过多次实际测试、调试和性能优化
• 持续改进: 基于用户反馈不断修复问题和增强功能
• 质量保证: 每个版本都经过功能测试和兼容性验证

技术特点

• 采用现代化的JavaScript ES6+语法
• 模块化架构，便于维护和扩展
• 完善的错误处理和日志系统
• 性能优化的DOM操作和事件处理

🌟 致谢

感谢以下项目和服务的支持：

• 一言API - 提供优美的句子内容
• Tampermonkey - 强大的用户脚本管理器
• ScriptCat - 优秀的脚本管理器平台
• DeepSeek - 提供AI辅助开发支持
• 所有贡献者 - 感谢每一位贡献者

📞 联系我们

• 项目主页: GitHub Repository
• 问题反馈: GitHub Issues
• 版本更新: Releases