项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1273
使用教程
环境要求
- Python 环境（后端使用 FastAPI）
- Node.js 环境（前端使用 Electron）
- 需准备并配置数据库连接（在 .env 中设置）
- Windows 用户可选择免配置的发行版便携包
安装与启动步骤
-
1获取项目源码
从 GitHub 克隆 NovelForge 仓库到本地，这是源码运行方式的第一步。
git clone https://github.com/RhythmicWave/NovelForge.git -
2安装后端依赖
在后端目录执行，安装 Python / FastAPI 相关依赖，请先确认 Python 环境可用。
pip install -r requirements.txt -
3配置后端环境变量
按 README 说明将 backend/.env.example 修改为 .env，并按需填写数据库连接配置。
cp backend/.env.example backend/.env -
4启动后端服务
运行 main.py 启动后端服务，保持该进程运行，不要关闭终端窗口。
python main.py -
5安装前端依赖
在前端目录执行，安装 Node.js / Electron 相关依赖。
npm install -
6启动前端界面
启动 Electron 开发服务器；若只想用浏览器使用，可改用 npm run dev:web。
npm run dev -
7一行命令启动前后端
使用 npm 脚本一次性同时启动前后端，省去分别启动的步骤。
npm run dev
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
APP_PORT | 否 | 后端服务端口，默认 54321，被占用时可修改 | 54321 |
如何确认成功
后端进程无报错并持续运行，前端开发服务器启动后出现 NovelForge 创作界面、能新建项目即为成功。
常见问题
Q：只想在浏览器中使用，可以吗？
A：可以，README 提供了 npm run dev:web 命令，用该命令即可启动 Web 页面方式。
Q：如何同时启动前后端？
A：在项目根目录执行 npm run dev，即可一条命令同时启动前后端服务。
Q：不想配置开发环境怎么办？
A：前往项目 Releases 页面下载最新便携版压缩包，解压后依次运行 backend/NovelForgeBackend.exe 与 NovelForge.exe。
Q：默认 54321 端口被占用怎么办？
A：修改 .env 中的 APP_PORT 即可，后端与桌面前端会读取同一份配置。
Q：版本更新后数据会丢失吗？
A：大部分数据存储在 backend/novelforge.db，迁移时把该数据库文件复制到对应位置即可。
注意事项
- 非开发者建议使用发行版便携包，解压即用，无需配置开发环境。
- .env 需由 backend/.env.example 复制后修改，主要用于配置数据库连接。
- 发行版解压后需先编辑 backend/.env，再启动后端与主程序两个可执行文件。
- 全部数据集中在 backend/novelforge.db，升级或迁移时复制该文件即可。
核心亮点
- 基于 JSON Schema 的结构化生成，支持上下文引用，便于扩展和定制创作流程
- 卡片式创作模式贴合长篇小说分场景/章节的写作习惯，降低组织复杂度
- Python 技术栈，LLM 集成灵活，适合开发者二次开发和自动化工作流
不足之处
- 文档/社区待观察
- 星标数尚在成长阶段，生态和插件丰富度可能有限
适用场景
- 长篇小说作者进行分章分场景的草稿创作与大纲管理
- 需要结构化生成内容的 AI 写作工具开发与集成
- 写作工作流自动化，如批量生成角色设定、情节分支等
替代项目
NovelAI、Sudowrite、LangChain
上一篇：humanize-text
下一篇：shuorenhua
同类项目推荐
worldcraft-codex
开源
本地管理世界观与人物关系，AI 辅助写小说和游戏剧情
A local-first desktop workspace for worldbuilding, game narrative, quests, maps, rel···
LaTeXTrans
开源
翻译 LaTeX 论文，保留公式排版，一键跨语言阅读
A tool for translating the content of LaTeX documents into various other natural lan···
neuro-book
开源
像写代码一样写小说，多智能体帮你管设定防崩坏
An AI-powered IDE for long-form fiction writing, combining software engineering work···
GemType
开源
用你自己的 Gemini 密钥，免费获得全网站语法检查与改写
Free, open-source Grammarly alternative for Chrome & Safari — AI grammar checker an···
awesome-latex-skills
开源
给AI装上LaTeX大脑，论文排版改稿一键搞定
LaTeX manuscript workflows with five agent skills, project diagnostics, reproducible···
bili-note
开源
把B站视频一键变成可搜索的Markdown学习笔记
Extract Bilibili videos into learning-oriented Markdown notes with full subtitle and···
writing-helper
开源
接入多种大模型，定制风格，让写作更快更顺手。
A Next.js-based AI writing assistant supporting multiple LLM APIs (OpenAI, Claude, G···
GPTS-Prompt-Collection
开源
汇集海量 GPTs 提示词，抄作业快速构建你的专属 GPTs
收集GPTS的prompt / Collect the prompt of GPTS
humanize
开源
让 AI 写的文字像真人，九个杠杆一键调
Best static AI text humanizer. Two research-grounded LLM-agnostic skills that make A···