⚠️ 本版本仅支持 Chat 页面（https://www.douyin.com/chat*）。Chat 页面与 Creator 创作者平台已拆分维护，Creator 版本将在后续独立发布。

✨ 新增

• 📅 火花天数管理面板：每个好友独立记录，支持扫描、搜索、修改、清空；新增「自动从页面获取」开关（关闭则每天首次发送 +1）
• 📖 使用帮助面板：6 大分节 + 搜索 + 关键词高亮定位；内置配套工具下载按钮
• 📋 日志系统重做：结构化字段、按天分片、多维筛选、批写、.txt + .json 双格式导出

🐛 修复

• 修复 _logFlushBuffer 拼写错误导致面板无法加载（严重）
• 修复火花天数误读他人天数（严格限定右侧面板读取）
• 修复用户列表重复/无关（data-e2e="conversation-item" 精准锚定）
• 移除观察器代码，解决 #15 日志刷屏
• 修复暂停后定时器泄漏、发送流程无错误边界
• 修复下拉菜单白底白字、底部按钮换行

⚡ 性能

🗑️ 移除

• 移除 Creator 创作者平台支持（拆分独立维护）
• 移除发送结果校验、测试发送按钮、逐字符输入延迟

📥 配套工具下载

⚠️ 升级建议

• 从 v2026.07.13 升级：建议先删除旧脚本再安装新版
• 使用旧版 Creator 页面：请勿升级，等待 Creator 版本独立发布

完整更新日志：README.md → 更新日志

✨ 新增功能

📱 Chat 页面全面支持

• 完整支持 https://www.douyin.com/chat* 页面
• 专用用户搜索功能，自动在搜索框中输入用户名并点击聊天按钮
• 支持换行输入（Shift+Enter），逐字符模拟真人输入
• 自动读取并记录当前聊天对象的火花天数
• 自动适配 Chat 页面消息输入框（contenteditable）

⏸️ 暂停/继续控制

• 点击控制面板暂停按钮随时暂停或恢复自动发送
• 暂停状态下自动停止所有正在进行的任务
• 暂停状态持久化保存，页面刷新后恢复

👤 用户火花天数独立记录

• 每个目标用户独立记录火花天数，不再是全局统一天数
• 从 Chat 页面自动读取并记录每个用户的火花天数
• [天数] 占位符自动替换为当前用户对应的火花天数
• 新增「清空天数」按钮，一键清空所有用户的火花天数记录

🔗 后端调度器回调集成

• 任务完成时自动通知本地后端调度器
• 支持 success / all_failed / partial 三种回调状态
• 回调失败时自动重试（默认 25 分钟后）
• 防止重复通知，避免后端调度器收到冗余回调

🔄 多用户失败处理优化

• 新增 failedUsersToday 数组，记录所有重试失败的用户
• 单用户达到最大重试次数后，自动标记为失败并切换下一用户
• 所有用户全部失败或部分失败时，向调度器发送详细状态报告

⏱️ 初始加载延迟配置

• 新增 initialDelay 配置项（默认 30 秒）
• 避免页面未完全加载时过早触发发送
• 可设置为 0 立即启动

🔧 Chat 页面换行分隔符

• 新增 chatPageLineSeparator 配置（默认 |）
• Chat 页面不支持换行时自动替换为自定义分隔符

🐛 问题修复

• 修复查找尝试次数过多时当前用户未正确标记为失败的问题
• 修复多用户模式下所有用户处理完毕时未正确通知后端调度器的问题
• 修复 Chat 页面搜索框输入中文输入法导致的乱码
• 修复 Chat 页面搜索结果加载慢导致找不到聊天按钮的问题
• 修复发送完成后冷却期检查逻辑，避免频繁发送

⚡ 性能优化

• 新增发送冷却期（3 秒），避免短时间内重复触发
• 新增防频繁重试检查（5 秒），避免重试循环过快
• 优化 Chat 页面元素查找效率，减少不必要的 DOM 查询
• 精简 Chat 页面查找日志，避免日志刷屏

📦 配套工具

配套工具为初始版本，提供以下基础功能：

• callback_server.py — Python HTTP 回调服务器
• scheduler.ps1 — Windows 调度器脚本
• scheduler.sh — Linux/macOS 调度器脚本
• config.json — 调度器配置文件
• 抖音续火综合管理器.pyw — Windows 图形化管理工具

📥 下载说明

🙏 贡献者

• @YsKiKi - 调度器（fork 本项目后新增，后由本项目合并）

