openwrite-novel

name	openwrite-novel
description	Use when user wants to write novels, manage outlines, characters, world-building, style, workflows, or chapter review. Triggers: 写章节, 生成大纲, 创建角色, 世界观, 风格, 伏笔, 小说

OpenWrite 小说创作系统

OpenWrite 是一个面向长篇小说创作的技能集合。当前口径已经统一到：

• 日常主入口只有两个：openwrite goethe 与 openwrite dante
• src/ 是人和 AI 共读的确认版真源
• data/ 是运行态、缓存、workflow、手稿与草案
• src/story/author_intent.md 是长期作者意图，src/story/current_focus.md 是近期创作罗盘
• openwrite dante 是主编排入口
• openwrite goethe 是长期会话 planning 入口
• write / multi-write / review 也会推进同一套 runtime state
• 每章摘要、观察与三阶段 token 用量保存在 data/memory/chapters/
• write 使用跨进程作品锁，并对正文、truth、memory 做失败回滚
• Studio 顶栏“模型设置”可在当前进程中即时切换模型、API 端点和 token 预算； DeepSeek 快速预设仅包含 V4 Pro / V4 Flash，OpenAI / Anthropic 表示接口格式， Base URL 与模型名保持可编辑； API Key 不得写入项目、Git、浏览器存储或 Agent 上下文
• Studio 的 AI WORKING 必须来自 ReAct 后端活动事件，不得用前端计时伪造阶段
• Goethe / Dante 的正式资产写入共用确认门：先预览 diff，本轮用户明确确认后才允许应用

子技能导航

根据用户意图，读取对应子技能的 SKILL.md：

用户意图	子技能文件	说明
写章节 / 续写 / 生成草稿	skills/novel-creator/SKILL.md	章节创作 Pipeline
角色 / 大纲 / 世界观 / 伏笔管理	skills/novel-manager/SKILL.md	项目资产维护
审查 / 润色 / 连续性检查	skills/novel-reviewer/SKILL.md	审查与修订
风格初始化 / 合成 / 提取	skills/style-system/SKILL.md	风格系统
世界观实体 / 关系图谱	skills/world-query/SKILL.md	世界查询
对话风格 / 口头禅分析	skills/dialoguequality/SKILL.md	对话质量检测
真相文件一致性	skills/truth-validation/SKILL.md	运行态验证
后置规则检查	skills/post-validation/SKILL.md	AI 痕迹与规则检测
伏笔 DAG 管理	skills/foreshadowing-system/SKILL.md	伏笔跟踪
工作流 / 阶段进度 / 恢复	skills/workflow-manager/SKILL.md	流程调度
切割 / 压缩 / 长文本处理	skills/text-processing/SKILL.md	文本处理
长期规划 / 建书 / 灵感收敛	skills/goethe-agent/SKILL.md	Goethe planning 会话与 handoff

当前架构

Goethe / Dante 分工

• Goethe 负责长会话规划：汇总灵感、提建议、修背景、修人物、修设定、修大纲，并在资产成熟时显式 handoff 给 Dante
• Dante 负责把可写资产持续写成正文：预检、写章、审查、状态结算；必要时为正文推进回修人物、设定和大纲

1. 单源文档

核心文档优先使用 TOML front matter + Markdown 正文：

• src/story/*.md
• src/characters/*.md
• src/world/entities/*.md
• data/world/*.md

front matter 负责索引字段：

• id
• summary
• tags
• detail_refs
• related

正文负责详细设定、人类可读说明和长期维护内容。

2. 大纲层级

卷纲 (Volume)
  └─ 幕纲 (Act)       — 卷内的大阶段
      └─ 节纲 (Section) — 中层剧情段落
          └─ 章纲 (Chapter) — 最小写作单元，通常 3000-5000 字

src/outline.md 是唯一语义真源。data/hierarchy.yaml 只是派生缓存，不应手工维护。

3. 风格层次

craft/                                      -> 通用写作技法
data/novels/{id}/data/sources/{source_id}/  -> 用户提供文本提取出的 source pack
data/novels/{id}/src/**                     -> 本书设定约束
data/novels/{id}/data/style/composed.md     -> 合成后的作品风格文档

4. 运行态

data/novels/{id}/data/ 下的重点目录：

• planning/：草案、灵感、未确认大纲
• manuscript/arc_*/ch_*.md：章节正文
• world/：current_state.md / ledger.md / relationships.md
• workflows/：book_state.yaml、wf_ch_*.yaml、Goethe/Dante 的滚动会话状态与完整 *session.jsonl 对话归档
• memory/chapters/：有界章节摘要、客观观察与 token 用量
• reviews/：结构化章节审稿结果
• foreshadowing/dag.yaml：伏笔图
• style/：fingerprint.yaml 与 composed.md

上下文组装

当前默认使用 canonical packet，而不是分散读取多套来源。

from pathlib import Path
from tools.chapter_assembler import ChapterAssemblerV2

assembler = ChapterAssemblerV2(
    project_root=Path.cwd(),
    novel_id="my_novel",
    style_id="my_novel",
)
packet = assembler.assemble("ch_005")
prompt_text = packet.to_markdown()

packet 典型包含：

• 系统职责提示词
• 故事背景
• 历史篇梗概
• 当前篇各节梗概
• 上一章正文
• 主角状态 / current_state / ledger / relationships
• 相关人物文档
• 风格文档
• 概念文档

CLI 入口

主入口

• openwrite dante：长期会话主编排入口
• openwrite goethe：长期会话 planning 入口
• openwrite agent：已退役，提示用户改用 openwrite dante

