小说创作智能体（自研薄编排层）

两段式：规划组（创意→大纲+设定圣经）→ 写作组（大纲→全自动出稿）。两组通过共享文档库 workspace/ 交接，零耦合。模型走国内 OpenAI 兼容接口：DeepSeek / Qwen / GLM / 讯飞星火任选。

两段式流程

plan:  一段话创意 →[交互问答]→ concept-brief.md
            →[自动] 世界观→人物→剧情→伏笔节奏 → bible/*.md + outline.md（分卷+章梗概）
            →[评审→仲裁→修订] 大纲定稿
            │ 交接（同一 workspace）
write: Director 读 outline.md（抽本卷走向+本章梗概）+ bible → 单章细纲 → 写手
            → 四评审(读者/主播/逻辑/文学) → 仲裁 →[收敛]→ 文学润色(逻辑复检) → 定稿
            → 设定师增量更新 bible/continuity.md（供下一章读取）

规划组角色（7 个，`agents/planning/`）

角色	文件	职责与质量硬要求
简案策划师	`brief_strategist.py`	每轮只问最收窄空间的 1-3 问 → 简案必含差异化卖点 + 对标不同点
世界观架构师	`worldbuilder.py`	世界观/规则体系 + 代价体系（能力必有代价）+ 编号设定红线清单
人物设计师	`character_designer.py`	每人四件套（欲望-恐惧-谎言-弧光）+ 语言指纹 + 人物红线
剧情架构师	`plot_architect.py`	分卷（含卷末高潮）+ 章梗概四元组（事件/冲突/钩子/推进）→ outline.md
伏笔节奏设计师	`pacing_designer.py`	伏笔台账（编号\|埋设章\|预定回收章\|回收方式）+ 只写可核验规则的文风指南
大纲评审	`outline_critic.py`	逻辑视角 + 商业清单（黄金三章/追读节奏/断更点/卖点兑现）
策划总监	`planning_director.py`	大纲仲裁：硬伤才打回、第3轮起收益递减放行

写作组角色（10 个，含第二阶段 4 角色）

角色	文件	职责与质量硬要求
主控	`agents/director.py`	起承转合节拍细纲 + 指定章末钩子类型；时序纪律（未到章号的人物/事实禁提前引用）
写手	`agents/writer.py`	show-don’t-tell/对白三要求/进场晚离场早；修订禁抄评审示例句、场景清单核对防丢内容
读者评审	`agents/reader_critic.py`	弃书触发器清单 + 强制评钩子 + 回答”会不会点下一章”
主播评审	`agents/streamer_critic.py`	口播可念性；书面语风格偏好最多报一次且归 low（防死循环）
逻辑检测	`agents/logic_checker.py`	先查分章大事记→再查因果→后核数值；issue 须引用违反的条目原文
文学评审	`agents/literary_critic.py`	陈词滥调/叙事距离/情绪是否挣得；对照文风指南上报违规
修订仲裁	`agents/arbiter.py`	硬伤才打回、品味归优化；第3轮起收益递减放行；顺带核查字数
文学润色	`agents/polisher.py`	砍副词/换强动词/拆长句，只做减法；复检只拦新引入硬伤
设定师	`agents/continuity_keeper.py`	维护 `continuity.md`：事实标注确立章号 + 分章大事记（供跨章进度）
经验提炼	`agents/craft_distiller.py`	教训须”可直接执行”；文风指南优先级高于经验库

第二阶段 4 角色（文学评审/文学润色/设定师/经验提炼）默认全开；在 .env 置 ENABLE_LITERARY_REVIEW/ENABLE_POLISH/ENABLE_CONTINUITY/ENABLE_CRAFT_MEMORY=false 可逐项回退。

回顾优化组（4 个，`agents/retro/`）——处理”问题停滞”

台账终态闭环：每条残留问题最终归于 已优化 / 搁置（品味） / 待改（留人工）/ 已作废（重写）。入口：python main.py retro（自动扫早停/超时章）或 retro --chapters 1-3； write --chapters N --from-issues 同样路由到本组。

文档库产物（`workspace/`）

bible/*.md 设定圣经（你提供的部分系统只读用于校验；continuity.md 由设定师自动维护，含分章大事记；style-guide.md 走独立最高优先通道注入写手/润色/文学评审）
chapters/章N.md 定稿正文（章头如实标注：收敛于第K轮 / 早停定稿 / 达上限定稿）
review-log/章N-第K轮.md 每轮评审快照
issues.md 必改问题台账　improvements.md 可选优化　revision-decisions.md 仲裁记录
run-state.json 断点续跑检查点（简案历史 / 大纲草稿轮次 / 写作进度与补充指引）
craft/{writer,reviewer,director}.md 自进化经验库（每章定稿后自动沉淀，注入后续写作；可手动编辑）

断点续跑与中途补充

进度自动落盘，中断后原样重跑同一命令即自动续跑（跳过已定稿单元、复原上下文）；--fresh 从头来。

续写注入新指引：write --chapters 5-10 --note "加入角色墨鸦" --from 5
继续简案问答：重跑 plan 复原对话接着答
修订已定稿：plan --note "..."（改大纲）/ write --chapters 5 --redo --note "..."（返工某章）
按问题台账优化：plan --from-issues（优化大纲）/ write --chapters N --from-issues（优化章节）——读回 issues.md/improvements.md 逐条落实并标记已优化

详见 USAGE.md 第 8 节。

快速开始

uv venv .venv && uv pip install -r requirements.txt
cp .env.example .env        # 填入 LLM_PROVIDER 和对应 API Key

# 不花钱先自检结构
python main.py plan --seed "赛博朋克+修仙" --dry-run
python main.py write --outline examples/outline.md --chapters 1-3 --dry-run

# 规划：交互出简案 → 自动出大纲+设定圣经
python main.py plan --seed "赛博朋克+修仙"

# 写作：基于大纲全自动出稿（默认读 workspace/outline.md）
python main.py write --chapters 1
# 或直接用示例大纲
python main.py write --outline examples/outline.md --chapters 1

切换模型

改 .env 里的 LLM_PROVIDER（deepseek/qwen/glm/astron）即可；模型名与收敛参数在 config.py（默认：单章 4 轮、硬上限 8、过关阈值 medium）。

编排流程

主控产细纲(节拍+钩子类型) → 写手出稿(文风指南最高优先) → [读者/主播/逻辑/文学] 并行评审(带本章梗概基准)
   └─ 仲裁裁决(硬伤才打回；第3轮起收益递减；核查字数)
       → 打回 → 写手定向重写（携历轮记忆；禁抄示例句；场景清单核对）
       → 收敛 / 早停(问题停滞) / 超时(达上限) —— 章头如实标注
定稿前 → 文学润色（复检只拦新引入硬伤，原有问题不回退）
定稿后 → 设定师更新 continuity.md(分章大事记) → 经验提炼更新 craft/*.md（注入后续章节）

编排逻辑集中在 pipeline.py，角色只管”输入→输出”，便于增删角色。质量设计四支柱：

跨章连续性：分章大事记作前文进度 + 时序纪律（防人物提前登场类事故）；
收敛可控：过关阈值 + 收益递减 + 早停，质量靠阈值而非堆轮数；
文风强执行：style-guide 独立最高优先通道，评审对照上报违规；
双层迭代：章内历轮记忆（抑制震荡）+ 跨章经验库（越写越懂偏好）。