bb16d3a5c9
访谈与阶段 - 新增 app/agents/stage_constants.py：集中 CHAT_STAGES、章节分类/顺序、阶段到默认 memoir 类别等，与 MemoirState 默认槽位顺序对齐；减少散落在 prompts 内的重复常量。 - 新增 app/agents/chat/prompt_context.py：以 ChatPromptContext 汇总 guided 系统提示所需字段（阶段、槽位、轮次、人设、记忆证据、回复长度模式、背景声线、职业等），统一走 get_guided_conversation_prompt。 - 大幅收敛 app/agents/chat/prompts_conversation.py；调整 prompts.py、stage_prompts.py、stage_detection.py；同步 interview_agent、profile_agent、helpers 与 state_schema，使对话侧构造提示的方式一致、可测。 回忆录流水线 - memoir/prompts.py 删除已迁至 stage_constants / 独立模板的大段常量与图片占位相关逻辑；classification / extraction / fidelity / narrative agents 与 orchest（全量历史仍可用于计数，注入模型时按轮次与字符上限截断）、image_prompt_fallback_disabled。 - dependencies 增加 get_llm_provider_fast（LRU 缓存，可与默认共用密钥与 base_url）。 任务与编排 - memoir_tasks：prepare_batches 注入 llm_fast；开启独立快档模型时打结构化日志。 - chapter_cover_tasks、story_image_tasks：与图片 prompt / JSON 工具路径或策略变更对齐（import 与行为一致）。 - story_pipeline_sync 等小处同步。 其它核心 - langchain_llm、text_normalize 随上述调用链微调。 开发者体验 - .cursor/settings.json：启用 redis-development、postman 插件。 测试 - 新增 test_image_prompt_policy：覆盖「禁止回退」等图片 prompt 策略。 - 更新 test_interview_prompts、test_interview_reply_length、test_experience_regressions、test_json_and_memory_utils，匹配新常量位置、json_utils 与对话/长度行为。
319 lines
12 KiB
Python
319 lines
12 KiB
Python
"""
|
||
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.agents.image_prompt import get_image_prompt_orchestrator
|
||
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 _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"}
|
||
|
||
chapter_title = chapter.title or ""
|
||
chapter_category = chapter.category or ""
|
||
chapter_user_id = chapter.user_id
|
||
|
||
try:
|
||
image_generator = get_image_generator()
|
||
storage = TencentCosStorageService.from_env()
|
||
from app.features.memoir.memoir_images.settings import MemoirImageSettings
|
||
|
||
settings = MemoirImageSettings.from_env()
|
||
orch = get_image_prompt_orchestrator()
|
||
prompt_out = orch.build_cover_prompt(
|
||
chapter_title=chapter_title,
|
||
chapter_category=chapter_category,
|
||
context_excerpt=intent.prompt_brief or "",
|
||
)
|
||
prompt_final = prompt_out["prompt"]
|
||
style_for_image = prompt_out.get("style") or settings.default_style
|
||
size_for_image = prompt_out.get("size") or settings.default_size
|
||
|
||
result = image_generator.generate(
|
||
prompt_final,
|
||
size_for_image,
|
||
style_for_image,
|
||
)
|
||
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=style_for_image,
|
||
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)
|