如果不是在做调试、脚本化或精确控制，优先只通过 goethe / dante 两个 agent 使用系统。

直接命令

• openwrite write ch_005
• openwrite multi-write ch_005
• openwrite review ch_005
• openwrite context ch_005
• openwrite assemble ch_005
• openwrite style synthesize
• openwrite setting extract <source_id> --source <file>
• openwrite source review <source_id>
• openwrite source promote <source_id> --target all

source promote --target all 会把 source pack 同时晋升到 style、foundation 和 world 文档。

• openwrite sync --check
• openwrite status
• openwrite desk
• openwrite studio
• openwrite focus set "本阶段目标"
• openwrite import existing-novel.txt
• openwrite export --format md

所有顶层命令均可附加 --project <作品目录>；省略时使用当前目录。

当前约束

• write / multi-write / review 现在都会复用 canonical packet 语义
• direct CLI 也会推进 book_state.yaml 与 wf_ch_*.yaml
• CLI 与 Studio 共用同一套写章锁、事务提交、审稿存储和生命周期
• Studio 前端覆盖模型会话配置、Goethe/Dante 对话、导入、同步、上下文预览、资产新建、连续性、伏笔和 source pack 全流程
• Goethe / Dante 的 AI 回复按 CommonMark 渲染标题、列表、引用、链接与代码块； 原始 HTML 被转义，用户消息与错误消息保持纯文本
• Studio 左侧“大纲”直接打开 src/outline.md；“故事”不混入大纲，搜索可单独限定大纲
• 项目搜索由 MIT 许可的 HKUDS/LightRAG 提供知识图谱与向量混合检索；索引位于作品私有目录 .openwrite/lightrag/，通过文档内容 revision 增量插入、更新和删除，并把检索块映射回原始文件、标题和行号。未配置 embedding 或服务不可用时只做带状态提示的精确文本降级
• Studio 与 ReAct 通过 get_outline_structure 共用卷/幕/节/章树；按最早未写章纲智能选章，并用 outline revision 防止写错目标
• Studio 与 ReAct 通过 edit_outline_structure 做最小增量改名、增删卷幕节章；删除子树时，后续同类卷/幕/节/章在同一次原子写入中连续补位，附录不参与。ReAct 先以 confirm=false 预览完整级联 diff，再在用户确认后写入。禁止用整份 create_outline 覆盖已有大纲；删除包含正文的节点，或补位会改变已有正文 ch_XXX 的操作必须阻止
• Studio 关系拓扑与 ReAct 的 get_world_relations 共用人物和世界实体真源；不维护 graph.yaml。 拓扑搜索按节点名称、ID、摘要、类型和关系文字匹配，并保留一跳相邻上下文；ReAct 在同一结果集中过滤，不维护第二套索引
• Agent 修改正式关系时必须先预览 diff，再用同一 base_revision 和明确确认写入 [[related]]；revision 冲突时重新预览
• Agent 对大纲、人物、故事、世界实体和关系的应用操作共用不可绕过的明确确认门；工具参数中的 confirm=true 不能代替用户本轮确认
• Studio 的 AI 活动面板轮询 /api/agent/activity，展示后端模型/工具/校验/回复事件；长时与疑似卡住提示保留最后一个真实步骤
• CLI 顶层入口统一接受 --project，从框架目录即可操作独立作品目录
• 空目录运行 openwrite studio 会进入前端建书页，不再要求先执行 openwrite init
• current_state / ledger / relationships 是公开 canonical 命名

关键 Python 工具

工具	文件	用途
大纲解析	tools/outline_parser.py	outline.md → OutlineHierarchy
大纲树与选章	tools/outline_tree.py	Studio/ReAct 同源结构树与下一章建议
大纲树增量编辑	tools/outline_tree.py	revision 保护的改名、新增、删除与安全连续重编号
大纲缓存	tools/outline_cache.py	outline 派生缓存
上下文构建	tools/context_builder.py	章节级生成上下文
章节组装	tools/chapter_assembler.py	canonical packet
主编排	tools/agent/orchestrator.py	书级流程推进
多代理编排	tools/agent/director.py	multi-write 子流程
工作流调度	tools/workflow_scheduler.py	wf_ch_*.yaml
书级状态	tools/agent/book_state.py	book_state.yaml
真相文件	tools/truth_manager.py	runtime truth files
项目搜索	tools/project_search.py	LightRAG 图谱/向量索引与原文定位
世界查询	tools/world_query.py	世界观实体与关系
共享文档规范化	tools/shared_documents.py	单源文档规范化

目录约定

data/novels/{novel_id}/
├── src/
│   ├── outline.md
│   ├── story/*.md
│   ├── characters/*.md
│   └── world/
│       ├── rules.md
│       ├── terminology.md
│       ├── timeline.md
│       └── entities/*.md
└── data/
    ├── hierarchy.yaml
    ├── planning/*.md
    ├── characters/cards/*.yaml
    ├── manuscript/arc_*/ch_*.md
    ├── memory/chapters/ch_*.yaml
    ├── reviews/ch_*.json
    ├── foreshadowing/dag.yaml
    ├── world/*.md
    ├── style/composed.md
    ├── style/fingerprint.yaml
    ├── workflows/book_state.yaml
    ├── workflows/wf_ch_*.yaml
    └── test_outputs/

参考入口

• README.md — 项目概览与命令入口
• tests/test_novel_workspace.py — 小说工作台、创作罗盘与导入导出验收

版本: 5.8.0 | 最后更新: 2026-07-14