Skip to content

LiPu-jpg/Openwrite

BranchesTags

Repository files navigation

OpenWrite

Autonomous Novel Writing CLI AI Agent
自动化长篇小说写作 CLI AI Agent

Version Python >= 3.10 Primary Entry: openwrite dante Structure: src + data

长篇小说不是一次性 prompt。OpenWrite 把立项、设定、滚动大纲、章节写作、审查、真相文件和 workflow 放进同一条长期生产线里，让你和 Dante 持续把一本书写下去。

推荐用法

OpenWrite 推荐你把它当成一个长期协作的主 agent，而不是一组需要手工维护的文件夹。

  • 对大多数用户来说，日常只需要记住两个入口：openwrite goethe 和 openwrite dante
  • 先用 openwrite goethe 把脑洞整理成可写资产
  • 日常推进时优先用 openwrite dante
  • 只在需要精确检查或脚本化时才直接用 write、review、context、assemble
  • 不要手工维护 data/ 里的缓存和 workflow 文件
  • 只有确认版内容才建议手改 src/

职责拆分：

  • Goethe 负责长会话规划：汇总灵感、提建议、修人物、修设定、修大纲，并在资产成熟时显式交接给 Dante
  • Dante 负责把可写资产持续写成正文，并在正文推进过程中必要时回修资产

一句话说清楚：

  • src/ 是人和 AI 共读的确认版真源
  • data/ 是运行态、workflow、手稿、缓存和快照
  • dante 才是你最应该频繁使用的入口

只记住这两个入口

如果你不想记一堆命令，先只记住：

  • openwrite goethe 负责把你的脑洞整理成可写资产：灵感、人物、设定、大纲、风格来源
  • openwrite dante 负责把这些资产持续写成正文：写章、审查、推进运行态

其他 CLI 命令都可以理解成高级控制面：

  • 当你要调试、脚本化、强制执行某一步时再用
  • 平时不需要围着 data/ 或单个工具命令工作

快速开始

1. 安装

git clone https://github.com/LiPu-jpg/Openwrite_skill.git
cd Openwrite_skill
python -m venv .venv
source .venv/bin/activate
pip install -e .

2. 配置模型

export LLM_API_KEY=your-key
export LLM_MODEL=glm-5

# 如果你走兼容 OpenAI 的端点，也可以设置：
# export LLM_BASE_URL=https://open.bigmodel.cn/api/paas/v4/chat/completions

3. 新书先开 Goethe

openwrite goethe

进入 Goethe 之后，先把这几类信息聊清楚：

  • 题材、基调和核心卖点
  • 主角、主要矛盾、想避免的套路
  • 基础设定、人物草案、当前可写范围大纲
  • 你自己的样文、设定素材或同人来源文本

4. 资产够写了，再切 Dante

openwrite dante

如果项目已经存在，而且你已经有可写资产，通常不需要重新开 Goethe，直接：

source .venv/bin/activate
openwrite dante

最推荐的工作流

1. 先用 Goethe 把灵感整理成可写资产

Goethe 不是一次性建书器，而是长期 planning 会话。先在 Goethe 里把 idea 讲清楚：

  • 题材和基调
  • 主角与核心冲突
  • 想避免的套路
  • 你自己的样文、同人来源或设定素材
  • 当前最想推进到哪

推荐会话像这样：

$ openwrite goethe

我想写一本都市职场异能小说。
主角是普通上班族，晚上能看到异常术式。
先帮我汇总一下当前想法。
这个汇总可以，再整理成基础设定和人物草案。
把大纲推进到能写第六章的范围。

2. 再让 Dante 推进正文

当人物、设定和当前可写范围大纲已经成型后，再进入 Dante：

$ openwrite dante

写第六章，3500 字，冲突更直接。
写完后先自审，再告诉我有没有设定冲突。

3. 让 Goethe 先做汇总，再做大纲；让 Goethe 显式 handoff 给 Dante

最稳的顺序是：

  1. 聊 idea
  2. 让 Goethe 汇总 idea
  3. 确认基础设定
  4. 生成或修改可写范围大纲
  5. Goethe 在资产满足条件后显式 handoff 给 Dante
  6. 再交给 Dante 写章和审查

