重构回忆录为 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:
Kevin
2026-03-20 10:30:07 +08:00
parent 13e3124b85
commit 7f57f96c25
67 changed files with 4751 additions and 832 deletions

View File

@@ -59,32 +59,28 @@ class MemoirImageParserTest(unittest.TestCase):
)
self.assertEqual(items[0]["description"], "1938年初的上海弄堂口冬日萧瑟")
def test_parse_narrative_json_returns_sections_with_content_and_placeholder_info(
self,
):
def test_parse_narrative_json_ignores_image_description(self):
raw = '{"paragraphs": [{"content": "那年春天。", "image_description": "南方小镇的青石板路"}, {"content": "奶奶坐在藤椅上。", "image_description": "奶奶的藤椅"}]}'
segments = parse_narrative_json(raw)
self.assertEqual(len(segments), 2)
self.assertEqual(segments[0]["content"], "那年春天。")
self.assertEqual(
segments[0]["placeholder_info"]["description"], "南方小镇的青石板路"
)
self.assertIsNone(segments[0]["placeholder_info"])
self.assertEqual(segments[1]["content"], "奶奶坐在藤椅上。")
self.assertEqual(segments[1]["placeholder_info"]["description"], "奶奶的藤椅")
self.assertIsNone(segments[1]["placeholder_info"])
def test_parse_narrative_to_sections_prefers_json_then_fallback_to_placeholder(
self,
):
def test_parse_narrative_to_sections_json_then_plain_strips_placeholders(self):
json_raw = (
'{"paragraphs": [{"content": "段落一", "image_description": "图一"}]}'
)
segments = parse_narrative_to_sections(json_raw)
self.assertEqual(len(segments), 1)
self.assertEqual(segments[0]["content"], "段落一")
self.assertEqual(segments[0]["placeholder_info"]["description"], "图一")
self.assertIsNone(segments[0]["placeholder_info"])
placeholder_raw = "正文。\n\n{{{{IMAGE:描述}}}}\n\n结尾。"
segments2 = parse_narrative_to_sections(placeholder_raw)
self.assertEqual(len(segments2), 2)
self.assertIn("正文", segments2[0]["content"])
self.assertEqual(segments2[0]["placeholder_info"]["description"], "描述")
self.assertEqual(segments2[0]["content"], "正文。")
self.assertEqual(segments2[1]["content"], "结尾。")
self.assertIsNone(segments2[0]["placeholder_info"])
self.assertIsNone(segments2[1]["placeholder_info"])