mirror of https://github.com/halfwaystudent/douyin-sparkflow.git synced 2026-06-27 02:11:34 +08:00

Go to file

codex 8fe630f356 fix: 私信发送确认误判——用 is-me class + 今日时间截断取代宽泛选择器

问题：snapshot_last_own_message 用 [class*='message']/[class*='bubble'] 等宽泛
选择器扫全页并靠位置猜自己消息，抓到的是整个聊天区容器节点。导致
confirm_message_sent 永远比不上单条气泡文本，100% 误报失败，每条消息
纯浪费 ~80 秒空转 + 进入失败队列反复重试。

改动：
1. snapshot_last_own_message 完全重写——直接用抖音 DOM 结构：
   - 找所有 box-item- 行
   - 从底部往上扫 time- 时间分隔符，碰到 昨天/星期/2026- 就标记今日边界
   - 今日区域内从底部找第一个 is-me 行，从 <pre> 取文本
2. 新增 count_today_own_message_matches——只数今日 is-me 气泡里精确匹配
   指定文本的条数。用于发送前后增量比较，挡住手机并发发消息把最后一条
   顶掉导致主路径漏判的场景。
3. confirm_message_sent 加 count 兜底——主路径(最后一条自己消息==本次
   发送文本)未命中时，回退到 count 增量判断；超时前再兜底一次。
4. 保留 _detect_send_failure_indicator——轮询中一旦发现红色感叹号/
   重试按钮/发送失败文字立即判失败，不写 sentAt。

原文件备份：tasks.py.bak-20260624-snapshot-fix（容器内）

2026-06-25 10:04:55 +08:00

deploy

Improve one-click deployment workflow

2026-06-20 02:13:28 +08:00

docs

docs: add screenshot usage guide

2026-05-30 02:41:03 +08:00

DouYinSparkFlow

fix: 私信发送确认误判——用 is-me class + 今日时间截断取代宽泛选择器

2026-06-25 10:04:55 +08:00

proxy

Add Docker Compose one-click deployment

2026-05-30 00:39:14 +08:00

.env.example

Improve one-click deployment workflow

2026-06-20 02:13:28 +08:00

.gitattributes

Avoid compose plugin download during image build

2026-05-30 01:26:43 +08:00

.gitignore

feat: redesign web admin layout

2026-05-30 02:41:03 +08:00

CHANGELOG.md

docs: highlight screenshot guide link

2026-05-30 02:41:03 +08:00

docker-compose.yml

Improve one-click deployment workflow

2026-06-20 02:13:28 +08:00

README.md

docs: 更新贡献说明 - 暂不接受外部 PR

2026-06-21 00:58:39 +08:00

refresh_proxy.sh

Avoid compose plugin download during image build

2026-05-30 01:26:43 +08:00

README.md

🔥 DouYin SparkFlow

抖音多账号火花自动维护系统

一个智能化的抖音好友互动管理工具，自动维护好友火花标记，支持多账号管理、定时发送、Web 控制台

功能特性 • 快速开始 • 使用文档 • 部署指南 • 社区讨论

📸 主界面预览

🌙 暗色模式

Web 管理控制台 - 仪表盘视图（暗色主题）

☀️ 亮色模式

Web 管理控制台 - 仪表盘视图（亮色主题）

✨ 功能特性

🎯 核心功能

🔄 自动维护火花标记 - 智能识别需要维护的好友关系，自动发送消息保持火花
👥 多账号管理 - 支持同时管理多个抖音账号，集中控制、独立配置
⏰ 定时任务调度 - 灵活的定时发送策略，支持自定义发送时间窗口
🎨 消息模板系统 - 内置多种消息模板（一言、节日祝福等），支持自定义
📊 可视化仪表盘 - 实时监控账号状态、任务进度、发送历史

🛠️ 技术特性

🌐 Web 管理界面 - 现代化的 Web UI，支持移动端访问
🎭 主题切换 - 内置亮色/暗色主题，自适应系统偏好
🔐 扫码登录 - 安全的二维码登录方式，无需密码
🔌 浏览器自动化 - 基于 Playwright 的稳定浏览器控制
🐳 容器化部署 - 开箱即用的 Docker 支持，一键部署
🔄 登录态持久化 - 自动保存登录状态，减少重复登录
📝 完整日志系统 - 详细的操作日志，方便问题追踪

🎨 界面特点

现代化设计 - 简洁美观的深色模式主界面，炫彩火花渐变效果
响应式布局 - 适配桌面和移动设备
侧边栏导航 - 清晰的功能分区：概览、登录、账号、控制台、日志、设置
实时状态更新 - 账号在线状态、任务执行进度实时显示
交互式控制 - 一键启动/停止任务，批量操作支持

