小说创作工具2.0 需求文档

更新于 2026/4/19
项目信息

小说创作工具2.0 需求文档

1. 项目概述

1.1 项目背景

现有小说创作工具已实现单本小说的创建、编辑与管理功能。为满足用户创作长篇连载作品的需求，推出2.0版本，实现多本书籍管理、跨章节关联追踪和云端同步。

1.2 目标用户

  • 网络小说作者（长篇连载、多角色管理）
  • 有多本书籍同时更新的创作者

1.3 开发约束

  • UI一致性：新功能在现有UI基础上修改，保持风格统一
  • 技术栈：现有前端+Node.js后端架构不变

2. 功能需求

2.1 功能优先级矩阵

优先级功能模块核心价值
P0连章创作系统多章节连续创作，支持批量操作
P0角色档案库统一管理全书角色，支持跨章引用
P0情节线追踪可视化情节发展，关联角色与事件
P0伏笔管理系统记录埋设的伏笔，支持回收追踪
P0云端同步多设备实时同步，数据一致性保障
P1版本管理章节版本历史，回溯与对比
P2推广素材生成自动生成简介、章节概要

2.2 P0 核心功能详述

2.2.1 连章创作系统

  • 书架管理：支持创建多个书籍卡片，显示基本信息（书名、封面、字数、更新时间）
  • 章节列表：展示全书章节树，支持拖拽排序、分组（卷/部）
  • 批量操作：批量创建章节、批量更新状态、批量导出

2.2.2 角色档案库

  • 角色卡片：头像、姓名、性别、身份、性格标签、登场章节索引
  • 关系图谱：可视化展示角色间关系
  • 跨章引用：编辑时快速插入/引用已有角色

2.2.3 情节线追踪

  • 情节节点：时间线形式展示关键事件
  • 多线管理：支持主线、副线、支线分类
  • 关联功能：节点关联角色、章节、伏笔

2.2.4 伏笔管理系统

  • 伏笔记录：描述、埋设章节、预期回收章节、状态（待回收/已回收/已失效）
  • 到期提醒：临近预期回收章节时预警
  • 回收追踪：自动关联伏笔与回收处内容

2.2.5 云端同步

  • 实时同步：操作后自动同步，支持冲突处理
  • 离线支持：本地缓存，离线可写
  • 同步状态：清晰展示同步进度与状态

2.3 P1 功能详述

版本管理

  • 每次保存生成版本快照
  • 版本列表展示：时间、操作类型、版本备注
  • 版本对比：支持两版本内容diff展示
  • 一键回溯：选定版本后恢复

2.4 P2 功能详述

推广素材生成

  • 基于章节内容自动生成简介/章节概要
  • 社交媒体推广文案（100字/500字版本）
  • 一键复制，支持多格式导出

3. 数据结构设计

3.1 核心数据模型

// 书籍
{
  "id": "string",
  "title": "string",
  "cover_url": "string",
  "total_words": "number",
  "chapters": ["chapter_id"],
  "characters": ["character_id"],
  "plotlines": ["plotline_id"],
  "foreshadowing": ["foreshadowing_id"],
  "created_at": "timestamp",
  "updated_at": "timestamp"
}

// 章节
{
  "id": "string",
  "book_id": "string",
  "title": "string",
  "order": "number",
  "content": "string",
  "word_count": "number",
  "status": "draft|completed|published",
  "versions": ["version_id"],
  "character_ids": ["character_id"],
  "foreshadowing_ids": ["foreshadowing_id"],
  "plotline_node_ids": ["node_id"],
  "created_at": "timestamp",
  "updated_at": "timestamp"
}

// 角色
{
  "id": "string",
  "name": "string",
  "avatar_url": "string",
  "gender": "string",
  "identity": "string",
  "personality_tags": ["string"],
  "appearance_chapters": ["chapter_id"],
  "relationships": [{ "target_id": "string", "type": "string" }]
}

// 伏笔
{
  "id": "string",
  "book_id": "string",
  "description": "string",
  "sowed_chapter_id": "string",
  "expected_recycle_chapter_id": "string",
  "actual_recycle_chapter_id": "string",
  "status": "pending|recycled|invalid"
}

