novel-creator

name	novel-creator
description	Use when user wants to write chapters, generate drafts, or continue the story. Triggers include "写第", "生成章节", "续写", "草稿", "创作".

小说创作编排

Dante 的完整原始对话追加保存在 data/workflows/agent_session.jsonl； agent_session.yaml 是有界的恢复状态。较早轮次进入滚动摘要，但原始记录不会因压缩丢失。

网页端模型连接从 Studio 顶栏“模型设置”进入。配置在当前服务进程即时生效； DeepSeek 快速预设为 V4 Pro / V4 Flash；OpenAI / Anthropic 是接口格式而非模型限定， Base URL 和模型名可编辑。 API Key 不进入作品文件、Git、浏览器存储、ReAct 工具结果或会话历史。 Studio 将 Goethe / Dante 回复按安全 CommonMark 渲染；用户输入、错误消息和原始 HTML 不作为可执行页面内容处理。

编排 Director → Writer → User Review → Stylist 完整创作流程。

触发条件

• "写第X章" / "写章节"
• "生成章节" / "生成草稿"
• "续写" / "继续创作"
• "创作" + 章节相关

工作流程

digraph creation_flow {
    rankdir=TB;
    
    "用户请求" [shape=box];
    "解析意图" [shape=box];
    "组装上下文" [shape=box];
    "生成节拍" [shape=box];
    "生成草稿" [shape=box];
    "用户审核" [shape=diamond style=filled fillcolor=lightyellow];
    "风格润色" [shape=box];
    "保存草稿" [shape=box];
    "重写" [shape=box];
    
    "用户请求" -> "解析意图";
    "解析意图" -> "组装上下文";
    "组装上下文" -> "生成节拍";
    "生成节拍" -> "生成草稿";
    "生成草稿" -> "用户审核";
    "用户审核" -> "风格润色" [label="通过"];
    "用户审核" -> "重写" [label="修改"];
    "重写" -> "生成节拍";
    "风格润色" -> "保存草稿";
}

Step 1: 解析意图

从用户请求中提取：

• 章节 ID: ch_005 或 第五章
• 创作目标: 继续故事、特定场景、情感走向
• 约束条件: 禁用词、必需元素、字数要求

未指定章节时先调用 get_outline_structure：选择大纲顺序中最早尚无正文的章纲，并读取其卷/幕/节面包屑。指定章节时也用该工具验证章纲存在；已有正文时打开或审查，不得直接覆盖。

Studio 创建章节时使用返回的建议预填 chapter_id、所属节上下文和最近三章实际字数均值。提交时携带大纲 revision；revision 冲突时重新预览，禁止继续使用旧建议。

结构调整优先使用 edit_outline_structure 的最小增量操作，并先预览 diff 再确认；删除会让后续同类卷/幕/节/章连续补位，需向用户展示完整级联影响。新增章节必须使用唯一章节号，已有正文节点不可删除；补位会使已有正文 ch_XXX 换号时也必须拒绝。

Step 2: 组装上下文

调用 ContextBuilder.build_generation_context()：

上下文组件:
├── 大纲窗口（前后 5 章）
│   └── 确保剧情连贯
├── 出场角色档案
│   └── 自动识别 involved_characters
├── 伏笔状态
│   ├── 待回收: 需要在本章或后续回收
│   └── 已埋下: 可以呼应
├── 三层风格
│   ├── craft/ 通用技法（dialogue_craft + scene_craft + rhythm_craft + humanization）
│   ├── data/novels/{id}/data/sources/{source_id}/style/ 提取风格源
│   └── data/novels/{id}/src/characters/ + src/world/ 设定约束
├── 世界观规则
│   └── 相关实体和关系
└── 真相文件（融合 InkOS）
    ├── current_state.md - 世界当前状态
    ├── ledger.md - 资源账本
    └── relationships.md - 角色关系矩阵

发送前必须执行 tiered-hierarchical-v2 预算检查。超限时依次压缩旧章节记忆、 当前章居中的大纲窗口、真相运行态/人物/精确上文，最后执行硬适配并复检。 前三层不得删除作者意图、创作罗盘或当前章；不得修改 src/ 真源、完整正文或 JSONL 会话历史。将压缩级别、动作及压缩前后估算 token 写入 context.compression。

可选：使用内置 Agent

如果需要更强大的写作能力，可使用内置 Agent：

from tools.agent import WriterAgent, AgentContext
from tools.llm import LLMClient, LLMConfig

config = LLMConfig.from_env()
client = LLMClient(config)
ctx = AgentContext(client, config.model, project_root)

writer = WriterAgent(ctx)
result = await writer.write_chapter(context, chapter_number=5)

WriterAgent 采用两阶段写作：

1. 创意写作 (temperature=0.7) - 生成章节正文
2. 状态结算 (temperature=0.3) - 将变化合并到真相文件

