docs: Writer 串行约束写回(T10 架构审查整改,I14)

- design.md §6.8.1 新增串行生成约束:理由(章间引用依赖前章 WriterState /
  并行收益低复杂度高 / Token 友好)+ 落地点(编排层严格顺序串行、UI 预估
  总时长与逐章进度、禁止并发多章)
- api-design §4.3 补串行消费说明(对应 §6.8.1)
- web-ui-design 进度 UI 补串行语义(预计=章数×单章 3-5 分)
- 纯文档,无代码变更;全量 248 passed / 100.00% 不回归
This commit is contained in:
lhl
2026-08-12 23:11:14 +08:00
parent 3ae1f5f38f
commit a1336f6dd3
4 changed files with 31 additions and 1 deletions
+7 -1
View File
@@ -191,9 +191,15 @@ WS /api/ws/sessions/{id}
### 4.3 进程内调用 vs 队列
```
默认(InMemoryQueue:
默认(InMemoryQueue):
Orchestrator 进程内 asyncio 任务池消费队列
状态与任务结果共享内存(FastAPI 进程内)
```
> **串行生成约束(T10 文档化,对应 design.md §6.8.1 / I14**:同一会话的逐章生成
> 任务**严格按模板章节顺序串行消费**。`POST /generate` 投递后不并发执行多章——
> 后章依赖前章 `WriterState` 摘要(design §6.9),并行会造成竞态。单章失败可独立
> `regenerate-chapter` 重试,不影响其余章。
v2 预留)RedisQueue/ValkeyQueue:
Orchestrator 投递 → Redis/Valkey Stream