nex_animation/backend/app/services/progress.py

72 lines
2.8 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

"""进行中的任务如何把自己「此刻在做什么」说出来。
为什么需要这一层:出图动辄四十几秒、出片动辄十几分钟,而调用模型的那段代码埋在
适配器深处(``providers/comfy_common.py``),手里既没有会话也不知道 task_id。
以前它什么都说不出来,界面上就只剩一个转圈的图标——用户分不清「模型正在算」
和「排在别人的任务后面」,只能一遍遍刷新页面去猜。
做法:执行线程起跑时把 task_id 绑到 thread-local(见 ``jobs/handlers.run``),
深处任何一层调 ``report("排队中:等待算力空闲")`` 就能写回任务行;
不在任务上下文里(普通请求线程)静默返回,调用点因此不需要判空。
写入走**另一条会话**并立刻提交:执行线程自己那条会话正握着业务事务,
在深处顺手 commit 会把事务提前收掉,半途失败的素材状态就会对不上。
"""
from __future__ import annotations
import logging
import threading
from typing import Any
from sqlalchemy import update
from app.db import SessionLocal
from app.models import Task, now_utc
log = logging.getLogger("nex.progress")
_local = threading.local()
#: message 列宽 400,超了按字符砍掉——宁可截断也不要当场报错
MAX_MESSAGE_CHARS = 400
def bind(task_id: int) -> None:
"""声明「当前线程正在执行这条任务」;由 handlers.run 统一调用。"""
_local.task_id = int(task_id)
def unbind() -> None:
_local.task_id = None
def current_task_id() -> int | None:
return getattr(_local, "task_id", None)
def report(message: str, *, progress: float | None = None) -> None:
"""给进行中的任务补一句解释(可顺带推进度);不在任务上下文里时什么都不做。
这里**只写不读**、且永远不改 status:状态归执行体自己收口,
深处这一层只负责把过程说清楚,失败了也不该影响正在跑的模型调用。
"""
task_id = current_task_id()
if not task_id:
return
patch: dict[str, Any] = {"message": message[:MAX_MESSAGE_CHARS], "heartbeat_at": now_utc()}
if progress is not None:
patch["progress"] = max(0.0, min(1.0, float(progress)))
session = SessionLocal()
try:
session.execute(update(Task).where(Task.id == task_id).values(**patch)
.execution_options(synchronize_session=False))
session.commit()
except Exception as exc: # noqa: BLE001 - 说不出来不等于做错了
log.debug("任务 #%s 状态说明回写失败:%s", task_id, exc)
session.rollback()
finally:
session.close()
__all__ = ["MAX_MESSAGE_CHARS", "bind", "current_task_id", "report", "unbind"]