4. API规划

4.1 RESTful API 规范

资源端点方法说明
书籍/api/booksGET/POST列表/创建
书籍/api/books/{id}GET/PUT/DELETE详情/更新/删除
章节/api/books/{book_id}/chaptersGET/POST列表/批量创建
章节/api/chapters/{id}GET/PUT/DELETE详情/更新/删除
角色/api/books/{book_id}/charactersGET/POST列表/创建
角色/api/characters/{id}GET/PUT/DELETE详情/更新/删除
伏笔/api/books/{book_id}/foreshadowingGET/POST列表/创建
伏笔/api/foreshadowing/{id}PUT更新状态
同步/api/syncPOST推送同步
版本/api/chapters/{id}/versionsGET版本列表

4.2 同步协议

{
  "client_version": "timestamp",
  "changes": [
    {
      "resource": "chapter",
      "id": "string",
      "operation": "create|update|delete",
      "data": {},
      "timestamp": "timestamp"
    }
  ]
}

5. 风险分析

5.1 风险分析表

风险项类型概率影响程度应对措施
离线编辑冲突处理不当技术中高实现基于时间戳的CRDT冲突合并；提供手动解决界面
大体积书籍同步耗时过长技术高中分页加载+增量同步；后台队列异步处理
角色关系图谱渲染性能技术中中使用WebGL/Canvas优化；数据量过大时降级为列表展示
多设备同时编辑数据不一致运营中高强化冲突检测机制；提供版本历史回溯
隐私数据泄露（角色设定/剧情）合规低高数据传输加密存储；完善权限控制体系
用户数据丢失（误删除/同步故障）财务低高多级备份机制；回收站功能；操作日志审计
核心功能未达预期（情节线追踪）商业中中快速迭代验证；灰度发布收集反馈
推广素材生成版权风险合规低中生成内容添加水印；明确免责声明
云服务成本超出预算财务中中用量监控告警；分层存储策略（热/冷数据）
用户隐私合规（GDPR/个保法）合规低高数据导出/删除功能；隐私政策更新

5.2 关键风险应对

  1. 数据一致性：采用乐观锁+最终一致性模型，配合冲突解决UI
  2. 性能优化：前端懒加载+后端分页，核心交互控制在200ms内
  3. 数据安全：传输HTTPS+服务端加密，敏感操作需二次验证

6. 执行计划（AI开发版）

开发主体：AI智能体 时间估算原则：按AI实际执行效率评估，不含人类团队协作开销

6.1 里程碑

阶段周期交付内容说明
M1第1-3天书架管理、章节列表、基础章节编辑核心CRUD功能
M2第4-6天角色档案库、关系图谱卡片+可视化
M3第7-10天情节线追踪、伏笔管理数据关联较复杂
M4第11-14天云端同步、离线支持冲突处理+本地缓存
M5第15-16天版本管理快照+diff展示
M6第17-20天集成测试、发布测试环境验证后上线

总周期：约3周（含需求确认、测试验证时间）

6.2 时间估算说明

AI开发相比人类团队的优势：

  • 无沟通协作开销
  • 代码生成速度快
  • 可连续执行不休息

需额外考虑的时间：

  • 用户需求确认和反馈周期
  • 测试环境验证流程
  • 可能穿插的其他任务

6.3 验收标准

  • 支持同时管理≥10本书籍
  • 单本书籍支持≥500章节
  • 角色关系图谱加载≤2秒（≤100角色）
  • 同步延迟≤5秒（正常网络）
  • 离线编辑可正常工作，恢复网络后自动同步
  • 版本历史可追溯最近30天操作
  • UI与现有工具保持一致

7. 附录

7.1 术语表

术语说明
连章创作支持多章节连续编辑、批量操作
伏笔回收在后续章节呼应/揭示之前埋设的伏笔
情节节点情节线上的关键事件点

7.2 参考文档

  • 现有小说创作工具UI设计稿
  • 技术架构文档（另行维护）
  • 用户研究调研报告（待补充）

文档版本：v2.0 更新日期：2024年

返回列表