FableFlow/README.md

## FableFlow（寓言流）
- 一个基于多 Agent 协作的长篇故事创意与写作系统
- 没什么技术含量，只是用于展示无代码多 AGENT 的实际应用场景

> <img width="2880" height="1773" alt="01" src="https://github.com/user-attachments/assets/7378a045-de06-4c4a-9589-4c9eccc06e42" />

## 项目简介
- 通过三个专业化 AI Agent 的协作，实现从创意构思到正文输出的完整创作流程
- 专注于创作具有强烈沉浸感与情感冲击力的优秀小说
- 通过精准的细节描写、递进的情节张力与深刻的角色塑造，为读者带来难忘的阅读体验

## 核心特性

### 三位一体的 Agent 协作系统
- **架构师**：负责场景规划与剧情大纲设计，输出包含"高冲击力"细节的批量大纲
- **写作员**：根据大纲输出高质量正文，每章约 8000 字，分三次输出
- **书记员**：维护世界观、人物档案、剧情摘要等持久化数据，确保逻辑一致性

### 技术优势
- **职责分离**：三个 Agent 各司其职，避免单一 Agent 承担过多任务导致的质量下降
- **质量控制**：内置详细创作准则，书记员执行逻辑质检，确保输出质量
- **伏笔管理**：完整的伏笔管理系统，确保故事的连贯性和完整性
- **滑动上下文**：智能管理上下文长度，保证创作一致性的同时避免性能问题

## 使用方法

### 运行环境
- FableFlow 是一个纯 Agent 应用，需要依赖 Agent 框架才能运行
- 开发环境是字节跳动的 [→ Trae IDE ←](https://www.trae.cn/)，因为不要钱
- 理论上其他 Agent 框架也可以，请自行尝试

### 创建智能体
- 架构师
  - **提示词**：填入 `99_System/01_架构师.md` 文件内的内容
  - **工具权限**： 仅勾选 Read 权限
- 写作员
  - **提示词**：填入 `99_System/02_写作员.md` 文件内的内容
  - **工具权限**： 仅勾选 Read Write 权限
- 书记员
  - **提示词**：填入 `99_System/03_书记员.md` 文件内的内容
  - **工具权限**： 仅勾选 Read Write 权限

### 前置准备
- 清空目录：`01_World/`、`02_Memory/`、`03_Story/`
- 根据需要修改 `00_Base/初始创意.md` `00_Base/创作准则.md` 中的内容

### 创作流程
- 创意：
  - 选择架构师智能体，输入召唤词：`开始执行创作基座任务`
  - 架构师会根据初始创意和创作准则，开始与你讨论故事创意
  - 聊完所有脑洞和细节后，输入召唤词：`开始执行章节规划任务`，架构师输出分章节剧情大纲
- 记录：
  - 选择书记员智能体，输入召唤词：`开始执行创作基座持久化任务`
  - 书记员会将创作基座写入文件持久化
- 创作：
  - 重新启动一个新的对话任务（可选，但是推荐，因为长上下文会显著降低模型智能）
  - 选择写作员智能体，输入召唤词：`开始执行创作第x章任务`
  - 观看写作员的输出，确认是否符合预期，若不符合，你可以提出修改意见让其修改或者重写
- 记录：
  - 选择书记员智能体，输入召唤词：`开始执行动态记忆持久化任务`
  - 书记员会将创作动态记忆写入文件持久化
- 重复 `创作 * 记录` 步骤，直至完成

## 目录结构

```
FableFlow/
├── 00_Base/                    # 创意与基准
│   ├── 创作准则.md
│   └── 初始创意.md
├── 01_World/                   # 静态设定
├── 02_Memory/                  # 动态记忆
├── 03_Story/                   # 故事正文
└── 99_System/                  # 系统资料
    ├── 01_架构师.md
    ├── 02_写作员.md
    └── 03_书记员.md
```

## 适用场景
- 长篇小说创作，特别是需要保持高度一致性和细节丰富度的作品
- 悬疑推理、科幻奇幻、现实主义、浪漫爱情等类型文学
- 需要严格管理设定、人物、伏笔的复杂世界观故事

## 一个由 `FableFlow` 生成的故事的示例
- 点击下载 [→ Sample_SFW ←](https://github.com/neavo/FableFlow/releases/tag/Sample_SFW)
- 一共五章
- 全自动生成，所有创意和正文编纂都由 AI 处理，无人工介入
- 创意阶段和前三章的处理模型是 `Doubao-1.8`，后两章的处理模型是 `DeepSeek-v3.1`

## 许可证
- 本项目采用 [CC BY-NC 4.0](LICENSE)（知识共享 署名-非商业 4.0）许可证
- **允许：**
  - ✅ 个人学习、研究和创作
  - ✅ 非商业用途的自由使用、分享、修改和衍生
- **禁止：**
  - ❌ 商业用途（任何以盈利为目的的使用）
- **要求：**
  - 📝 使用时需署名原作者