My Novel Writer

# Novel Writer 技能

**版本**: 1.0  
**描述**: 辅助创作长篇小说的智能助手，支持人物设定、世界观管理、大纲控制和分章生成。

---

## 🚀 功能特性

> ⚠️ **重要**：请通过环境变量配置 API 密钥，不要在配置文件中硬编码。

### 环境变量列表

| 变量名 | 必填 | 默认值 | 说明 |
|--------|------|--------|------|
| `WORKDIR` | 否 | `/app/working` | 工作目录 |
| `NOVEL_API_KEY` | 是 | - | API 密钥 |
| `NOVEL_API_BASE_URL` | 否 | - | API 基础 URL |
| `NOVEL_MODEL` | 否 | `gpt-3.5-turbo` | 模型名称 |
| `NOVEL_TEMPERATURE` | 否 | `0.8` | 温度参数 |
| `NOVEL_MAX_TOKENS` | 否 | `4096` | 最大令牌数 |
| `NOVEL_DEFAULT_STYLE` | 否 | `wuxia` | 默认写作风格 |

### 使用示例

```bash
# Linux/Mac
export NOVEL_API_KEY="sk-xxx"
export NOVEL_API_BASE_URL="https://your-api.com/v1"
export NOVEL_MODEL="qwen/qwen3.5-122b-a10b"

# Windows (CMD)
set NOVEL_API_KEY=sk-xxx

# Windows (PowerShell)
$env:NOVEL_API_KEY="sk-xxx"
```

---

- ✅ **记忆持久化**: 自动保存人物、世界观、大纲和已写章节，避免遗忘。
- ✅ **大纲驱动**: 先规划大纲，再按章生成，确保剧情逻辑连贯。
- ✅ **风格锁定**: 支持自定义写作风格（如：武侠、科幻、悬疑）。
- ✅ **进度管理**: 实时查看创作进度，支持动态调整大纲。
- ✅ **文件输出**: 每章自动生成独立的 `.md` 文件，方便后续编辑。

---

## 📖 使用指南

### 1. 初始化小说
```text
novel_writer --new "我的奇幻世界"
```
> 这将创建一个名为《我的奇幻世界》的新小说项目，并初始化记忆库。

### 2. 设定人物
```text
novel_writer --set-character "林风" "主角，25岁，剑客，性格孤傲但重情义。"
novel_writer --set-character "苏月" "女主角，23岁，医师，温柔善良，擅长草药。"
```

### 3. 设定世界观
```text
novel_writer --set-world "一个充满魔法与剑的奇幻大陆，分为三大王国，常年处于战争边缘。"
```

### 4. 规划大纲
```text
novel_writer --add-outline 1 "初遇" "林风在森林中救下受伤的苏月，两人结伴同行。"
novel_writer --add-outline 2 "危机" "遭遇敌国刺客，林风重伤，苏月用草药救他。"
```

### 5. 生成章节
```text
novel_writer --generate 1 2500
```
> 生成第 1 章，目标字数 2500 字。生成后会自动保存到 `novels/` 目录。

###...

# Novel Writer v3.0

小说创作助手，支持人物设定、世界观管理、大纲控制和 AI 章节生成。

## 环境配置

```bash
# 必填
export NOVEL_API_KEY="your-api-key"
export NOVEL_API_BASE_URL="https://your-api.com/v1"

# 可选
export NOVEL_MODEL="gpt-3.5-turbo"
export NOVEL_TEMPERATURE="0.8"
export NOVEL_MAX_TOKENS=4096
export NOVEL_DEFAULT_STYLE="wuxia"
```

## 安装依赖

```bash
pip install openai pydantic
```

## 快速开始

```bash
# 1. 创建新小说
python core.py --new "我的奇幻世界"

# 2. 设定人物
python core.py --novel-title "我的奇幻世界" --set-character "林风" "主角，25岁，剑客"

# 3. 设定世界观
python core.py --novel-title "我的奇幻世界" --set-world "一个充满魔法的大陆"

# 4. 设定风格
python core.py --novel-title "我的奇幻世界" --set-style "wuxia"

# 5. 添加大纲
python core.py --novel-title "我的奇幻世界" --add-outline 1 "初遇" "林风在森林中救下受伤的少女"

# 6. 生成章节
python core.py --novel-title "我的奇幻世界" --generate 1 2300

# 7. 查看进度
python core.py --novel-title "我的奇幻世界" --status
```

## CLI 命令

| 命令 | 说明 |
|------|------|
| `--new TITLE` | 创建新小说项目 |
| `--novel-title TITLE` | 指定小说名称 |
| `--set-character NAME PROFILE` | 设定人物 |
| `--set-world SETTING` | 设定世界观 |
| `--set-style STYLE` | 设定写作风格 (wuxia/xianxia/scifi/mystery) |
| `--add-outline NUM TITLE SUMMARY` | 添加大纲 |
| `--import-outline FILE` | 从 JSON 导入大纲 |
| `--export-outline FILE` | 导出大纲到 JSON |
| `--generate NUM WORDS` | 生成章节 |
| `--generate-batch START END WORDS` | 批量生成章节 |
| `--regenerate NUM` | 重新生成章节 |
| `--status` | 查看创作进度 |
| `--stats` | 查看详细统计 |

## 高级功能

### 批量生成
```bash
python core.py --novel-title "我的小说" --generate-batch 1 10 2300
```

### 导入大纲 (JSON)
```bash
python core.py --novel-title "我的小说" --import-outline outline.json
```

大纲 JSON 格式:
```json
{
  "novel_title": "我的小说",
  "outline": [
    {"chapter": 1, "title": "初遇", "summary": "..."},
    {"chapter": 2, "title": "危机", "summary": "......