🚀 快速开始

前置要求

Python 3.8 或更高版本
Docker 和 Docker Compose（用于容器部署）
稳定的网络连接

📦 安装部署

🐳 方式一：Docker 一键部署（推荐）

适用场景：服务器部署、生产环境

# 1. 克隆仓库
git clone https://github.com/halfwaystudent/douyin-sparkflow.git
cd douyin-sparkflow

# 2. 配置环境变量
cp .env.example .env
nano .env  # 根据需要修改配置

# 3. 启动服务
docker-compose up -d

# 4. 访问 Web 界面
# 浏览器打开 http://localhost:8787

服务端口说明：

8787: Web 管理控制台
18090: 登录桌面 API
5901: VNC 远程桌面
8788: noVNC Web 桌面

💻 方式二：本地开发运行

适用场景：本地开发、功能测试

# 1. 克隆仓库
git clone https://github.com/halfwaystudent/douyin-sparkflow.git
cd douyin-sparkflow/DouYinSparkFlow

# 2. 安装依赖
pip install -r requirements.txt
pip install -r requirements-web.txt

# 3. 安装 Playwright 浏览器
playwright install chromium

# 4. 启动 Web 服务
python main.py --web

# 5. 访问 http://localhost:8787

🎬 使用流程

登录账号 → 进入"登录工作区"，扫码登录抖音账号
添加好友 → 在"账号管理"中刷新好友列表，选择需要维护火花的好友
配置任务 → 设置发送时间窗口、消息模板
启动任务 → 在"概览"页面启动定时任务
监控运行 → 在"发送控制台"查看实时日志和发送记录

📖 详细使用教程请查看使用文档

📂 项目结构

douyin-sparkflow/
├── DouYinSparkFlow/          # 核心应用源码
│   ├── core/                 # 核心功能模块
│   │   ├── browser.py        # 浏览器控制
│   │   ├── friends.py        # 好友管理
│   │   ├── login.py          # 登录处理
│   │   ├── msg_builder.py    # 消息构建
│   │   ├── protocol_sender.mjs  # 协议发送
│   │   └── tasks.py          # 任务调度（核心）
│   ├── webui/                # Web 界面
│   │   ├── app.py            # FastAPI 主应用
│   │   ├── auth.py           # 认证模块
│   │   ├── login_sessions.py # 登录会话管理
│   │   ├── ops.py            # 操作接口
│   │   ├── static/           # 静态资源（CSS/JS）
│   │   └── templates/        # HTML 模板
│   ├── utils/                # 工具模块
│   │   ├── config.py         # 配置管理
│   │   ├── logger.py         # 日志记录
│   │   └── hitokoto.py       # 一言 API
│   ├── scripts/              # 辅助脚本
│   ├── docs/                 # 文档和截图
│   ├── main.py               # 主入口
│   ├── login_desktop_server.py  # 登录桌面服务
│   └── relogin_worker.py     # 重登录工作进程
├── proxy/                    # 代理配置
│   └── config.yaml           # Mihomo 代理配置
├── docker-compose.yml        # 容器编排配置
├── .env.example              # 环境变量模板
├── refresh_proxy.sh          # 代理刷新脚本
└── README.md                 # 本文件

📖 使用文档

🔑 账号管理

扫码登录：使用抖音 APP 扫描二维码完成登录
多账号支持：可同时管理多个账号，独立配置每个账号的发送策略
登录态保持：自动保存登录状态，无需频繁重新登录
状态监控：实时显示账号在线状态和登录有效期

📝 消息管理

内置模板类型：

一言（Hitokoto）：随机诗词、名言警句
节日祝福：自动识别节假日，发送对应祝福语
自定义消息：支持纯文本自定义消息

发送策略：

时间窗口设置（如：09:00-22:00）
随机延迟避免检测
发送失败自动重试
发送确认机制

⚙️ 配置说明

点击查看配置文件说明

`.env` - 环境变量配置

# 代理配置（可选）
PROXY_URL=http://proxy-container:7890

# Web 服务端口
WEB_PORT=8787

# 登录桌面端口
LOGIN_DESKTOP_PORT=18090

# VNC 端口
VNC_PORT=5901

`config.json` - 应用配置

{
  "send_window_start": "09:00",  // 发送窗口开始时间
  "send_window_end": "22:00",    // 发送窗口结束时间
  "send_interval_min": 300,      // 最小发送间隔（秒）
  "message_template": "hitokoto", // 消息模板类型
  "enable_send_confirm": true,   // 启用发送确认
  "friend_refresh_interval": 3600 // 好友列表刷新间隔（秒）
}

🐳 部署指南

Docker Compose 部署（推荐）

