Re:Novel
文境重塑

智能化的小说重写工作台

目前的功能 项目的愿景

• 导入TXT文件并进行章节分析与记忆保存
• 查看小说内容/分章节或全文
• 根据需求进行精修
• 针对AI生成内容的精校
• 动态的记忆保存功能
• 通过聊天的形式获取小说内容
• 不仅是小说
• 完全兼容酒馆（sillytavern）的预设与角色卡

**👉 还有些其他的....**

或许可以用来改论文？

给小说加料？(NSFW)

还有什么....

🌟 核心特性 (Features)

1. 🧠 全局记忆与一致性 (RAG Memory)

告别“吃书”，系统内置 ChromaDB 向量数据库，自动记忆全书内容。

• 智能检索：当你改写第 100 章时，AI 会自动检索参考第 1 章的伏笔、设定和人物关系。
• 智能联想：即使你只写了“那把剑”，系统也能联想到“生锈的铁剑”并提取相关设定。

2. ✍️ 卡片流式编辑器 (Card-Flow Editor)

• 平行对比：左侧原文，右侧 AI 改写，段落级绝对对齐。
• 动态操作：支持任意插入新段落、删除冗余。AI 可根据指令进行扩写或无中生有。
• 沉浸体验：基于 CodeMirror 的美化编辑器，支持全屏专注写作。

3. 🤖 三模态 AI 协作 (Tri-Model Architecture)

独特的双模态写作-写作与校验同步运行-保证你的文章质量

角色	功能描述
Writer (作家)	负责根据你的指令进行改写、润色、扩写。
Reviewer (总监)	独立的审校 AI。检查 OOC（角色崩坏）或逻辑漏洞。
Chat (助手)	右侧常驻助手，随时回答“这一章讲了什么？”或“主角第一次出场是在哪？”。

4. ⚡ 自动化工作流 (Batch Workflow)

• 全书精修：一键启动流水线，自动遍历全书逐章改写。
• 断点续传：随时暂停，进度自动保存。
• 数据安全：支持一键 Fork 项目副本，改坏了随时回滚，安全感拉满。

5. 🎭 角色扮演与风格控制

• SillyTavern 兼容：支持导入酒馆 (Tavern) 格式的 PNG/JSON 角色卡，自动提取人设。ToDo
• 风格矩阵：精细控制保留度（20%-100%）、扩写欲望（保守/狂野）、内容尺度和文风倾向。

---

🚀 快速开始 (Quick Start)

🚀最简单的方式

右侧release下载zip文件解压，打开Run.Bat即可

🌟 开始

环境要求

• OS: Windows / macOS / Linux
• Python: 3.10 或 3.11 (推荐 3.11)

Important

Windows 用户请注意：你需要安装 C++ Build Tools 以编译向量库依赖。

安装步骤

1. 克隆仓库

git clone [https://github.com/BiranSama/ReNovel-AI.git](https://github.com/BiranSama/ReNovel-AI.git)
cd NovelForge-AI--

2. 创建虚拟环境 (推荐)

Windows

python -m venv venv
.\venv\Scripts\activate

macOS / Linux

python3 -m venv venv
source venv/bin/activate

3. 安装依赖

pip install -r requirements.txt

4. 配置APIkey 启动程序后，点击右上角 ⚙️ 设置 (Settings) 图标，填入你的 OpenAI 或 Google Gemini API Key。 (可选：将 .env.example 重命名为 .env 并填入默认 Key)

5. 启动！

python main.py

📖 使用指南

1. 导入与分章

点击右上角 “导入”，拖入 .txt 小说文件。

系统会自动识别“第X章”或纯文本标题，并将小说切分为章节存入数据库。

导入时系统会自动进行一次全书向量化，大文件请耐心等待。

2. 单章精修

在左侧书架选择一章。

在顶部输入指令（例如：“把这段对话写得更幽默”）。

点击段落中间的魔法棒。

AI 会生成改写内容。如果开启了 Reviewer，它会自动进行评分和拦截。

3. 全书自动化精修

点击顶部的 “批量任务” 按钮。

选择范围（全书 / 继续进度）。

勾选 “创建副本”（强烈推荐）。

点击启动，观察 AI 自动工作。

🛠️ 技术栈 (Tech Stack)

模块	技术方案
Frontend	NiceGUI (Vue/FastAPI)
Database	SQLite (Metadata) + ChromaDB (Vector)
AI Core	LangChain
Processing	RapidFuzz, Tiktoken
Editor	CodeMirror

📂 目录结构

NovelForge/
├── data/                 # 用户数据 (已在 .gitignore 中忽略)
│   ├── projects/         # SQLite 数据库 (.db)
│   ├── vectordb/         # ChromaDB 向量索引
│   └── presets/          # 角色卡与预设
├── src/
│   ├── ai/               # LLM 交互与 RAG 引擎
│   ├── core/             # 项目管理与文件解析
│   ├── ui/               # 界面布局与组件
│   └── utils/            # 日志与工具类
├── main.py               # 启动入口
└── requirements.txt      # 依赖清单

🤝 贡献 (Contributing)

欢迎提交 Issue 或 Pull Request！如果你有新的脑洞，请随时告诉我。这是我首次通过git上传仓库

有任何建议请不要吝啬。

Please Star！！！！

📄 License

本项目采用 GPL-3.0 License 开源