Update README.md

README.md

@@ -9,4 +9,78 @@ app_file: app.py
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# LongStory Agent 使用说明
+
+LongStory Agent 是一个「多智能体长篇小说生成」前端 Demo，用于调用后端的 `Longstory-backend`（基于 StoryWriter / Agents' Room 等工作）自动生成包含大纲、分事件规划、人物档案和正文章节的长篇故事。
+
+---
+
+## 一、基本使用流程
+
+### 1. 输入故事梗概（Premise）
+
+1. 在左侧 **“Story Premise”** 文本框中输入你的故事创意，例如：
+
+   > 高二分班那天，全校第一的高冷学霸竟然主动申请坐到了全是“差生”的最后一排，成了我的同桌，还递给我一本写满笔记的物理书。
+
+2. 也可以直接点击下方的 **示例（Examples）**，自动填入预设的故事创意
+
+
+### 2. 启动生成
+
+- 点击紫色按钮：**「✨ 开始生成 (GENERATE)」**  
+- 左下角的 `system.log` 会实时打印：
+  - Outline 生成进度
+  - 事件拆分 / 规划进度
+  - 人物档案 / 动态轨迹对齐
+  - 正文写作进度
+
+> ⚠️ **提示：生成长篇全文比较耗时。**
+> 
+> 建议调试阶段先用**一个 Event 或少量章节**的故事（例如"生成一个只有一个Event的校园故事"），便于快速观察结构与界面效果。
+
+---
+
+## 二、各个 Tab 的功能说明
+
+右侧主体区域分为五个 Tab：
+
+### 1. 📖 正文阅读（核心阅读区）
+
+- 模拟「纸质书页」的阅读体验：
+  - 中间是正文书页（固定高度）
+  - 左右有 **箭头按钮** 控制「上一页 / 下一页」
+  - 下方有 **⏮️ 上一章 / ⏭️ 下一章** 按钮做章节级跳转
+
+### 2. 🗺️ 故事大纲（Outline）
+
+- 展示结构化的事件大纲 JSON，例如：
+  - 全局章节列表
+  - 每个事件的简要描述、时间线
+  - 用于后续分事件拆分和写作
+
+适合用来快速理解「整本故事的骨架」。
+
+### 3. 📅 剧情规划（Planning）
+
+- 展示由 PlanningAgent / SubeventDynamicsAligner 生成的「事件 → 子事件」规划结果：
+  - 每个 Event 被拆成若干 Sub-events
+  - 记录了人物在各个 Sub-event 中的参与与状态
+- 便于分析：
+  - 某个角色在整个时间线中的出场分布
+  - 关键冲突在哪些小节展开
+
+### 4. 👥 人物档案（Personas）
+
+- 显示为卡片式人物档案（Character Cards）：
+  - 姓名、年龄阶段、性别
+  - 角色定位（如「女主」「男二」「闺蜜」「对手」等）
+  - 人物标签 / 原型（archetype）
+  - 外貌描述摘要
+
+### 5. 📄 全文导出（Full Story Export）
+
+- 提供**一键复制全文**功能，方便你：
+  - 复制到 Word / Markdown / Notion / LaTeX 中继续修改
+  - 做自动评价、人工润色、二次创作等
+