auto-novelist

KO | EN

gitlite — search

#hacktoberfest #react #go #android #rust #linux #macos #java #windows #cli #security #ios #mcp #openai

(★ 19)

No description available.

auto-novelist Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 📖 auto-novelist

让 AI 为你写小说，力争解放你的双手。

**核心做法：**

👉 用一句灵感启动整本书——AI 自动给出方向、世界观、角色、大纲、章节任务 
👉 章节生成 → 去 AI 味 → 字数检查 → 审核修复 → 状态回灌，形成可断点续跑的生产流水线 
👉 写作知识库（12 份指南 + 3 个检测脚本）作为长期资产，每次创作自动召回 
👉 Web 图形界面操作，零命令行基础也能用；也支持 Claude Code Skill 模式 
👉 LLM 可切换：默认阿里千问，也支持 Claude

---

## ✨ 特性

- **🌐 Web 图形界面** — 浏览器操作，项目管理 + 实时流式写作
- **🤖 AI 全自动写作** — 从大纲到成书，一键自动完成
- **📝 千问驱动** — 阿里云 DashScope 千问模型（支持切换 Claude）
- **🔧 双模式运行** — Claude Code Skill（CLI）/ Web 应用（GUI）
- **🧹 去 AI 味系统** — 三遍法 + 8 种 AI 指纹 + 定量检测 + 禁用词分级
- **💓 情绪爽点设计** — 6 种情绪弧线 + 爽点金字塔 + 期待感管理
- **✂️ 章节自定义字数** — 每章独立设定目标字数
- **📤 一键导出** — SQLite → Markdown 导出
- **⏸️ 中断续写** — 自动检测断点，从断点恢复
- **✅ 自动校验修复** — 字数检查 + AI 痕迹扫描 + 不合格自动重写

---

## 🚀 快速开始

### Web 应用模式

```bash
# 1. 配置 API Key
cd novelist-app/backend
cp .env.example .env
# 编辑 .env，填入 DASHSCOPE_API_KEY
# 申请地址：https://bailian.console.aliyun.com

# 2. 安装依赖
pip install -r requirements.txt
cd ../frontend && npm install

# 3. 终端1：启动后端
cd ../backend
python -m uvicorn app.main:app --port 8000 --reload

# 4. 终端2：启动前端
cd ../frontend
npm run dev

# 5. 浏览器打开 http://localhost:3000
```

### Claude Code Skill 模式

```bash
npx skills add junmin-ke/auto-novelist -g
# 在 Claude Code 中输入：
使用 auto-novelist 帮我写一部小说
```

---

## 🏗️ 项目结构

```
auto-novelist/
├── skills/
│   └── auto-novelist/
│       ├── SKILL.md                 # Skill 入口（场景路由 + 决策表 + 自检清单）
│       └── references/
│           ├── flows/   (8 files)   # 编排流程（初始化 → 问答 → 规划 → 写作 → 校验）
│           └── guides/  (17 files)  # 写作知识库 + 模板
├── scripts/
│   ├── check_ai_patterns.py         # AI 痕迹检测（11项规则）
│   └── export_novel.py              # 小说导出
├── screenshots/                     # 界面截图
├── novelist-app/
│   ├── backend/                     # FastAPI + SQLAlchemy + SQLite
│   │   └── app/
│   │       ├── routers/             # API（projects/chapters/ai/orchestration）
│   │       ├── services/            # LLM 客户端 + Skill 编排 + Prompt 构建
│   │       └── models/              # 数据模型
│   └── frontend/                    # Next.js 16 + Tailwind v4 + Tiptap 编辑器
│       └── src/app/novel/[id]/
│           ├── setup/               # 项目创建向导
│           └── workspace/           # 写作工作台
```

---

## 📊 创作流程

```
Phase 0：初始化
  ├─ 加载偏好 → 检测中断 → 展示欢迎
  ↓
Phase 1：三层递进式问答（Web 模式由 Setup Wizard 替代）
  ├─ L1 核心定位 → L2 深度定制 → L3 标题生成
  ↓
Phase 2：规划 + 确认
  ├─ 生成人物档案 → 生成大纲 → 写作计划
  ↓
Phase 3：疯狂创作（全自动，无需确认）
  ├─ 逐章：分析 → 撰写 → 去AI味 → 字数检查 → 下一章
  ↓
Phase 4：自动校验与修复
  ├─ 字数 + AI痕迹 + 对话检查 → 不合格重写（≤3轮）
  ↓
✅ 全稿完成
```

---

## 🎯 核心法则

| 法则 | 说明 |
|-----|------|
| **展示而非讲述** | 用动作和对话表现，不写"他感到愤怒"，写"手背青筋暴起" |
| **冲突驱动剧情** | 每章必须有冲突或转折，连续 500 字无冲突必须引入新张力 |
| **悬念承上启下** | 每章结尾必须留下钩子，13 种类型轮换使用 |
| **对话即权力** | 上位者话少（≤10字），下位者话多（≥20字） |

---

