OpenWrite

OpenWrite 是一套专为长篇叙事设计的 AI Agent 协作系统，解决传统聊天式 AI 写作中常见的上下文丢失、设定冲突和逻辑断层问题。它通过将作者意图、人物状态、世界规则和滚动大纲整合进一个可持续的创作流程，确保故事在几十甚至几百章后仍能保持连贯性与一致性。

该项目采用本地优先架构，所有核心数据以 Markdown 文件形式落盘，支持版本控制与离线运行，适合希望掌握创作主导权的中长篇作者。

核心架构：Goethe 与 Dante 双 Agent 协同

OpenWrite 的工作流由两个专职 Agent 驱动，通过明确的交接（Handoff）机制协作：

1. Goethe（规划者）：
   • 负责将灵感转化为可写资产。
   • 管理人物档案、世界设定、伏笔及全书大纲。
   • 在与作者讨论后，仅当获得明确确认才将变更写入正式资产库（src/ 目录）。
2. Dante（执行者）：
   • 负责具体的章节写作、审稿与修订。
   • 组装包含最近正文、滚动大纲、相关人物状态及语义召回的“规范数据包”（Canonical Packet）。
   • 执行写前检查、初稿生成、事实提取及章节状态结算。

关键特性

• 🧭 创作罗盘与单一真源：
  • author_intent.md 记录全书核心承诺，current_focus.md 锁定近期目标。
  • 所有人物、世界和大纲信息以 src/ 目录下的文件为唯一真源，避免信息分散。
• 📝 可追踪的状态管理：
  • 每章结束后自动进行“状态结算”，更新人物位置、伤势、认知等客观事实。
  • 支持轻量内联批注，自动检查连续性冲突（如人物在前一章已受伤，下一章却完好无损）。
• 🛡️ 可靠写章与版本保护：
  • 引入作品级锁机制，确保写章过程中正文、真相文件和章节记忆作为一个原子单元提交。
  • 支持 Checkpoint 和 AI 修订 Diff，失败时可一键恢复至写前快照。
• 🔍 37 维审稿闭环：
  • 审稿 Agent 基于作者意图、正典、关系网、风格指南及章节目标，从 37 个维度扫描问题。
  • 支持在 Studio 中定位原文、筛选问题严重度，并生成可审阅的修订提案。
• 💾 本地检索与参考库：
  • 默认使用本机 FastEmbed 进行向量检索，支持 OpenAI-compatible 接口。
  • 复杂关系遍历时可启用 LightRAG 图谱模式。
  • 私有参考库仅纳入人工明确选中的风格或设定，防止模型随意引入外部噪声。

快速上手

OpenWrite 提供了图形化界面（Studio）和命令行工具（CLI），推荐普通用户直接使用 Studio。

1. 启动 Studio

下载或克隆仓库后，直接双击根目录下的启动脚本：

• macOS: 启动 OpenWrite.command
• Windows: 启动 OpenWrite.bat

启动器会自动检查 Python 3.10+ 环境，在 .openwrite-runtime/ 中创建隔离虚拟环境并安装依赖。

2. 从源码安装

git clone https://github.com/LiPu-jpg/Openwrite.git
cd Openwrite
python3.10 -m venv .venv
source .venv/bin/activate       # Windows: .venv\Scripts\activate
python -m pip install -e .
openwrite studio

3. 配置与创作

• 模型配置：在 Studio 顶栏设置 OpenAI、Anthropic 或自定义兼容模型的 API Key。密钥默认仅保存在当前进程内存中，可选择加密存入本地凭据文件。
• 建书与导入：支持从零创建新书，或通过“项目迁移”功能解析现有的 TXT/Markdown 正文，无缝接入 AI 协作流程。

适用人群

• 中长篇网文/小说作者：需要维护庞大世界观和复杂人物关系的创作者。
• 严谨型写作者：重视逻辑连贯性、设定一致性及版本管理的作者。
• 本地化偏好者：希望数据完全掌握在自己手中，不依赖云端平台锁定的用户。