重构回忆录为 story-first / markdown-first 架构并整合图片意图与前端 UI 修复
本次 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 映射等回归测试,并加入图片占位符退役设计文档。
This commit is contained in:
34
api/app/features/story/backfill.py
Normal file
34
api/app/features/story/backfill.py
Normal file
@@ -0,0 +1,34 @@
|
||||
"""
|
||||
Story 图片回填 — 将 asset:// 引用插入 markdown。
|
||||
|
||||
图片生成成功后,基于 source_span 或 fallback 位置插入 。
|
||||
"""
|
||||
|
||||
|
||||
def backfill_image_into_markdown(
|
||||
markdown: str,
|
||||
asset_id: str,
|
||||
caption: str,
|
||||
*,
|
||||
source_span: dict | None = None,
|
||||
) -> str:
|
||||
"""
|
||||
将图片引用回填到 markdown。
|
||||
|
||||
格式:
|
||||
位置:若 source_span 有效则在对应段落后插入;否则在开头插入。
|
||||
"""
|
||||
img_ref = f""
|
||||
if not markdown or not markdown.strip():
|
||||
return img_ref
|
||||
|
||||
if source_span and isinstance(source_span, dict):
|
||||
start = source_span.get("start")
|
||||
end = source_span.get("end")
|
||||
if start is not None and end is not None and 0 <= start <= end <= len(markdown):
|
||||
return markdown[:end] + "\n\n" + img_ref + "\n\n" + markdown[end:]
|
||||
|
||||
parts = markdown.strip().split("\n\n", 1)
|
||||
if len(parts) == 1:
|
||||
return img_ref + "\n\n" + markdown.strip()
|
||||
return parts[0] + "\n\n" + img_ref + "\n\n" + parts[1]
|
||||
Reference in New Issue
Block a user