不推荐直接说“给我写一章”，尤其是在设定和大纲还没稳定的时候。

4. 只有少数场景才建议直达命令

你要做什么 推荐命令 说明
从零开始建项目或持续规划资产 openwrite goethe 长期 planning 入口
长期讨论、推进整本书 openwrite dante 主入口
强制写指定章节 openwrite write ch_006 直达写作
用子流程写章 openwrite multi-write ch_006 director/writer/reviewer 子流程
单独审查已写章节 openwrite review ch_006 不进聊天
查看组装上下文 openwrite context ch_006 --show 查 Dante 到底看了什么
导出 canonical packet openwrite assemble ch_006 --output-dir out 调试写作输入
查看当前运行态 openwrite status 看进度和阶段

你完全可以把这张表当“高级操作列表”：

  • 日常创作：优先 goethe / dante
  • 精确控制、调试或自动化脚本：再用这些直达命令

Dante 会帮你做什么

openwrite dante 是长期会话 ReAct 主 agent。它会在会话里自己决定什么时候：

  • 基于现有人物、设定和大纲推进正文
  • 做章节 preflight
  • 调 write 或 multi-write
  • 调 review
  • 必要时提出并回修人物、设定或大纲
  • 推进 book_state.yaml 和 wf_ch_*.yaml

它不是一次一问一答的 prompt 包装，而是一个以正文推进为中心的持续工作主编排入口。

Dante 的上下文来源

写章前，系统会组 canonical packet，而不是只拼一段 prompt。典型会包含：

  • 当前可写范围大纲
  • 故事背景和基础设定
  • 相关角色文档
  • 相关概念与世界规则
  • 上一章正文
  • current_state.md、ledger.md、relationships.md
  • 风格合成结果和 craft 规则

Dante 也会接收 Goethe 交接过来的 handoff 摘要和当前可写窗口，不需要你从头重新解释前情。

所以更好的提问方式是给目标和约束，而不是直接指挥它去改某个缓存文件。

什么时候才手工改文件

绝大多数情况下，你不需要手工维护运行态文件。

推荐：

  • 和 Dante 聊，确认后让它推进
  • 需要人工修正时，只改 src/ 下的确认版真源
  • 改完 src/ 后，用 openwrite sync 刷新派生缓存