本项目提供完整的 Docker Compose 配置，包含以下服务：

douyin-web: Web 管理控制台服务
login-desktop: 登录桌面服务（包含浏览器环境）
proxy: Mihomo 代理服务（可选）

快速部署

# 1. 准备环境变量
cp .env.example .env

# 2. 启动所有服务
docker-compose up -d

# 3. 查看日志
docker-compose logs -f

# 4. 停止服务
docker-compose down

仅部署 Web 服务

docker-compose up -d douyin-web

服务器部署最佳实践

查看部署建议

系统要求

CPU: 2 核心或以上
内存: 2GB 或以上
存储: 10GB 可用空间
系统: Ubuntu 20.04+ / CentOS 7+ / Debian 10+

持久化数据

以下目录建议挂载为数据卷：

volumes:
  - ./state:/app/state          # 运行状态数据
  - ./logs:/app/logs            # 日志文件
  - ./DouYinSparkFlow:/app      # 应用代码（开发环境）

网络配置

如需外网访问，建议配置反向代理（Nginx/Caddy）：

# Nginx 配置示例
server {
    listen 80;
    server_name sparkflow.example.com;
    
    location / {
        proxy_pass http://localhost:8787;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

安全建议

✅ 修改默认管理员密码
✅ 启用 HTTPS（使用 Let's Encrypt）
✅ 配置防火墙规则
✅ 定期备份 state/ 和 usersData.json
✅ 使用环境变量管理敏感配置

🔧 高级配置

代理配置

项目支持通过代理访问抖音服务，配置文件位于 proxy/config.yaml：

mixed-port: 7890
allow-lan: true
mode: rule
# ... 更多配置见配置文件

GitHub Actions 定时任务

支持通过 GitHub Actions 运行定时任务，配置文件：.github/workflows/schedule.yml

📊 技术栈

后端框架: FastAPI - 现代化的 Python Web 框架
前端: HTML5 + CSS3 + Vanilla JavaScript
浏览器自动化: Playwright - 跨浏览器自动化
容器化: Docker + Docker Compose
代理: Mihomo (Clash Meta)
任务调度: APScheduler
模板引擎: Jinja2

⚠️ 免责声明

本项目仅供学习研究使用

本工具仅用于技术学习和个人使用，不得用于任何商业用途
使用本工具产生的一切后果由使用者自行承担
请遵守平台规则，合理使用，避免频繁操作
作者不对使用本工具导致的账号异常、封禁等问题负责
请评估使用风险，建议使用小号测试

📝 更新日志

查看 CHANGELOG.md 了解版本更新历史。

最新更新 (2026-05-30):

✨ 重新设计 Web UI，全新视觉风格
🎨 新增亮色/暗色主题切换
📱 优化移动端响应式布局
🔄 改进好友列表刷新可靠性
🚀 优化一键部署流程
📖 新增截图使用指南

🤝 贡献

本项目目前作为个人项目维护，暂不接受外部 Pull Request。

如果你有：

🐛 发现问题 - 欢迎提交 Issue 报告 Bug
💡 功能建议 - 欢迎在 Issue 中提出改进想法
🤔 使用疑问 - 可以在 Linux Do 社区或 Issue 中讨论

感谢你的理解和支持！

📄 许可证

本项目采用 MIT License 开源协议。

🌟 Star History

🔗 相关链接

项目主页: GitHub Repository
社区讨论: Linux Do 社区
使用文档: docs/usage.md
问题反馈: Issues

如果这个项目对你有帮助，请给个 ⭐ Star 支持一下！

Made with ❤️ by halfwaystudent

Languages

Python 40.5%

JavaScript 31.8%

HTML 19.3%

CSS 6.3%

Shell 1.7%

Other 0.4%

README.md Unescape Escape

🔥 DouYin SparkFlow

📸 主界面预览

🌙 暗色模式

☀️ 亮色模式

✨ 功能特性

🎯 核心功能

🛠️ 技术特性

🎨 界面特点

🚀 快速开始

前置要求

📦 安装部署

🎬 使用流程

📂 项目结构

📖 使用文档

🔑 账号管理

📝 消息管理

⚙️ 配置说明

.env - 环境变量配置

config.json - 应用配置

🐳 部署指南

Docker Compose 部署（推荐）

快速部署

仅部署 Web 服务

服务器部署最佳实践

系统要求

持久化数据

网络配置

安全建议

🔧 高级配置

代理配置

GitHub Actions 定时任务

📊 技术栈

⚠️ 免责声明

📝 更新日志

🤝 贡献

📄 许可证

🌟 Star History

🔗 相关链接

README.md

`.env` - 环境变量配置

`config.json` - 应用配置