Upload 33 files

Dockerfile

@@ -0,0 +1,26 @@
+FROM python:3.11-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1 \
+    PLAYWRIGHT_BROWSERS_PATH=/ms-playwright \
+    PORT=7860
+
+WORKDIR /app
+
+COPY requirements.txt /app/requirements.txt
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ca-certificates \
+    curl \
+    fonts-liberation \
+    && rm -rf /var/lib/apt/lists/* \
+    && pip install --upgrade pip \
+    && pip install -r /app/requirements.txt \
+    && python -m playwright install --with-deps chromium
+
+COPY . /app
+
+EXPOSE 7860
+
+CMD ["python", "main.py"]

app.py

@@ -0,0 +1,998 @@
+import asyncio
+import atexit
+import hashlib
+import json
+import logging
+import os
+import secrets
+import shutil
+import threading
+import traceback
+from collections import deque
+from datetime import datetime
+from pathlib import Path
+from typing import Any, Optional
+
+import uvicorn
+from apscheduler.schedulers.background import BackgroundScheduler
+from apscheduler.triggers.cron import CronTrigger
+from fastapi import FastAPI, File, Form, HTTPException, Request, UploadFile, status
+from fastapi.responses import HTMLResponse, JSONResponse, RedirectResponse
+from fastapi.staticfiles import StaticFiles
+from fastapi.templating import Jinja2Templates
+from pydantic import BaseModel, Field
+
+from core.tasks import runTasks
+from utils.logger import setup_logger
+
+
+logger = setup_logger(level=logging.DEBUG)
+
+BASE_DIR = Path(__file__).resolve().parent
+TEMPLATES_DIR = BASE_DIR / "templates"
+STATIC_DIR = BASE_DIR / "static"
+ROOT_CONFIG_PATH = BASE_DIR / "config.json"
+DATA_DIR = BASE_DIR / "data"
+TENANTS_DIR = DATA_DIR / "tenants"
+USERS_META_PATH = DATA_DIR / "users.json"
+SESSION_COOKIE_NAME = "sparkflow_auth"
+DEFAULT_TIMEZONE = "Asia/Shanghai"
+MAX_LOG_LINES = 1200
+MAX_TEMPLATE_LENGTH = 2000
+PASSWORD_ITERATIONS = 210000
+
+DEFAULT_USER_CONFIG = {
+    "multiTask": True,
+    "taskCount": 5,
+    "proxyAddress": "",
+    "messageTemplate": "续火花！！！",
+    "hitokotoTypes": ["文学", "影视", "诗词", "哲学"],
+    "scheduler": {
+        "enabled": True,
+        "timezone": DEFAULT_TIMEZONE,
+        "hour": 9,
+        "minute": 0,
+        "runOnStartup": False,
+    },
+}
+
+AUTH_SESSIONS: dict[str, dict[str, str]] = {}
+data_file_lock = threading.Lock()
+scheduler_lock = threading.Lock()
+runtime_map_lock = threading.Lock()
+
+
+class UserRuntimeState:
+    def __init__(self, username: str):
+        self.username = username
+        self._run_lock = threading.Lock()
+        self._state_lock = threading.Lock()
+        self.is_running = False
+        self.last_status = "未开始"
+        self.last_error = ""
+        self.last_trigger = "-"
+        self.last_start = None
+        self.last_end = None
+        self.next_run = None
+        self.schedule_hour = 9
+        self.schedule_minute = 0
+        self.schedule_timezone = DEFAULT_TIMEZONE
+        self.history = deque(maxlen=50)
+        self.logs = deque(maxlen=2000)
+
+    def _format_ts(self, value: Optional[datetime]):
+        if not value:
+            return "-"
+        return value.strftime("%Y-%m-%d %H:%M:%S")
+
+    def schedule_time(self):
+        return f"{self.schedule_hour:02d}:{self.schedule_minute:02d}"
+
+    def _set_running(self, value: bool):
+        with self._state_lock:
+            self.is_running = value
+
+    def add_log(self, message: str):
+        ts = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+        with self._state_lock:
+            self.logs.append(f"{ts} [{self.username}] {message}")
+
+    def update_schedule(self, hour: int, minute: int, timezone: str):
+        with self._state_lock:
+            self.schedule_hour = hour
+            self.schedule_minute = minute
+            self.schedule_timezone = timezone
+
+    def update_next_run(self, next_run):
+        with self._state_lock:
+            self.next_run = next_run
+
+    def snapshot(self, account_count: int, target_count: int):
+        with self._state_lock:
+            return {
+                "is_running": self.is_running,
+                "last_status": self.last_status,
+                "last_error": self.last_error,
+                "last_trigger": self.last_trigger,
+                "last_start": self._format_ts(self.last_start),
+                "last_end": self._format_ts(self.last_end),
+                "next_run": self._format_ts(self.next_run),
+                "account_count": account_count,
+                "target_count": target_count,
+                "schedule_time": self.schedule_time(),
+                "schedule_timezone": self.schedule_timezone,
+            }
+
+    def history_rows(self):
+        with self._state_lock:
+            return list(self.history)[::-1]
+
+    def recent_logs(self, limit=MAX_LOG_LINES):
+        with self._state_lock:
+            lines = list(self.logs)[-max(1, limit):]
+        return "\n".join(lines) if lines else "暂无日志。"
+
+    def run_once(self, trigger: str):
+        if not self._run_lock.acquire(blocking=False):
+            self.add_log(f"任务已在运行中，忽略触发：{trigger}")
+            return False, "已有任务在运行，本次触发已跳过。"
+
+        self._set_running(True)
+        with self._state_lock:
+            self.last_trigger = trigger
+            self.last_start = datetime.now()
+            self.last_end = None
+            self.last_error = ""
+            self.last_status = "运行中"
+        self.add_log(f"任务开始执行，触发方式：{trigger}")
+
+        ok = True
+        message = "任务执行完成。"
+        try:
+            asyncio.run(_run_user_tasks(self.username))
+            with self._state_lock:
+                self.last_status = "成功"
+        except Exception as exc:
+            ok = False
+            message = f"任务执行失败：{exc}"
+            with self._state_lock:
+                self.last_status = "失败"
+                self.last_error = repr(exc)
+            self.add_log(f"任务失败：{exc}")
+            logger.error("Task failed. user=%s trigger=%s error=%s", self.username, trigger, exc)
+            logger.debug("Task traceback:\n%s", traceback.format_exc())
+        finally:
+            end_at = datetime.now()
+            with self._state_lock:
+                self.last_end = end_at
+                duration = (self.last_end - self.last_start).total_seconds()
+                self.history.append(
+                    {
+                        "trigger": trigger,
+                        "start": self._format_ts(self.last_start),
+                        "end": self._format_ts(self.last_end),
+                        "status": self.last_status,
+                        "duration": f"{duration:.2f}s",
+                        "message": self.last_error or "OK",
+                    }
+                )
+                current_status = self.last_status
+            self.add_log(f"任务结束，状态={current_status}，耗时={duration:.2f}s")
+            self._set_running(False)
+            self._run_lock.release()
+        return ok, message
+
+
+runtime_map: dict[str, UserRuntimeState] = {}
+scheduler = None
+
+
+class UserLoginPayload(BaseModel):
+    username: str
+    password: str
+
+
+class AdminLoginPayload(BaseModel):
+    password: str
+
+
+class SchedulePayload(BaseModel):
+    time: str
+
+
+class MessageTemplatePayload(BaseModel):
+    message: str
+
+
+class UserTargetsItem(BaseModel):
+    unique_id: str
+    targets: list[str] = Field(default_factory=list)
+
+
+class UserTargetsPayload(BaseModel):
+    users: list[UserTargetsItem]
+
+
+def _ensure_data_layout():
+    DATA_DIR.mkdir(parents=True, exist_ok=True)
+    TENANTS_DIR.mkdir(parents=True, exist_ok=True)
+    if not USERS_META_PATH.exists():
+        _save_json(USERS_META_PATH, {"users": []})
+
+
+def _load_json(path: Path, default):
+    if not path.exists():
+        return default
+    with path.open("r", encoding="utf-8") as f:
+        return json.load(f)
+
+
+def _save_json(path: Path, payload):
+    with data_file_lock:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        with path.open("w", encoding="utf-8") as f:
+            json.dump(payload, f, ensure_ascii=False, indent=2)
+
+
+def _safe_slug(text: str):
+    allowed = []
+    for ch in text:
+        if ch.isalnum() or ch in ("-", "_"):
+            allowed.append(ch)
+        else:
+            allowed.append("_")
+    slug = "".join(allowed).strip("_")
+    return slug or "user"
+
+
+def _hash_password(password: str, salt_hex: Optional[str] = None):
+    salt = bytes.fromhex(salt_hex) if salt_hex else secrets.token_bytes(16)
+    digest = hashlib.pbkdf2_hmac(
+        "sha256",
+        password.encode("utf-8"),
+        salt,
+        PASSWORD_ITERATIONS,
+    )
+    return {
+        "salt": salt.hex(),
+        "hash": digest.hex(),
+    }
+
+
+def _verify_password(password: str, salt_hex: str, expected_hash: str):
+    data = _hash_password(password, salt_hex=salt_hex)
+    return secrets.compare_digest(data["hash"], expected_hash)
+
+
+def _load_users_meta():
+    _ensure_data_layout()
+    raw = _load_json(USERS_META_PATH, {"users": []})
+    users = raw.get("users", []) if isinstance(raw, dict) else []
+    result = {}
+    for item in users:
+        username = str(item.get("username", "")).strip()
+        if username:
+            result[username] = item
+    return result
+
+
+def _save_users_meta(users_map: dict[str, dict[str, Any]]):
+    payload = {"users": sorted(users_map.values(), key=lambda x: x.get("username", ""))}
+    _save_json(USERS_META_PATH, payload)
+
+
+def _get_user_meta_or_404(username: str):
+    users_map = _load_users_meta()
+    user = users_map.get(username)
+    if not user:
+        raise HTTPException(status_code=404, detail="用户不存在")
+    return user
+
+
+def _get_tenant_dir(user_meta: dict[str, Any]):
+    tenant_rel = user_meta.get("tenant_dir", "")
+    if not tenant_rel:
+        raise RuntimeError(f"用户 {user_meta.get('username')} 缺少 tenant_dir")
+    return (BASE_DIR / tenant_rel).resolve()
+
+
+def _get_user_config_path(username: str):
+    user_meta = _get_user_meta_or_404(username)
+    return _get_tenant_dir(user_meta) / "config.json"
+
+
+def _get_user_data_path(username: str):
+    user_meta = _get_user_meta_or_404(username)
+    return _get_tenant_dir(user_meta) / "usersData.json"
+
+
+def _get_default_user_config():
+    if ROOT_CONFIG_PATH.exists():
+        try:
+            return _load_json(ROOT_CONFIG_PATH, DEFAULT_USER_CONFIG)
+        except Exception:
+            logger.warning("Failed to read root config.json. fallback to DEFAULT_USER_CONFIG")
+    return json.loads(json.dumps(DEFAULT_USER_CONFIG, ensure_ascii=False))
+
+
+def _load_user_config(username: str):
+    path = _get_user_config_path(username)
+    if not path.exists():
+        cfg = _get_default_user_config()
+        _save_json(path, cfg)
+        return cfg
+    return _load_json(path, _get_default_user_config())
+
+
+def _save_user_config(username: str, cfg: dict):
+    path = _get_user_config_path(username)
+    _save_json(path, cfg)
+
+
+def _load_user_users_data(username: str):
+    path = _get_user_data_path(username)
+    if not path.exists():
+        raise FileNotFoundError(f"用户 {username} 的 usersData.json 不存在")
+    data = _load_json(path, [])
+    if not isinstance(data, list):
+        raise ValueError("usersData.json 必须是数组")
+    return data
+
+
+def _save_user_users_data(username: str, users_data: list):
+    path = _get_user_data_path(username)
+    _save_json(path, users_data)
+
+
+def _sanitize_targets(values):
+    cleaned = []
+    seen = set()
+    for value in values or []:
+        text = str(value).strip()
+        if not text or text in seen:
+            continue
+        seen.add(text)
+        cleaned.append(text)
+    return cleaned
+
+
+def _validate_and_normalize_users_data(raw_bytes: bytes):
+    try:
+        payload = json.loads(raw_bytes.decode("utf-8"))
+    except Exception as exc:
+        raise ValueError(f"上传文件不是合法 JSON：{exc}")
+
+    if not isinstance(payload, list) or not payload:
+        raise ValueError("usersData.json 必须是非空数组")
+
+    normalized = []
+    for idx, item in enumerate(payload):
+        if not isinstance(item, dict):
+            raise ValueError(f"第 {idx + 1} 条用户数据格式错误（必须是对象）")
+
+        unique_id = str(item.get("unique_id", "")).strip()
+        username = str(item.get("username", "")).strip()
+        cookies = item.get("cookies", [])
+        targets = item.get("targets", [])
+
+        if not unique_id:
+            raise ValueError(f"第 {idx + 1} 条缺少 unique_id")
+        if not username:
+            raise ValueError(f"第 {idx + 1} 条缺少 username")
+        if not isinstance(cookies, list) or not cookies:
+            raise ValueError(f"第 {idx + 1} 条 cookies 不能为空且必须是数组")
+        if not isinstance(targets, list):
+            raise ValueError(f"第 {idx + 1} 条 targets 必须是数组")
+
+        normalized.append(
+            {
+                "unique_id": unique_id,
+                "username": username,
+                "cookies": cookies,
+                "targets": _sanitize_targets(targets),
+            }
+        )
+
+    primary_username = normalized[0]["username"]
+    primary_unique_id = normalized[0]["unique_id"]
+    return normalized, primary_username, primary_unique_id
+
+
+def _count_targets(users_data: list):
+    return sum(len(user.get("targets", [])) for user in users_data)
+
+
+def _get_runtime(username: str):
+    with runtime_map_lock:
+        runtime = runtime_map.get(username)
+        if runtime is None:
+            runtime = UserRuntimeState(username=username)
+            runtime_map[username] = runtime
+        return runtime
+
+
+def _delete_runtime(username: str):
+    with runtime_map_lock:
+        runtime_map.pop(username, None)
+
+
+def _session_from_request(request: Request):
+    token = request.cookies.get(SESSION_COOKIE_NAME)
+    if not token:
+        return None
+    return AUTH_SESSIONS.get(token)
+
+
+def _require_user_session(request: Request):
+    session = _session_from_request(request)
+    if not session or session.get("role") != "user":
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail="未登录或登录已失效",
+        )
+    return session
+
+
+def _require_admin_session(request: Request):
+    session = _session_from_request(request)
+    if not session or session.get("role") != "admin":
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail="未登录或登录已失效",
+        )
+    return session
+
+
+def _parse_time_string(value: str):
+    parts = value.strip().split(":")
+    if len(parts) not in (2, 3):
+        raise ValueError("时间格式错误，必须是 HH:MM")
+    hour = int(parts[0])
+    minute = int(parts[1])
+    if hour < 0 or hour > 23 or minute < 0 or minute > 59:
+        raise ValueError("时间范围错误，小时 0-23，分钟 0-59")
+    return hour, minute
+
+
+def _build_editor_state(username: str):
+    cfg = _load_user_config(username)
+    users = _load_user_users_data(username)
+    return {
+        "message_template": str(cfg.get("messageTemplate", "")),
+        "users": [
+            {
+                "unique_id": str(user.get("unique_id", "")),
+                "username": str(user.get("username", "未知用户")),
+                "targets": _sanitize_targets(user.get("targets", [])),
+            }
+            for user in users
+        ],
+    }
+
+
+def _scheduler_job_id(username: str):
+    return f"daily_task::{username}"
+
+
+def _run_scheduled_once(username: str):
+    runtime = _get_runtime(username)
+    runtime.run_once("schedule")
+    if scheduler:
+        job = scheduler.get_job(_scheduler_job_id(username))
+        runtime.update_next_run(job.next_run_time if job else None)
+
+
+async def _run_user_tasks(username: str):
+    cfg = _load_user_config(username)
+    users_data = _load_user_users_data(username)
+    await runTasks(config=cfg, userData=users_data)
+
+
+def _schedule_user_job(username: str):
+    global scheduler
+
+    cfg = _load_user_config(username)
+    scheduler_cfg = cfg.get("scheduler", {}) if isinstance(cfg, dict) else {}
+    enabled = bool(scheduler_cfg.get("enabled", True))
+    timezone = str(scheduler_cfg.get("timezone", DEFAULT_TIMEZONE))
+    hour = int(scheduler_cfg.get("hour", 9))
+    minute = int(scheduler_cfg.get("minute", 0))
+
+    runtime = _get_runtime(username)
+    runtime.update_schedule(hour, minute, timezone)
+
+    with scheduler_lock:
+        if scheduler is None:
+            scheduler = BackgroundScheduler(timezone=timezone)
+            scheduler.start()
+
+        job_id = _scheduler_job_id(username)
+        if not enabled:
+            if scheduler.get_job(job_id):
+                scheduler.remove_job(job_id)
+            runtime.update_next_run(None)
+            runtime.add_log("定时任务已禁用")
+            return
+
+        scheduler.add_job(
+            _run_scheduled_once,
+            args=[username],
+            trigger=CronTrigger(hour=hour, minute=minute, timezone=timezone),
+            id=job_id,
+            replace_existing=True,
+            max_instances=1,
+            coalesce=True,
+        )
+        job = scheduler.get_job(job_id)
+        runtime.update_next_run(job.next_run_time if job else None)
+        runtime.add_log(f"定时任务更新为 {hour:02d}:{minute:02d} ({timezone})")
+
+
+def _remove_user_schedule_job(username: str):
+    with scheduler_lock:
+        if scheduler is None:
+            return
+        job_id = _scheduler_job_id(username)
+        if scheduler.get_job(job_id):
+            scheduler.remove_job(job_id)
+
+
+def _start_background_run(username: str, trigger: str):
+    runtime = _get_runtime(username)
+
+    def _worker():
+        runtime.run_once(trigger)
+        if scheduler:
+            job = scheduler.get_job(_scheduler_job_id(username))
+            runtime.update_next_run(job.next_run_time if job else None)
+
+    thread = threading.Thread(target=_worker, daemon=True)
+    thread.start()
+    return True
+
+
+def _start_scheduler():
+    global scheduler
+    _ensure_data_layout()
+    with scheduler_lock:
+        if scheduler is None:
+            scheduler = BackgroundScheduler(timezone=DEFAULT_TIMEZONE)
+            scheduler.start()
+
+    users_map = _load_users_meta()
+    for username in users_map.keys():
+        _schedule_user_job(username)
+        cfg = _load_user_config(username)
+        run_on_startup = bool(cfg.get("scheduler", {}).get("runOnStartup", False))
+        if run_on_startup:
+            _start_background_run(username, "startup")
+
+
+def _stop_scheduler():
+    global scheduler
+    with scheduler_lock:
+        if scheduler and scheduler.running:
+            scheduler.shutdown(wait=False)
+            logger.info("Scheduler stopped.")
+        scheduler = None
+
+
+app = FastAPI(title="DouYin Spark Flow Dashboard")
+app.mount("/static", StaticFiles(directory=str(STATIC_DIR)), name="static")
+templates = Jinja2Templates(directory=str(TEMPLATES_DIR))
+
+
+@app.on_event("startup")
+async def on_startup():
+    _ensure_data_layout()
+    _start_scheduler()
+    atexit.register(_stop_scheduler)
+
+
+@app.on_event("shutdown")
+async def on_shutdown():
+    _stop_scheduler()
+
+
+@app.get("/", response_class=HTMLResponse)
+async def dashboard(request: Request):
+    session = _session_from_request(request)
+    if not session:
+        return RedirectResponse(url="/login", status_code=303)
+    if session.get("role") == "admin":
+        return RedirectResponse(url="/admin", status_code=303)
+
+    username = session.get("username")
+    runtime = _get_runtime(username)
+    return templates.TemplateResponse(
+        "dashboard.html",
+        {
+            "request": request,
+            "default_time": runtime.schedule_time(),
+            "username": username,
+        },
+    )
+
+
+@app.get("/login", response_class=HTMLResponse)
+async def login_page(request: Request):
+    session = _session_from_request(request)
+    if session:
+        if session.get("role") == "admin":
+            return RedirectResponse(url="/admin", status_code=303)
+        return RedirectResponse(url="/", status_code=303)
+    return templates.TemplateResponse("login.html", {"request": request})
+
+
+@app.get("/register", response_class=HTMLResponse)
+async def register_page(request: Request):
+    session = _session_from_request(request)
+    if session:
+        if session.get("role") == "admin":
+            return RedirectResponse(url="/admin", status_code=303)
+        return RedirectResponse(url="/", status_code=303)
+    return templates.TemplateResponse("register.html", {"request": request})
+
+
+@app.get("/admin", response_class=HTMLResponse)
+async def admin_page(request: Request):
+    session = _session_from_request(request)
+    if not session or session.get("role") != "admin":
+        return templates.TemplateResponse(
+            "admin_login.html",
+            {
+                "request": request,
+                "password_missing": not bool(os.getenv("PASSWORD")),
+            },
+        )
+    return templates.TemplateResponse("admin.html", {"request": request})
+
+
+@app.post("/api/login")
+async def api_login(payload: UserLoginPayload):
+    username = payload.username.strip()
+    if not username:
+        return JSONResponse(status_code=400, content={"ok": False, "message": "用户名不能为空。"})
+
+    users_map = _load_users_meta()
+    user = users_map.get(username)
+    if not user:
+        return JSONResponse(status_code=401, content={"ok": False, "message": "用户名或密码错误。"})
+
+    if not _verify_password(payload.password, user.get("password_salt", ""), user.get("password_hash", "")):
+        return JSONResponse(status_code=401, content={"ok": False, "message": "用户名或密码错误。"})
+
+    token = secrets.token_urlsafe(32)
+    AUTH_SESSIONS[token] = {"role": "user", "username": username}
+
+    response = JSONResponse({"ok": True, "message": "登录成功。"})
+    response.set_cookie(
+        key=SESSION_COOKIE_NAME,
+        value=token,
+        httponly=True,
+        samesite="lax",
+        max_age=7 * 24 * 3600,
+    )
+    return response
+
+
+@app.post("/api/admin/login")
+async def api_admin_login(payload: AdminLoginPayload):
+    expected_password = os.getenv("PASSWORD")
+    if not expected_password:
+        return JSONResponse(
+            status_code=500,
+            content={"ok": False, "message": "服务端未配置 PASSWORD 环境变量。"},
+        )
+
+    if payload.password != expected_password:
+        return JSONResponse(status_code=401, content={"ok": False, "message": "密码错误。"})
+
+    token = secrets.token_urlsafe(32)
+    AUTH_SESSIONS[token] = {"role": "admin", "username": "admin"}
+    response = JSONResponse({"ok": True, "message": "登录成功。"})
+    response.set_cookie(
+        key=SESSION_COOKIE_NAME,
+        value=token,
+        httponly=True,
+        samesite="lax",
+        max_age=7 * 24 * 3600,
+    )
+    return response
+
+
+@app.post("/api/register")
+async def api_register(password: str = Form(...), users_file: UploadFile = File(...)):
+    if len(password.strip()) < 4:
+        return JSONResponse(status_code=400, content={"ok": False, "message": "密码至少 4 位。"})
+
+    if not users_file.filename.lower().endswith(".json"):
+        return JSONResponse(status_code=400, content={"ok": False, "message": "请上传 usersData.json 文件。"})
+
+    try:
+        raw = await users_file.read()
+        users_data, username, unique_id = _validate_and_normalize_users_data(raw)
+    except Exception as exc:
+        return JSONResponse(status_code=400, content={"ok": False, "message": str(exc)})
+
+    users_map = _load_users_meta()
+    if username in users_map:
+        return JSONResponse(status_code=409, content={"ok": False, "message": f"用户名 {username} 已注册。"})
+
+    for existing in users_map.values():
+        if str(existing.get("unique_id", "")).strip() == unique_id:
+            return JSONResponse(status_code=409, content={"ok": False, "message": f"unique_id {unique_id} 已注册。"})
+
+    tenant_slug = _safe_slug(f"{username}_{unique_id}_{secrets.token_hex(3)}")
+    tenant_dir = TENANTS_DIR / tenant_slug
+    tenant_dir.mkdir(parents=True, exist_ok=True)
+
+    _save_json(tenant_dir / "usersData.json", users_data)
+    default_config = _get_default_user_config()
+    default_config.setdefault("scheduler", {})
+    default_config["scheduler"].setdefault("enabled", True)
+    default_config["scheduler"].setdefault("timezone", DEFAULT_TIMEZONE)
+    default_config["scheduler"].setdefault("hour", 9)
+    default_config["scheduler"].setdefault("minute", 0)
+    default_config["scheduler"].setdefault("runOnStartup", False)
+    _save_json(tenant_dir / "config.json", default_config)
+
+    hash_data = _hash_password(password.strip())
+    users_map[username] = {
+        "username": username,
+        "unique_id": unique_id,
+        "password_hash": hash_data["hash"],
+        "password_salt": hash_data["salt"],
+        "tenant_dir": str(tenant_dir.relative_to(BASE_DIR)).replace("\\", "/"),
+        "created_at": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
+    }
+    _save_users_meta(users_map)
+
+    _schedule_user_job(username)
+    _get_runtime(username).add_log("用户已注册并完成定时任务初始化")
+
+    return {
+        "ok": True,
+        "message": "注册成功，请使用用户名和密码登录。",
+        "username": username,
+    }
+
+
+@app.post("/api/logout")
+async def api_logout(request: Request):
+    token = request.cookies.get(SESSION_COOKIE_NAME)
+    if token:
+        AUTH_SESSIONS.pop(token, None)
+    response = JSONResponse({"ok": True})
+    response.delete_cookie(SESSION_COOKIE_NAME)
+    return response
+
+
+@app.get("/api/status")
+async def api_status(request: Request):
+    session = _require_user_session(request)
+    username = session["username"]
+    runtime = _get_runtime(username)
+    users_data = _load_user_users_data(username)
+    return {
+        "ok": True,
+        "runtime": runtime.snapshot(
+            account_count=len(users_data),
+            target_count=_count_targets(users_data),
+        ),
+        "history": runtime.history_rows(),
+    }
+
+
+@app.get("/api/logs")
+async def api_logs(request: Request, limit: int = MAX_LOG_LINES):
+    session = _require_user_session(request)
+    username = session["username"]
+    runtime = _get_runtime(username)
+    limit = min(max(100, limit), 3000)
+    return {"ok": True, "logs": runtime.recent_logs(limit=limit)}
+
+
+@app.post("/api/run")
+async def api_run(request: Request):
+    session = _require_user_session(request)
+    username = session["username"]
+    runtime = _get_runtime(username)
+
+    if runtime.is_running:
+        return JSONResponse(
+            status_code=409,
+            content={"ok": False, "message": "已有任务正在执行，请稍后再试。"},
+        )
+
+    _start_background_run(username, "manual")
+    return {"ok": True, "message": "任务已开始执行。"}
+
+
+@app.post("/api/schedule")
+async def api_schedule(request: Request, payload: SchedulePayload):
+    session = _require_user_session(request)
+    username = session["username"]
+
+    try:
+        hour, minute = _parse_time_string(payload.time)
+    except Exception as exc:
+        return JSONResponse(status_code=400, content={"ok": False, "message": str(exc)})
+
+    cfg = _load_user_config(username)
+    scheduler_cfg = cfg.setdefault("scheduler", {})
+    scheduler_cfg["enabled"] = True
+    scheduler_cfg["hour"] = hour
+    scheduler_cfg["minute"] = minute
+    scheduler_cfg["timezone"] = str(scheduler_cfg.get("timezone", DEFAULT_TIMEZONE))
+    scheduler_cfg["runOnStartup"] = bool(scheduler_cfg.get("runOnStartup", False))
+    _save_user_config(username, cfg)
+
+    _schedule_user_job(username)
+    runtime = _get_runtime(username)
+    return {
+        "ok": True,
+        "message": f"定时任务已更新为每天 {hour:02d}:{minute:02d}。",
+        "time": f"{hour:02d}:{minute:02d}",
+        "next_run": runtime.snapshot(0, 0)["next_run"],
+    }
+
+
+@app.get("/api/editor/state")
+async def api_editor_state(request: Request):
+    session = _require_user_session(request)
+    username = session["username"]
+    return {"ok": True, **_build_editor_state(username)}
+
+
+@app.post("/api/editor/message")
+async def api_editor_message(request: Request, payload: MessageTemplatePayload):
+    session = _require_user_session(request)
+    username = session["username"]
+
+    message = payload.message.strip()
+    if not message:
+        return JSONResponse(status_code=400, content={"ok": False, "message": "消息内容不能为空。"})
+    if len(message) > MAX_TEMPLATE_LENGTH:
+        return JSONResponse(
+            status_code=400,
+            content={"ok": False, "message": f"消息内容过长，最多 {MAX_TEMPLATE_LENGTH} 字符。"},
+        )
+
+    cfg = _load_user_config(username)
+    cfg["messageTemplate"] = message
+    _save_user_config(username, cfg)
+    _get_runtime(username).add_log("消息模板已更新")
+    return {"ok": True, "message": "消息模板已保存。"}
+
+
+@app.post("/api/editor/targets")
+async def api_editor_targets(request: Request, payload: UserTargetsPayload):
+    session = _require_user_session(request)
+    username = session["username"]
+
+    users_data = _load_user_users_data(username)
+    updates = {item.unique_id: _sanitize_targets(item.targets) for item in payload.users}
+
+    updated = 0
+    for user in users_data:
+        uid = str(user.get("unique_id", ""))
+        if uid in updates:
+            user["targets"] = updates[uid]
+            updated += 1
+
+    _save_user_users_data(username, users_data)
+    _get_runtime(username).add_log(f"目标好友已更新，涉及账号数：{updated}")
+    return {"ok": True, "message": f"目标好友已保存（{updated} 个账号）。"}
+
+
+@app.get("/api/admin/overview")
+async def api_admin_overview(request: Request):
+    _require_admin_session(request)
+    users_map = _load_users_meta()
+
+    rows = []
+    for username, meta in sorted(users_map.items(), key=lambda x: x[0]):
+        try:
+            cfg = _load_user_config(username)
+            users_data = _load_user_users_data(username)
+        except Exception as exc:
+            rows.append(
+                {
+                    "username": username,
+                    "unique_id": meta.get("unique_id", ""),
+                    "created_at": meta.get("created_at", "-"),
+                    "error": str(exc),
+                }
+            )
+            continue
+
+        scheduler_cfg = cfg.get("scheduler", {})
+        runtime = _get_runtime(username)
+        runtime_snapshot = runtime.snapshot(
+            account_count=len(users_data),
+            target_count=_count_targets(users_data),
+        )
+
+        receivers = []
+        for item in users_data:
+            receivers.extend(item.get("targets", []))
+
+        rows.append(
+            {
+                "username": username,
+                "unique_id": meta.get("unique_id", ""),
+                "created_at": meta.get("created_at", "-"),
+                "scheduler_enabled": bool(scheduler_cfg.get("enabled", True)),
+                "schedule_time": f"{int(scheduler_cfg.get('hour', 9)):02d}:{int(scheduler_cfg.get('minute', 0)):02d}",
+                "schedule_timezone": str(scheduler_cfg.get("timezone", DEFAULT_TIMEZONE)),
+                "message_template": str(cfg.get("messageTemplate", "")),
+                "targets": receivers,
+                "target_count": len(receivers),
+                "next_run": runtime_snapshot.get("next_run", "-"),
+                "last_status": runtime_snapshot.get("last_status", "-"),
+                "last_start": runtime_snapshot.get("last_start", "-"),
+                "is_running": runtime_snapshot.get("is_running", False),
+            }
+        )
+
+    return {
+        "ok": True,
+        "users": rows,
+        "task_count": len(rows),
+    }
+
+
+@app.post("/api/admin/tasks/{username}/delete")
+async def api_admin_delete_task(request: Request, username: str):
+    _require_admin_session(request)
+    username = username.strip()
+    _get_user_meta_or_404(username)
+
+    cfg = _load_user_config(username)
+    scheduler_cfg = cfg.setdefault("scheduler", {})
+    scheduler_cfg["enabled"] = False
+    _save_user_config(username, cfg)
+
+    _remove_user_schedule_job(username)
+    runtime = _get_runtime(username)
+    runtime.update_next_run(None)
+    runtime.add_log("管理员已删除（禁用）该用户定时任务")
+
+    return {"ok": True, "message": f"已删除用户 {username} 的定时任务。"}
+
+
+@app.delete("/api/admin/users/{username}")
+async def api_admin_delete_user(request: Request, username: str):
+    _require_admin_session(request)
+    username = username.strip()
+
+    users_map = _load_users_meta()
+    user = users_map.get(username)
+    if not user:
+        return JSONResponse(status_code=404, content={"ok": False, "message": "用户不存在。"})
+
+    _remove_user_schedule_job(username)
+    tenant_dir = _get_tenant_dir(user)
+    if tenant_dir.exists():
+        shutil.rmtree(tenant_dir, ignore_errors=True)
+
+    users_map.pop(username, None)
+    _save_users_meta(users_map)
+    _delete_runtime(username)
+
+    return {"ok": True, "message": f"用户 {username} 已删除。"}
+
+
+@app.get("/health")
+async def health():
+    return {"ok": True, "status": "alive"}
+
+
+def run_server():
+    port = int(os.getenv("PORT", "7860"))
+    uvicorn.run("app:app", host="0.0.0.0", port=port, workers=1)
+
+
+if __name__ == "__main__":
+    run_server()

config.json

@@ -0,0 +1,23 @@
+{
+  "multiTask": true,
+  "taskCount": 5,
+  "proxyAddress": "",
+  "messageTemplate": "续火花！！！",
+  "hitokotoTypes": [
+    "文学",
+    "影视",
+    "诗词",
+    "哲学"
+  ],
+  "happyNewYear": {
+    "enabled": true,
+    "messageTemplate": "续火花！！！"
+  },
+  "scheduler": {
+    "enabled": true,
+    "timezone": "Asia/Shanghai",
+    "hour": 9,
+    "minute": 0,
+    "runOnStartup": false
+  }
+}

core/browser.py

@@ -0,0 +1,70 @@
+import os
+import sys
+import traceback
+from pathlib import Path
+
+from playwright.async_api import async_playwright
+from rich.console import Console
+
+from utils.config import DEBUG, Environment, get_environment
+
+
+PLAYWRIGHT_BROWSERS_PATH = "../chrome"
+console = Console()
+
+
+def _looks_like_bundled_windows_playwright(path: Path):
+    if not path.exists():
+        return False
+    return any(p.name.startswith("chromium-") for p in path.iterdir())
+
+
+def _configure_playwright_browser_path(env: Environment):
+    # Respect explicit runtime override first.
+    if os.getenv("PLAYWRIGHT_BROWSERS_PATH"):
+        return
+
+    # Hugging Face Docker should use browsers installed in the image.
+    if env == Environment.HUGGINGFACE:
+        return
+
+    # Local mode may have a bundled playwright browser directory.
+    if env == Environment.LOCAL:
+        bundled = Path(__file__).resolve().parent / PLAYWRIGHT_BROWSERS_PATH
+        # The repo bundles Windows binaries only. Avoid forcing this path on Linux/macOS.
+        if os.name == "nt" and _looks_like_bundled_windows_playwright(bundled):
+            os.environ["PLAYWRIGHT_BROWSERS_PATH"] = str(bundled.resolve())
+        return
+
+    # Packed mode keeps runtime assets near executable.
+    if env == Environment.PACKED:
+        packed = Path(sys.executable).resolve().parent / PLAYWRIGHT_BROWSERS_PATH
+        if packed.exists():
+            os.environ["PLAYWRIGHT_BROWSERS_PATH"] = str(packed.resolve())
+
+
+async def get_browser(GUI=False):
+    headless = True
+    env = get_environment()
+    _configure_playwright_browser_path(env)
+
+    if env == Environment.LOCAL and DEBUG:
+        headless = False
+    if GUI:
+        headless = False
+
+    try:
+        playwright = await async_playwright().start()
+        browser = await playwright.chromium.launch(
+            headless=headless,
+            args=[
+                "--no-sandbox",
+                "--disable-dev-shm-usage",
+                "--disable-gpu",
+            ],
+        )
+        return playwright, browser
+    except Exception:
+        traceback.print_exc()
+        raise
+

core/login.py

@@ -0,0 +1,87 @@
+import asyncio
+import json
+import os
+from rich.console import Console
+from core.browser import get_browser
+
+xpaths = {
+    "unique_id": """xpath=//*[contains(@id, "garfish_app_for_douyin_creator_pc_home")]/div/div[2]/div/div[2]/div[1]/div[2]/div[1]/div[3]""",
+    "name": """xpath=//*[contains(@id, "garfish_app_for_douyin_creator_pc_home")]/div/div[2]/div/div[2]/div[1]/div[2]/div[1]/div[1]/div[1]""",
+}
+
+console = Console()
+
+
+async def userLogin():
+    playwright, browser = await get_browser(GUI=True)
+    try:
+        context = await browser.new_context()
+        page = await context.new_page()
+
+        # 打开目标页面
+        await page.goto("https://creator.douyin.com/")
+
+        print("请手动登录抖音创作者中心")
+
+        # 等待页面跳转或特定元素出现
+        # 等待 XPath 元素加载完成
+        await page.wait_for_selector(
+            'xpath=//*[contains(@id, "garfish_app_for_douyin_creator_pc_home")]/div/div[2]/div/div[2]/div[1]',
+            timeout=300000,  # 设置输入超时时间为 5 分钟
+        )
+
+        # 等待 unique_id 元素加载完成
+        unique_id_element = await page.wait_for_selector(xpaths["unique_id"])
+        unique_id = (await unique_id_element.inner_text())[
+            4:
+        ]  # 去掉前四个字符 "抖音号："
+        print("Unique ID:", unique_id)
+
+        # 等待 name 元素加载完成
+        name_element = await page.wait_for_selector(xpaths["name"])
+        username = await name_element.inner_text()
+        print("Name:", username)
+
+        # 获取所有 Cookie
+        cookies = await context.cookies()
+        print("Cookies:", f"找到 {len(cookies)} 条 Cookie")
+
+        if os.path.exists("usersData.json"):
+            with open("usersData.json", "r", encoding="utf-8") as f:
+                userdata = json.load(f)
+        else:
+            userdata = []
+
+        targets = input(
+            "点击互动管理->私信管理->朋友私信，查看并输入目标好友对应昵称（空格分割）"
+        )
+
+        for user in userdata:
+            if user["unique_id"] == unique_id:
+                print(f"用户 {unique_id} 已存在，更新信息。")
+                user["cookies"] = cookies
+                user["username"] = username
+                user["targets"] = [target.strip() for target in targets.split(" ")]
+                break
+        else:
+            print(f"添加新用户 {unique_id} 。")
+            userdata.append(
+                {
+                    "unique_id": unique_id,
+                    "username": username,
+                    "cookies": cookies,
+                    "targets": [target.strip() for target in targets.split(" ")],
+                }
+            )
+
+        with open("usersData.json", "w", encoding="utf-8") as f:
+            json.dump(userdata, f, ensure_ascii=False, indent=4)
+
+        console.print(f"[bold green]登录完成！已添加用户 {username}[/bold green]")
+    finally:
+        await playwright.stop()
+        await browser.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(userLogin())

core/msg_builder.py

@@ -0,0 +1,18 @@
+"""
+core/msg_builder.py
+解析消息模板构建具体发送的消息内容
+"""
+
+from typing import Optional
+
+from utils.config import get_config
+from utils.hitokoto import request_hitokoto
+
+
+def build_message(config: Optional[dict] = None) -> str:
+    active_config = config or get_config()
+    message = active_config.get("messageTemplate", "续火花")
+    if "[API]" in message:
+        api_content = request_hitokoto()
+        message = message.replace("[API]", api_content)
+    return message.strip()

core/tasks.py

@@ -0,0 +1,237 @@
+import asyncio
+import traceback
+import logging
+from utils.logger import setup_logger
+from utils.config import get_config, get_userData, reload_config, reload_userData
+from core.msg_builder import build_message
+from core.browser import get_browser
+
+
+complates = {}
+
+logger = setup_logger(level=logging.DEBUG)
+
+
+async def retry_operation(name, operation, retries=3, delay=2, *args, **kwargs):
+    """
+    通用的重试逻辑
+    :param name: 操作名称（用于日志记录）
+    :param operation: 要执行的异步操作
+    :param retries: 最大重试次数
+    :param delay: 每次重试之间的延迟（秒）
+    :param args: 传递给操作的参数
+    :param kwargs: 传递给操作的关键字参数
+    """
+    for attempt in range(retries):
+        try:
+            return await operation(*args, **kwargs)
+        except Exception as e:
+            if attempt < retries - 1:
+                logger.warning(f"{name} 失败，正在重试第 {attempt + 1} 次，错误：{e}")
+                await asyncio.sleep(delay)
+            else:
+                logger.error(f"{name} 失败，已达到最大重试次数，错误：{e}")
+                raise
+
+
+async def scroll_and_select_user(page, username, targets):
+    """尝试滚动并查找用户名"""
+    # 定义目标元素和滚动容器的选择器
+    friends_tab_selector = 'xpath=//*[@id="sub-app"]/div/div/div[1]/div[2]'
+    target_selector = 'xpath=//*[@id="sub-app"]/div/div[1]/div[2]/div[2]//div[contains(@class, "semi-list-item-body semi-list-item-body-flex-start")]'
+    scrollable_friends_selector = 'xpath=//*[@id="sub-app"]/div/div[1]/div[2]/div[2]/div/div/div[3]/div/div/div/ul/div'
+    
+    # [修改] 更加精确的状态选择器
+    no_more_selector = 'xpath=//div[contains(@class, "no-more-tip-ftdJnu")]'
+    loading_selector = 'xpath=//div[contains(@class, "semi-spin")]'
+
+    logger.debug(f"账号 {username} 开始查找目标好友列表")
+    logger.debug(f"账号 {username} 目标好友列表: {targets}")
+
+    logger.debug(f"账号 {username} 点击进入好友标签页")
+    # 点击好友标签页
+    await page.wait_for_selector(friends_tab_selector)
+    await page.locator(friends_tab_selector).click()
+
+    logger.debug(f"账号 {username} 进入好友列表页面")
+
+    # 确保第一个好友元素加载完成
+    first_friend_selector = 'xpath=//*[@id="sub-app"]/div/div/div[2]/div[2]/div/div/div[1]/div/div/div/ul/div/div/div[1]/li/div'
+    await page.wait_for_selector(first_friend_selector)
+    await page.locator(first_friend_selector).click()  # 点击第一个好友，确保列表激活
+
+    logger.debug(f"账号 {username} 已激活好友列表，开始滚动查找目标好友")
+
+    await asyncio.sleep(2)  # 等待好友列表加载
+
+    found_usernames = set()
+    # [修改] 复制一份目标列表用于追踪进度
+    remaining_targets = set(targets)
+
+    while True:
+        # 查找所有目标元素
+        target_elements = await page.locator(target_selector).all()
+
+        for element in target_elements:
+            try:
+                # 查找子元素 span，模糊匹配 class
+                span = element.locator(
+                    """xpath=.//span[contains(@class, "item-header-name-")]"""
+                )
+                targetName = await span.inner_text()
+
+                if targetName in found_usernames:
+                    continue  # 已处理过，跳过
+                found_usernames.add(targetName)
+
+                logger.debug(f"账号 {username} 找到好友 {targetName}")
+                # 检查是否是目标用户名
+                if targetName in targets:
+                    await element.click()
+                    logger.info(
+                        f"账号 {username} 选中目标好友 {targetName} 准备开始交互"
+                    )
+                    yield targetName
+                    
+                    # [修改] 标记已找到，如果全找到了直接退出
+                    if targetName in remaining_targets:
+                        remaining_targets.remove(targetName)
+                    if len(remaining_targets) == 0:
+                        logger.info(f"账号 {username} 所有目标好友均已找到，停止搜索")
+                        return
+                    break
+            except Exception as e:
+                traceback.print_exc()
+        else:
+            # [修改] 状态检测逻辑
+            
+            # 1. 检查是否到底（没有更多了）
+            if await page.locator(no_more_selector).count() > 0:
+                logger.info(f"账号 {username} 检测到'没有更多了'标志，已到达底部")
+                if len(remaining_targets) > 0:
+                    logger.warning(f"账号 {username} 搜索结束，仍有以下好友未找到: {remaining_targets}")
+                break
+
+            # 2. 检查是否正在���载
+            if await page.locator(loading_selector).count() > 0:
+                logger.debug(f"账号 {username} 列表正在加载中 (Loading)...")
+                await asyncio.sleep(1.5) # 给加载留点时间
+                # 不 break，继续去滚动以触发后续内容
+
+            # 3. 滚动容器
+            scrollable_element = await page.locator(
+                scrollable_friends_selector
+            ).element_handle()
+            
+            if scrollable_element:
+                # [修改] 加大滚动幅度
+                await page.evaluate(
+                    "(element) => element.scrollTop += 800", scrollable_element
+                )
+                logger.debug(f"账号 {username} 滚动好友列表以加载更多好友")
+                await asyncio.sleep(1.5)
+            else:
+                logger.error(f"账号 {username} 未找到滚动容器，退出")
+                break
+
+
+async def do_user_task(browser, username, cookies, targets, semaphore, config):
+    async with semaphore:  # 使用信号量控制并发数量
+        context = await browser.new_context()  # 每个任务使用独立的上下文
+        context.set_default_navigation_timeout(120000)  # 设置导航超时时间为 90 秒
+        context.set_default_timeout(120000)  # 设置所有操作的默认超时时间为 120 秒
+
+        page = await context.new_page()
+        # 打开抖音创作者中心
+        await retry_operation(
+            "打开抖音创作者中心",
+            page.goto,
+            retries=3,
+            delay=5,
+            url="https://creator.douyin.com/",
+        )
+        # 注入 Cookie
+        await context.add_cookies(cookies)
+
+        # 导航到消息页面
+        await retry_operation(
+            "导航到消息页面",
+            page.goto,
+            retries=3,
+            delay=5,
+            url="https://creator.douyin.com/creator-micro/data/following/chat",
+        )
+
+        logger.info(f"账号 {username} 开始发送消息")
+        # 滚动并选择用户
+        async for _target_name in scroll_and_select_user(page, username, targets):
+            logger.info(f"账号 {username} 已选中好友 {username} 发送消息")
+            # 等待 chat-input-dccKiL 元素加载完成
+            chat_input_selector = "xpath=//div[contains(@class, 'chat-input-dccKiL')]"
+            await page.wait_for_selector(chat_input_selector)
+            chat_input = page.locator(chat_input_selector)
+
+            # 在 chat-input-dccKiL 中输入内容
+            message = build_message(config=config)
+            for line in message.split("\n"):
+                await chat_input.type(line)  # 输入每一行
+                # 如果不是最后一行，模拟 Shift+Enter 插入换行
+                if line != message.split("\n")[-1]:
+                    await chat_input.press("Shift+Enter")  # 模拟 Shift+Enter 插入换行
+
+            logger.debug(
+                f"账号 {username} 准备发送消息给好友 {username}：\n\t{message}"
+            )
+            logger.info(f"账号 {username} 给好友 {username} 发送消息完成")
+            # 模拟按下回车键发送消息
+            await chat_input.press("Enter")
+            await asyncio.sleep(2)  # 发送完等待一会儿
+
+        await context.close()  # 任务完成后关闭上下文
+
+
+async def runTasks(config=None, userData=None):
+    active_config = config if config is not None else reload_config()
+    active_user_data = userData if userData is not None else reload_userData()
+    playwright, browser = await get_browser()
+    try:
+        # 检查是否启用多任务和任务数量
+        # 创建信号量以限制并发任务数量
+        logger.info("开始执行任务,当前配置如下：")
+        multi_task = bool(active_config.get("multiTask", True))
+        task_count = int(active_config.get("taskCount", 1) or 1)
+        logger.info(f"多任务模式: {multi_task}, 任务数量: {task_count}")
+        logger.info(f"消息模板: {active_config.get('messageTemplate', '')}")
+        logger.info(f"一言类型: {active_config.get('hitokotoTypes', [])}")
+        for user in active_user_data:
+            logger.info(
+                f"用户: {user.get('username', '未知用户')}, 目标好友: {user.get('targets', [])}"
+            )
+            
+        semaphore = asyncio.Semaphore(task_count if multi_task else 1)
+
+        tasks = []
+        for user in active_user_data:
+            cookies = user.get("cookies", [])
+            targets = user.get("targets", [])
+            unique_id = user.get("unique_id", "")
+            if not cookies:
+                logger.warning("用户 %s 缺少 cookies，已跳过。", user.get("username", "未知用户"))
+                continue
+            complates[unique_id] = []  # 初始化该用户的已完成列表
+            username = user.get("username", "未知用户")
+            # 创建任务
+            tasks.append(
+                do_user_task(browser, username, cookies, targets, semaphore, active_config)
+            )
+
+        # 并发执行任务
+        if tasks:
+            await asyncio.gather(*tasks)
+        else:
+            logger.warning("没有可执行的任务（用户数据为空或均缺少 cookies）。")
+    finally:
+        await playwright.stop()
+
+        # 关闭浏览器实例
+        await browser.close()

main.py

@@ -0,0 +1,26 @@
+import argparse
+import asyncio
+
+from core.tasks import runTasks
+
+
+def main():
+    parser = argparse.ArgumentParser(description="DouYin Spark Flow")
+    parser.add_argument(
+        "--doTask",
+        action="store_true",
+        help="Run tasks once and exit.",
+    )
+    args = parser.parse_args()
+
+    if args.doTask:
+        asyncio.run(runTasks())
+        return
+
+    from app import run_server
+
+    run_server()
+
+
+if __name__ == "__main__":
+    main()

requirements.txt

@@ -0,0 +1,20 @@
+certifi==2025.11.12
+charset-normalizer==3.4.4
+colorama==0.4.6
+APScheduler>=3.10,<4
+fastapi>=0.115,<1
+uvicorn[standard]>=0.30,<1
+jinja2>=3.1,<4
+greenlet==3.2.4
+idna==3.11
+markdown-it-py==4.0.0
+mdurl==0.1.2
+playwright==1.56.0
+pyee==13.0.0
+pyperclip==1.11.0
+Pygments==2.19.2
+qrcode==8.2
+requests==2.32.5
+rich==14.2.0
+typing_extensions==4.15.0
+urllib3==2.5.0

static/style.css

@@ -0,0 +1,447 @@
+:root {
+  --bg-1: #edf5ef;
+  --bg-2: #f8efe6;
+  --ink: #1f2d2b;
+  --muted: #5d6f6b;
+  --line: #d2dfda;
+  --panel: #ffffff;
+  --brand: #106d5d;
+  --brand-deep: #0b5347;
+  --danger: #b9402b;
+  --shadow: 0 14px 30px rgba(16, 83, 71, 0.12);
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  color: var(--ink);
+  font-family: "PingFang SC", "Microsoft YaHei", "Noto Sans SC", sans-serif;
+  background:
+    radial-gradient(1200px 600px at 10% 0%, #d9f0e8 0%, transparent 70%),
+    radial-gradient(900px 500px at 100% 10%, #fae6d3 0%, transparent 68%),
+    linear-gradient(180deg, var(--bg-1), var(--bg-2));
+}
+
+.topbar {
+  max-width: 1180px;
+  margin: 28px auto 16px;
+  padding: 18px 22px;
+  border-radius: 16px;
+  background: linear-gradient(120deg, #0f6959 0%, #157a67 55%, #1f8b73 100%);
+  color: #fff;
+  box-shadow: 0 18px 36px rgba(15, 105, 89, 0.24);
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 16px;
+}
+
+.topbar h1 {
+  margin: 0;
+  font-size: 28px;
+}
+
+.topbar p {
+  margin: 6px 0 0;
+  opacity: 0.92;
+}
+
+.container {
+  max-width: 1180px;
+  margin: 0 auto 40px;
+  display: grid;
+  gap: 14px;
+}
+
+.panel,
+.card,
+.login-card {
+  background: var(--panel);
+  border: 1px solid var(--line);
+  border-radius: 14px;
+  box-shadow: var(--shadow);
+}
+
+.panel {
+  padding: 16px;
+}
+
+.panel h2 {
+  margin: 0 0 12px;
+  font-size: 19px;
+}
+
+.panel-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  margin-bottom: 10px;
+}
+
+.quick {
+  border-left: 5px solid #17856f;
+}
+
+.status-row {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  margin-bottom: 12px;
+}
+
+.status-label {
+  color: var(--muted);
+  font-size: 14px;
+}
+
+.badge {
+  display: inline-flex;
+  align-items: center;
+  border-radius: 999px;
+  font-size: 12px;
+  font-weight: 700;
+  padding: 4px 12px;
+}
+
+.badge.running {
+  color: #8a3c0a;
+  background: #fde3cd;
+}
+
+.badge.idle {
+  color: #0d5d4f;
+  background: #d8f2ec;
+}
+
+.control-grid {
+  display: grid;
+  grid-template-columns: minmax(220px, 320px) 140px 180px;
+  gap: 10px;
+  align-items: end;
+}
+
+.field {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.field label {
+  font-size: 13px;
+  color: var(--muted);
+}
+
+input[type="time"],
+input[type="password"],
+input[type="text"],
+input[type="file"] {
+  width: 100%;
+  border: 1px solid #bfd2cc;
+  border-radius: 10px;
+  padding: 10px 11px;
+  font-size: 14px;
+  background: #fbfffd;
+  color: var(--ink);
+}
+
+textarea {
+  width: 100%;
+  border: 1px solid #bfd2cc;
+  border-radius: 10px;
+  padding: 10px 11px;
+  font-size: 14px;
+  background: #fbfffd;
+  color: var(--ink);
+  resize: vertical;
+  min-height: 110px;
+  font-family: inherit;
+}
+
+input:focus {
+  outline: none;
+  border-color: #34a48e;
+  box-shadow: 0 0 0 3px rgba(52, 164, 142, 0.18);
+}
+
+textarea:focus {
+  outline: none;
+  border-color: #34a48e;
+  box-shadow: 0 0 0 3px rgba(52, 164, 142, 0.18);
+}
+
+.btn {
+  border: 1px solid #95b8af;
+  background: #f5fbf8;
+  color: #1d4d43;
+  border-radius: 10px;
+  padding: 9px 14px;
+  font-size: 14px;
+  cursor: pointer;
+  transition: transform .15s ease, box-shadow .2s ease, background .2s ease;
+}
+
+.btn:hover {
+  transform: translateY(-1px);
+  box-shadow: 0 10px 18px rgba(21, 122, 103, 0.15);
+}
+
+.btn.primary {
+  border-color: #136957;
+  background: linear-gradient(120deg, #117664 0%, #0f8b73 100%);
+  color: #fff;
+}
+
+.btn.ghost {
+  background: rgba(255, 255, 255, 0.18);
+  border-color: rgba(255, 255, 255, 0.45);
+  color: #fff;
+}
+
+.top-actions {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.msg {
+  min-height: 18px;
+  margin: 10px 0 0;
+  font-size: 13px;
+  color: #146356;
+}
+
+.muted {
+  color: var(--muted);
+}
+
+.mini {
+  font-size: 12px;
+}
+
+.target-editor {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(290px, 1fr));
+  gap: 10px;
+}
+
+.target-user-card {
+  border: 1px solid #d8e5e0;
+  border-radius: 12px;
+  background: #fbfffd;
+  padding: 12px;
+}
+
+.target-user-head {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  margin-bottom: 8px;
+}
+
+.target-user-head strong {
+  font-size: 15px;
+}
+
+.target-user-head span {
+  font-size: 12px;
+  color: var(--muted);
+}
+
+.target-list {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  border: 1px dashed #cadad4;
+  border-radius: 10px;
+  padding: 8px;
+  min-height: 56px;
+  margin-bottom: 8px;
+}
+
+.target-item {
+  display: inline-flex;
+  align-items: center;
+  gap: 7px;
+  font-size: 13px;
+}
+
+.add-target-row {
+  display: grid;
+  grid-template-columns: 1fr 76px;
+  gap: 8px;
+}
+
+.new-target-input {
+  width: 100%;
+  border: 1px solid #bfd2cc;
+  border-radius: 10px;
+  padding: 8px 10px;
+  font-size: 13px;
+  background: #fff;
+}
+
+.stats-grid {
+  display: grid;
+  grid-template-columns: repeat(6, 1fr);
+  gap: 10px;
+}
+
+.card {
+  padding: 14px;
+}
+
+.card h3 {
+  margin: 0;
+  color: var(--muted);
+  font-size: 13px;
+  font-weight: 600;
+}
+
+.card p {
+  margin: 8px 0 0;
+  font-size: 20px;
+  font-weight: 700;
+}
+
+.table-wrap {
+  overflow: auto;
+}
+
+table {
+  width: 100%;
+  border-collapse: collapse;
+  min-width: 860px;
+}
+
+th,
+td {
+  text-align: left;
+  padding: 10px;
+  border-bottom: 1px solid #e3ece9;
+  font-size: 13px;
+  vertical-align: top;
+}
+
+th {
+  color: var(--muted);
+  font-weight: 600;
+}
+
+pre {
+  margin: 0;
+  padding: 14px;
+  border-radius: 10px;
+  min-height: 340px;
+  max-height: 560px;
+  overflow: auto;
+  background: #0e1a17;
+  color: #c5f5e9;
+  border: 1px solid #183731;
+  font-size: 12px;
+  line-height: 1.48;
+  font-family: "Consolas", "Monaco", monospace;
+}
+
+.login-body {
+  min-height: 100vh;
+  display: grid;
+  place-items: center;
+}
+
+.login-shell {
+  width: 100%;
+  max-width: 420px;
+  padding: 16px;
+}
+
+.login-card {
+  padding: 24px;
+}
+
+.login-card h1 {
+  margin: 0;
+  font-size: 26px;
+}
+
+.login-card .subtitle {
+  margin: 8px 0 18px;
+  color: var(--muted);
+}
+
+.auth-links {
+  display: flex;
+  justify-content: space-between;
+  gap: 10px;
+  margin-top: 10px;
+  font-size: 13px;
+}
+
+.auth-links a {
+  color: #116d5d;
+  text-decoration: none;
+}
+
+.auth-links a:hover {
+  text-decoration: underline;
+}
+
+.alert {
+  border-radius: 10px;
+  padding: 10px 12px;
+  margin-bottom: 12px;
+  font-size: 13px;
+}
+
+.alert.warning {
+  color: #7f4a00;
+  background: #fff1d9;
+  border: 1px solid #ffddad;
+}
+
+.admin-actions {
+  display: grid;
+  gap: 6px;
+}
+
+.clamp-cell {
+  max-width: 260px;
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+
+@media (max-width: 1100px) {
+  .stats-grid {
+    grid-template-columns: repeat(3, 1fr);
+  }
+}
+
+@media (max-width: 860px) {
+  .topbar {
+    margin: 16px 10px 12px;
+    border-radius: 14px;
+    flex-direction: column;
+    align-items: flex-start;
+  }
+
+  .container {
+    margin: 0 10px 24px;
+  }
+
+  .control-grid {
+    grid-template-columns: 1fr;
+  }
+
+  .stats-grid {
+    grid-template-columns: repeat(2, 1fr);
+  }
+}
+
+@media (max-width: 520px) {
+  .stats-grid {
+    grid-template-columns: 1fr;
+  }
+}
+

templates/admin.html

@@ -0,0 +1,194 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>DouYin Spark Flow - Admin 控制台</title>
+  <link rel="stylesheet" href="/static/style.css">
+</head>
+<body class="dash-body">
+  <header class="topbar">
+    <div>
+      <h1>Admin 后台管理</h1>
+      <p>用户管理 + 定时任务总览</p>
+    </div>
+    <div class="top-actions">
+      <button id="refreshBtn" class="btn ghost">刷新</button>
+      <button id="logoutBtn" class="btn ghost">退出登录</button>
+    </div>
+  </header>
+
+  <main class="container">
+    <section class="panel">
+      <h2>用户与任务总览</h2>
+      <p id="summary" class="muted">加载中...</p>
+      <div class="table-wrap">
+        <table>
+          <thead>
+            <tr>
+              <th>发起用户</th>
+              <th>唯一标识</th>
+              <th>注册时间</th>
+              <th>定时状态</th>
+              <th>发送时间</th>
+              <th>消息内容</th>
+              <th>接收方</th>
+              <th>下次执行</th>
+              <th>最近状态</th>
+              <th>操作</th>
+            </tr>
+          </thead>
+          <tbody id="adminBody">
+            <tr><td colspan="10">暂无数据</td></tr>
+          </tbody>
+        </table>
+      </div>
+      <p id="adminMsg" class="msg"></p>
+    </section>
+  </main>
+
+  <script>
+    const adminBody = document.getElementById("adminBody");
+    const summary = document.getElementById("summary");
+    const adminMsg = document.getElementById("adminMsg");
+
+    function setMsg(msg, isError = false) {
+      adminMsg.textContent = msg || "";
+      adminMsg.style.color = isError ? "#c0392b" : "#146356";
+    }
+
+    async function requestJSON(url, options = {}) {
+      const resp = await fetch(url, {
+        credentials: "same-origin",
+        headers: { "Content-Type": "application/json", ...(options.headers || {}) },
+        ...options,
+      });
+
+      if (resp.status === 401) {
+        window.location.href = "/admin";
+        throw new Error("登录已失效，请重新登录。");
+      }
+
+      const data = await resp.json();
+      if (!resp.ok || data.ok === false) {
+        throw new Error(data.message || "请求失败");
+      }
+      return data;
+    }
+
+    function escapeHtml(value) {
+      return String(value ?? "")
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/\"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+    }
+
+    function renderRows(users) {
+      if (!users || users.length === 0) {
+        adminBody.innerHTML = '<tr><td colspan="10">暂无用户</td></tr>';
+        return;
+      }
+
+      adminBody.innerHTML = users.map((u) => {
+        if (u.error) {
+          return `
+            <tr>
+              <td>${escapeHtml(u.username)}</td>
+              <td>${escapeHtml(u.unique_id || "-")}</td>
+              <td>${escapeHtml(u.created_at || "-")}</td>
+              <td colspan="6" style="color:#c0392b;">数据异常：${escapeHtml(u.error)}</td>
+              <td>
+                <button class="btn admin-delete-user" data-user="${escapeHtml(u.username)}">删除用户</button>
+              </td>
+            </tr>
+          `;
+        }
+
+        const targets = Array.isArray(u.targets) ? u.targets : [];
+        const targetText = targets.length ? targets.join(" / ") : "-";
+
+        return `
+          <tr>
+            <td>${escapeHtml(u.username)}</td>
+            <td>${escapeHtml(u.unique_id)}</td>
+            <td>${escapeHtml(u.created_at)}</td>
+            <td>${u.scheduler_enabled ? "启用" : "禁用"}</td>
+            <td>${escapeHtml(u.schedule_time)} (${escapeHtml(u.schedule_timezone)})</td>
+            <td class="clamp-cell">${escapeHtml(u.message_template || "")}</td>
+            <td class="clamp-cell">${escapeHtml(targetText)}</td>
+            <td>${escapeHtml(u.next_run || "-")}</td>
+            <td>${u.is_running ? "运行中" : escapeHtml(u.last_status || "-")}</td>
+            <td>
+              <div class="admin-actions">
+                <button class="btn admin-del-task" data-user="${escapeHtml(u.username)}">删任务</button>
+                <button class="btn admin-delete-user" data-user="${escapeHtml(u.username)}">删用户</button>
+              </div>
+            </td>
+          </tr>
+        `;
+      }).join("");
+
+      document.querySelectorAll(".admin-del-task").forEach((btn) => {
+        btn.addEventListener("click", async () => {
+          const username = btn.dataset.user;
+          if (!confirm(`确认删除用户 ${username} 的定时任务？`)) return;
+          setMsg("正在删除任务...");
+          try {
+            const data = await requestJSON(`/api/admin/tasks/${encodeURIComponent(username)}/delete`, {
+              method: "POST",
+              body: "{}",
+            });
+            setMsg(data.message || "已删除任务");
+            await loadOverview();
+          } catch (err) {
+            setMsg(err.message, true);
+          }
+        });
+      });
+
+      document.querySelectorAll(".admin-delete-user").forEach((btn) => {
+        btn.addEventListener("click", async () => {
+          const username = btn.dataset.user;
+          if (!confirm(`确认删除用户 ${username}？该操作不可恢复。`)) return;
+          setMsg("正在删除用户...");
+          try {
+            const data = await requestJSON(`/api/admin/users/${encodeURIComponent(username)}`, {
+              method: "DELETE",
+            });
+            setMsg(data.message || "用户已删除");
+            await loadOverview();
+          } catch (err) {
+            setMsg(err.message, true);
+          }
+        });
+      });
+    }
+
+    async function loadOverview() {
+      const data = await requestJSON("/api/admin/overview");
+      summary.textContent = `共 ${data.task_count || 0} 个用户任务。`;
+      renderRows(data.users || []);
+    }
+
+    document.getElementById("refreshBtn").addEventListener("click", async () => {
+      try {
+        await loadOverview();
+      } catch (err) {
+        setMsg(err.message, true);
+      }
+    });
+
+    document.getElementById("logoutBtn").addEventListener("click", async () => {
+      await fetch("/api/logout", { method: "POST", credentials: "same-origin" });
+      window.location.href = "/admin";
+    });
+
+    loadOverview().catch((err) => setMsg(err.message, true));
+    setInterval(() => {
+      loadOverview().catch(() => {});
+    }, 8000);
+  </script>
+</body>
+</html>

templates/admin_login.html

@@ -0,0 +1,69 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>DouYin Spark Flow - Admin 登录</title>
+  <link rel="stylesheet" href="/static/style.css">
+</head>
+<body class="login-body">
+  <main class="login-shell">
+    <section class="login-card">
+      <h1>管理员登录</h1>
+      <p class="subtitle">账号固定为 <code>admin</code>，密码为环境变量 <code>PASSWORD</code></p>
+      {% if password_missing %}
+      <div class="alert warning">服务端未设置 <code>PASSWORD</code> 环境变量，当前无法登录。</div>
+      {% endif %}
+      <div class="field">
+        <label for="password">管理员密码</label>
+        <input id="password" type="password" placeholder="请输入 PASSWORD" autocomplete="current-password">
+      </div>
+      <button id="loginBtn" class="btn primary">进入后台</button>
+      <p id="loginMsg" class="msg"></p>
+      <div class="auth-links">
+        <a href="/login">返回用户登录</a>
+      </div>
+    </section>
+  </main>
+
+  <script>
+    const loginBtn = document.getElementById("loginBtn");
+    const passwordInput = document.getElementById("password");
+    const loginMsg = document.getElementById("loginMsg");
+
+    async function doLogin() {
+      const password = passwordInput.value.trim();
+      if (!password) {
+        loginMsg.textContent = "请输入管理员密码。";
+        return;
+      }
+
+      loginBtn.disabled = true;
+      loginMsg.textContent = "正在校验...";
+      try {
+        const resp = await fetch("/api/admin/login", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ password }),
+          credentials: "same-origin",
+        });
+        const data = await resp.json();
+        if (!resp.ok || !data.ok) {
+          throw new Error(data.message || "登录失败");
+        }
+        loginMsg.textContent = "登录成功，正在跳转...";
+        window.location.href = "/admin";
+      } catch (err) {
+        loginMsg.textContent = "登录失败：" + err.message;
+      } finally {
+        loginBtn.disabled = false;
+      }
+    }
+
+    loginBtn.addEventListener("click", doLogin);
+    passwordInput.addEventListener("keydown", (e) => {
+      if (e.key === "Enter") doLogin();
+    });
+  </script>
+</body>
+</html>

templates/dashboard.html

@@ -0,0 +1,430 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>DouYin Spark Flow - 控制台</title>
+  <link rel="stylesheet" href="/static/style.css">
+</head>
+<body class="dash-body">
+  <header class="topbar">
+    <div>
+      <h1>DouYin Spark Flow 控制台</h1>
+      <p>每日自动任务 + 手动执行 + 实时日志{% if username %} · 当前用户：{{ username }}{% endif %}</p>
+    </div>
+    <button id="logoutBtn" class="btn ghost">退出登录</button>
+  </header>
+
+  <main class="container">
+    <section class="panel quick">
+      <div class="status-row">
+        <span class="status-label">运行状态</span>
+        <span id="runBadge" class="badge idle">空闲</span>
+      </div>
+      <div class="control-grid">
+        <div class="field">
+          <label for="taskTime">每日执行时间（北京时间）</label>
+          <input id="taskTime" type="time" value="{{ default_time }}">
+        </div>
+        <button id="saveScheduleBtn" class="btn">保存定时</button>
+        <button id="runNowBtn" class="btn primary">立即执行任务</button>
+      </div>
+      <p id="actionMsg" class="msg"></p>
+    </section>
+
+    <section class="stats-grid">
+      <article class="card">
+        <h3>账号数量</h3>
+        <p id="accountCount">-</p>
+      </article>
+      <article class="card">
+        <h3>目标好友总数</h3>
+        <p id="targetCount">-</p>
+      </article>
+      <article class="card">
+        <h3>最近触发方式</h3>
+        <p id="lastTrigger">-</p>
+      </article>
+      <article class="card">
+        <h3>最近执行结果</h3>
+        <p id="lastStatus">-</p>
+      </article>
+      <article class="card">
+        <h3>最近开始时间</h3>
+        <p id="lastStart">-</p>
+      </article>
+      <article class="card">
+        <h3>下一次执行时间</h3>
+        <p id="nextRun">-</p>
+      </article>
+    </section>
+
+    <section class="panel">
+      <div class="panel-header">
+        <h2>消息内容编辑</h2>
+        <button id="saveMessageBtn" class="btn">保存消息内容</button>
+      </div>
+      <div class="field">
+        <label for="messageTemplate">消息模板（支持换行，支持 [API] 占位符）</label>
+        <textarea id="messageTemplate" rows="5" placeholder="请输入发送内容模板"></textarea>
+      </div>
+    </section>
+
+    <section class="panel">
+      <div class="panel-header">
+        <h2>目标好友编辑（勾选即本次生效）</h2>
+        <button id="saveTargetsBtn" class="btn">保存目标好友</button>
+      </div>
+      <div id="targetEditor" class="target-editor">
+        <p class="muted">加载中...</p>
+      </div>
+      <p id="editorMsg" class="msg"></p>
+    </section>
+
+    <section class="panel">
+      <h2>运行历史（最多 50 条）</h2>
+      <div class="table-wrap">
+        <table>
+          <thead>
+            <tr>
+              <th>触发方式</th>
+              <th>开始时间</th>
+              <th>结束时间</th>
+              <th>状态</th>
+              <th>耗时</th>
+              <th>信息</th>
+            </tr>
+          </thead>
+          <tbody id="historyBody">
+            <tr><td colspan="6">暂无记录</td></tr>
+          </tbody>
+        </table>
+      </div>
+    </section>
+
+    <section class="panel">
+      <div class="panel-header">
+        <h2>实时日志</h2>
+        <button id="refreshBtn" class="btn ghost">立即刷新</button>
+      </div>
+      <pre id="logBox">加载中...</pre>
+    </section>
+  </main>
+
+  <script>
+    const runBadge = document.getElementById("runBadge");
+    const actionMsg = document.getElementById("actionMsg");
+    const historyBody = document.getElementById("historyBody");
+    const taskTimeInput = document.getElementById("taskTime");
+    const logBox = document.getElementById("logBox");
+    const accountCount = document.getElementById("accountCount");
+    const targetCount = document.getElementById("targetCount");
+    const lastTrigger = document.getElementById("lastTrigger");
+    const lastStatus = document.getElementById("lastStatus");
+    const lastStart = document.getElementById("lastStart");
+    const nextRun = document.getElementById("nextRun");
+    const messageTemplateInput = document.getElementById("messageTemplate");
+    const targetEditor = document.getElementById("targetEditor");
+    const editorMsg = document.getElementById("editorMsg");
+    let isEditingTime = false;
+
+    function escapeHtml(value) {
+      return String(value ?? "")
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/\"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+    }
+
+    function targetRowHtml(target, checked = true) {
+      const safeTarget = escapeHtml(target);
+      return `
+        <label class="target-item">
+          <input type="checkbox" class="target-checkbox" data-target="${safeTarget}" ${checked ? "checked" : ""}>
+          <span>${safeTarget}</span>
+        </label>
+      `;
+    }
+
+    function setMessage(msg, isError = false) {
+      actionMsg.textContent = msg || "";
+      actionMsg.style.color = isError ? "#c0392b" : "#146356";
+    }
+
+    function setEditorMessage(msg, isError = false) {
+      editorMsg.textContent = msg || "";
+      editorMsg.style.color = isError ? "#c0392b" : "#146356";
+    }
+
+    async function requestJSON(url, options = {}) {
+      const resp = await fetch(url, {
+        credentials: "same-origin",
+        headers: { "Content-Type": "application/json", ...(options.headers || {}) },
+        ...options,
+      });
+      if (resp.status === 401) {
+        window.location.href = "/login";
+        throw new Error("登录已失效，请重新登录。");
+      }
+      const data = await resp.json();
+      if (!resp.ok || data.ok === false) {
+        throw new Error(data.message || ("请求失败: " + resp.status));
+      }
+      return data;
+    }
+
+    function renderStatus(runtime) {
+      runBadge.textContent = runtime.is_running ? "运行中" : "空闲";
+      runBadge.className = runtime.is_running ? "badge running" : "badge idle";
+      accountCount.textContent = runtime.account_count;
+      targetCount.textContent = runtime.target_count;
+      lastTrigger.textContent = runtime.last_trigger;
+      lastStatus.textContent = runtime.last_status;
+      lastStart.textContent = runtime.last_start;
+      nextRun.textContent = runtime.next_run;
+      if (!isEditingTime) {
+        taskTimeInput.value = runtime.schedule_time;
+      }
+    }
+
+    function renderHistory(rows) {
+      if (!rows || rows.length === 0) {
+        historyBody.innerHTML = '<tr><td colspan="6">暂无记录</td></tr>';
+        return;
+      }
+      historyBody.innerHTML = rows
+        .map(
+          (row) => `
+        <tr>
+          <td>${row.trigger}</td>
+          <td>${row.start}</td>
+          <td>${row.end}</td>
+          <td>${row.status}</td>
+          <td>${row.duration}</td>
+          <td>${row.message}</td>
+        </tr>
+      `,
+        )
+        .join("");
+    }
+
+    function renderTargetEditor(users) {
+      if (!users || users.length === 0) {
+        targetEditor.innerHTML = '<p class="muted">暂无账号数据，请先完成登录并写入 usersData.json。</p>';
+        return;
+      }
+
+      targetEditor.innerHTML = users
+        .map((user) => {
+          const username = escapeHtml(user.username || "未知用户");
+          const uniqueId = escapeHtml(user.unique_id || "");
+          const targets = Array.isArray(user.targets) ? user.targets : [];
+          const targetList = targets.length
+            ? targets.map((item) => targetRowHtml(item, true)).join("")
+            : '<p class="muted mini">暂无目标，可在下方手动添加。</p>';
+          return `
+          <article class="target-user-card" data-uid="${uniqueId}">
+            <div class="target-user-head">
+              <strong>${username}</strong>
+              <span>${uniqueId}</span>
+            </div>
+            <div class="target-list">${targetList}</div>
+            <div class="add-target-row">
+              <input type="text" class="new-target-input" placeholder="输入好友昵称后点击添加">
+              <button type="button" class="btn add-target-btn">添加</button>
+            </div>
+          </article>
+        `;
+        })
+        .join("");
+
+      targetEditor.querySelectorAll(".add-target-btn").forEach((btn) => {
+        btn.addEventListener("click", () => {
+          const card = btn.closest(".target-user-card");
+          const input = card.querySelector(".new-target-input");
+          const list = card.querySelector(".target-list");
+          const value = input.value.trim();
+          if (!value) {
+            setEditorMessage("请输入要添加的目标昵称。", true);
+            return;
+          }
+
+          const exists = Array.from(card.querySelectorAll(".target-checkbox")).find(
+            (el) => (el.dataset.target || "").trim() === value,
+          );
+          if (exists) {
+            exists.checked = true;
+            setEditorMessage(`目标「${value}」已存在，已重新勾选。`);
+          } else {
+            const muted = list.querySelector(".muted");
+            if (muted) muted.remove();
+            list.insertAdjacentHTML("beforeend", targetRowHtml(value, true));
+            setEditorMessage(`已添加目标「${value}」。`);
+          }
+
+          input.value = "";
+          input.focus();
+        });
+      });
+
+      targetEditor.querySelectorAll(".new-target-input").forEach((input) => {
+        input.addEventListener("keydown", (e) => {
+          if (e.key === "Enter") {
+            e.preventDefault();
+            input.closest(".add-target-row").querySelector(".add-target-btn").click();
+          }
+        });
+      });
+    }
+
+    function collectTargetsPayload() {
+      const users = Array.from(document.querySelectorAll(".target-user-card")).map((card) => {
+        const uniqueId = (card.dataset.uid || "").trim();
+        const targets = Array.from(card.querySelectorAll(".target-checkbox:checked"))
+          .map((el) => (el.dataset.target || "").trim())
+          .filter(Boolean);
+        return { unique_id: uniqueId, targets };
+      });
+      return { users };
+    }
+
+    async function refreshStatus() {
+      const data = await requestJSON("/api/status");
+      renderStatus(data.runtime);
+      renderHistory(data.history);
+    }
+
+    async function refreshLogs() {
+      const data = await requestJSON("/api/logs?limit=1200");
+      logBox.textContent = data.logs || "暂无日志。";
+      logBox.scrollTop = logBox.scrollHeight;
+    }
+
+    async function refreshEditorState() {
+      const data = await requestJSON("/api/editor/state");
+      messageTemplateInput.value = data.message_template || "";
+      renderTargetEditor(data.users || []);
+    }
+
+    async function refreshAll(withEditor = false) {
+      try {
+        const tasks = [refreshStatus(), refreshLogs()];
+        if (withEditor) tasks.push(refreshEditorState());
+        await Promise.all(tasks);
+      } catch (err) {
+        setMessage(err.message, true);
+      }
+    }
+
+    async function persistEditorsBeforeRun() {
+      const message = messageTemplateInput.value;
+      if (!message.trim()) {
+        throw new Error("消息内容不能为空，请先填写后再执行任务。");
+      }
+      await requestJSON("/api/editor/message", {
+        method: "POST",
+        body: JSON.stringify({ message }),
+      });
+
+      const payload = collectTargetsPayload();
+      if (payload.users.length) {
+        await requestJSON("/api/editor/targets", {
+          method: "POST",
+          body: JSON.stringify(payload),
+        });
+      }
+    }
+
+    document.getElementById("runNowBtn").addEventListener("click", async () => {
+      setMessage("正在保存编辑内容并触发任务...");
+      try {
+        await persistEditorsBeforeRun();
+        const data = await requestJSON("/api/run", { method: "POST", body: "{}" });
+        setMessage(data.message || "任务已启动。");
+        setEditorMessage("已在执行前自动保存消息内容和目标好友。");
+        await refreshAll();
+      } catch (err) {
+        setMessage(err.message, true);
+      }
+    });
+
+    document.getElementById("saveScheduleBtn").addEventListener("click", async () => {
+      const time = taskTimeInput.value;
+      if (!time) {
+        setMessage("请先选择时间。", true);
+        return;
+      }
+      isEditingTime = true;
+      setMessage("正在保存定时...");
+      try {
+        const data = await requestJSON("/api/schedule", {
+          method: "POST",
+          body: JSON.stringify({ time }),
+        });
+        setMessage(
+          (data.message || "定时已更新。") + (data.next_run ? " 下一次执行：" + data.next_run : ""),
+        );
+        await refreshStatus();
+      } catch (err) {
+        setMessage(err.message, true);
+      } finally {
+        isEditingTime = false;
+      }
+    });
+
+    document.getElementById("saveMessageBtn").addEventListener("click", async () => {
+      const message = messageTemplateInput.value;
+      if (!message.trim()) {
+        setEditorMessage("消息内容不能为空。", true);
+        return;
+      }
+      setEditorMessage("正在保存消息内容...");
+      try {
+        const data = await requestJSON("/api/editor/message", {
+          method: "POST",
+          body: JSON.stringify({ message }),
+        });
+        setEditorMessage(data.message || "消息模板已保存。");
+      } catch (err) {
+        setEditorMessage(err.message, true);
+      }
+    });
+
+    document.getElementById("saveTargetsBtn").addEventListener("click", async () => {
+      const payload = collectTargetsPayload();
+      if (!payload.users.length) {
+        setEditorMessage("当前没有可保存的账号。", true);
+        return;
+      }
+      setEditorMessage("正在保存目标好友...");
+      try {
+        const data = await requestJSON("/api/editor/targets", {
+          method: "POST",
+          body: JSON.stringify(payload),
+        });
+        setEditorMessage(data.message || "目标好友已保存。");
+        await refreshStatus();
+      } catch (err) {
+        setEditorMessage(err.message, true);
+      }
+    });
+
+    document.getElementById("logoutBtn").addEventListener("click", async () => {
+      await fetch("/api/logout", { method: "POST", credentials: "same-origin" });
+      window.location.href = "/login";
+    });
+
+    document.getElementById("refreshBtn").addEventListener("click", () => refreshAll(true));
+    taskTimeInput.addEventListener("focus", () => {
+      isEditingTime = true;
+    });
+    taskTimeInput.addEventListener("blur", () => {
+      isEditingTime = false;
+    });
+
+    refreshAll(true);
+    setInterval(refreshAll, 5000);
+  </script>
+</body>
+</html>

templates/login.html

@@ -0,0 +1,73 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>DouYin Spark Flow - 用户登录</title>
+  <link rel="stylesheet" href="/static/style.css">
+</head>
+<body class="login-body">
+  <main class="login-shell">
+    <section class="login-card">
+      <h1>DouYin Spark Flow</h1>
+      <p class="subtitle">普通用户登录</p>
+      <div class="field">
+        <label for="username">用户名</label>
+        <input id="username" type="text" placeholder="请输入注册时自动提取的用户名" autocomplete="username">
+      </div>
+      <div class="field">
+        <label for="password">登录密码</label>
+        <input id="password" type="password" placeholder="请输入注册时设置的密码" autocomplete="current-password">
+      </div>
+      <button id="loginBtn" class="btn primary">登录控制台</button>
+      <p id="loginMsg" class="msg"></p>
+      <div class="auth-links">
+        <a href="/register">没有账号？去注册</a>
+        <a href="/admin">管理员入口</a>
+      </div>
+    </section>
+  </main>
+
+  <script>
+    const loginBtn = document.getElementById("loginBtn");
+    const usernameInput = document.getElementById("username");
+    const passwordInput = document.getElementById("password");
+    const loginMsg = document.getElementById("loginMsg");
+
+    async function doLogin() {
+      const username = usernameInput.value.trim();
+      const password = passwordInput.value.trim();
+      if (!username || !password) {
+        loginMsg.textContent = "请输入用户名和密码。";
+        return;
+      }
+
+      loginBtn.disabled = true;
+      loginMsg.textContent = "正在校验...";
+      try {
+        const resp = await fetch("/api/login", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ username, password }),
+          credentials: "same-origin"
+        });
+        const data = await resp.json();
+        if (!resp.ok || !data.ok) {
+          throw new Error(data.message || "登录失败");
+        }
+        loginMsg.textContent = "登录成功，正在跳转...";
+        window.location.href = "/";
+      } catch (err) {
+        loginMsg.textContent = "登录失败：" + err.message;
+      } finally {
+        loginBtn.disabled = false;
+      }
+    }
+
+    loginBtn.addEventListener("click", doLogin);
+    passwordInput.addEventListener("keydown", (e) => {
+      if (e.key === "Enter") doLogin();
+    });
+  </script>
+</body>
+</html>

templates/register.html

@@ -0,0 +1,82 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>DouYin Spark Flow - 用户注册</title>
+  <link rel="stylesheet" href="/static/style.css">
+</head>
+<body class="login-body">
+  <main class="login-shell">
+    <section class="login-card">
+      <h1>用户注册</h1>
+      <p class="subtitle">上传 <code>usersData.json</code>，系统将自动提取用户名并创建独立任务空间</p>
+
+      <div class="field">
+        <label for="usersFile">上传 usersData.json</label>
+        <input id="usersFile" type="file" accept="application/json,.json">
+      </div>
+      <div class="field">
+        <label for="password">设置登录密码</label>
+        <input id="password" type="password" placeholder="至少 4 位" autocomplete="new-password">
+      </div>
+
+      <button id="registerBtn" class="btn primary">注册账号</button>
+      <p id="registerMsg" class="msg"></p>
+      <div class="auth-links">
+        <a href="/login">已有账号？去登录</a>
+      </div>
+    </section>
+  </main>
+
+  <script>
+    const registerBtn = document.getElementById("registerBtn");
+    const usersFileInput = document.getElementById("usersFile");
+    const passwordInput = document.getElementById("password");
+    const registerMsg = document.getElementById("registerMsg");
+
+    async function doRegister() {
+      const file = usersFileInput.files[0];
+      const password = passwordInput.value.trim();
+      if (!file) {
+        registerMsg.textContent = "请先上传 usersData.json 文件。";
+        return;
+      }
+      if (!password) {
+        registerMsg.textContent = "请输入登录密码。";
+        return;
+      }
+
+      registerBtn.disabled = true;
+      registerMsg.textContent = "正在注册...";
+
+      try {
+        const formData = new FormData();
+        formData.append("users_file", file);
+        formData.append("password", password);
+
+        const resp = await fetch("/api/register", {
+          method: "POST",
+          body: formData,
+          credentials: "same-origin",
+        });
+        const data = await resp.json();
+        if (!resp.ok || !data.ok) {
+          throw new Error(data.message || "注册失败");
+        }
+
+        registerMsg.textContent = `注册成功，用户名为 ${data.username}，正在跳转登录页...`;
+        setTimeout(() => {
+          window.location.href = "/login";
+        }, 1200);
+      } catch (err) {
+        registerMsg.textContent = "注册失败：" + err.message;
+      } finally {
+        registerBtn.disabled = false;
+      }
+    }
+
+    registerBtn.addEventListener("click", doRegister);
+  </script>
+</body>
+</html>

utils/chinese_new_year_2026_mare.py

@@ -0,0 +1,933 @@
+from datetime import date
+import random
+
+# 2026年丙午马年 春节通用文案库 (每日30+条)
+# 特点：全场景通用、无特定对象、强日期贴合度
+SPRING_FESTIVAL_QUOTES = {
+    # ==============================================
+    # 2026年2月16日 除夕 (岁除/大年夜)
+    # 核心：辞旧、团圆、守岁、年夜饭、跨年
+    # ==============================================
+    date(2026, 2, 16): [
+        # 辞旧迎新篇
+        "2026丙午除夕，烟火起，照人间，举杯敬此年。",
+        "辞别乙巳，拥抱丙午。愿旧岁千般皆如意，新年万事定称心。",
+        "最后一天，把所有的遗憾打包封存，把所有的期待整装待发。",
+        "岁序更替，华章日新。站在新年的门槛，准备好迎接火热的马年。",
+        "长路浩浩荡荡，万物尽可期待。2025圆满谢幕，2026正式启航。",
+        "旧岁已展千重锦，新年再进百尺竿。除夕快乐，万事胜意。",
+        "将往事清零，与岁月言和。愿新的一年，多喜乐，长安宁。",
+        "光阴流转，又逢除夕。愿所有的努力，都能在马年开花结果。",
+        "挥手作别旧时路，策马扬鞭新征程。除夕安康，福暖四季。",
+        "跨年的钟声即将敲响，愿未来的日子，如骏马奔腾，一往无前。",
+
+        # 团圆守岁篇
+        "万家灯火时，阖家团圆日。今夜围炉话岁，共享人间清欢。",
+        "年夜饭的香气，是这一年最温暖的句号。",
+        "灯火可亲，饭香扑鼻。愿岁岁年年，共占春风。",
+        "守岁至天明，喜乐伴一生。今夜不谈烦恼，只叙团圆。",
+        "窗外烟火璀璨，屋内笑语盈盈。这便是人间最好的光景。",
+        "一杯屠苏酒，一桌团圆饭。敬过往，敬明天，敬每一个当下。",
+        "今夜无眠，唯有欢喜。愿烟火向星辰，所愿皆成真。",
+        "饺子滚一滚，福气进家门。除夕的饺子，包进了一整年的好运。",
+        "围炉守岁，静待新春。愿马年的第一缕阳光，照亮心底的梦想。",
+        "在这个辞旧迎新的夜晚，愿平安与健康，常伴左右。",
+
+        # 马年预热篇
+        "丙午火马，即将登场。愿新的一年，生命力如烈火般旺盛。",
+        "金蛇隐去，骏马奔腾。2026，准备好马力全开。",
+        "除夕之夜，许下心愿：2026，马不停蹄奔向幸福。",
+        "烟火升腾处，金马踏春来。愿新年，胜旧年。",
+        "迎接丙午马年，愿前程如骏马驰骋，一马平川。",
+        "除夕快乐！金马贺岁，福暖四季，万事胜意。",
+        "2026，愿如骏马，不负韶华，驰骋万里。",
+        "在这个火热的年份，愿日子过得红红火火，热气腾腾。",
+        "策马扬鞭迎新岁，意气风发赴前程。除夕大吉。",
+        "准备好，和金马一起，跨越山海，奔赴美好。",
+
+        # 短句补充篇
+        "除夕快乐，2026你好。",
+        "烟火年年，岁岁平安。",
+        "旧疾当愈，新年可期。",
+        "辞旧岁，迎新春，万事兴。",
+        "丙午大吉，马到成功。",
+        "万家团圆，喜乐安康。",
+        "今夜好梦，明天好运。",
+        "感恩过往，期待未来。",
+        "福满人间，春回大地。",
+        "跨年快乐，马年大吉。"
+    ],
+
+    # ==============================================
+    # 2026年2月17日 正月初一 (春节/元日)
+    # 核心：开门见喜、拜年、新岁、龙马精神
+    # ==============================================
+    date(2026, 2, 17): [
+        # 开门见喜篇
+        "正月初一，开门见喜。愿2026年的第一天，满载好运与福气。",
+        "大年初一，喜气洋洋。推开窗，迎接第一缕春风与阳光。",
+        "初一启新程，万事皆顺遂。愿这一年，所求皆如愿。",
+        "门迎百福，户纳千祥。马年第一天，好运接踵而至。",
+        "初一早，福气到。愿生活明朗，万物可爱。",
+        "新岁启封，美好开场。2026，从这喜气洋洋的一天开始。",
+        "晨光熹微，年味正浓。初一早安，马年吉祥。",
+        "开启新岁的第一份好运，愿平安喜乐，一路随行。",
+        "初一开门红，全年万事通。愿日子红红火火，蒸蒸日上。",
+        "迎着朝阳，许下心愿：2026，一马当先，万事胜意。",
+
+        # 龙马精神篇
+        "丙午马年，正月初一。愿龙马精神，常驻心间。",
+        "2026，做一匹奔腾的骏马，跨越所有障碍，奔向理想。",
+        "大年初一，祝龙马精神，身体康健，活力满满。",
+        "马年第一天，愿拥有骏马的速度，更有骏马的耐力。",
+        "春风得意马蹄疾，一日看尽长安花。新年伊始，意气风发。",
+        "以梦为马，���负韶华。初一启程，奔赴山海。",
+        "金马迎春，万象更新。愿精神抖擞，迎接每一个挑战。",
+        "马到成功，从大年初一做起。每一步，都坚定有力。",
+        "愿如骏马，驰骋疆场，所向披靡，收获满满。",
+        "正月初一，愿一马平川，前程似锦，无往不利。",
+
+        # 拜年祈福篇
+        "新春大吉，拜年啦。愿这一年，多喜乐，长安宁。",
+        "大年初一，送上最真挚的祝福：四季平安，万事顺遂。",
+        "初一纳福，愿福气满满，财运亨通，好运连连。",
+        "拜年进行时，祝福送不停。愿2026，皆是欢喜。",
+        "大年初一，不只是祝福，更是对未来的美好期许。",
+        "新的一年，愿日子如熹光，温柔又安详。",
+        "初一祈福，愿阖家欢乐，岁月静好，现世安稳。",
+        "春风送暖，福气盈门。大年初一，喜乐安康。",
+        "给时光拜个年，愿它温柔以待每一个努力的人。",
+        "2026的第一声祝福：愿世间美好，与你环环相扣。",
+
+        # 短句补充篇
+        "初一吉祥，马年大吉。",
+        "开门纳福，万事亨通。",
+        "龙马精神，一马当先。",
+        "新春快乐，好事连连。",
+        "元日安康，福暖人间。",
+        "2026，向阳而生。",
+        "大年初一，喜气盈门。",
+        "马到成功，前程似锦。",
+        "新年第一喜，好运属于你。",
+        "喜乐无忧，自在如风。"
+    ],
+
+    # ==============================================
+    # 2026年2月18日 正月初二 (回门/迎婿)
+    # 核心：归家、亲情、欢聚、福满门
+    # ==============================================
+    date(2026, 2, 18): [
+        # 归家欢聚篇
+        "正月初二，归宁之喜。带上祝福，奔赴另一场团圆。",
+        "初二回门，福气临门。愿每一次归家，都温暖如初。",
+        "初一团圆，初二欢聚。亲情的纽带，从未如此紧密。",
+        "带上爱与思念，回到温暖的港湾。初二快乐。",
+        "正月初二，风和日丽。适合相聚，适合表达爱意。",
+        "回门的路，是通往幸福的路。愿一路欢歌，一路笑语。",
+        "初二时光，慢煮生活。愿烟火气中，皆是幸福味。",
+        "走亲访友，传递温情。初二这一天，装满了爱。",
+        "归宁日，欢喜时。愿所有的美好，都恰逢其时。",
+        "初二启程，满载欢喜。愿相聚的时光，温柔又绵长。",
+
+        # 福满双门篇
+        "正月初二，福满双门。愿两家喜乐，万事兴隆。",
+        "初二迎福，愿福气不仅满盈小家，更福泽大家。",
+        "门门有喜，户户纳福。初二这一天，喜气洋洋。",
+        "双门纳福，马年吉祥。愿两边的长辈，福寿安康。",
+        "正月初二，好事成双。愿快乐加倍，幸福翻倍。",
+        "福临门，喜盈户。初二的日子，红红火火。",
+        "两家欢喜，一门和气。愿这份福气，延续一整年。",
+        "初二接福，愿生活有滋有味，日子顺顺当当。",
+        "福气流转，爱意相传。正月初二，吉祥如意。",
+        "双福临门，万事胜意。愿马年的每一天，都充满阳光。",
+
+        # 春日随行篇
+        "初二春早，惠风和畅。愿春风十里，不如相聚有你。",
+        "正月初二，踏春而行。愿脚步所至，皆是美好。",
+        "春日暖阳，照见归途。初二这一天，温暖随行。",
+        "春风送暖入屠苏，初二归宁乐陶陶。",
+        "马年的春天，从初二的欢聚开始。生机勃勃，充满希望。",
+        "花开正艳，春意正浓。初二出门，遇见美好。",
+        "暖阳相伴，清风相随。初二的时光，惬意又美好。",
+        "踏遍春色，归来仍是少年。正月初二，喜乐安康。",
+        "春日迟迟，卉木萋萋。初二之日，愿心情如花般绽放。",
+        "迎着春光，奔赴团圆。初二快乐，马年大吉。",
+
+        # 短句补充篇
+        "初二回门，喜气洋洋。",
+        "归宁日，幸福时。",
+        "福满双门，好事成双。",
+        "初二吉祥，马年安康。",
+        "欢聚时刻，喜乐无忧。",
+        "亲情无价，岁月留痕。",
+        "初二纳福，万事顺遂。",
+        "春风十里，不如团圆。",
+        "回门之喜，福暖人心。",
+        "马年初二，福气满满。"
+    ],
+
+    # ==============================================
+    # 2026年2月19日 正月初三 (赤狗日/宅家)
+    # 核心：静养、安歇、蓄力、宅家
+    # ==============================================
+    date(2026, 2, 19): [
+        # 宅家静养篇
+        "正月初三，安歇静养。给身体放个假，给心情充个电。",
+        "初三宅家，慢��时光。在喧嚣之外，寻得一份宁静。",
+        "初一忙，初二累，初三在家睡。享受难得的清闲。",
+        "宅家的日子，也是一种幸福。初三快乐，自在随心。",
+        "闭门谢客，静心养神。初三这一天，只属于自己。",
+        "放慢脚步，享受慢生活。初三，宜休息，宜欢聚。",
+        "窗外年味浓，屋内岁月静。初三宅家，惬意安然。",
+        "暂时放下忙碌，享受片刻悠闲。正月初三，岁月静好。",
+        "初三时光，用来虚度。愿日子慢一点，幸福长一点。",
+        "在家纳福，平安喜乐。初三这一天，简单又美好。",
+
+        # 蓄力待发篇
+        "初三蓄力，静待花开。为了更好的出发，此刻需要沉淀。",
+        "养精蓄锐，马力全开。初三的休息，是为了未来的奔跑。",
+        "积蓄力量，厚积薄发。2026，准备好惊艳全场。",
+        "暂停，是为了更好的前行。初三，在宁静中积蓄能量。",
+        "休整身心，整装待发。愿未来的路，走得更稳更远。",
+        "初三时光，用来规划。愿马年的每一步，都走得坚定。",
+        "充电完毕，满格出发。初三之后，又是新的征程。",
+        "在安静中蓄力，在沉淀中成长。正月初三，未来可期。",
+        "养足精神，迎接挑战。马年的精彩，还在后面。",
+        "初三纳福，蓄力前行。愿2026，一往无前。",
+
+        # 平安纳福篇
+        "正月初三，赤狗日。宜居家，纳平安，避纷争。",
+        "在家纳福，百邪不侵。愿金马护宅，万事顺遂。",
+        "初三吉祥，平安第一。愿日子安稳，岁月静好。",
+        "纳福迎祥，阖家安康。初三这一天，福气满满。",
+        "平安是福，健康是金。正月初三，祈愿平安。",
+        "福宅安康，万事兴隆。初三纳福，马年吉祥。",
+        "闭门纳福，开门迎喜。愿初三的宁静，带来一整年的安稳。",
+        "岁月安稳，现世静好。初三之日，福暖人间。",
+        "纳千祥，迎万福。正月初三，平安喜乐。",
+        "金马护佑，平安相随。初三安康，万事大吉。",
+
+        # 短句补充篇
+        "初三宅家，自在逍遥。",
+        "静养身心，蓄力前行。",
+        "闭门纳福，平安是福。",
+        "初三吉祥，岁月静好。",
+        "慢享时光，惬意安然。",
+        "养精蓄锐，马到成功。",
+        "正月初三，宜休息。",
+        "在家享福，福气自来。",
+        "沉淀自己，未来可期。",
+        "初三安康，福满人间。"
+    ],
+
+    # ==============================================
+    # 2026年2月20日 正月初四 (接灶神)
+    # 核心：烟火、食禄、家肥屋润、三餐四季
+    # ==============================================
+    date(2026, 2, 20): [
+        # 恭迎灶神篇
+        "正月初四，恭迎灶神。愿三餐四季，温暖如初。",
+        "灶神归位，烟火重燃。初四这一天，充满了生活气息。",
+        "恭迎灶王爷，福泽满人间。愿家肥屋润，衣食无忧。",
+        "初四接灶，五谷丰登。愿粮仓常满，日子富足。",
+        "灶火初红，春意渐浓。迎接灶神，迎接美好。",
+        "一炉香火，祈愿平安。初四接灶，马年吉祥。",
+        "灶神下界，保祐平安。愿每一顿饭，都吃得香甜。",
+        "正月初四，迎灶纳福。愿烟火气中，皆是幸福味。",
+        "接灶神，纳吉祥。愿2026，衣食无忧，生活美满。",
+        "灶火通明，福气盈门。初四大吉，万事顺遂。",
+
+        # 人间烟火篇
+        "人间烟火气，最抚凡人心。初四这一天，重拾生活的热爱。",
+        "三餐四季，温柔有趣。愿灶火不熄，爱与温暖常在。",
+        "厨房里的烟火，是家里最美的风景。初四快乐。",
+        "一碗热汤，温暖身心。愿马年的每一天，都热气腾腾。",
+        "烟火升腾处，幸福正当时。初四，宜下厨，宜欢聚。",
+        "柴米油盐酱醋茶，人间烟火也有趣。正月初四，岁月静好。",
+        "灶台飘香，日子红火。愿生活有滋有味，红红火火。",
+        "在烟火气中，感受生活的美好。初四这一天，惬意安然。",
+        "灶火声声，笑语盈盈。愿家宅安宁，幸福绵长。",
+        "人间有味是清欢。初四之日，愿享受每一顿家常便饭。",
+
+        # 食禄丰足篇
+        "初四接灶，食禄丰足。愿2026，不愁吃穿，富足安康。",
+        "米缸常满，日子香甜。愿马年的每一天，都衣食无忧。",
+        "食禄双全，福气满满。正月初四，祈愿丰收。",
+        "五谷丰登，食禄无忧。愿生活富足，岁月安稳。",
+        "迎灶神，纳食禄。愿这一年，物质富足，精神丰盈。",
+        "仓廪实而知礼节，衣食足而知荣辱。初四祈愿富足。",
+        "食禄绵长，福泽深厚。马年初四，吉祥如意。",
+        "愿手中有粮，心中不慌。初四接灶，岁岁安康。",
+        "丰衣足食，安居乐业。正月初四，万事亨通。",
+        "接灶神，保食禄。愿2026，日子过得殷实又幸福。",
+
+        # 短句补充篇
+        "初四接灶，福气满堂。",
+        "烟火人间，温暖相伴。",
+        "家肥屋润，衣食无忧。",
+        "灶神归位，万事顺遂。",
+        "三餐四季，温柔有趣。",
+        "食禄丰足，马年大吉。",
+        "正月初四，宜纳福。",
+        "烟火气中，幸福绵长。",
+        "迎灶纳祥，岁岁安康。",
+        "柴米油盐，皆是幸福。"
+    ],
+
+    # ==============================================
+    # 2026年2月21日 正月初五 (破五/迎财神)
+    # 核心：财运、破禁、送穷、发财
+    # ==============================================
+    date(2026, 2, 21): [
+        # 迎财纳福篇
+        "正月初五，迎财神。愿2026，财运亨通，富贵吉祥。",
+        "五路财神齐到访，八方来财福满堂。初五接福啦。",
+        "财神到，福运照。愿马年的每一天，都财源滚滚。",
+        "初五迎财，开门见喜。愿事业有成，财运亨通。",
+        "东路招财，西路纳珍。初五这一天，装满了财富。",
+        "财神骑马到家门，金银财宝进家门。马年发大财。",
+        "正月初五，财门大开。愿八方财源，滚滚而来。",
+        "迎财神，纳千祥。愿2026，腰缠万贯，富贵安康。",
+        "五路财神护佑，马年财运亨通。初五快乐。",
+        "财星高照，福气临门。正月初五，恭喜发财。",
+
+        # 破五送穷篇
+        "正月初五，破五送穷。送走烦恼，送走霉运，送走贫穷。",
+        "破五之时，送穷出门。愿2026，轻装上阵，奔赴美好。",
+        "鞭炮一响，穷鬼跑光。初五这一天，除旧布新。",
+        "破除禁忌，送走穷困。愿马年的日子，蒸蒸日上。",
+        "破五开运，万象更新。愿所有的不好，都随风而去。",
+        "送穷迎富，福气满屋。正月初五，好运连连。",
+        "破五之日，百无禁忌。愿想做的事，都能如愿。",
+        "送走旧岁的穷气，迎来新年的财气。初五大吉。",
+        "破五重生，焕然一新。愿2026，元气满满。",
+        "除旧迎新，破五纳祥。愿未来的日子，一片光明。",
+
+        # 马年钱程篇
+        "策马奔腾赴钱程，马不停蹄赚金银。初五快乐。",
+        "马年行大运，财运滚滚来。愿事业如骏马，飞驰向前。",
+        "金马送财，富贵花开。愿2026，钱途无量。",
+        "马力全开搞事业，一心一意赚大钱。初五吉祥。",
+        "如骏马驰骋，在财富的草原上，收获满满。",
+        "马到成功，财到手。愿2026，盆满钵满。",
+        "金马踏春来，财运随身带。正月初五，发财发财。",
+        "驰骋商海，如骏马奔腾。愿财源广进，日进斗金。",
+        "马年第一桶金，从初五迎财神开始。",
+        "财运如骏马，日行千里，夜行八百。",
+
+        # 短句补充篇
+        "初五迎财，富贵自来。",
+        "送穷迎富，万事胜意。",
+        "财神驾到，财源滚滚。",
+        "破五开运，马到成功。",
+        "五路接财，八方纳福。",
+        "马年发财，钱途无量。",
+        "正月初五，恭喜发财。",
+        "财门大开，好运自来。",
+        "送穷出门，迎富入宅。",
+        "日进斗金，腰缠万贯。"
+    ],
+
+    # ==============================================
+    # 2026年2月22日 正月初六 (送穷/开市)
+    # 核心：顺意、开工、送穷、六六大顺
+    # ==============================================
+    date(2026, 2, 22): [
+        # 六六大顺篇
+        "正月初六，六六大顺。愿2026，万事顺遂，顺心如意。",
+        "六六大顺日，马年吉祥时。愿好运连连，幸福满满。",
+        "初六大顺，一顺百顺。愿生活顺心，事业顺利。",
+        "天顺地顺人更顺，心顺意顺事事顺。正月初六快乐。",
+        "顺风顺水，顺理成章。愿马年的每一天，都顺顺利利。",
+        "六六大顺，福满人间。愿所有的美好，都如期而至。",
+        "初六送福，顺字当头。愿日子过得舒心，过得顺心。",
+        "顺气东来，福气西至。正月初六，万事亨通。",
+        "顺顺利利开工，红红火火生活。初六大吉。",
+        "顺境常伴，逆境不扰。愿2026，一路顺风。",
+
+        # 送穷启程篇
+        "正月初六，送穷启程。愿霉运清零，好运加满。",
+        "送走穷神，迎来福神。初六这一天，焕然一新。",
+        "穷气送出门，福气迎进门。愿马年的日子，富足安康。",
+        "初六送穷，一送永逸。愿2026，无病无灾，无贫无困。",
+        "鞭炮声声送穷神，欢歌笑语迎新春。正月初六快乐。",
+        "送穷归故里，迎富入新宅。愿生活蒸蒸日上。",
+        "初六启程，甩掉包袱。愿轻装上阵，奔赴前程。",
+        "穷神走，财神留。愿2026，富贵常伴。",
+        "送穷之日，开启新程。愿马年的路，越走越宽。",
+        "告别贫穷与烦恼，迎接富裕与快乐。初六吉祥。",
+
+        # 开市大吉篇
+        "正月初六，开市大吉。愿2026，事业兴旺，财源广进。",
+        "开工啦！愿马力全开，业绩长虹。",
+        "初六启市，百业兴旺。愿生意兴隆，客似云来。",
+        "开市迎财，大吉大利。愿马年的事业，如日中天。",
+        "鞭炮一响，黄金万两。初六开工，红红火火。",
+        "新征程，新起点。初六开市，未来可期。",
+        "开门做生意，笑脸迎财神。愿2026，订单不断。",
+        "初六开工，元气满满。愿工作顺利，薪水翻番。",
+        "开市纳福，生意兴隆。愿马年的事业，一马当先。",
+        "正月初六，宜开工。愿所有的努力，都有回报。",
+
+        # 短句补充篇
+        "初六大顺，万事亨通。",
+        "送穷迎富，开工大吉。",
+        "六六大顺，马到成功。",
+        "顺风顺水，前程似锦。",
+        "开市纳财，富贵吉祥。",
+        "正月初六，启程出发。",
+        "霉运清零，好运加满。",
+        "红红火火，开工大吉。",
+        "顺字当头，幸福安康。",
+        "马年开工，业绩长虹。"
+    ],
+
+    # ==============================================
+    # 2026年2月23日 正月初七 (人日/庆寿)
+    # 核心：生民、健康、成长、七菜
+    # ==============================================
+    date(2026, 2, 23): [
+        # 众人生日篇
+        "正月初七，人日快乐。愿世间所有人，平安健康。",
+        "传说女娲造人，初七始成。这是属于每个人的生日。",
+        "人日吉祥，喜乐安康。愿2026，善待每一个生命。",
+        "初七庆生，福满人间。愿岁月温柔，不负韶华。",
+        "所有人的生日，所有的祝福。愿平安常伴，健康常在。",
+        "人日之时，许下心愿：愿众生皆苦，唯有你甜。",
+        "正月初七，祝自己，也祝你，生日快乐。",
+        "生而为人，何其有幸。初七这一天，感恩生命。",
+        "人日纳福，愿每一个人，都能被世界温柔以待。",
+        "初七之日，万物生辉。愿生命蓬勃，充满希望。",
+
+        # 健康成长篇
+        "人日祈健康，愿身体无恙，精神饱满。",
+        "正月初七，宜养生。愿龙马精神，常驻心间。",
+        "健康是福，平安是金。愿2026，无病无灾。",
+        "在这个属于人的日子，愿健康常伴左右。",
+        "茁壮成长，不负春光。愿马年的每一天，都充满活力。",
+        "身强体健，百病不侵。初七祈愿，健康长寿。",
+        "愿如骏马，体魄强健，驰骋万里。",
+        "人日吃顿好，身体没烦恼。愿营养均衡，健康无忧。",
+        "正月初七，动起来。愿活力满满，元气十足。",
+        "健康的体魄，是梦想的基石。初七快乐。",
+
+        # 七菜迎春篇
+        "初七吃七菜，福气自然来。愿生活丰富多彩。",
+        "七菜羹，聚福气。愿2026，集齐所有的美好。",
+        "七种蔬菜，七种祝福。愿马年的日子，五彩斑斓。",
+        "食七菜，迎新春。愿日子过得有滋有味。",
+        "正月初七，尝鲜迎春。愿生活如七菜，清爽又健康。",
+        "七菜同煮，福气满屋。愿阖家欢乐，岁月静好。",
+        "吃口七菜羹，全年万事兴。初七吉祥。",
+        "七种食材，七种好运。愿马年的每一天，都有惊喜。",
+        "人日食七菜，健康又自在。愿身体安康，万事顺遂。",
+        "七菜迎春，福满人间。正月初七，喜乐安康。",
+
+        # 短句补充篇
+        "初七人日，喜乐安康。",
+        "众人生日，平安吉祥。",
+        "健康第一，万事无忧。",
+        "人日纳福，马年大吉。",
+        "生而自由，爱而无畏。",
+        "七菜迎春，福气满满。",
+        "正月初七，岁月静好。",
+        "生命可贵，且行且惜。",
+        "人日快乐，诸事顺遂。",
+        "龙马精神，健康长寿。"
+    ],
+
+    # ==============================================
+    # 2026年2月24日 正月初八 (开工/谷日)
+    # 核心：耕耘、丰收、事业、启程
+    # ==============================================
+    date(2026, 2, 24): [
+        # 开工启程篇
+        "正月初八，开工大吉。愿2026，马力全开，再创辉煌。",
+        "初八启程，奔赴前程。愿事业如骏马，一日千里。",
+        "假期归零，快乐不归零。初八开工，元气满满。",
+        "新的征程，从初八开始。愿脚踏实地，仰望星空。",
+        "初八开工，喜气洋洋。愿工作顺利，步步高升。",
+        "收心归位，全力以付。愿马年的事业，一马当先。",
+        "正月初八，宜奋斗。愿每一份努力，都不被辜负。",
+        "开工啦！愿2026，业绩长虹，薪水翻番。",
+        "带着新年的喜气，投入工作的热情。初八快乐。",
+        "启程出发，未来可期。正月初八，万事亨通。",
+
+        # 谷日祈丰篇
+        "正月初八，谷日吉祥。愿五谷丰登，国泰民安。",
+        "谷日祈丰收，愿大地回馈，仓廪丰实。",
+        "初八是谷日，预示丰收年。愿生活富足，岁月安稳。",
+        "春种一粒粟，秋收万颗子。初八祈愿，收获满满。",
+        "五谷飘香，日子绵长。愿马年的每一天，都衣食无忧。",
+        "谷日纳福，愿耕耘有收获，付出有回报。",
+        "正月初八，惜粮感恩。愿每一粒粮食，都被珍惜。",
+        "谷物丰登，福气盈门。愿2026，物质富足。",
+        "谷日之时，许下心愿：愿世间无饥饿，人间皆温饱。",
+        "初八谷日，福泽深厚。愿马年，岁岁丰收。",
+
+        # 耕耘收获篇
+        "一分耕耘，一分收获。初八开工，愿辛勤付出，换来硕果累累。",
+        "如农人耕耘，如骏马驰骋。愿在事业的田野，收获满满。",
+        "播种希望，收获未来。正月初八，宜行动。",
+        "不驰于空想，不骛于虚声。初八开始，脚踏实地。",
+        "耕耘当下，收获未来。愿2026，满载而归。",
+        "像守护庄稼一样，守护梦想。初八快乐。",
+        "辛勤耕耘，静待花开。愿马年的事业，蒸蒸日上。",
+        "只有播种，才有收获。初八启程，开始新的耕耘。",
+        "愿汗水浇灌梦想，收获金色的未来。正月初八吉祥。",
+        "耕耘岁月，收获幸福。愿2026，硕果累累。",
+
+        # 短句补充篇
+        "初八开工，大吉大利。",
+        "谷日祈丰，五谷丰登。",
+        "马力全开，奔赴前程。",
+        "耕耘收获，未来可期。",
+        "正月初八，宜奋斗。",
+        "业绩长虹，步步高升。",
+        "仓廪丰实，衣食无忧。",
+        "脚踏实地，仰望星空。",
+        "开工启程，马到成功。",
+        "播种希望，收获辉煌。"
+    ],
+
+    # ==============================================
+    # 2026年2月25日 正月初九 (天公生)
+    # 核心：天长地久、祈福、高远、玉皇诞
+    # ==============================================
+    date(2026, 2, 25): [
+        # 天公诞辰篇
+        "正月初九，天公生。愿上天庇佑，阖家安康。",
+        "玉皇大帝诞辰日，一拜天公，风调雨顺。",
+        "初九拜天公，福气满乾坤。愿2026，万事顺遂。",
+        "天公作美，岁月静好。正月初九，吉祥如意。",
+        "叩拜天公，祈愿平安。愿风调雨顺，国泰民安。",
+        "初九吉日，天公赐福。愿所有的美好，都降临身边。",
+        "天公生，福满门。愿金马踏云，带来祥瑞。",
+        "正月初九，诚心祈福。愿上天眷顾，诸事皆宜。",
+        "拜天公，纳千祥。愿2026，福运亨通。",
+        "天公庇佑，金马护航。初九安康，万事大吉。",
+
+        # 长长久久篇
+        "正月初九，长长久久。愿福气长久，财运长久。",
+        "九为数之极，寓意圆满。愿2026，长长久久的幸福。",
+        "初九之日，许下心愿：愿健康长久，快乐长久。",
+        "长长久久的陪伴，长长久久的幸福。正月初九快乐。",
+        "友谊长存，爱意长久。愿所有的关系，都天长地久。",
+        "初九纳福，愿好运长久相伴，烦恼长久远离。",
+        "幸福久久，好运连连。愿马年的每一天，都充满阳光。",
+        "长长久久的岁月，长长久久的安康。",
+        "正月初九，愿这份祝福，伴你天长地久。",
+        "久久同心，万事胜意。愿2026，美好长存。",
+
+        # 志存高远篇
+        "初九天公生，愿志存高远，心向星辰。",
+        "如天马行空，自由自在。愿梦想无边界，前程无阻碍。",
+        "仰望星空，脚踏实地。正月初九，未来可期。",
+        "心有凌云志，脚下万里途。愿马年的你，驰骋万里。",
+        "志在千里，壮心不已。愿2026，实现远大理想。",
+        "天高地阔，任君驰骋。愿如骏马，飞跃高山。",
+        "���月初九，宜立志。愿立下鸿鹄志，不负少年时。",
+        "胸怀天下，志存高远。愿马年的事业，蒸蒸日上。",
+        "心向蓝天，脚踏实地。愿每一步，都走得坚定。",
+        "初九之日，愿眼界开阔，格局打开。",
+
+        # 短句补充篇
+        "初九拜天，福泽绵绵。",
+        "天长地久，幸福安康。",
+        "天公赐福，万事大吉。",
+        "正月初九，步步高升。",
+        "志存高远，马到成功。",
+        "福气久久，好运连连。",
+        "风调雨顺，国泰民安。",
+        "天马行空，自在逍遥。",
+        "初九吉祥，福满人间。",
+        "长长久久，万事胜意。"
+    ],
+
+    # ==============================================
+    # 2026年2月26日 正月初十 (石不动/十全十美)
+    # 核心：圆满、稳固、十全十美、基础
+    # ==============================================
+    date(2026, 2, 26): [
+        # 十全十美篇
+        "正月初十，十全十美。愿2026，圆满无缺，万事胜意。",
+        "十全十美日，马年吉祥时。愿集齐所有的美好。",
+        "初十圆满，事事如意。愿生活有滋有味，有声有色。",
+        "十分幸福，十分美满。正月初十，福暖人间。",
+        "十全十美，百事无忧。愿马年的每一天，都顺心顺意。",
+        "初十这一天，愿所有的期待，都得到圆满答复。",
+        "十分好运，十分福气。愿2026，好运连连。",
+        "十全十美，千金不换。愿这份幸福，伴你一生。",
+        "正月初十，愿生活满分，快乐满分。",
+        "圆满之日，喜乐之时。愿马年，圆圆满满。",
+
+        # 根基稳固篇
+        "正月初十，石不动。愿根基稳固，如磐石般坚定。",
+        "石不动，心安稳。愿马年的每一步，都走得踏实。",
+        "初十之日，宜固本。愿基础扎实，前程稳固。",
+        "如磐石般坚定，如骏马般奔腾。愿动静皆宜。",
+        "根基深厚，枝繁叶茂。愿事业如大树，茁壮成长。",
+        "石不动，福常驻。愿家宅安宁，岁月静好。",
+        "正月初十，愿初心如磐，使命在肩。",
+        "稳固根基，才能行稳致远。初十吉祥。",
+        "如石般坚定，如水般灵动。愿马年的日子，刚柔并济。",
+        "初十纳福，愿基业长青，幸福长久。",
+
+        # 十福临门篇
+        "初十迎十福，福满门庭。愿福气、财气、运气，统统到来。",
+        "一福平安，二福健康。初十这一天，十福临门。",
+        "集齐十福，召唤好运。愿2026，福气满满。",
+        "十福齐至，万事亨通。正月初十，喜乐安康。",
+        "福满十方，喜盈门庭。愿马年的日子，红红火火。",
+        "初十接福，愿幸福像花儿一样，朵朵绽放。",
+        "十全十美，五福临门。愿2026，好事成双。",
+        "福运绵长，十全十美。愿每一个梦想，都开花结果。",
+        "正月初十，愿福气东来，紫气西至。",
+        "十福相伴，一生平安。愿马年，福暖四季。",
+
+        # 短句补充篇
+        "初十圆满，十全十美。",
+        "石不动，福常驻。",
+        "根基稳固，行稳致远。",
+        "十福临门，万事大吉。",
+        "正月初十，圆满收官。",
+        "十分幸福，十分美满。",
+        "马年圆满，事事如意。",
+        "初心如磐，未来可期。",
+        "初十吉祥，福满人间。",
+        "十全十美，喜乐无忧。"
+    ],
+
+    # ==============================================
+    # 2026年2月27日 正月十一 (子婿日/宴请)
+    # 核心：相聚、情谊、款待、热闹
+    # ==============================================
+    date(2026, 2, 27): [
+        # 欢聚宴请篇
+        "正月十一，欢聚时刻。愿情谊长存，温暖常在。",
+        "子婿之日，宴请亲朋。愿欢声笑语，充满屋宇。",
+        "正月十一，宜相聚。愿推杯换盏，共话桑麻。",
+        "宴请八方客，喜迎四海宾。正月十一，热闹非凡。",
+        "欢聚一堂，喜气洋洋。愿这份热闹，延续一整年。",
+        "十一之日，美酒佳肴。愿吃得开心，聊得尽兴。",
+        "高朋满座，胜友如云。愿马年的日子，贵人常伴。",
+        "正月十一，把酒言欢。愿烦恼抛诸脑后，快乐常驻心间。",
+        "相聚的时光，总是短暂。愿珍惜当下，不负相遇。",
+        "宴请亲朋，共庆新春。正月十一，吉祥如意。",
+
+        # 情谊绵长篇
+        "正月十一，情谊绵长。愿亲情、友情，如陈年老酒，越久越香。",
+        "岁月流转，情谊不变。愿每一次相聚，都温暖如初。",
+        "子婿之日，亲情浓。愿家人闲坐，灯火可亲。",
+        "朋友相聚，友情深。愿高山流水，知音常在。",
+        "情谊是冬日的暖阳，是夏日的清风。正月十一，感恩相遇。",
+        "愿这份情谊，如骏马奔腾，跨越山海，永不褪色。",
+        "正月十一，愿所有的感情，都能被温柔以待。",
+        "相聚是缘，相守是福。愿情谊长存，岁月静好。",
+        "把酒言欢，共叙情谊。愿马年的每一天，都有朋友相伴。",
+        "十一之日，愿情谊之花，常开不败。",
+
+        # 余庆延续篇
+        "年味未减，余庆延续。正月十一，依然喜气洋洋。",
+        "春节的热闹，还在继续。愿快乐不减，福气依旧。",
+        "正月十一，新年的余温尚在。愿好运连连，幸福满满。",
+        "年虽过半，味仍浓。愿马年的日子，依然红红火火。",
+        "余庆绵绵，福泽深厚。正月十一，万事顺遂。",
+        "新年的脚步虽远，祝福的心意未减。",
+        "正月十一，愿这份喜气，伴你左右。",
+        "年味渐淡，情意更浓。愿每一次相聚，都值得珍藏。",
+        "十一之日，愿新年的好运，继续加持。",
+        "余庆延续，马年大吉。愿未来的日子，充满阳光。",
+
+        # 短句补充篇
+        "正月十一，欢聚一堂。",
+        "情谊绵长，温暖相伴。",
+        "子婿之日，喜气洋洋。",
+        "把酒言欢，共话美好。",
+        "余庆延续，福满人间。",
+        "高朋满座，胜友如云。",
+        "十一吉祥，马年安康。",
+        "相聚是缘，相守是福。",
+        "年味依旧，快乐不减。",
+        "宴请亲朋，共庆新春。"
+    ],
+
+    # ==============================================
+    # 2026年2月28日 正月十二 (搭灯棚/备元宵)
+    # 核心：预热、光明、期待、筹备
+    # ==============================================
+    date(2026, 2, 28): [
+        # 搭棚迎灯篇
+        "正月十二，搭灯棚。为即将到来的元宵，点亮希望。",
+        "灯棚初搭，喜气初临。愿光明将至，幸福将至。",
+        "正月十二，张灯结彩。愿大街小巷，充满节日的气氛。",
+        "搭起灯棚，点亮心灯。愿2026，前途一片光明。",
+        "十二之日，筹备元宵。愿所有的期待，都如期而至。",
+        "灯棚高高挂，福气进门来。正月十二，吉祥如意。",
+        "红红火火搭灯棚，热热闹闹迎元宵。",
+        "正月十二，愿这一盏盏灯，照亮前行的路。",
+        "搭灯棚，纳吉祥。愿马年的夜晚，不再黑暗。",
+        "十二这一天，为团圆做准备。愿日子红红火火。",
+
+        # 元宵预热篇
+        "年味未消，元宵将至。正月十二，期待满满。",
+        "倒计时三天，元宵佳节即将登场。愿快乐加倍。",
+        "正月十二，心向元宵。愿那一碗汤圆，甜进心里。",
+        "春节的尾声，元宵的序曲。十二这一天，承上启下。",
+        "期待那一夜的灯火，期待那一碗的香甜。",
+        "正月十二，愿所有的美好，都在元宵之夜绽放。",
+        "预热元宵，福气先行。愿2026，圆圆满满。",
+        "十二之日，许下心愿：愿元宵之夜，月圆人圆。",
+        "春节的热闹还在，元宵的期待已来。",
+        "正月十二，愿这份期待，化作美好的现实。",
+
+        # 光明希望篇
+        "正月十二，点亮心灯。愿心中有光，脚下有路。",
+        "灯象征着希望。愿2026，如明灯指引，一路向前。",
+        "十二之日，愿光明驱散黑暗，希望战胜绝望。",
+        "心有明灯，不惧黑暗。愿马年的每一天，都充满阳光。",
+        "搭灯棚，迎光明。愿前程似锦，未来可期。",
+        "正月十二，愿这世间，灯火通明，温暖常在。",
+        "光明将至，幸福随行。愿马年的夜晚，星光璀璨。",
+        "点亮一盏灯，照亮一片天。十二这一天，充满希望。",
+        "愿心灯长明，愿福运长伴。",
+        "正月十二，愿如骏马，向着光明，飞驰而去。",
+
+        # 短句补充篇
+        "正月十二，搭灯迎福。",
+        "元宵预热，期待满满。",
+        "心有明灯，前途光明。",
+        "张灯结彩，喜气洋洋。",
+        "十二吉祥，圆圆满满。",
+        "筹备元宵，福气先行。",
+        "灯火可亲，未来可期。",
+        "马年十二，光明将至。",
+        "搭起灯棚，点亮希望。",
+        "喜迎元宵，万事顺遂。"
+    ],
+
+    # ==============================================
+    # 2026年3月1日 正月十三 (试灯/赏花灯)
+    # 核心：试灯、璀璨、浪漫、初亮
+    # ==============================================
+    date(2026, 3, 1): [
+        # 试灯初亮篇
+        "正月十三，试灯初亮。愿这一抹光，温暖整个春天。",
+        "灯火试明，幸福先行。愿元宵之夜，璀璨夺目。",
+        "十三试灯，点亮街头。愿这世界，五彩斑斓。",
+        "试灯的夜晚，星光与灯光交相辉映。",
+        "正月十三，灯火初上。愿这光亮，照亮心底的梦想。",
+        "试灯迎元宵，喜气满人间。愿2026，光彩照人。",
+        "十三之日，灯火璀璨。愿每一盏灯，都藏着美好祝福。",
+        "试灯啦！愿马年的夜晚，不再孤单。",
+        "正月十三，愿灯光驱散寒意，带来温暖。",
+        "灯火初亮，希望初升。愿未来的日子，一片光明。",
+
+        # 璀璨浪漫篇
+        "正月十三，灯火璀璨。愿生活如灯，五彩斑斓。",
+        "试灯之夜，浪漫无边。愿遇见美好，遇见爱。",
+        "灯火万家城四畔，星河一道水中央。十三之夜，美不胜收。",
+        "正月十三，愿这璀璨的灯火，照亮浪漫的人生。",
+        "灯光摇曳，人影婆娑。愿这一夜，温柔又美好。",
+        "十三试灯，愿所有的浪漫，都恰逢其时。",
+        "璀璨灯火，映照笑脸。愿马年的每一天，都灿烂如花。",
+        "正月十三，愿在灯火阑珊处，遇见那个对的人。",
+        "浪漫之夜，灯火可亲。愿幸福绵长，岁月静好。",
+        "试灯初亮，浪漫开场。愿2026，不负韶华。",
+
+        # 期盼圆满篇
+        "正月十三，期盼圆满。愿元宵之夜，月圆人圆事事圆。",
+        "试灯是序曲，元宵是高潮。愿精彩值得等待。",
+        "十三这一天，为圆满做最后的准备。",
+        "期盼那一碗汤圆，期盼那一夜团圆。",
+        "正月十三，愿所有的等待，都不负期待。",
+        "试灯之时，许下心愿：愿2026，圆圆满满。",
+        "期盼元宵，期盼美好。愿马年的第一个月圆，圆满无缺。",
+        "正月十三，愿这份期盼，化作甜蜜的果实。",
+        "灯火试明，圆满将至。愿幸福如约而至。",
+        "十三之日，愿所有的梦想，都圆满落地。",
+
+        # 短句补充篇
+        "正月十三，试灯纳福。",
+        "灯火璀璨，浪漫无边。",
+        "试灯初亮，希望在前。",
+        "十三吉祥，圆满可期。",
+        "璀璨灯火，照亮前程。",
+        "喜迎元宵，万事胜意。",
+        "试灯之夜，幸福相伴。",
+        "马年十三，光彩照人。",
+        "灯火可亲，岁月温柔。",
+        "期盼圆满，福满人间。"
+    ],
+
+    # ==============================================
+    # 2026年3月2日 正月十四 (元宵前夕/月色)
+    # 核心：待圆、酝酿、惜别、倒数
+    # ==============================================
+    date(2026, 3, 2): [
+        # 待圆酝酿篇
+        "正月十四，待圆之时。所有的美好，都在悄然酝酿。",
+        "月圆前夜，幸福将至。愿明天的团圆，圆满无缺。",
+        "十四这一天，静候月圆。愿所有的期待，都开花结果。",
+        "美好在酝酿，幸福在靠近。正月十四，满怀希望。",
+        "元宵前夕，蓄势待发。愿明天的烟火，惊艳时光。",
+        "十四之夜，月色渐浓。愿这温柔的夜，孕育美好的明天。",
+        "待圆之日，心怀期盼。愿2026，事事圆满。",
+        "正月十四，愿所有的遗憾，都在明天圆满。",
+        "酝酿已久的幸福，即将在明天绽放。",
+        "十四这一天，愿耐心等待，收获圆满。",
+
+        # 月色温柔篇
+        "正月十四，月色温柔。愿这一夜的月光，照亮心底的柔软。",
+        "月圆前夜，月色撩人。愿这温柔的光，伴你入梦。",
+        "十四之夜，月光如水。愿岁月静好，现世安稳。",
+        "月色朦胧，情意绵绵。愿这一夜，浪漫又安宁。",
+        "正月十四，愿月光指引，找到回家的路。",
+        "月光洒在身上，幸福藏在心里。",
+        "十四的月亮，虽未圆满，却已温柔。",
+        "愿这月色，洗去一身疲惫，带来满心欢喜。",
+        "正月十四，月色相伴，幸福相随。",
+        "月光所至，皆是美好。愿马年的夜晚，月色常明。",
+
+        # 惜别新春篇
+        "正月十四，惜别新春。愿这份年味，永驻心间。",
+        "春节的最后倒计时，珍惜最后的热闹。",
+        "十四这一天，是春节的尾声，也是元宵的序曲。",
+        "惜别新春，迎接元宵。愿美好延续，幸福长存。",
+        "正月十四，愿抓住春节的尾巴，再快乐一次。",
+        "年味渐淡，情意更浓。愿这份祝福，伴你一整年。",
+        "惜别旧岁的热闹，迎接新年的安稳。",
+        "十四之日，愿感恩相遇，珍惜拥有。",
+        "新春将过，记忆永存。愿2026，温暖常在。",
+        "正月十四，愿不负新春，不负韶华。",
+
+        # 短句补充篇
+        "正月十四，静待月圆。",
+        "月色温柔，幸福将至。",
+        "元宵前夕，蓄势待发。",
+        "惜别新春，迎接圆满。",
+        "十四吉祥，万事顺遂。",
+        "美好酝酿，幸福花开。",
+        "月色撩人，情意绵绵。",
+        "马年十四，期待满满。",
+        "静待花开，如愿以偿。",
+        "福暖元宵，圆满在即。"
+    ],
+
+    # ==============================================
+    # 2026年3月3日 正月十五 (元宵节/上元节)
+    # 核心：团圆、圆满、灯火、收官
+    # ==============================================
+    date(2026, 3, 3): [
+        # 圆满团圆篇
+        "正月十五，元宵佳节。愿月圆人圆，事事圆满。",
+        "上元之夜，万家团圆。愿这一轮明月，照亮每一个归人。",
+        "灯火良宵，鱼龙百戏。愿今宵团圆，岁岁长安。",
+        "一碗汤圆，一份团圆。愿生活软糯香甜，日子圆圆满满。",
+        "正月十五，月光所至，皆是团圆。",
+        "闹元宵，庆团圆。愿所有的思念，都能奔赴相见。",
+        "马年第一个月圆夜，愿美好与圆满撞个满怀。",
+        "花好月圆人团圆，福满乾坤春满园。",
+        "元宵佳节，愿天涯共此时，千里共婵娟。",
+        "圆满收官，幸福续航。愿这份团圆，延续一整年。",
+
+        # 灯火璀璨篇
+        "东风夜放花千树，更吹落，星如雨。上元灯火，璀璨人间。",
+        "正月十五，花灯如昼。愿这漫天灯火，照亮前行的路。",
+        "灯火万家，良辰美景。愿身处璀璨，心向光明。",
+        "赏花灯，猜灯谜。愿元宵之夜，热闹非凡，喜乐无边。",
+        "灯火阑珊处，美好正发生。愿你遇见惊喜，遇见幸运。",
+        "上元灯火，映照笑脸。愿2026，光彩夺目，熠熠生辉。",
+        "今夜灯明，如昼如幻。愿马年的日子，红红火火。",
+        "一盏花灯，一份祈愿。愿心之所向，光亮通达。",
+        "烟花绽放，灯火璀璨。愿这一刻的美好，定格成永恒。",
+        "元宵夜，看花灯。愿生活如灯，五彩斑斓，充满希望。",
+
+        # 喜乐民俗篇
+        "正月十五闹元宵，锣鼓喧天春意闹。愿欢声笑语，响彻云霄。",
+        "吃汤圆，闹元宵。愿团团圆圆，甜甜蜜蜜。",
+        "猜灯谜，赢好礼。愿智慧与福气，双双入怀。",
+        "舞龙舞狮，锣鼓喧天。愿马年的运势，气势如虹。",
+        "踩高跷，划旱船。愿民间喜乐，岁岁相传。",
+        "元宵佳节，宜欢聚，宜赏灯，宜纳福。",
+        "捏个汤圆，团团圆圆；挂盏灯笼，亮亮堂堂。",
+        "上元祈福，百无禁忌。愿所求皆如愿，所行皆坦途。",
+        "闹元宵，迎福气。愿2026，人气旺，财气旺，运气旺。",
+        "传统民俗，热闹元宵。愿文化传承，岁月流芳。",
+
+        # 新春收官篇
+        "正月十五，新春收官。感谢相遇，期待同行。",
+        "年味虽淡，情意不减。元宵一过，整装出发。",
+        "春节的最后一场狂欢，愿不留遗憾，尽兴而归。",
+        "圆满收官，奔赴新程。愿马年的下半场，更加精彩。",
+        "以元宵的圆满，开启全年的顺遂。",
+        "告别新春，迎接春天。愿万物复苏，梦想发芽。",
+        "正月十五，为春节画上一个完美的句号。",
+        "收官之夜，许下宏愿。愿2026，马力全开，一往无前。",
+        "新春已过，奋斗在即。愿不负春光，不负自己。",
+        "元宵圆满，万事胜意。愿这一年，步履不停，收获满满。",
+
+        # 短句补充篇
+        "元宵快乐，圆满吉祥。",
+        "花好月圆，喜乐安康。",
+        "灯火万家，幸福中华。",
+        "上元佳节，福满人间。",
+        "汤圆甜甜，日子圆圆。",
+        "闹元宵，迎好运。",
+        "马年元宵，圆满收官。",
+        "花灯璀璨，前程似锦。",
+        "月圆人圆，事事圆满。",
+        "正月十五，万事亨通。"
+    ]
+}
+
+lunar_calendar = {
+    date(2026, 2, 16): "除夕",
+    date(2026, 2, 17): "正月初一",
+    date(2026, 2, 18): "正月初二",
+    date(2026, 2, 19): "正月初三",
+    date(2026, 2, 20): "正月初四",
+    date(2026, 2, 21): "正月初五",
+    date(2026, 2, 22): "正月初六",
+    date(2026, 2, 23): "正月初七",
+    date(2026, 2, 24): "正月初八",
+    date(2026, 2, 25): "正月初九",
+    date(2026, 2, 26): "正月初十",
+    date(2026, 2, 27): "正月十一",
+    date(2026, 2, 28): "正月十二",
+    date(2026, 3, 1): "正月十三",
+    date(2026, 3, 2): "正月十四",
+    date(2026, 3, 3): "正月十五"
+}
+
+def get_lunar_date(gregorian_date):
+    """
+    根据公历日期获取对应的农历日期
+    参数：gregorian_date - datetime.date 对象
+    返回：str - 农历日期字符串；None - 日期不在农历范围内
+    """
+    return lunar_calendar.get(gregorian_date, None)
+
+def get_random_festival_quote():
+    """
+    根据当前日期从 SPRING_FESTIVAL_QUOTES 中随机获取一条祝福语
+    返回：str - 随机选中的祝福语；None - 当前日期无对应祝福语
+    """
+    # 获取当前系统日期（年-月-日）
+    today = date.today()
+    
+    # 1. 检查当前日期是否在祝福语字典中
+    if today in SPRING_FESTIVAL_QUOTES:
+        # 2. 获取当日的所有祝福语列表
+        daily_quotes = SPRING_FESTIVAL_QUOTES[today]
+        # 3. 随机选择一条祝福语
+        random_quote = random.choice(daily_quotes)
+        return random_quote
+    else:
+        # 若当前日期无对应祝福语，返回提示（也可改为返回None）
+        return f"今日（{today.strftime('%Y年%m月%d日')}）暂无专属春节祝福语"
+
+# 测试调用示例
+if __name__ == "__main__":
+    quote = get_random_festival_quote()
+    print(quote)

utils/config.py

@@ -0,0 +1,92 @@
+import json
+import logging
+import os
+import sys
+from enum import Enum
+from pathlib import Path
+
+from utils.logger import setup_logger
+
+
+logger = setup_logger(level=logging.DEBUG)
+
+DEBUG = False
+CONFIGFILE = "config.json"
+USERDATAFILE = "usersData.json"
+BASE_DIR = Path(__file__).resolve().parent.parent
+config = None
+userData = None
+
+
+class Environment(Enum):
+    GITHUBACTION = "GITHUB_ACTION"
+    LOCAL = "LOCAL"
+    PACKED = "PACKED"
+    HUGGINGFACE = "HUGGINGFACE"
+
+    def __str__(self):
+        return self.value
+
+
+def get_environment():
+    if getattr(sys, "frozen", False) and hasattr(sys, "_MEIPASS"):
+        return Environment.PACKED
+    if os.getenv("GITHUB_ACTIONS") == "true":
+        return Environment.GITHUBACTION
+    if os.getenv("SPACE_ID") or os.getenv("HF_SPACE_ID"):
+        return Environment.HUGGINGFACE
+    return Environment.LOCAL
+
+
+def _resolve_runtime_file(file_name):
+    env = get_environment()
+    if env == Environment.PACKED:
+        return os.path.join(os.path.dirname(sys.executable), file_name)
+    return str((BASE_DIR / file_name).resolve())
+
+
+def get_config():
+    global config
+
+    if config is not None:
+        return config
+
+    config_path = _resolve_runtime_file(CONFIGFILE)
+    with open(config_path, "r", encoding="utf-8") as f:
+        config = json.loads(f.read())
+    return config
+
+
+def reload_config():
+    global config
+    config = None
+    return get_config()
+
+
+def get_userData():
+    global userData
+
+    if userData is not None:
+        return userData
+
+    env = get_environment()
+    if env == Environment.GITHUBACTION:
+        user_data_json = os.getenv("USER_DATA", None)
+        if not user_data_json:
+            logger.error("Environment variable USER_DATA is not set.")
+            raise RuntimeError("USER_DATA is required in GitHub Actions.")
+    else:
+        user_data_path = _resolve_runtime_file(USERDATAFILE)
+        if not os.path.exists(user_data_path):
+            raise FileNotFoundError(f"Missing required file: {user_data_path}")
+        with open(user_data_path, "r", encoding="utf-8") as f:
+            user_data_json = f.read()
+
+    userData = json.loads(user_data_json)
+    return userData
+
+
+def reload_userData():
+    global userData
+    userData = None
+    return get_userData()

utils/github_action_config.py

@@ -0,0 +1,49 @@
+import json
+from rich.console import Console
+from rich.panel import Panel
+from utils.config import get_config
+import pyperclip
+
+config = get_config()
+
+# 初始化 rich 控制台
+console = Console()
+
+
+def compress_users_data():
+    # 压缩 usersData.json 内容
+    with open("usersData.json", "r", encoding="utf-8") as f:
+        user_data = json.loads(f.read())
+
+    return json.dumps(user_data, ensure_ascii=False)
+
+
+def print_github_action_config():
+    """
+    打印 GitHub Action 配置表格
+    """
+
+    # 输出前置步骤说明
+    steps = (
+        "1. 确保已克隆仓库并在仓库的 [bold yellow]Action[/bold yellow] 选项卡下启用 "
+        "[bold green]DouYin Spark Flow Schedule Run[/bold green]\n"
+        "2. 在仓库的设置选项卡下的 [bold yellow]Environment[/bold yellow] 配置项中添加 "
+        "[bold green]user-data[/bold green] 环境，并将下方列出 Secrets 依次添加到该环境的 Secrets 中"
+    )
+    console.print(Panel(steps, title="前置步骤", expand=False, style="bold cyan"))
+
+    secrets = {
+        "USER_DATA": compress_users_data()
+    }
+    if "proxyAddress" in config and config["proxyAddress"]:
+        secrets["proxyAddress"] = config["proxyAddress"]
+
+    # 打印每个键名和键值
+    console.print("\n[bold yellow]Secrets 配置：选中后右击鼠标复制（没有弹出菜单点击鼠标右键就完成复制了！）[/bold yellow]")
+
+    for key, value in secrets.items():
+        console.rule(f"[bold cyan]{key}[/bold cyan]")
+        console.print(f"[green]{value}[/green]\n")
+
+    pyperclip.copy(secrets["USER_DATA"])
+    console.print("[bold yellow]提示：[/bold yellow][bold magenta] USER_DATA 的值已自动写入剪贴板（建议直接粘贴，手动复制可能多出空白符导致出错） [/bold magenta]")

utils/hitokoto.py

@@ -0,0 +1,48 @@
+import requests
+from utils.config import get_config
+
+hitokotoApi = "https://v1.hitokoto.cn/"
+
+allHitokotoTypes = {
+    "动画": "a",
+    "漫画": "b",
+    "游戏": "c",
+    "文学": "d",
+    "原创": "e",
+    "来自网络": "f",
+    "其他": "g",
+    "影视": "h",
+    "诗词": "i",
+    "哲学": "k",
+    "抖机灵": "l",
+}
+
+
+def request_hitokoto():
+    """请求一言 API 获取一句话"""
+    config = get_config()
+    
+    api_url = hitokotoApi
+
+    for t in allHitokotoTypes.keys():
+        if t in config["hitokotoTypes"]:
+            if "?" not in api_url:
+                api_url += "?"
+            if "c=" in api_url:
+                api_url += f"&c={allHitokotoTypes[t]}"
+            else:
+                api_url += f"c={allHitokotoTypes[t]}"
+
+    try:
+        response = requests.get(api_url, timeout=10)
+        response.raise_for_status()
+        data = response.json()
+        theFrom = data.get("from")
+        if theFrom is None or theFrom.strip() == "":
+            theFrom = "未知来源"
+        theFromWho = data.get("from_who")
+        if theFromWho is None or theFromWho.strip() == "":
+            theFromWho = "未知作者"
+        return f"{data['hitokoto']} —— {theFrom} ({theFromWho})"
+    except Exception as e:
+        return "[error] 无法获取一言内容"

utils/logger.py

@@ -0,0 +1,67 @@
+import logging
+import os
+from collections import deque
+from logging.handlers import RotatingFileHandler
+
+
+if not os.path.exists("logs"):
+    os.makedirs("logs")
+
+
+LOG_FORMAT = "%(asctime)s - %(name)s - %(levelname)s - %(filename)s:%(lineno)d - %(message)s"
+LOG_FILE = "logs/app.log"
+MAX_IN_MEMORY_LOGS = 2000
+_recent_logs = deque(maxlen=MAX_IN_MEMORY_LOGS)
+
+
+class InMemoryLogHandler(logging.Handler):
+    """Keep recent log lines in memory for dashboard display."""
+
+    def emit(self, record):
+        try:
+            _recent_logs.append(self.format(record))
+        except Exception:
+            # Never let logging break business logic.
+            pass
+
+
+def get_recent_logs(limit=400):
+    if limit <= 0:
+        return ""
+    return "\n".join(list(_recent_logs)[-limit:])
+
+
+def setup_logger(name="app", level=logging.INFO):
+    logger = logging.getLogger(name)
+    logger.setLevel(level)
+
+    if logger.handlers:
+        return logger
+
+    formatter = logging.Formatter(LOG_FORMAT)
+
+    console_handler = logging.StreamHandler()
+    console_handler.setLevel(level)
+    console_handler.setFormatter(formatter)
+    logger.addHandler(console_handler)
+
+    memory_handler = InMemoryLogHandler()
+    memory_handler.setLevel(level)
+    memory_handler.setFormatter(formatter)
+    logger.addHandler(memory_handler)
+
+    try:
+        file_handler = RotatingFileHandler(
+            LOG_FILE,
+            maxBytes=5 * 1024 * 1024,
+            backupCount=3,
+            encoding="utf-8",
+        )
+        file_handler.setLevel(level)
+        file_handler.setFormatter(formatter)
+        logger.addHandler(file_handler)
+    except Exception as exc:
+        logger.warning("Failed to initialize file logger: %s", exc)
+
+    return logger
+