Files
life-echo/api/app/tasks/chapter_cover_tasks.py
Kevin a3f61fcc0f feat(api+app): 对话阶段化、回忆录流水线与客户端会话体验
- DB: segments 用户输入文本(Alembic 0002)
- Chat: 阶段检测/阶段提示/回复限制,编排与访谈/画像 prompts 调整
- Memoir: 忠实度检查 agent,叙事与分类等链路更新
- Core: agent 日志、Alembic 启动、LangChain/日志/配置等
- Story: time_hints;Memory 检索与相关测试
- Expo: 助手头像、会话页与消息拆分、实时会话与文案/i18n
- Docs/scripts/tests: 迁移脚本、LLM JSON/记忆检索文档、新增单测
2026-03-26 12:13:36 +08:00

316 lines
11 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""
Chapter 封面生成 Celery 任务。
从 chapter_cover_intents 原子 claim intent或创建新 intent 后生成封面,
写入 assets绑定到 chapters.cover_asset_id。封面不回写进正文 markdown。
"""
import hashlib
import uuid
from datetime import datetime, timedelta, timezone
from celery import shared_task
from PIL import Image
from sqlalchemy import and_, func, or_, select, update
from sqlalchemy.orm import joinedload
from app.core.db import get_sync_db
from app.core.dependencies import get_image_generator
from app.core.logging import get_logger
from app.core.redis_lock import acquire_redis_lock, release_redis_lock
from app.features.asset.models import Asset
from app.features.memoir.chapter_cover import (
aggregate_cover_prompt_from_stories,
)
from app.features.memoir.cover_eligibility import (
chapter_eligible_for_cover_by_inline_body_image_count,
chapter_has_story_links,
)
from app.features.memoir.memoir_images.storage import TencentCosStorageService
from app.features.memoir.models import Chapter, ChapterCoverIntent, ChapterStoryLink
from app.ports.image_gen import TaskStatus
logger = get_logger(__name__)
CHAPTER_COVER_LOCK_TTL_SECONDS = 1800
CHAPTER_COVER_CLAIM_TTL_SECONDS = 1800
def _build_cover_cos_key(user_id: str, chapter_id: str, prompt: str) -> str:
short_hash = hashlib.sha1(prompt.encode("utf-8")).hexdigest()[:10]
return f"chapters/{user_id}/{chapter_id}/cover-{short_hash}.png"
def _normalize_image_bytes(image_bytes: bytes) -> bytes:
from io import BytesIO
with Image.open(BytesIO(image_bytes)) as image:
output = BytesIO()
if image.mode in {"RGBA", "LA"}:
normalized = image
elif image.mode == "P":
normalized = image.convert("RGBA")
else:
normalized = image.convert("RGB")
normalized.save(output, format="PNG")
return output.getvalue()
def _build_cover_prompt(prompt_brief: str) -> str:
"""从 intent.prompt_brief 构建出图 prompt。"""
from app.agents.memoir.prompts import IMAGE_PLACEHOLDER_TEMPLATE
base = IMAGE_PLACEHOLDER_TEMPLATE
if prompt_brief and prompt_brief.strip():
return f"{base}{prompt_brief.strip()}"
return f"{base}。章节封面"
def _chapter_cover_claimable_clause(now: datetime):
cutoff = now - timedelta(seconds=CHAPTER_COVER_CLAIM_TTL_SECONDS)
return or_(
ChapterCoverIntent.status.in_(["pending", "failed"]),
and_(
ChapterCoverIntent.status == "processing",
or_(
ChapterCoverIntent.claimed_at.is_(None),
ChapterCoverIntent.claimed_at < cutoff,
),
),
)
def _build_chapter_cover_brief(chapter: Chapter) -> str:
stories = []
for link in sorted(
chapter.story_links, key=lambda link_row: link_row.order_index or 0
):
story = getattr(link, "story", None)
if story:
stories.append(story)
return aggregate_cover_prompt_from_stories(
stories,
chapter_title=chapter.title or "",
chapter_category=chapter.category or "",
)
def _claim_chapter_cover_intent_sync(db, chapter: Chapter, claim_token: str):
now = datetime.now(timezone.utc)
claimable = _chapter_cover_claimable_clause(now)
candidate_id = db.execute(
select(ChapterCoverIntent.id)
.where(ChapterCoverIntent.chapter_id == chapter.id)
.where(claimable)
.order_by(
ChapterCoverIntent.updated_at.desc(), ChapterCoverIntent.created_at.desc()
)
.limit(1)
).scalar_one_or_none()
if candidate_id:
claimed = db.execute(
update(ChapterCoverIntent)
.where(ChapterCoverIntent.id == candidate_id)
.where(_chapter_cover_claimable_clause(now))
.values(
status="processing",
claim_token=claim_token,
claimed_at=now,
updated_at=now,
error=None,
attempt_count=func.coalesce(ChapterCoverIntent.attempt_count, 0) + 1,
)
)
if (claimed.rowcount or 0) != 1:
db.rollback()
return None
intent = db.get(ChapterCoverIntent, candidate_id)
db.commit()
return intent
cutoff = now - timedelta(seconds=CHAPTER_COVER_CLAIM_TTL_SECONDS)
fresh_processing = db.execute(
select(ChapterCoverIntent.id)
.where(ChapterCoverIntent.chapter_id == chapter.id)
.where(ChapterCoverIntent.status == "processing")
.where(ChapterCoverIntent.claimed_at.is_not(None))
.where(ChapterCoverIntent.claimed_at >= cutoff)
.limit(1)
).scalar_one_or_none()
if fresh_processing:
return None
intent = ChapterCoverIntent(
id=str(uuid.uuid4()),
chapter_id=chapter.id,
prompt_brief=_build_chapter_cover_brief(chapter),
status="processing",
claim_token=claim_token,
claimed_at=now,
attempt_count=1,
)
db.add(intent)
db.flush()
db.commit()
return intent
@shared_task(bind=True, max_retries=3, default_retry_delay=30)
def generate_chapter_cover(self, chapter_id: str):
"""
为 chapter 生成封面。
从 chapter_cover_intents 原子认领 intent或创建新 intent 后生成,
写入 assets 并绑定到 chapters.cover_asset_id。
"""
lock_key = f"lock:chapter-images:{chapter_id}"
lock_handle = acquire_redis_lock(
lock_key, ttl_seconds=CHAPTER_COVER_LOCK_TTL_SECONDS
)
if lock_handle is None:
logger.debug("generate_chapter_cover: chapter={}, reason=locked", chapter_id)
return {"status": "locked"}
claim_token = uuid.uuid4().hex
intent = None
try:
with get_sync_db() as db:
stmt = (
select(Chapter)
.where(Chapter.id == chapter_id)
.options(
joinedload(Chapter.story_links).joinedload(ChapterStoryLink.story),
)
)
chapter = db.execute(stmt).unique().scalar_one_or_none()
if not chapter:
logger.debug(
"generate_chapter_cover: chapter={}, reason=not_found", chapter_id
)
return {"status": "no_chapter"}
if not chapter_eligible_for_cover_by_inline_body_image_count(chapter):
logger.debug(
"generate_chapter_cover: chapter={}, reason=insufficient_inline_body_images",
chapter_id,
)
return {"status": "insufficient_inline_body_images"}
if not chapter_has_story_links(chapter):
logger.debug(
"generate_chapter_cover: chapter={}, reason=no_story_links",
chapter_id,
)
return {"status": "no_story_links"}
if getattr(chapter, "cover_asset_id", None):
logger.debug(
"generate_chapter_cover: chapter={}, reason=has_cover_asset",
chapter_id,
)
return {"status": "already_has_asset"}
intent = _claim_chapter_cover_intent_sync(db, chapter, claim_token)
if not intent:
logger.debug(
"generate_chapter_cover: chapter={}, reason=no_claimable_intent",
chapter_id,
)
return {"status": "no_intent"}
try:
image_generator = get_image_generator()
storage = TencentCosStorageService.from_env()
from app.features.memoir.memoir_images.settings import MemoirImageSettings
settings = MemoirImageSettings.from_env()
prompt_final = _build_cover_prompt(intent.prompt_brief or "")
result = image_generator.generate(
prompt_final,
settings.default_size,
settings.default_style,
)
if result.status != TaskStatus.COMPLETED or not result.image_url:
raise RuntimeError(result.error or "Image generation failed")
image_bytes = _normalize_image_bytes(
image_generator.download_image(result.image_url)
)
cos_key = _build_cover_cos_key(chapter.user_id, chapter_id, prompt_final)
url = storage.upload_bytes(image_bytes, cos_key, "image/png")
asset_id = str(uuid.uuid4())
with get_sync_db() as db:
intent_db = db.get(ChapterCoverIntent, intent.id)
if (
not intent_db
or (intent_db.status or "").strip() != "processing"
or (intent_db.claim_token or "").strip() != claim_token
):
logger.debug(
"generate_chapter_cover: skip persist intent={} status={} claim={}",
intent.id,
getattr(intent_db, "status", None),
getattr(intent_db, "claim_token", None),
)
return {"status": "superseded_or_cancelled"}
asset = Asset(
id=asset_id,
asset_type="chapter_cover",
storage_key=cos_key,
url=url,
provider=settings.provider,
style_profile=settings.default_style,
prompt_final=prompt_final,
status="completed",
)
db.add(asset)
db.flush()
intent_db.asset_id = asset_id
intent_db.status = "completed"
intent_db.claim_token = None
intent_db.claimed_at = None
intent_db.error = None
intent_db.updated_at = datetime.now(timezone.utc)
chapter_db = db.get(Chapter, chapter_id)
chapter_db.cover_asset_id = asset_id
db.commit()
logger.info(
"generate_chapter_cover: chapter={}, asset={}",
chapter_id,
asset_id,
)
logger.debug(
"generate_chapter_cover: chapter={} asset={} url={} cos_key={} prompt_final={}",
chapter_id,
asset_id,
url,
cos_key,
prompt_final,
)
return {"status": "success", "asset_id": asset_id}
except Exception as exc:
if intent is not None:
with get_sync_db() as db:
intent_db = db.get(ChapterCoverIntent, intent.id)
if (
intent_db
and (intent_db.claim_token or "").strip() == claim_token
):
intent_db.status = "failed"
intent_db.claim_token = None
intent_db.claimed_at = None
intent_db.error = str(exc)
intent_db.updated_at = datetime.now(timezone.utc)
db.commit()
logger.warning(
"generate_chapter_cover failed: chapter={}, error={}", chapter_id, exc
)
raise self.retry(exc=exc) from exc
finally:
release_redis_lock(lock_handle)