## 🧹 去 AI 味系统

### 三遍法
1. **去泛化** — 砍废话、冗余心理活动、无用环境描写
2. **去书面化** — 打破 AI 腔、破被动句、变化句长节奏
3. **回自然感** — 插入无关细节、对话打断、人物失控时刻

### 8 种 AI 指纹
解释性语气 · 论文式段落 · 意义膨胀 · 三连排比癖 · 总结式结尾 · 形容词堆砌 · 四字格惯性 · 抽象升华

### 定量阈值
- 弱化副词 ≤ 3 个/千字
- 无"不是 A 而是 B"句式
- 章尾禁总结升华
- 身体反应描写 ≥ 1 处/千字
- 对话占比 30-50%

### 检测脚本
```bash
python scripts/check_ai_patterns.py 第01章.md
# 输出：🔴 阻断 / 🟠 警示 / 🟢 通过
```

---

## 🔧 工具脚本

| 脚本 | 用途 |
|------|------|
| `scripts/check_ai_patterns.py <文件>` | AI 痕迹检测（11 项） |
| `scripts/export_novel.py <项目ID> --split` | 导出为 Markdown |

### 导出示例
```bash
python scripts/export_novel.py --list          # 列出所有项目
python scripts/export_novel.py 1               # 导出单一文件
python scripts/export_novel.py 1 --split -o ./我的小说  # 每章独立文件
```

---

## 🖼️ Web 应用

<img src="screenshots/example.png" width="800" alt="写作工作台">
 
 写作工作台 — 左侧章节列表 | 中间 Tiptap 编辑器 | 右侧角色/大纲/统计面板 | 底部 AI 操作栏

| 页面 | 功能 |
|------|------|
| 仪表盘 `/` | 项目列表、创建新项目、继续写作 |
| 项目设置 `/novel/new/setup` | 三步向导：核心定位 → 深度定制 → 标题确认 |
| 写作工作台 `/novel/[id]/workspace` | Tiptap 编辑器 + 角色/大纲面板 + AI 生成/润色/扩展 |
| 设置 `/settings` | API Key 配置、偏好管理 |

### 工作台操作

| 按钮 | 功能 |
|------|------|
| 🤖 AI 生成本章 | 千问实时生成当前章节（SSE 流式输出） |
| 🚀 自动写完 | 一键全自动：规划 → 全部章节 → 校验修复 |
| ✨ 润色去 AI 味 | 对已有章节执行去 AI 味润色 |
| 📈 扩展字数 | 字数不足时自动扩展内容 |
| 目标字数输入框 | 每章独立设定字数，不设则用项目默认值 |

---

## ⚙️ LLM 配置

`.env` 中配置（默认千问）：

```env
LLM_PROVIDER=dashscope
DASHSCOPE_API_KEY=sk-your-key-here
QWEN_MODEL=qwen-plus

# 切换 Claude：
# LLM_PROVIDER=anthropic
# ANTHROPIC_API_KEY=sk-ant-your-key-here
```

---

## 📚 参考资料

### 编排流程（`references/flows/`）

| 文件 | 内容 |
|------|------|
| `00-initialization.md` | 初始化：偏好加载、中断检测 |
| `01-core-identity.md` | Layer 1：核心定位问答 |
| `02-deep-customization.md` | Layer 2：深度定制 |
| `03-title-selection.md` | Layer 3：标题生成 |
| `04-planning.md` | 规划：大纲 + 人物 + 写作计划 |
| `06-writing.md` | 写作：场景检测 + 三种模式 + 13 步协议 |
| `07-validation.md` | 校验：字数 + AI 痕迹 + 差异化修复 |
| `_shared-infrastructure.md` | 共享机制 |

### 写作指南（`references/guides/`）

| 文件 | 内容 |
|------|------|
| `anti-ai-writing.md` | 去 AI 味系统（三遍法 + 8 指纹 + 禁用词 + 改写示例） |
| `emotional-beats.md` | 情绪爽点设计（三板斧 + 6 弧线 + 期待感管理） |
| `chapter-guide.md` | 章节写作（10 种开头 + 中文技法 + 质量评分） |
| `hook-techniques-guide.md` | 悬念钩子（13 尾 + 7 首 + 5 级强度） |
| `content-expansion-guide.md` | 内容扩充（6 技法 + 分题材策略） |
| `character-guide.md` | 人物塑造（矛盾创造深度 + 缺陷框架） |
| `dialogue-guide.md` | 对话写作（权力博弈 + 7 模式 + 5 级递进） |
| `plot-structures-guide.md` | 情节结构（八节点 + 爽点公式 + 五折线） |
| `title-guide.md` | 标题生成 |
| `chapter-template.md` | 章节模板（字段说明 + 定位表 + 示例） |
| `character-template.md` | 人物模板（关系 + 弧线 + 示例） |
| `outline-template.md` | 大纲模板（卷级 + 逐章 + 弧线追踪） |

---

auto-novelist

auto-novelist Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

auto-novelist

auto-novelist Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README