图文小说应用

技术基线

World 世界（宇宙）
│
├─ 共享设定 （跨小说通用）
│   ├─ Character 角色 ────┐
│   ├─ Scene 场景     ────┼──→ 可被配图点引用（多对多）
│   └─ 世界观 / 力量体系 / 地理  │
│                              │
│                   两者均带 阶段版本（随时间推进）
│
└─ Novel 小说 （世界中的一个故事）
    └─ Volume 卷
        └─ Chapter 章
            └─ SceneSegment 场景段
                └─ IllustrationPoint 配图点
                    └─ Image 图片 （可多版本，含候选）

Revision 修订 （所有正文变更留痕，可回滚）

起步兼容：初期 1 个世界 + 1 本小说，与单本创作体验无差别； 后续新增小说时自动继承共享设定。

数据根目录/
│
├── sandbox/      测试区  AI 试写、生图试验、导入预览
├── workspace/    工作区  正在写的小说、草稿、未完成配图
├── production/   正式储存 已定稿内容，阅读页「正式」模式读这里
├── backup/       备份区  重大改动前的快照
└── trash/        回收站  可恢复；1 个月后永久删除

流转规则

角色卡：按需生成的稳定资产

角色卡不是每张图都重新生成。读取剧情时生成一次、存档，之后复用。 当角色进入新形态，再手动（或自动）生成一张新阶段的卡，不满意可以反复重生， 满意才存。

阶段状态：单向推进的状态机

角色「沈墨渊」
├─ 阶段 1「筑基期」    第 1 章起    青年修士，黑发，深色袍
├─ 阶段 2「机械飞升」  第 30 章起   一旦进入，后续全部延续此形态
└─ 阶段 3「……」        第 80 章起

给定「第 N 章」，系统应能唯一确定角色当时的形态——不靠你手选。

双锚：文字与图片都要

提示词编译器：隔离格式差异

不同上游的生图提示词格式不同——NovelAI 系用标签式，其他用自然语言，中英文支持 也不一致。所以加一层编译器：角色卡只存语义，不存死提示词， 由编译器按目标模型渲染成对应格式。换模型时角色卡不用改。

【语义层】模型无关、语言无关
  角色：阿芷 / 阶段2 / 桃花眼、眼尾绯红
  场景：荒山洞府 / 火光
        │
        ▼  按目标模型适配
【渲染层】模型专属
  NAI 系  → 标签串 + 英文 + 权重语法
  自然语言 → 中文描述句
  其他     → 各连接自定义模板

现象

提交生图任务后，任务状态一直是「排队中」——不报错、不推进、不提示。 连接健康状态显示为 failed。

根因

worker 主循环捕获了执行器的异常，但只把任务 id 加进一个进程内存集合， 然后静默把状态改回排队——不写错误码、不记日志、不转失败状态。 该集合被用于排除认领，于是在本次进程生命周期内，这个任务永远不会再被处理。

# 简化示意
try:
    self.executor(task, self)
except Exception:
    self._failed_tasks.add(task["id"])   # 仅内存，重启即丢
    self._safe_abandon(task)             # 静默改回 queued

影响面

新系统的处理

失败必须落库（错误码 + 可读错误信息 + 状态转失败）；失败任务可重试； 禁止静默回退——失败就是失败，不假装回队。这条写进了第 0 期地基与第 4 期任务队列的验收标准。