不推荐：

  • 手改 data/hierarchy.yaml
  • 手改 data/characters/cards/*.yaml
  • 手改 data/workflows/wf_ch_*.yaml
  • 把 background_draft.md、foundation_draft.md、outline_draft.md 当另一套真相长期维护

如果你在问“该不该改这个 data/ 文件”，大多数情况下答案都是“不该”。

目录心智

data/novels/{novel_id}/
├── src/
│   ├── outline.md
│   ├── story/
│   │   ├── background.md
│   │   └── foundation.md
│   ├── characters/*.md
│   └── world/
│       ├── rules.md
│       ├── terminology.md
│       ├── timeline.md
│       └── entities/*.md
└── data/
    ├── planning/
    │   ├── ideation.md
    │   ├── ideation_summary.md
    │   ├── background_draft.md
    │   ├── foundation_draft.md
    │   └── outline_draft.md
    ├── manuscript/arc_*/ch_*.md
    ├── world/
    │   ├── current_state.md
    │   ├── ledger.md
    │   └── relationships.md
    ├── foreshadowing/dag.yaml
    ├── style/
    │   ├── composed.md
    │   ├── fingerprint.yaml
    │   └── manifest.toml
    ├── sources/{source_id}/
    │   ├── source.md
    │   ├── setting_profile.md
    │   ├── style/*.md
    │   └── extraction/
    ├── workflows/
    │   ├── book_state.yaml
    │   └── wf_ch_*.yaml
    ├── hierarchy.yaml
    ├── characters/cards/*.yaml
    └── test_outputs/

其中：

  • src/outline.md 是唯一大纲真源
  • data/hierarchy.yaml 是派生缓存
  • data/planning/ideation.md 和 data/planning/ideation_summary.md 是会话与规划运行态
  • data/world/*.md 和 data/workflows/*.yaml 是运行时状态

风格文件说人话

如果你把一篇参考文章交给系统，风格这条链会产出 3 层东西：

  • data/sources/{source_id}/ 这是“拆书笔记”。AI 会把你提供的文章拆成来源说明、设定提要、叙述声音、语言习惯、节奏、对话等文档。
  • data/style/manifest.toml 这是“整理后的风格清单”。系统会把拆书笔记归一成：哪些能学、哪些不能照搬、哪些是作品约束、哪些是对话/叙述/节奏规则。
  • data/style/composed.md 这是“最终给这本书用的风格说明书”。Writer 真正主要参考的是它，而不是直接照着来源文章写。

一句话记忆：

  • sources/{source_id} = 参考文章的拆解笔记
  • manifest.toml = 拆解笔记整理后的可用风格清单
  • composed.md = 给你这本书使用的最终风格说明书

常用命令

主入口

  • openwrite dante
  • openwrite goethe

写作与审查

  • openwrite write next
  • openwrite write ch_006
  • openwrite multi-write ch_006
  • openwrite review
  • openwrite review ch_006

诊断与上下文

  • openwrite status
  • openwrite doctor
  • openwrite context ch_006 --show
  • openwrite assemble ch_006 --output-dir out
  • openwrite sync --check
  • openwrite sync

风格与题材

  • openwrite style extract office_excerpt --source text.txt
  • openwrite setting extract office_excerpt --source text.txt
  • openwrite source review office_excerpt
  • openwrite source promote office_excerpt --target all
  • openwrite style synthesize
  • openwrite radar

其中 source promote --target all 会同时：

  • 切换 style_id
  • 更新 foundation.md
  • 把规则、时间线和阵营拆进 src/world/*.md

旧的 openwrite agent 已退役，请改用 openwrite dante。

Agent 分工

  • Dante 正文创作主 ReAct agent。默认负责基于人物、设定和大纲推进章节正文、预检、审查和状态结算；必要时为正文推进回修资产。
  • Goethe 长会话规划 agent。更适合从零开始汇总灵感、提建议、写背景、写人物、写设定和写大纲，并在资产成熟后显式 handoff 给 Dante。
  • write direct CLI 写作入口。适合明确知道要写哪一章时使用。
  • multi-write Dante 可调度的写作子流程。内部会编排 director、writer、reviewer。
  • review 独立审查入口。适合对现有章稿做单独质量检查。

标准样例

标准样例项目在 data/novels/test_novel/。

如果你想最快看懂这套结构，建议顺序是：

  1. src/outline.md
  2. src/story/background.md
  3. data/planning/ideation.md
  4. data/planning/ideation_summary.md
  5. data/world/current_state.md
  6. data/workflows/book_state.yaml

常见问题

我应该先用 Goethe 还是 Dante

新书第一次启动，先 openwrite goethe。
一旦书建立好了，日常推进基本都用 openwrite dante。

我改了 src/，为什么写作结果没变

先执行：

openwrite sync

outline_draft.md 是不是另一份大纲真相

不是。src/outline.md 才是唯一真源。
outline_draft.md 是给运行态和 workflow 可见性的镜像。

为什么 Dante 有时候会先让我确认，而不是直接写

因为大纲、基础设定和 idea summary 都是门禁。
这不是磨叽，是为了避免长篇写作在后面 20 章、50 章后开始漂。

环境变量

变量 说明 默认值
LLM_API_KEY 模型 API Key 无
LLM_PROVIDER 提供商 openai
LLM_MODEL 模型名 gpt-4o-mini
LLM_BASE_URL 自定义兼容网关 https://api.openai.com/v1
LLM_TEMPERATURE 默认温度 0.7
LLM_MAX_TOKENS 最大输出 token 24000
LLM_TIMEOUT_SECONDS 请求超时秒数 SDK 默认
LLM_MAX_RETRIES 重试次数 SDK 默认

版本

当前版本：5.4.0

About

AI小说创作引擎 - 对话式引导创建项目、动态+静态文件防遗忘、多维风格提取与合成、通用技法质量审核、热门题材查看分析、多层渐进式压缩长文本 支持：四级大纲(总纲→篇→节→章)、三层风格合成、伏笔DAG管理、情节弧线-节拍模板驱动写作、去AI味技法

Topics

story-writing writing-assistant ai-novel

Resources

Readme
Activity

Stars

69 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages