7f57f96c25
本次 squash merge 将 codex-story-first-image-intent 的整体改动合入 development，核心内容包括： 1. 后端数据与迁移：新增 stories、story_versions、story_image_intents、chapter_cover_intents、assets 等模型与 Alembic 迁移，建立 story-first、markdown-first、asset-first 的主数据链路。 2. 生成与任务链：引入 StoryBuilderOrchestrator、ChapterComposerOrchestrator、story_image_tasks、chapter_cover_tasks，图片生成从正文占位符改为结构化 intent -> asset -> markdown 回填。 3. 并发与一致性：为 story/chapter intent 增加 claim_token、claimed_at、attempt_count，采用数据库原子 claim 为主、Redis 锁为辅，避免重复生成、锁误删和 processing 卡死。 4. Memoir 读写路径：章节 canonical_markdown 成为正文真源，列表/详情接口补齐 markdown、cover_asset、word_count 等字段，PDF 与 asset 解析链路同步升级。 5. Memory / Retrieval：扩展 transcript ingest、chunking、evidence 检索与 story 聚合基础设施，为后续 story-first RAG 与多 agent 编排提供底座。 6. App 端体验：章节页继续走 MarkdownRenderer 阅读链，同时吸收 fix3-19 的跨平台 UI glitch 修复；更新对话页、首页、文案资源与章节列表映射逻辑。 7. 测试与文档：补充 asset resolver、story image task、章节封面派发、markdown 映射等回归测试，并加入图片占位符退役设计文档。
42 lines
1.0 KiB
Python
42 lines
1.0 KiB
Python
"""Small Redis lock helpers for background tasks."""
|
|
|
|
from dataclasses import dataclass
|
|
import uuid
|
|
|
|
import redis
|
|
|
|
from app.core.config import settings
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class RedisLockHandle:
|
|
client: redis.Redis
|
|
key: str
|
|
token: bytes
|
|
|
|
|
|
def acquire_redis_lock(key: str, *, ttl_seconds: int) -> RedisLockHandle | None:
|
|
"""Acquire a single-owner Redis lock or return None when unavailable."""
|
|
client = redis.from_url(settings.redis_url, decode_responses=False)
|
|
token = uuid.uuid4().hex.encode("utf-8")
|
|
if not client.set(key, token, nx=True, ex=ttl_seconds):
|
|
return None
|
|
return RedisLockHandle(client=client, key=key, token=token)
|
|
|
|
|
|
def release_redis_lock(handle: RedisLockHandle | None) -> None:
|
|
"""Release the lock only if we still own it."""
|
|
if handle is None:
|
|
return
|
|
handle.client.eval(
|
|
"""
|
|
if redis.call("GET", KEYS[1]) == ARGV[1] then
|
|
return redis.call("DEL", KEYS[1])
|
|
end
|
|
return 0
|
|
""",
|
|
1,
|
|
handle.key,
|
|
handle.token,
|
|
)
|