# novel-ai

**Repository Path**: snail_tech/novel-ai

## Basic Information

- **Project Name**: novel-ai
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-03
- **Last Updated**: 2026-10-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# novel-ai · 全自动小说创作工作台

挂机式全自动小说生产系统：AI 立项 → 七步流水线 → 质量门禁 → 章节落账，文件即真相源（兼容 novel-creation 技能目录规范）。

## 快速开始

```bash
# 1. 安装依赖（Python 3.10+）
cd backend
pip install -r requirements.txt

# 2. 配置 LLM（复制并填入你的 Key，OpenAI 兼容协议）
copy ..\config.example.json ..\config.json

# 3. 启动
run.bat        # 或: python -m uvicorn app.main:app --port 8765 --app-dir backend

# 4. 打开工作台
http://127.0.0.1:8765
```

## 使用流程

1. **书架 → 新建书籍**：输入一句话灵感，AI 自动立项（书名/大纲/契约/人物雏形全部自动生成）
2. **生产看板**：选择连写章数 →「开始生产」→ 实时查看流式正文、机器门禁、QC 评审、自动决策日志
3. **章节表**：点击任意章查看正文 + 八维雷达图 + 问题清单
4. **设置**：配置主/备模型（备用失败自动切换）、测试连通性

默认契约：总字数 100w-200w（默认 150w）、单章 8000 字，建书后可在契约接口调整。

## 架构

```
backend/app/
├── config.py / db.py / llm.py / sse.py      # 基础设施（SQLite 索引 + LLM 抽象 + SSE 总线）
├── engine/                                   # 质量引擎（G1-G12 门禁 + anti-slop）与 Prompt 装配
├── harness/                                  # Agent Loop 运行时（state/tools/evaluator/loop）
├── presets/                                  # 预设库：题材/文风/人物档案组件/写作技法
└── routers/api.py                            # REST API
frontend/                                     # Vue3 + ECharts 工作台（零构建，本地 vendor）
data/novels/<书>/                             # 书目录（技能规范：chapters/qc/project.json/硬约束/时间线）
docs/                                         # 设计文档 00-05 + 验收自评
```

## 设计文档

- `docs/00-产品初步大纲.md` — 总纲
- `docs/01-工作台模式设计.md` — 五模式/布局/状态机
- `docs/02-约束体系与质量闭环设计.md` — 约束三层/图谱/质量闭环
- `docs/03-辅助创作系统设计.md` — 文风/去AI化/文学修改/文化融合
- `docs/04-人物人化模拟系统设计.md` — 人物五层模型/角色面试
- `docs/05-模块化架构设计.md` — 六类模块/manifest/扩展机制
- `docs/06-业界调研与融合.md` — 14 项目调研与 9 项融合（I1-I9）
- `docs/07-能力全景与验证.md` — 七大板块能力清单与五层验证记录
- `docs/验收/M1-自评.md` — 里程碑自评（对照技能包）

## 里程碑

- [x] **M1** 单章全自动闭环（Loop + 门禁 + QC + 最小 UI）
- [ ] **M2** 设定阶段 P1-P5 + 设定工作区 + 人物工坊 + 伏笔台账
- [ ] **M3** 挂机引擎（Watchdog + 三方对账 + 红区审批流）
- [ ] **M4** 仪表盘 + 阅读器 + 导出