感谢以上贡献者对本版本的支持！

📌 升级指南

脚本升级

1. 打开脚本管理器，点击「安装此脚本」或手动更新
2. 刷新抖音页面即可生效

配套工具升级

1. 下载 tools.zip 并解压为 配套工具/ 目录
2. 替换旧版文件（注意备份 config.json 和 profiles/ 目录）
3. 运行 抖音续火综合管理器.pyw 验证配置

💡 强烈建议所有用户升级到此版本！

该版本为系统自动同步更新

该版本为系统自动同步更新

v3.1.1 - 观察器状态管理与详细日志增强

📊 观察器状态管理系统

• 🎯 详细状态监控: 新增观察器运行时长、DOM变化次数、当前目标用户等详细信息
• 🔄 多状态管理: 支持查找中、已找到、发送中等多种状态实时监控
• 📈 性能统计: 自动记录观察器的运行时长和DOM变化统计
• 💾 状态持久化: 观察器状态会持久化保存，支持跨页面刷新
• 📝 详细停止原因: 明确记录观察器停止的具体原因（成功找到目标用户、查找超时等）
• 🚀 减少冗余日志: 在清空数据和重置配置时不记录观察器停止日志
• 🔍 查找过程监控: 每5秒记录一次查找状态，包含查找时长和DOM变化次数
• 🎮 状态信息展示: 显示当前状态、重试次数等关键信息

🔥 主要更新内容

🛠️ 智能重试机制

• 自动重试功能: 新增10分钟自动重试功能，达到最大重试后自动重置
• 定时重置重试: 新增定时重置重试功能，可配置重置间隔时间（默认10分钟）
• 重试状态管理: 重试计数持久化保存，避免重置为0的问题
• 重置重试按钮: 控制面板新增"重置重试"按钮，手动重置重试计数
• 重试设置面板: 新增"重试设置"选项卡，集中管理重试配置

🐛 关键问题修复

• 状态检查优化: 修复今日状态为"未发送"却不自动发送的问题
• 重试逻辑增强: 修复重试次数重置为0的问题，添加状态变量跟踪
• 重复发送防护: 在autoSendIfNeeded()函数开始处添加isProcessing检查，避免重复发送
• 触发逻辑优化: 优化了自动发送的触发逻辑，确保按时执行

⚡ 性能与稳定性

• 重试持久化: 重试计数现在会持久化保存到GM_setValue
• 时间管理优化: 达到最大重试后，会记录时间并等待自动重试
• 菜单命令增强: 添加了相应的菜单命令，便于操作
• 状态显示优化: 优化了重试计数显示和状态管理

📥 升级说明

1. 自动升级: 已安装脚本的用户会自动收到更新通知
2. 手动安装: 点击此处下载最新版本
3. 配置迁移: 旧版配置会自动迁移，无需重新设置
4. 兼容性: 完全兼容v3.0版本的所有功能

🔧 新功能使用指南

1. 启用智能重试

1. 打开设置面板 → 重试设置
2. 启用"达到最大重试后自动重置"
3. 设置自动重试间隔（推荐10-30分钟）
4. 设置定时重置间隔（推荐10-30分钟）
5. 保存配置

2. 使用重置功能

1. 控制面板新增"重置重试"按钮
2. 点击可手动重置当前重试计数
3. 系统会每10分钟自动重置一次重试状态
4. 达到最大重试后会自动触发重置

📋 完整更新日志

详细更新内容请查看：README.md

⚠️ 重要提醒

• 强烈建议所有用户升级到此版本，修复了关键的重试问题
• 如果遇到任何问题，请在 Issues 中反馈
• 使用前请确保浏览器已设置为"保持活跃状态"

📦 文件下载

• scriptcat-douyin-fire-helper.user.js - 主脚本文件

感谢所有用户的支持与反馈！如果这个项目对您有帮助，请给项目一个 ⭐ Star！

🎉 四大全新功能震撼登场！

🔥 火花天数记录系统

• 新增 [天数] 占位符 - 自动记录火花持续天数
• 每日自动增加 - 每天第一次发送时天数+1
• 实时显示 - 控制面板实时显示当前火花天数
• 手动调整 - 支持手动修改天数，灵活控制

💫 专属一言功能

• 星期专属文案 - 周一到周日分别设置不同文案
• 新增 [专属一言] 占位符 - 自动匹配当天文案
• 防重复发送 - 每天记录已发送文案，避免重复
• 两种发送模式 - 随机发送或顺序发送

🎲 随机发送时间系统

• 随机时间模式 - 新增随机时间开关
• 时间范围设置 - 自定义开始和结束时间
• 智能随机选择 - 每天在范围内随机选择发送时间
• 跨天时间支持 - 支持跨天时间范围（如23:00-01:00）

👥 用户选择面板（革命性改进！）

• 自动解析用户 - 一键解析聊天列表所有用户
• 可视化选择 - 全新选择界面，告别手动输入
• 全选/取消全选 - 批量操作更高效
• 状态标识 - 已添加用户自动打勾，一目了然

🔄 核心优化与改进

🎯 智能自动化

• 自动开关机制 - 目标用户查找功能自动管理
• 简化配置流程 - 移除手动开关，配置更简单
• 智能状态同步 - 实时显示功能状态

📝 操作体验大升级

• 用户分隔符统一 - 统一使用换行符分隔用户
• 按钮功能优化 - "更新目标用户"更准确反映操作
• 配置逻辑简化 - 减少冗余配置项

🔧 技术架构增强

• 模块化架构优化 - 新增功能模块化设计
• 数据存储升级 - 新增 lastFireDate 等字段
• 错误处理增强 - 完善边界情况处理

🐛 重要修复

• 多用户时间重置 - 修复多用户模式下时间到达未清空记录的问题
• 倒计时状态同步 - 确保状态更新及时准确
• 重试策略完善 - 完整实现重试同一用户功能

⚡ 性能提升

• DOM操作优化 - 用户选择面板性能优化
• 内存管理改进 - 减少内存占用，提升稳定性
• 响应速度提升 - 界面交互更加流畅

📈 版本对比亮点

🚀 升级建议

强烈推荐所有用户升级到v3.0！

1. 新用户：直接使用v3.0，享受最完整功能
2. v2.x用户：必升！获得四大新功能和众多改进
3. v1.x用户：强烈建议升级，体验全自动化和现代化界面

⚠️ 升级注意事项

1. 配置备份：建议升级前导出重要配置
2. 新功能配置：需要手动配置火花天数、专属一言等新功能
3. 用户列表更新：建议使用新的用户选择面板重新选择用户

📋 使用指南

1. 安装新版本：覆盖安装或重新安装
2. 配置新功能：
   • 设置初始火花天数
   • 配置周一到周日专属一言
   • 启用随机时间模式并设置范围
3. 使用用户选择面板：
   • 点击控制面板"选择用户"按钮
   • 勾选目标用户
   • 点击"更新目标用户"保存

🔧 故障排除

如遇问题，请：

1. 查看控制台错误信息
2. 阅读历史日志了解详细情况
3. 在GitHub Issues提交问题报告

🔄 关键修复

• 🐛 多用户模式时间重置: 修复多用户模式下到达指定时间未清空记录的问题，现在多用户模式也能正常重置每日发送记录
• 📅 日期检查机制: 新增日期检查函数，确保新的一天能正确重置发送记录
• 🔧 状态持久化: 完善重置日期记录，确保多用户模式下每日重置功能正常工作

⚡ 核心优化

• 🔄 自动重置逻辑: 优化多用户模式下的自动重置逻辑，确保每个新的一天都能从第一个用户开始发送
• 💾 配置一致性: 确保多用户模式与单用户模式在时间到达时的行为一致
• 🚀 稳定性提升: 修复可能存在的状态不一致问题，提升脚本整体稳定性

v2.3 状态修复与功能完善

1. 倒计时修复: 解决倒计时结束后状态更新不及时的问题
2. 重试策略: 完整实现"重试时使用同一用户"功能
3. 状态管理: 新增"发送中"状态，更准确反映操作状态
4. 稳定性: 完善重试用户状态重置机制

🎨 界面设计升级

• ✨ 抖音风格设计: 采用现代化深色主题，界面风格与抖音保持一致
• 🗂️ 功能分类设置: 设置面板按功能模块分类，查找配置更便捷
• 🖱️ 面板拖动功能: 支持拖拽移动控制面板，自由调整位置
• 🔄 重新打开优化: 优化悬浮按钮的显示效果和交互体验

📏 显示优化

• 🖱️ 拖动体验优化: 改进拖动逻辑，使用left/top定位替代transform

⚡ 稳定性增强

• 🔄 聊天输入框重试限制: 新增聊天输入框查找的重试次数限制，避免无限重试
• 🛡️ 错误处理优化: 增强各种边界情况的错误处理能力
• 🚀 性能优化: 进一步优化DOM操作和事件处理性能