# novel

**Repository Path**: wb04307201/novel

## Basic Information

- **Project Name**: novel
- **Description**: 通用长篇网文生成引擎核心库（题材无关）。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# novel-engine-lib

通用长篇网文生成引擎核心库（题材无关）。

## 目录结构

```
.
├── README.md                       ← 本文件
├── .gitignore                       ← IDE / Python 元数据
├── novel_engine_lib/                ← Python 包
│   ├── pyproject.toml
│   ├── CHANGELOG.md
│   ├── README.md
│   ├── smoke_test_cfg.json
│   ├── novel_engine_lib/            ← 包源码（12 子包）
│   │   ├── drivers/                 ← LLMDriver ABC + APIDriver
│   │   ├── config/                  ← pydantic schema + loader
│   │   ├── verifiers/               ← Rule ABC + 4 builtin
│   │   ├── redactors/               ← Redaction ABC + 2 builtin
│   │   ├── tickets/                 ← TicketFormatter + Registry + 3 builtin
│   │   ├── prompts/                 ← PromptSection + Builder + 8 sections
│   │   ├── maintenance/             ← MaintenanceTask + Scheduler + 3 builtin
│   │   ├── parsers/                 ← 章节解析
│   │   ├── writers/                 ← 章节写盘
│   │   ├── core/                    ← paths + state + BatchRunner
│   │   ├── judges/                  ← FiveDimJudge + PolishJudge
│   │   ├── bible/                   ← BibleLoader
│   │   ├── outline/                 ← OutlineLoader
│   │   ├── threads/                 ← ThreadStore
│   │   └── cli.py
│   ├── tests/                       ← 129 个单元测试
│   └── templates/                   ← 模板项目 + 迁移示范
│       ├── novel_project_template/  ← 新题材模板（14 圣经 + 10 卷 + custom_rules + cfg）
│       └── demo/                    ← v5.18 项目迁移示范
└── docs/
    └── superpowers/
        ├── specs/
        │   └── 2026-09-03-novel-engine-lib-design.md
        └── plans/
            └── 2026-09-03-novel-engine-lib.md
```

## 快速开始

```bash
# 1. 安装
cd novel_engine_lib
pip install -e .

# 2. 试模板项目
cd templates/novel_project_template
PYTHONIOENCODING=utf-8 python run.py check
PYTHONIOENCODING=utf-8 python run.py dry-run

# 3. 跑测试
cd ../..
PYTHONIOENCODING=utf-8 python -m pytest tests/ -v
# 期望: 129 passed
```

## 文档

- [设计 spec](docs/superpowers/specs/2026-09-03-novel-engine-lib-design.md)
- [实施 plan](docs/superpowers/plans/2026-09-03-novel-engine-lib.md)
- [lib README](novel_engine_lib/README.md)
- [CHANGELOG](novel_engine_lib/CHANGELOG.md)

## 版本

v0.5.0（Phase 1-5 全部完成，133 个测试通过）

## 抽象核心

6 个 ABC 接口（LLMDriver / Rule / Redaction / TicketFormatter / PromptSection / MaintenanceTask）让题材特化逻辑作为可注入插件。题材切换 = 复制模板 + 填圣经 + 写 custom_rules，零改 lib 代码。