group_fqcd_jr/app/worker/__main__.py

import argparse
import asyncio
import logging

from app.core.config import get_settings
from app.infrastructure.db import engine
from app.worker.runtime import WorkerRuntime

logger = logging.getLogger(__name__)


async def serve(*, once: bool = False) -> None:
    settings = get_settings()
    runtime = WorkerRuntime(settings=settings)
    try:
        while True:
            try:
                worked = await runtime.run_once()
            except Exception:
                # 常驻 Worker 不能因为"某一轮"的异常就整体退出：数据库抖动、
                # 迁移期间锁表、外部依赖瞬断都会命中这里，而 `run_once` 里的
                # 裸查询没有兜底。单轮失败记录堆栈后退避重试；`--once` 模式
                # 保持抛出，便于诊断一次性运行的真实问题。
                logger.warning("worker round failed; retrying after backoff", exc_info=True)
                if once:
                    raise
                await asyncio.sleep(settings.worker_poll_seconds)
                continue
            if once:
                return
            if not worked:
                await asyncio.sleep(settings.worker_poll_seconds)
    finally:
        await engine.dispose()


def main() -> None:
    parser = argparse.ArgumentParser(description="Agent 底座独立 Worker")
    parser.add_argument("--once", action="store_true", help="消费一次后退出")
    args = parser.parse_args()
    logging.basicConfig(level=get_settings().log_level)
    try:
        asyncio.run(serve(once=args.once))
    except KeyboardInterrupt:
        pass


if __name__ == "__main__":
    main()