LongStory / README.md
Yoyo2004's picture
Update README.md
1eb0422 verified
---
title: LongStory
emoji: 📊
colorFrom: gray
colorTo: purple
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: false
---
# LongStory Agent 使用说明
LongStory Agent 是一个「多智能体长篇小说生成」前端 Demo,自动生成包含大纲、分事件规划、人物档案和正文章节的长篇故事。
---
## 一、基本使用流程
### 1. 输入故事梗概(Premise)
1. 在左侧 **“Story Premise”** 文本框中输入你的故事创意,例如:
> 高二分班那天,全校第一的高冷学霸竟然主动申请坐到了全是“差生”的最后一排,成了我的同桌,还递给我一本写满笔记的物理书。
2. 也可以直接点击下方的 **示例(Examples)**,自动填入预设的故事创意
### 2. 启动生成
- 点击紫色按钮:**「✨ 开始生成 (GENERATE)」**
- 左下角的 `system.log` 会实时打印:
- Outline 生成进度
- 事件拆分 / 规划进度
- 人物档案 / 动态轨迹对齐
- 正文写作进度
> ⚠️ **提示:生成长篇全文比较耗时。**
>
> 建议调试阶段先用**一个 Event 或少量章节**的故事(例如"生成一个只有一个Event的校园故事"),便于快速观察结构与界面效果。
---
## 二、各个 Tab 的功能说明
右侧主体区域分为五个 Tab:
### 1. 📖 正文阅读(核心阅读区)
- 模拟「纸质书页」的阅读体验:
- 中间是正文书页(固定高度)
- 左右有 **箭头按钮** 控制「上一页 / 下一页」
- 下方有 **⏮️ 上一章 / ⏭️ 下一章** 按钮做章节级跳转
### 2. 🗺️ 故事大纲(Outline)
- 展示结构化的事件大纲 JSON,例如:
- 全局章节列表
- 每个事件的简要描述、时间线
- 用于后续分事件拆分和写作
适合用来快速理解「整本故事的骨架」。
### 3. 📅 剧情规划(Planning)
- 展示生成的「事件 → 子事件」规划结果:
- 每个 Event 被拆成若干 Sub-events
- 记录了人物在各个 Sub-event 中的参与与状态
- 便于分析:
- 某个角色在整个时间线中的出场分布
- 关键冲突在哪些小节展开
### 4. 👥 人物档案(Personas)
- 显示为卡片式人物档案(Character Cards):
- 姓名、年龄阶段、性别
- 角色定位(如「女主」「男二」「闺蜜」「对手」等)
- 人物标签 / 原型(archetype)
- 外貌描述摘要
### 5. 📄 全文导出(Full Story Export)
- 提供**一键复制全文**功能,方便你:
- 复制到 Word / Markdown / Notion / LaTeX 中继续修改
- 做自动评价、人工润色、二次创作等
## 三、参考文献(按字母顺序)
当前系统的设计与实现主要受到以下工作的启发(按英文标题首字母排序):
1. **AGENTS’ ROOM: Narrative Generation through Multi-step Collaboration**
OpenReview: <https://openreview.net/pdf?id=HfWcFs7XLR>
2. **DOC: Improving Long Story Coherence with Detailed Outline Control**
ACL 2023: <https://aclanthology.org/2023.acl-long.190>
3. **Generating Long-form Story Using Dynamic Hierarchical Outlining with Memory-Enhancement**
NAACL 2025: <https://aclanthology.org/2025.naacl-long.63/>
4. **Multi-Agent Based Character Simulation for Story Writing**
IN2Writing 2025: <https://aclanthology.org/2025.in2writing-1.9/>
5. **Story Generator / Long Story Generation via Knowledge Graph and Literary Theory**
arXiv: <https://arxiv.org/abs/2508.03137>
6. **StoryWriter: A Multi-Agent Framework for Long Story Generation**
arXiv: <https://arxiv.org/abs/2506.16445>
7. **WebNovelBench: Placing LLM Novelists on the Web Novel Distribution**
arXiv: <https://arxiv.org/abs/2505.14818>