Step 3: 确定戏剧位置

从大纲获取当前章节的 dramatic_position（起/承/转/合/过渡）和内容焦点， 并阅读所属节的普通梗概，理解本章在这一组事件中的承接关系。

示例：

篇梗概: 主角从失踪案追入旧城阴谋，在证据被毁后联合证人公开真相，并承担由此引发的后果。
节梗概: 主角循着失踪案追查旧档案，在证词矛盾中发现真相并决定公开证据。
▶ 本章位于: 转
▶ 本章焦点: 主角发现真相，内心崩溃

Step 4: 生成节拍

节拍是章内微结构，按 dramatic_position 从 templates/beat_templates.yaml 选择：

• 起 → 场景切入 + 悬念铺设 + 角色状态 + 衔接钩子
• 承 → 推进 + 碰撞 + (伏笔) + 递进
• 转 → 升级 + 核心决策 + 后果初现
• 合 → 余波 + 变化确认 + 遗留

节拍数量由章节字数决定（3000字以下: 2-3个; 3000-5000: 3-4个; 5000+: 4-6个）， 不由戏剧结构决定。

Step 5: 生成草稿

将节拍扩写为散文，关键约束：

• 本章的情绪变化由作者意图、章纲和上下文共同决定
• 节奏/张力须与 dramatic_position 匹配（「转」要比「承」更快更紧张）
• 应用风格档案
• 确保角色声音一致

Step 6: 用户审核（强制）

必须暂停等待用户确认！

📝 草稿已生成

**章节**: {chapter_id}
**戏剧位置**: {dramatic_position}
**字数**: {word_count}
**节拍数**: {beat_count}

### 预览（前 500 字）
{preview_text}

---

**请审核后选择**：
1. ✅ 通过 - 进入风格润色
2. 🔄 重写 - 提供修改意见  
3. 📋 手动编辑 - 保存草稿，退出流程

用户选择处理

选择	操作
通过	进入 Step 7 风格润色
重写	收集用户反馈 → 返回 Step 4 重新生成节拍
手动编辑	保存草稿到 manuscript/ → 结束流程

Step 7: 风格润色（可选）

使用 style-system Skill：

• AI 痕迹检测（40+ 中文 AI 套路词）
• 声音一致性检查
• 节奏分布验证（须匹配 dramatic_position 要求的张力）
• 信息倾倒检测

Step 8: 保存草稿

保存到 data/novels/{novel_id}/data/manuscript/：

data/manuscript/
├── arc_001/
│   ├── ch_005.md          # 最终版本
│   ├── ch_005_draft.md    # 初稿
│   └── ch_005_review.yaml # 审查记录

文件访问

操作	路径
读取大纲	data/novels/{novel_id}/src/outline.md + data/novels/{novel_id}/data/hierarchy.yaml
读取角色	data/novels/{novel_id}/src/characters/ + data/novels/{novel_id}/data/characters/cards/
读取风格	data/novels/{novel_id}/data/sources/{source_id}/style/ + data/novels/{novel_id}/data/style/composed.md
读取世界观	data/novels/{novel_id}/src/world/ + data/novels/{novel_id}/data/world/
写入草稿	data/novels/{novel_id}/data/manuscript/

前置条件

开始写章节前，确保以下数据已就绪：

数据	必须？	说明
大纲 (src/outline.md + data/hierarchy.yaml)	✅ 必须	至少有当前章节的章纲
角色卡 (data/characters/cards/)	✅ 必须	本章出场角色的卡片
合成风格 (data/style/composed.md)	⚠️ 建议	没有则使用默认风格
世界观 (src/world/ + data/world/)	可选	有则加载作为约束
伏笔 (data/foreshadowing/dag.yaml)	可选	有则提示待回收伏笔

错误处理

错误	处理
上下文超限	自动压缩低优先级内容
角色档案缺失	使用简卡信息
生成失败	重试 3 次，然后报错
用户中断	保存当前草稿

与其他 Skill 的关系

• novel-manager: 查询/修改大纲、角色、世界观
• novel-reviewer: 审查已完成的章节

示例对话

用户: 写第五章，主角发现真相

AI: 我来帮你创作第五章。

[组装上下文...]
- 大纲位置: 第五章位于第一篇的中段
- 出场角色: 林岑、周岚
- 待回收伏笔: 第二章埋下的神秘信件

[生成节拍...]
ch_005 开场: 林岑在书房发现一封神秘信件
ch_005 发展1: 信件揭示了一个惊人的真相...
...

[生成草稿...]

📝 草稿已生成（3521字）

### 预览
书房的烛火摇曳，林岑的手指颤抖着拆开那封泛黄的信件...

请选择：
1. ✅ 通过
2. 🔄 重写
3. 📋 手动编辑

用户: 1

AI: [风格润色中...]

✅ 第五章已完成，保存到 manuscript/arc_001/ch_005.md