AI-Novel-Writing-Assistant

从灵感一句话到整本小说，AI 帮你系统化写完长篇。

开源 🏷️完全免费 ✅ 目前可打开写作内容 🍴 复刻 636 🐛 待处理 117 👀 关注 17

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 3402

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，提供在线网页版，全部功能免费使用。

项目预览

AI-Novel-Writing-Assistant 项目界面预览图 — 图片来源：项目官网

项目数据

分类写作内容

开发团队ExplosiveCoderflome

官网地址https://explosivecoderflome.github.io/AI-Novel-Writing-Assistant

GitHubhttps://github.com/ExplosiveCoderflome/AI-Novel-Writing-Assistant

定价模式🏷️完全免费

价格说明开源项目，提供在线网页版，全部功能免费使用。

访问状态✅ 目前可打开

是否开源是

开源协议NOASSERTION

主要语言TypeScript

技术栈/模型agent-workflow,ai,creative-writing,long-form-fiction,narrative-engine,novel-writing,rag,story-generation,worldbuilding,writing-assistant

GitHub 星标★ 3402

上线时间2025-02-18 00:00:00

代码更新2026-11-06

仓库体积48.4 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数7

项目介绍

这是一个面向长篇小说创作的 AI Native 开源系统，旨在帮助新手作者从一句灵感出发，完成整本小说的创作。它通过 Agent 工作流、世界观构建、写法引擎和 RAG 技术，将创作过程结构化，覆盖从故事规划、角色设定到章节生成的完整流程。项目解决了传统 AI 写作工具难以处理长篇叙事一致性和复杂情节管理的问题，提供了整本生产工作流，让用户能系统性地推进创作。核心能力包括基于 Agent 的自动化写作、灵活的世界观管理、以及可定制的写作风格引擎，适合需要深度创作辅助的写作者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3402

技术标签

agent-workflow ai creative-writing novel-writing rag

使用教程

难度：进阶约 25 分钟部署方式：本地安装 7 步

环境要求

Node.js ^20.19.0 || ^22.12.0 || >=24.0.0
pnpm（项目使用 pnpm workspace 管理前后端）
可访问 Electron 分发源的网络环境（仅启动桌面端时需要）
可选：Qdrant Cloud 账号（需要启用 RAG 检索时）

安装与启动步骤

1拉取项目代码

把仓库克隆到本地并进入项目目录，后续所有命令都在项目根目录执行。
```
git clone https://github.com/ExplosiveCoderflome/AI-Novel-Writing-Assistant.git
cd AI-Novel-Writing-Assistant
```
2安装项目依赖

默认只准备 Web / Server 开发所需依赖，不会在首次安装时强制下载 Electron 桌面运行时。
```
pnpm install
```
3排查安装卡死

若在 Windows 上卡在 prisma preinstall，先查 Node 版本与 script-shell 配置，删除后再重装。
```
node -v
pnpm config get script-shell
npm config get script-shell
```
4配置环境变量

服务端读 server/.env，前端读 client/.env 或 client/.env.local；根目录 .env.example 只作总览参考。
5启动开发环境

一条命令同时起前后端；首次启动服务端会自动执行 Prisma generate 和 db push。
```
pnpm dev
```
6配置模型与路由

打开设置页至少填一组可用的模型供应商 API Key，再到模型路由页确认各任务实际使用的模型。
7可选接入 Qdrant

在 Qdrant Cloud 建集群并复制 Cluster URL 与 API Key 写入 server/.env，再验证连通性。
```
curl -X GET "https://your-cluster.region.cloud.qdrant.io:6333" \
  --header "api-key: your_database_api_key"
```

关键配置

配置项	必填	说明	示例
`RAG_ENABLED`	否	是否启用 RAG 检索；只想先体验主流程可设为 false	`false`
`QDRANT_URL`	否	Qdrant Cloud 集群地址，建议直接填带 :6333 的 REST 地址	`https://your-cluster.region.cloud.qdrant.io:6333`
`QDRANT_API_KEY`	否	Qdrant 集群的 Database API Key，创建后通常只展示一次	`your_database_api_key`

如何确认成功

浏览器打开 http://localhost:5173 能看到界面，后端 http://localhost:3000/api 可访问，即表示启动成功。

常见问题

Q：pnpm install 卡在 prisma preinstall 怎么办？

A：先确认 Node 版本符合要求；再检查 script-shell 是否被设成带 /k 的 cmd.exe，执行 npm config delete script-shell 和 pnpm config delete script-shell 后重开终端再安装。

Q：首次启动前需要手动跑 prisma generate 或 db push 吗？

A：不需要。首次启动服务端时会自动执行 Prisma generate 和 db push，只有自己改了 Prisma schema 或要走正式迁移流程时才手动使用相关命令。

Q：不装 Qdrant 能用吗？

A：可以。在 server/.env 里设 RAG_ENABLED=false 就能跑通主链，需要 RAG 检索时再接入 Qdrant。

Q：只想直接使用、不想配环境怎么办？

A：去 GitHub Releases 下载 Windows 桌面版，优先选 Setup.exe 安装版；不想安装或想放 U 盘运行可选 portable 版本。

注意事项

环境变量按子包读取：服务端读 server/.env，前端读 client/.env 或 client/.env.local，根目录 .env.example 只是总览参考。
RAG 并发数、限速等运行时参数已从 .env 迁到设置面板，改完即生效无需重启。
桌面端运行时首次下载需能访问 Electron 分发源，网络受限时先配置代理或镜像。
启动后建议先访问 /settings、/settings/model-routes，启用知识库时再进 /knowledge?tab=settings 保存 Embedding 与集合设置。