# Deep Novel System

> 一个用于撰写高质量长篇小说的综合系统，擅长复杂叙事、感官描写、跨章节记忆管理与反馈循环。支持多种类型与成人主题（在用户授权范围内）。当用户想开始新小说、继续现有小说或需要长篇结构化叙事指导时使用此技能。

- Skill: `albedo-tabai/deep-novel-system` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add albedo-tabai/deep-novel-system`
- Raw SKILL.md: https://api.skillmd.com/api/skills/albedo-tabai/deep-novel-system/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ALBEDO-TABAI (https://skillmd.com/u/albedo-tabai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/albedo-tabai/deep-novel-system

---


# Deep Novel System (深度小说系统)

## 概览 (Overview)
**Deep Novel System** 是一个专为创作复杂、高质量小说而设计的框架。它特别擅长需要详细感官描述、复杂情节管理和一致角色心理的类型，如色情小说、轻小说和深度叙事作品。

## 何时使用此技能 (When to Use This Skill)
- **开始新小说 (Starting a New Novel)**: 当用户想要构建具有稳健结构的新项目时。
- **撰写章节 (Writing Chapters)**: 当用户需要按照严格的工作流撰写特定部分（如 `CHxx SECxx`）时。
- **管理长篇叙事 (Managing Long Narratives)**: 当上下文管理、记忆更新和情节一致性至关重要时。
- **色情/感官描写 (Erotic/Sensory Writing)**: 当用户要求"深度"或"沉浸式"描述时。

---

## 首次使用指南 (First-Time Setup)

使用本技能前，需要先确定您的写作项目目录。

> **两种初始化方式**：
> 1. **交互式（推荐 / 默认）**：直接说"我想开始写小说"，AI 会按下方流程边问边生成完整项目结构。
> 2. **脚本（可选）**：`python scripts/init_novel.py <目录>`，仅复制 `assets/template/` 下的基础骨架（含空 `state.yaml` / `requirements.md`），之后仍需手动补全大纲、角色卡、范文等内容。

### 交互式引导

当您说"我想开始写小说"或激活此技能时，我会进行以下流程：

### 步骤 1：询问项目路径

> 您想把小说项目放在哪里？请提供一个目录路径。
> 
> 示例：`F:\我的小说\项目A` 或 `D:\Writing\新作品`

### 步骤 2：检查现有文件

- **如果目录已存在内容**：识别现有文件结构，询问是继续现有项目还是覆盖
- **如果是空目录或新目录**：进入引导问答

### 步骤 3：引导问答（如果没有基础文件）

我会询问以下问题来帮助建立项目基础：

1. **小说类型/风格**：例如色情、轻小说、现代言情、玄幻等
2. **主要角色**：简单描述 2-3 个核心角色
3. **核心冲突/主题**：故事的核心驱动力是什么？
4. **预计篇幅**：短篇（< 5万字）/ 中篇（5-20万字）/ 长篇（> 20万字）
5. **特殊要求**：是否有特定的写作风格或禁忌词汇要求

### 步骤 4：生成基础文件

根据您的回答，我会在项目目录下创建：

```
<您的项目目录>/
├── config/
│   └── instruction.md    # SillyTavern Chat Completion 预设（可选，不用 ST 可删）
├── drafts/               # 存放生成的章节草稿（ch??_sec??.md 或 ch??.md）
├── plans/
│   ├── global_plan.md    # 全局大纲（主线、三幕、章节清单、伏笔台账）
│   ├── chapters/         # 各章细分大纲（ch01_plan.md、ch02_plan.md ...）
│   └── setting/          # 世界观与角色设定
│       ├── characters.md # 角色卡与关系网
│       └── world.md      # 世界观事实、专有名词、时间线
├── memory/               # 已写章节/小节的压缩记忆块（mem_ch??_sec??.md）
├── references/           # 用户提供的范文与风格素材
├── feedback/
│   ├── requirements.md   # 累积反馈（条目元数据详见 docs/feedback_loop.md）
│   └── archive/          # 已归档规则
└── state.yaml            # 项目进度状态机
```

> **首次引导问答的详细流程见** [docs/onboarding.md](docs/onboarding.md)。

---

## 继续现有项目

如果您已有项目目录，只需告诉我：

> "继续写作 `<项目路径>`"

我会自动读取项目结构，加载上下文，并准备好从上次中断处继续。

---

## 工作流 (Workflows)

### 1. 长篇小说写作流程 (Long Novel Writing Process)
有关撰写章节的详细分步指南，请参阅 **长篇小说写作工作流**。

-   **参考文档**: [workflow.md](docs/workflow.md)
-   **关键阶段**:
    1.  **输入分析 (Input Analysis)**: 阅读以前的章节、大纲和要求。
    2.  **起草 (Drafting)**: 分块编写内容（例如 `CH01 SEC01`），含截断检测与续写。
    3.  **审查与润色 (Review & Refine)**: 根据"禁词表"和风格指南进行检查。
    4.  **状态机更新**: 推进 `state.yaml` 的章节/段落进度。

### 2. 记忆与上下文管理 (Memory & Context Management)
跨长篇小说管理状态至关重要。

-   **参考文档**: [memory_management.md](docs/memory_management.md)（含 YAML front-matter schema）
-   **参考文档**: [reference_usage.md](docs/reference_usage.md)
-   **原则**:
    -   在重大事件后更新 `memory/` 文件。
    -   维护角色状态和关系图。
    -   不可逆事件必须写入 memory front-matter 的 `irreversible_changes`，新章节不得违反。

### 3. 反馈循环 (Feedback Loop)
通过迭代反馈改进写作。

-   **参考文档**: [feedback_loop.md](docs/feedback_loop.md)（含条目元数据与归档流程）

> **重要**: `docs/` 目录下的文档是 AI 自身的规则手册。`references/` 目录下的内容才是用户提供的写作范文与素材。读取 `references/` 做风格学习时，**不要**把 `docs/` 也读进来，否则会把规则文档当成范文模仿。

---

## 项目模板结构 (`assets/template`)

该技能包含一个空白项目模板，使用初始化脚本复制到您的项目目录：

```bash
python scripts/init_novel.py <目标目录>           # 默认：仅创建缺失文件，不覆盖已有
python scripts/init_novel.py <目标目录> --dry-run # 预览将要创建的文件
python scripts/init_novel.py <目标目录> --force   # 显式确认覆盖（用于重置）
```

模板结构：
-   `config/instruction.md`: SillyTavern Chat Completion 预设（可选）
-   `plans/global_plan.md`: 全局大纲骨架
-   `plans/chapters/ch01_plan.md`: 章节大纲样板
-   `plans/setting/characters.md` + `world.md`: 角色与世界观骨架
-   `drafts/`: 存放生成章节文本
-   `memory/`: 每节/每章写完后的压缩记忆块
-   `references/`: 用户提供的范文与风格素材
-   `feedback/requirements.md`: 反馈骨架；`feedback/archive/`: 归档目录
-   `state.yaml`: 项目进度状态机

---

## 使用技巧 (Usage Tips)
-   **项目隔离**: 每个小说项目应有独立的目录，便于管理多个作品
-   **配置继承**: 可以从现有项目复制 `config/instruction.md` 到新项目
-   **风格**: 该系统推崇"展示，不要讲述 (Show, Don't Tell)"和沉浸式、感官丰富的描述
-   **安全**: 虽然能够处理 NSFW 内容（如果用户规则允许），但始终遵守 `instruction.md` 中配置的边界