[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82308":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":12,"stars7d":14,"stars30d":15,"stars90d":13,"forks30d":13,"starsTrendScore":16,"compositeScore":17,"rankGlobal":8,"rankLanguage":8,"license":8,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":18,"hasPages":18,"topics":20,"createdAt":8,"pushedAt":8,"updatedAt":21,"readmeContent":22,"aiSummary":23,"trendingCount":13,"starSnapshotCount":13,"syncStatus":24,"lastSyncTime":25,"discoverSource":26},82308,"douyin-sparkflow","halfwaystudent\u002Fdouyin-sparkflow","halfwaystudent",null,"Python",50,6,1,0,10,13,3,2.54,false,"main",[],"2026-06-12 02:04:25","# 🔥 douyin-sparkflow\n\nDouyin SparkFlow 提供一个面向个人自用场景的抖音火花维护工具。项目包含 Web 管理面板、登录桌面、定时任务和代理配置模板，默认通过 Docker Compose 部署。\n\n## 🧭 上游项目\n\n本项目基于 [2061360308\u002FDouYinSparkFlow](https:\u002F\u002Fgithub.com\u002F2061360308\u002FDouYinSparkFlow) 进行二次开发，主要补充 Web 管理、Docker Compose 部署和运行维护相关能力。\n\n## ✨ 功能特性\n\n- 🖥️ Web 面板管理账号、目标好友和发送窗口。\n- 🔐 浏览器扫码登录并保存本地登录态。\n- ⏱️ 定时执行续火花任务，支持手动触发和日志查看。\n- 🌐 可选 Mihomo\u002FClash 代理订阅配置。\n- 🐳 Docker Compose 编排 Web、登录桌面、定时器、任务和代理服务。\n- 🌗 支持小太阳\u002F小月亮切换白天模式和黑夜模式。\n\n## 🖼️ 界面预览\n\n![Douyin SparkFlow 控制台界面预览](docs\u002Fimages\u002Fui-preview.png)\n\n> 📘 **截图教程：** 新版 Web 面板将概览、登录工作区、账号与目标、运行与系统拆成独立视图。按截图完成首次配置，请直接阅读 [Douyin SparkFlow 使用教程](docs\u002Fusage.md)。\n\n## ⚠️ 免责声明\n\n本项目仅用于个人学习、研究和自用场景，不是抖音、字节跳动或相关平台的官方工具，也未获得其授权、背书或关联。\n\n使用本项目时，请遵守所在地法律法规、抖音平台规则和相关服务协议。请勿将本项目用于商业用途、批量营销、骚扰他人、刷量引流、规避平台风控，或任何可能损害平台、他人账号及第三方权益的行为。\n\n本项目会在使用者授权登录后，按照使用者配置的账号、好友和发送窗口执行自动化操作。由此产生的账号异常、限流、封禁、数据丢失、服务中断、消息误发、隐私泄露或其他损失，均由使用者自行承担。项目作者和贡献者不对使用本项目产生的任何直接或间接后果负责。\n\n请妥善保管 `.env`、登录态、Cookie、代理配置和运行日志等敏感信息，不要提交到公开仓库，也不要分享给不可信的第三方。如果平台规则、接口页面或风控策略发生变化，请立即停止使用并自行评估风险。\n\n继续部署、运行或修改本项目，即表示你已理解并接受以上说明；如果你不同意，请停止使用本项目。\n\n## 🚀 快速开始\n\n在服务器上推荐使用这条一键安装命令，适合 `raw.githubusercontent.com` 访问较慢或超时的环境：\n\n```bash\napt update && apt install -y git curl gnupg ca-certificates && rm -rf \u002Fopt\u002Fdouyin-sparkflow && git clone --depth=1 https:\u002F\u002Fgithub.com\u002Fhalfwaystudent\u002Fdouyin-sparkflow.git \u002Fopt\u002Fdouyin-sparkflow && cd \u002Fopt\u002Fdouyin-sparkflow && bash deploy\u002Finstall-server.sh\n```\n\n如果 GitHub 克隆时出现 `GnuTLS recv error`，先切到 HTTP\u002F1.1 后重试：\n\n```bash\ngit config --global http.version HTTP\u002F1.1\ngit config --global http.lowSpeedLimit 1000\ngit config --global http.lowSpeedTime 60\n```\n\n指定安装目录或代理订阅：\n\n```bash\nAPP_ROOT=\u002Fopt\u002Fdouyin-sparkflow PROXY_SUB_URL='你的 Mihomo\u002FClash 订阅链接' bash -c 'apt update && apt install -y git curl gnupg ca-certificates && rm -rf \"$APP_ROOT\" && git clone --depth=1 https:\u002F\u002Fgithub.com\u002Fhalfwaystudent\u002Fdouyin-sparkflow.git \"$APP_ROOT\" && cd \"$APP_ROOT\" && bash deploy\u002Finstall-server.sh'\n```\n\n如果你的服务器可以稳定访问 `raw.githubusercontent.com`，也可以使用精简版：\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fhalfwaystudent\u002Fdouyin-sparkflow\u002Fmain\u002Fdeploy\u002Finstall-server.sh | bash\n```\n\n部署完成后检查容器状态：\n\n```bash\ncd \u002Fopt\u002Fdouyin-sparkflow\ndocker compose ps\n```\n\n正常状态应包含：\n\n- `douyin-web`：`Up`，Web 面板服务。\n- `login-desktop`：`Up`，扫码登录桌面。\n- `douyin-scheduler`：`Up`，定时发送和自动兜底。\n- `mihomo`：`Up`，代理服务。\n- `douyin-task`：`Exited` 或 `Stopped` 是正常的，它是一次性手动任务容器，不需要常驻。\n\n确认 `douyin-web` 已启动后访问：\n\n- Web 面板：`http:\u002F\u002F服务器IP:8787`\n- 登录桌面：Web 面板中的“登录桌面”入口，默认端口 `8788`\n\n如果外网打不开 Web 面板，请在云服务器安全组、轻量云防火墙或 1Panel 防火墙中放行：\n\n- `8787\u002Ftcp`：Web 管理面板。\n- `8788\u002Ftcp`：扫码登录桌面。\n\n首次使用：\n\n1. 创建管理员账号。\n2. 打开登录工作区并扫码登录抖音。\n3. 保存登录态。\n4. 刷新好友列表并选择目标好友。\n5. 设置发送窗口，例如 `10:00-18:00\u002F10m`。\n\n## 💻 本地运行\n\nWindows 需要先启动 Docker Desktop：\n\n```powershell\n.\\deploy\\install-local.ps1\n```\n\n如需配置代理订阅：\n\n```powershell\n.\\deploy\\install-local.ps1 -ProxySubUrl \"你的 Mihomo\u002FClash 订阅链接\"\n```\n\nLinux\u002FmacOS：\n\n```bash\n.\u002Fdeploy\u002Finstall-local.sh\n```\n\n本地脚本会创建 `.env`、运行态目录和默认代理配置，并执行 `docker compose up -d --build`。\n\n## ⚙️ 配置说明\n\n如果 `.env` 中的 `PROXY_SUB_URL` 为空，项目会使用 `proxy\u002Fconfig.example.yaml` 生成直连代理配置。\n\n首次构建需要拉取 Playwright 基础镜像。默认 `.env.example` 使用国内同步源；如果同步源不可用，可以将 `.env` 中的 `PLAYWRIGHT_BASE_IMAGE` 改为：\n\n```bash\nPLAYWRIGHT_BASE_IMAGE=mcr.microsoft.com\u002Fplaywright\u002Fpython:v1.56.0-jammy\n```\n\n## 🧰 常用命令\n\n```bash\ndocker compose ps\ndocker compose logs -f web\ndocker compose logs -f scheduler\ndocker compose up -d --build\ndocker compose down\n```\n\n刷新代理订阅：\n\n```bash\n.\u002Frefresh_proxy.sh\ndocker compose restart proxy\n```\n\n## 📁 项目结构\n\n- `DouYinSparkFlow\u002F`：核心应用、Web UI、登录桌面和发送任务。\n- `docker-compose.yml`：容器编排入口。\n- `deploy\u002F`：服务器和本地部署脚本。\n- `proxy\u002Fconfig.example.yaml`：代理配置模板。\n- `.env.example`：部署环境变量模板。\n\n## 🗃️ 运行时文件\n\n以下路径由应用在部署或运行时生成，通常不纳入版本控制。迁移或备份实例时，可根据实际需要处理这些文件：\n\n- `.env`\n- `state\u002F`\n- `logs\u002F`\n- `proxy\u002Fconfig.yaml`\n- `DouYinSparkFlow\u002Flogs\u002F`\n- `DouYinSparkFlow\u002FusersData.json`\n- `DouYinSparkFlow\u002Fwebui_settings.json`\n- `DouYinSparkFlow\u002F.im_sdk_cache\u002F`\n\n## 📈 GitHub Star 趋势\n\n[![GitHub Star 趋势图](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=halfwaystudent\u002Fdouyin-sparkflow&type=Date)](https:\u002F\u002Fstar-history.com\u002F#halfwaystudent\u002Fdouyin-sparkflow&Date)\n\n## 🤝 友情链接\n\n- [Linux Do](https:\u002F\u002Flinux.do\u002F)\n\n## 📄 许可\n\n核心应用采用 MIT 协议，详见 [DouYinSparkFlow\u002FLICENSE](DouYinSparkFlow\u002FLICENSE)。\n","Douyin SparkFlow 是一个面向个人自用场景的抖音火花维护工具。它提供了Web管理面板、扫码登录、定时任务执行和代理配置等功能，支持通过Docker Compose进行部署。用户可以使用Web界面来管理账号、目标好友以及发送窗口，并且能够设置定时任务以自动执行续火花操作。此外，该项目还支持Mihomo\u002FClash代理订阅配置，便于在不同网络环境下稳定运行。适用于需要自动化维护抖音火花关系的个人用户，在确保遵守相关法律法规和服务协议的前提下使用。",2,"2026-06-11 04:08:21","CREATED_QUERY"]